شغّل المطعم محليًا

افتح كل طرفية في المكان الذي تتوقعه الأوامر أدناه: داخل food-studio-full-stack للحزمة الكاملة، أو بجوار مجلد التطبيق لحزمة التطبيق الواحد.

شغّل واجهة API أولًا: تقرأ الواجهتان الأماميتان كل بياناتهما منها.

شغّل واجهة API

1. 01

   ثبّت واضبط الإعداد

   يعمل .env.example كما هو للتطوير المحلي: SQLite على المنفذ 8000.

   الطرفيةنسخ

   corepack enable
   cd back-end
   yarn install
   cp .env.example .env

   شاهد الخطوة0:09

   تواجه مشكلة؟

   أنجزت هذه الخطوة
2. 02

   أنشئ قاعدة البيانات

   ينشئ yarn seed الملف database.sqlite وجداوله والمطعم التجريبي: ثماني فئات، و64 طبقًا مع صورها، والكومبو، وأربعة مطابخ، والفريق، وستة أسابيع من الطلبات والتقييمات ونقاط المكافآت. تشغيله مرة أخرى يضيف ما هو ناقص فقط.

   الطرفيةفي back-endنسخ

   yarn seed

   أنجزت هذه الخطوة
3. 03

   شغّل الخادم

   الطرفيةفي back-endنسخ

   yarn dev

   النتيجة المتوقعة: يجيب localhost:8000/api/healthمحلي بـ {"success":true,"data":{"status":"ok","database":"up"},"message":""}.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

شغّل واجهة API

1. 01

   ثبّت واضبط الإعداد

   يعمل .env.example كما هو للتطوير المحلي: SQLite على المنفذ 8000.

   الطرفيةنسخ

   corepack enable
   cd food-studio-backend
   yarn install
   cp .env.example .env

   شاهد الخطوة0:09

   تواجه مشكلة؟

   أنجزت هذه الخطوة
2. 02

   أنشئ قاعدة البيانات

   ينشئ yarn seed الملف database.sqlite وجداوله والمطعم التجريبي: ثماني فئات، و64 طبقًا مع صورها، والكومبو، وأربعة مطابخ، والفريق، وستة أسابيع من الطلبات والتقييمات ونقاط المكافآت. تشغيله مرة أخرى يضيف ما هو ناقص فقط.

   الطرفيةفي food-studio-backendنسخ

   yarn seed

   أنجزت هذه الخطوة
3. 03

   شغّل الخادم

   الطرفيةفي food-studio-backendنسخ

   yarn dev

   النتيجة المتوقعة: يجيب localhost:8000/api/healthمحلي بـ {"success":true,"data":{"status":"ok","database":"up"},"message":""}.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

شغّل موقع الطلبات

في طرفية ثانية:

1. 01

   ثبّت واضبط الإعداد

   يوجّه ملف .env المنسوخ الموقعَ إلى واجهة API على المنفذ 8000.

   الطرفيةنسخ

   cd storefront
   yarn install
   cp .env.example .env

   شاهد الخطوة0:07

   أنجزت هذه الخطوة
2. 02

   شغّله

   الطرفيةفي storefrontنسخ

   yarn dev

   النتيجة المتوقعة: يفتح localhost:3030محلي الموقع بالإنجليزية مع القائمة التجريبية؛ والنسخة العربية على /ar.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

شغّل موقع الطلبات

واجهة API ليست جزءًا من هذه الحزمة. شغّلها أولًا؛ يتوقعها ملف .env المنسوخ على http://localhost:8000/api.

1. 01

   ثبّت واضبط الإعداد

   إذا كانت واجهة API تعمل في مكان آخر، اضبط NEXT_PUBLIC_API_BASE_URL في .env على عنوانها، مع /api.

   الطرفيةنسخ

   corepack enable
   cd food-studio-website
   yarn install
   cp .env.example .env

   شاهد الخطوة0:07

   تواجه مشكلة؟

   أنجزت هذه الخطوة
2. 02

   شغّله

   الطرفيةفي food-studio-websiteنسخ

   yarn dev

   النتيجة المتوقعة: يفتح localhost:3030محلي الموقع مع القائمة القادمة من واجهة API الخاصة بك؛ والنسخة العربية على /ar.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

شغّل لوحة تحكم الفريق

في طرفية ثالثة:

1. 01

   ثبّت واضبط الإعداد

   يوجّه ملف .env المنسوخ لوحة التحكم إلى واجهة API وإشعاراتها المباشرة على المنفذ 8000.

   الطرفيةنسخ

   cd admin-dashboard
   yarn install
   cp .env.example .env

   شاهد الخطوة0:07

   أنجزت هذه الخطوة
2. 02

   شغّلها وسجّل الدخول

   الطرفيةفي admin-dashboardنسخ

   yarn dev

   النتيجة المتوقعة: يفتح localhost:3031محلي نموذج تسجيل الدخول. سجّل الدخول بـ owner@foodstudio.example وكلمة المرور FoodDemo2026!.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

شغّل لوحة تحكم الفريق

واجهة API ليست جزءًا من هذه الحزمة. شغّلها أولًا؛ يتوقعها ملف .env المنسوخ على http://localhost:8000/api.

1. 01

   ثبّت واضبط الإعداد

   إذا كانت واجهة API تعمل في مكان آخر، اضبط NEXT_PUBLIC_API_BASE_URL (مع /api) وNEXT_PUBLIC_WEBSOCKET_BASE_URL (من دونه) في .env على عنوانها.

   الطرفيةنسخ

   corepack enable
   cd food-studio-staff-dashboard
   yarn install
   cp .env.example .env

   شاهد الخطوة0:07

   تواجه مشكلة؟

   أنجزت هذه الخطوة
2. 02

   شغّلها وسجّل الدخول

   الطرفيةفي food-studio-staff-dashboardنسخ

   yarn dev

   النتيجة المتوقعة: يفتح localhost:3031محلي نموذج تسجيل الدخول. سجّل الدخول بحساب المالك owner@foodstudio.example وكلمة المرور FoodDemo2026!، وهو حساب تقبله واجهة API بعد تعبئة بياناتها.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

بناء الإنتاج

المجلدات نفسها، تُبنى مرة واحدة ثم تُشغَّل. اضبط أولًا ملف .env الخاص بواجهة API للإنتاج: مع NODE_ENV=production لا تنشئ واجهة API أي جداول عند بدء التشغيل، وترفض أن تبدأ ما دام JWT_SECRET فارغًا أو بقيمة المثال، أو ما دام CORS_ORIGIN فارغًا.

NODE_ENV=production
JWT_SECRET=paste-the-generated-secret-here
CORS_ORIGIN=http://localhost:3030,http://localhost:3031
FRONTEND_URL=http://localhost:3031
STOREFRONT_URL=http://localhost:3030

ولّد السر بالأمر node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". ثم، داخل مجلد واجهة API، ابنِها، وأنشئ جداولها مرة واحدة، وشغّلها. يضيف yarn seed:prod المطعم التجريبي وحساباته؛ أما yarn db:sync:prod بدلًا منه فينشئ جداول فارغة من دون حسابات.

yarn build
yarn seed:prod
yarn start:prod

• الإطلاق

بناء الإنتاج للواجهات الأمامية

في مجلد كل واجهة أمامية، ابنِ مرة واحدة ثم شغّل. يعمل الموقع على 3030 ولوحة التحكم على 3031.

yarn build
yarn start

تُضمِّن الواجهات الأمامية ملف .env الخاص بها وقت البناء، لذلك شغّل yarn build مجددًا بعد تغييره. قبل النشر في أي مكان عام، اقرأ قائمة التحقق الخاصة بالإطلاق.

• الإطلاق

ابدأ من جديد ببيانات تجريبية جديدة

أوقف واجهة API، ثم احذف ملف قاعدة البيانات واملأه بالبيانات مرة أخرى، داخل مجلد واجهة API. هذا يحذف كل ما أنشأته.

rm -f database.sqlite* && yarn seed

في PowerShell:

Remove-Item database.sqlite*; yarn seed

التالي

• اضبط متغيرات البيئة
• شغّله باستخدام Docker بدلًا من ذلك
• أصلح مشكلة في الإعداد