المتطلبات

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

كود واجهة NestJS 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 22.9 أو أحدث. تحقق من إصدارك بالأمر node -v. تستخدم صور Docker الإصدار Node.js 24.
• Yarn 4 عبر Corepack. نفّذ corepack enable مرة واحدة؛ فكل تطبيق يثبّت Yarn 4.8.1 في package.json، ولذلك يختار yarn هذا الإصدار. لا يأتي Node.js 25 وما بعده مع Corepack: نفّذ npm install -g corepack أولًا، ثم corepack enable.
• لا حاجة إلى حزم عامة. يأتي كل تطبيق مع ملف yarn.lock الخاص به، فيثبّت yarn install الإصدارات نفسها التي اختُبر بها القالب.

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

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

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

المنافذ

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

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

المنفذ

تستمع لوحة التحكم على المنفذ 3030. تأكد من أن شيئًا آخر لا يستخدمه، أو شغّلها على منفذ آخر.

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

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

لا شيء من هذه الخدمات ضروري لتشغيل لوحة التحكم محليًا. تُفعَّل كل واحدة بمتغيراتها؛ وإذا تركتها فارغة تبقى ميزتها معطلة ويعمل كل شيء آخر.

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