على خادم Linux (PM2 + Nginx)
ثبّت Node.js 22 أو أحدث وانسخ المشروع إلى الخادم (مثلاً
/var/www/sufra).أنشئ
.envكما في التثبيت، واضبط العنوان العام:SITE_URL="https://order.your-restaurant.com"يجب أن يكون
SITE_URLهو عنوان HTTPS الذي يستخدمه الزبائن بالضبط: إليه يعيد ثواني الزبون بعد الدفع، ويُعلَّم كوكي الجلسة بأنه آمن عندما يبدأ بـhttps://.ابنِ المشروع وأنشئ قاعدة البيانات:
npm ci npm run setup npm run buildأبقِه يعمل بـ PM2:
npm install -g pm2 pm2 start npm --name sufra -- start pm2 save && pm2 startupيستمع التطبيق على المنفذ 3301 (
npm start). لتغييره عدّل-p 3301في سكربتstartداخلpackage.json.ضع Nginx أمامه من أجل HTTPS:
server { server_name order.your-restaurant.com; client_max_body_size 5m; # رفع صور الأطباق (حتى 4 ميجابايت) location / { proxy_pass http://127.0.0.1:3301; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }ثم احصل على شهادة (مثلاً
certbot --nginx). سطرX-Forwarded-Forمهم: حدود الطلبات (الطلبات وتسجيل الدخول) تُحسب لكل زائر حسب عنوانه.
التحديث
git pull # أو انسخ الملفات الجديدة
npm ci
npx prisma db push # يطبّق الجداول أو الأعمدة الجديدة ويحتفظ ببياناتك
npm run build
pm2 restart sufra
النسخ الاحتياطي
مع SQLite يكون المطعم كله هو الملف prisma/sufra.db إضافة إلى صورك المرفوعة في public/uploads. انسخهما احتياطياً، مثلاً كل ليلة:
sqlite3 prisma/sufra.db ".backup /backups/sufra-$(date +%F).db"
tar czf /backups/uploads-$(date +%F).tgz public/uploads
الانتقال إلى PostgreSQL
SQLite كافٍ لمطعم واحد. لعدة نسخ من الخادم أو لقاعدة بيانات مُدارة:
- في
prisma/schema.prismaغيّرprovider = "sqlite"إلىprovider = "postgresql". - اضبط
DATABASE_URL="postgresql://user:password@host:5432/sufra". - شغّل
npm run setup.
لا شيء آخر يتغير. مع أكثر من نسخة خادم انقل الصور المرفوعة إلى تخزين مشترك، واستبدل محدِّد الطلبات المحفوظ في الذاكرة داخل src/lib/api.ts بمخزن مشترك (انظر حل المشكلات).
منصات الاستضافة
أي استضافة تشغّل خادم Node.js تعمل. على المنصات ذات القرص المؤقت أو للقراءة فقط (كثير من منصات serverless) لا يبقى ملف SQLite ولا مجلد public/uploads: استخدم PostgreSQL، وعدّل مسار الرفع src/app/api/dashboard/upload/route.ts ليحفظ في تخزين سحابي (S3 أو R2 أو غيرهما).