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

التثبيت اليدوي والنشر

ضع سُفرة على خادمك مع HTTPS وأبقِه يعمل.

على خادم Linux (PM2 + Nginx)

  1. ثبّت Node.js 22 أو أحدث وانسخ المشروع إلى الخادم (مثلاً /var/www/sufra).

  2. أنشئ .env كما في التثبيت، واضبط العنوان العام:

    SITE_URL="https://order.your-restaurant.com"
    

    يجب أن يكون SITE_URL هو عنوان HTTPS الذي يستخدمه الزبائن بالضبط: إليه يعيد ثواني الزبون بعد الدفع، ويُعلَّم كوكي الجلسة بأنه آمن عندما يبدأ بـ https://.

  3. ابنِ المشروع وأنشئ قاعدة البيانات:

    npm ci
    npm run setup
    npm run build
    
  4. أبقِه يعمل بـ PM2:

    npm install -g pm2
    pm2 start npm --name sufra -- start
    pm2 save && pm2 startup
    

    يستمع التطبيق على المنفذ 3301 (npm start). لتغييره عدّل -p 3301 في سكربت start داخل package.json.

  5. ضع 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 كافٍ لمطعم واحد. لعدة نسخ من الخادم أو لقاعدة بيانات مُدارة:

  1. في prisma/schema.prisma غيّر provider = "sqlite" إلى provider = "postgresql".
  2. اضبط DATABASE_URL="postgresql://user:password@host:5432/sufra".
  3. شغّل npm run setup.

لا شيء آخر يتغير. مع أكثر من نسخة خادم انقل الصور المرفوعة إلى تخزين مشترك، واستبدل محدِّد الطلبات المحفوظ في الذاكرة داخل src/lib/api.ts بمخزن مشترك (انظر حل المشكلات).

منصات الاستضافة

أي استضافة تشغّل خادم Node.js تعمل. على المنصات ذات القرص المؤقت أو للقراءة فقط (كثير من منصات serverless) لا يبقى ملف SQLite ولا مجلد public/uploads: استخدم PostgreSQL، وعدّل مسار الرفع src/app/api/dashboard/upload/route.ts ليحفظ في تخزين سحابي (S3 أو R2 أو غيرهما).