سُفرة التوثيق · سُفرة

التثبيت

من الملفات المنزّلة إلى موقع مطعم يعمل في نحو خمس دقائق.

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) في التثبيت اليدوي والنشر.