ابدأ من أساس يعمل.

ثبّت الحزم

فعّل Corepack مرة واحدة (يأتي مع Node.js 22.9 وما بعده)، ثم ثبّت حزم كل تطبيق بإصدار Yarn المثبّت في المستودع.

corepack enable
cd back-end && yarn install && cd ..
cd dashboard && yarn install && cd ..
cd website && yarn install && cd ..

اضبط البيئة

انسخ قالب البيئة لكل تطبيق. تشغّل القيم الافتراضية كل شيء على جهازك: الواجهة البرمجية على 8000، ولوحة التحكم على 3031، وهذا الموقع على 3030.

cp back-end/.env.example back-end/.env
cp dashboard/.env.example dashboard/.env
cp website/.env.example website/.env

استخدم قالب البيئة نفسه عند النشر، واضبط JWT_SECRET خاصًا بك في back-end/.env قبل أن يصل أي أحد آخر إلى الواجهة البرمجية.

ابدأ التطوير

أنشئ البيانات التجريبية مرة واحدة، ثم شغّل كل تطبيق في نافذة طرفية مستقلة وافتح http://localhost:3030.

cd back-end && yarn seed && yarn dev
cd dashboard && yarn dev
cd website && yarn dev

تفضّل Docker؟ من جذر المستودع، يبني الأمر docker compose up --build التطبيقات الثلاثة ويشغّلها مع البيانات التجريبية.