1. ثبّت الحزم
تحتاج Node.js الإصدار 22 أو أحدث (انظر المتطلبات). داخل مجلد المشروع:
npm install
2. أنشئ ملف الإعدادات
cp .env.example .env
افتح .env وغيّر هذين السطرين على الأقل:
AUTH_SECRET="ضع-هنا-نصاً-عشوائياً-طويلاً"
OWNER_PASSWORD="كلمة-مرور-قوية-للمالك"
لتوليد نص سري جيد:
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
كل المتغيرات مشروحة في متغيرات البيئة.
3. أنشئ قاعدة البيانات والمطعم التجريبي
npm run setup
ينفّذ هذا الأمر ثلاث خطوات: prisma generate (عميل قاعدة البيانات)، ثم prisma db push (ينشئ الجداول في prisma/sufra.db)، ثم npm run db:seed (القائمة التجريبية والإعدادات وحساب المالك الأول). يمكن تشغيله أكثر من مرة بأمان، فهو لا يملأ إلا ما هو فارغ.
للبدء من جديد بقاعدة بيانات فارغة:
npm run db:reset
4. شغّله
npm run dev
| العنوان | ماذا يفتح |
|---|---|
| http://localhost:3301 | يحوّل إلى الموقع العربي /ar |
| http://localhost:3301/en | الموقع الإنجليزي |
| http://localhost:3301/ar/dashboard | لوحة الموظفين (ادخل بـ OWNER_EMAIL و OWNER_PASSWORD) |
5. تأكد أن كل شيء يعمل
npm run lint # فحص TypeScript، والمتوقع بلا أخطاء
npm test # اختبارات الأسعار ومسار الطلب وساعات العمل
npm run build # بناء نسخة الإنتاج
الإنتاج
لمطعم حقيقي شغّل نسخة الإنتاج خلف HTTPS. الخطوات الكاملة (خادم مع PM2 و Nginx، والنسخ الاحتياطي، والانتقال إلى PostgreSQL) في التثبيت اليدوي والنشر.