عن المشروع

يشغّل هذا المستودع موقع PostHog بالكامل، ويُعامل كمنتج. يتضمن جميع المحتوى المكتوب (ميزات المنتج، والأدلة، والوثائق، والمدونات، ودراسات الحالة، والدروس التعليمية، ودليل الشركة)، بالإضافة إلى ميزات تفاعلية مثل نظام الأسئلة والأجوبة (Squeak!)، وقوائم الوظائف (عبر Ashby)، وحاسبة الأسعار، وخريطة الطريق، ووثائق API، والمزيد. تحتوي قاعدة الشيفرة على جميع المكونات والقوالب والمنطق والتصميم. ## البدء السريع 1. **ما قبل التثبيت**: ثبّت Node (الإصدار 22) وpnpm (عبر `corepack use pnpm@latest-10`). 2. **بدء التطوير**: استنسخ المستودع، وثبّت التبعيات باستخدام `pnpm install`، ثم شغّل `pnpm start`. يعمل الموقع على `http://localhost:8001`. بالنسبة لأجهزة Mac المزودة بشرائح Apple Silicon، تتضمن الخطوات الإضافية إزالة `node_modules` وتثبيت `vips` عبر Homebrew. 3. **التحرير والمعاينة**: استخدم أداة Gatsby GraphQL على `http://localhost:8001/___graphql` لاستعلامات البيانات. ## الإعداد المتقدم - **تصحيح الأخطاء**: اسحب أحدث التغييرات، ونظّف ذاكرة التخزين المؤقت، وتأكد من عدم وجود بيئات flox متعارضة. - **وثائق API**: تجاوز عنوان URL لمخطط API باستخدام `POSTHOG_OPEN_API_SPEC_URL` لاستخدام نسخة PostHog محلية. - **قوائم وظائف Ashby والمساهمون في GitHub**: يتطلب متغيرات بيئة خاصة. - **قسم المنشورات**: قم بزيارة `/posts` مباشرة لرؤية النسخة المحلية. - **معاينات Cloudflare للطلبات (PR)**: تُبنى باستخدام `GATSBY_MINIMAL=true`؛ قد لا يتم إنشاء صفحات القوائم. - **متجر البضائع**: يتطلب متغيرات بيئة Shopify (`SHOPIFY_APP_PASSWORD`، `GATSBY_MYSHOPIFY_URL`، `GATSBY_SHOPIFY_STOREFRONT_TOKEN`). - **صور Open Graph الديناميكية**: ابنِ باستخدام `ASHBY_API_KEY` و`GITHUB_API_KEY`، وقم مؤقتًا بتعطيل سطر في `gatsby/onPostBuild.ts` لإنشاء الصور محليًا. ## المساهمة المساهمات مرحّب بها. ترتيب الأولويات: اطرح الأسئلة في المجتمع، أو أرسل تقارير الأخطاء/الملاحظات، أو صوّت على الميزات، أو افتح طلبات السحب (PRs)، أو افتح مشكلات/أفكار محتوى. تتوفر تعليمات مفصلة في الدليل وملف `AGENTS.md`.