على خادم لينكس (PM2 وNginx)
ثبّت Node.js بإصدار 22.18 أو أحدث، وانسخ المشروع إلى الخادم (مثلاً
/var/www/nuzul).أنشئ
.envكما في التثبيت، واضبط العنوان العام والمنطقة الزمنية لإقاماتك:SITE_URL="https://stays.your-company.com" COMPANY_TIMEZONE="Asia/Muscat"يجب أن يكون
SITE_URLعنوان HTTPS الذي يستخدمه الضيوف بالضبط: إليه تعيد ثواني الضيف بعد الدفع، ومنه تُبنى خريطة الموقع، وعلى أساسه يُعلَّم ملف الجلسة بأنه آمن. أماCOMPANY_TIMEZONEفيحدد معنى «اليوم»: أي التواريخ مضى، ومتى يُسمح بتسجيل الوصول، ومتى يظهر رمز الباب.ابنِ المشروع وأنشئ قاعدة البيانات:
npm ci npm run setup npm run buildأبقِه يعمل بواسطة PM2:
npm install -g pm2 pm2 start npm --name nuzul -- start pm2 save && pm2 startupيستمع التطبيق على المنفذ 3304 (
npm start). لتغييره عدّل-p 3304في سكربتstartداخلpackage.json.ضع 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 لشركة واحدة بعشرات الإقامات. أما مع أكثر من نسخة للخادم أو قاعدة بيانات مُدارة:
- في
prisma/schema.prismaغيّرprovider = "sqlite"إلىprovider = "postgresql". - اضبط
DATABASE_URL="postgresql://user:password@host:5432/nuzul". - شغّل
npm run setup.
لا شيء آخر يتغير، والفهرس الفريد على (الإقامة، الليلة) الذي يمنع الحجز المزدوج يعمل في PostgreSQL بالطريقة نفسها. ومع أكثر من نسخة، انقل الصور المرفوعة إلى تخزين مشترك، واستبدل محدِّد الطلبات المحفوظ في الذاكرة داخل src/lib/api.ts بمخزن مشترك مثل Redis.
منصات الاستضافة
يعمل نُزُل على أي استضافة تشغّل خادم Node.js. في المنصات التي قرصها للقراءة فقط أو مؤقت (كثير من الاستضافات «بلا خادم») لا تبقى SQLite ولا public/uploads: استخدم PostgreSQL، وعدّل src/app/api/dashboard/upload/route.ts ليحفظ الصور في تخزين كائنات (S3 أو R2 وغيرهما).