نُزُل التوثيق · نُزُل

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

انشر نُزُل على خادمك مع HTTPS، واتركه يعمل دون انقطاع.

على خادم لينكس (PM2 وNginx)

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

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

    SITE_URL="https://stays.your-company.com"
    COMPANY_TIMEZONE="Asia/Muscat"
    

    يجب أن يكون SITE_URL عنوان HTTPS الذي يستخدمه الضيوف بالضبط: إليه تعيد ثواني الضيف بعد الدفع، ومنه تُبنى خريطة الموقع، وعلى أساسه يُعلَّم ملف الجلسة بأنه آمن. أما COMPANY_TIMEZONE فيحدد معنى «اليوم»: أي التواريخ مضى، ومتى يُسمح بتسجيل الوصول، ومتى يظهر رمز الباب.

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

    npm ci
    npm run setup
    npm run build
    
  4. أبقِه يعمل بواسطة PM2:

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

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

  5. ضع Nginx أمامه من أجل HTTPS:

    server {
      server_name stays.your-company.com;
      client_max_body_size 5m;               # رفع الصور (4 ميغابايت كحد أقصى)
      location / {
        proxy_pass http://127.0.0.1:3304;
        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). يجب أن يضبط Nginx الترويسة X-Forwarded-For كما في المثال، لأن حدود الطلبات على الحجز والبحث عن الحجز وتسجيل الدخول تُحسب لكل زائر حسب عنوانه.

التحديث

git pull            # أو انسخ الملفات الجديدة
npm ci
npx prisma db push  # يضيف الجداول أو الأعمدة الجديدة ويحافظ على بياناتك
npm run build
pm2 restart nuzul

النسخ الاحتياطي

مع SQLite، الشركة كلها في الملف prisma/nuzul.db إضافة إلى الصور المرفوعة في public/uploads. انسخهما كل ليلة، مثلاً:

sqlite3 prisma/nuzul.db ".backup /backups/nuzul-$(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/nuzul".
  3. شغّل npm run setup.

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

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

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