المتطلبات

ما تحتويه كل حزمة

حزمة التطبيق الواحد لا تتضمن التطبيقات الأخرى. الموقع ولوحة التحكم يقرآن كل شيء من واجهة API الخاصة بالقالب، وكود واجهة API موجود فقط في حزمتَي الحزمة الكاملة وواجهة API (Backend API).

باستخدام Docker

• Docker Desktop على macOS أو Windows، أو Docker Engine مع إضافة Compose على Linux. تبدأ الحزمة الكاملة بأمر docker compose واحد.
• اتصال بالإنترنت للبناء الأول، الذي ينزّل الصور الأساسية والاعتماديات.
• لا شيء آخر: يجلب Docker معه Node.js، وقاعدة البيانات ملف SQLite داخل وحدة تخزين Docker.

باستخدام Docker

• Docker Desktop على macOS أو Windows، أو Docker Engine على Linux. لتطبيقك ملف Dockerfile خاص به؛ ولا حاجة إلى Compose.
• اتصال بالإنترنت للبناء الأول، الذي ينزّل الصورة الأساسية والاعتماديات.

من دون Docker

• Node.js 24 أو أحدث، وهو الإصدار الذي يعلنه كل تطبيق وتستخدمه صورة Docker الخاصة به. تحقق من إصدارك بالأمر node -v.
• Yarn 4، عبر Corepack. شغّل corepack enable مرة واحدة؛ كل تطبيق يثبّت إصدار Yarn الخاص به، فيختار yarn الإصدار الصحيح. إذا لم يكن مع Node.js لديك Corepack، فثبّته أولًا بالأمر npm install -g corepack.
• لا حاجة إلى حزم عامة.

قاعدة البيانات

لا حاجة إلى خادم قاعدة بيانات. تستخدم واجهة API قاعدة SQLite افتراضيًا، وينشئ yarn seed الملف لك؛ ويستخدم Docker قاعدة SQLite أيضًا. الانتقال إلى MySQL مدعوم بتغيير في الإعدادات، لا بتغيير في الكود.

• استخدم MySQL بدلًا من ذلك

المنافذ

يعمل كل تطبيق على منفذ محلي ثابت. تأكد من أن لا شيء آخر يستخدمها، أو، مع Docker، انقل أحدها باستخدام SITE_PORT أو ADMIN_PORT أو API_PORT في ملف .env بجوار docker-compose.yml.

• المنفذ مستخدم بالفعل

المنفذ

يعمل الموقع على المنفذ 3030 ويتوقع واجهة API على 8000. تأكد من أن لا شيء آخر يستخدمهما.

• المنفذ مستخدم بالفعل

المنفذ

تعمل لوحة التحكم على المنفذ 3031 وتتوقع واجهة API على 8000. تأكد من أن لا شيء آخر يستخدمهما.

• المنفذ مستخدم بالفعل

المنفذ

تعمل واجهة API على المنفذ 8000، وتقبل افتراضيًا الموقع من 3030 ولوحة التحكم من 3031. تأكد من أن لا شيء آخر يستخدم المنفذ 8000.

• المنفذ مستخدم بالفعل

واجهة API للربط

ليست لتطبيقك بيانات خاصة به. يحتاج إلى واجهة API الخاصة بالقالب قيد التشغيل ومعبّأة بالبيانات، وتضبط عنوانها في ملف .env الخاص به. تُباع واجهة API كحزمة مستقلة، هي واجهة API (Backend API)، وهي جزء من الحزمة الكاملة.

• اربط واجهة API الخاصة بك

الخدمات الاختيارية

لا تحتاج إلى أي منها لتشغيل المطعم محليًا. يُفعَّل كل منها بمتغيراته في ملف .env الخاص بواجهة API؛ والمتغير الذي يبقى معلّقًا كتعليق يُبقي ميزته متوقفة.

• اضبط هذه الخدمات