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

التثبيت

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

1. ثبّت الحزم

تحتاج Node.js بالإصدار 22.18 أو أحدث (انظر المتطلبات). في مجلد المشروع:

npm install

2. أنشئ ملف الإعدادات

cp .env.example .env

افتح .env وغيّر هذه الأسطر على الأقل:

AUTH_SECRET="paste-a-long-random-string-here"
OWNER_EMAIL="you@your-company.com"
OWNER_PASSWORD="a-strong-password-for-the-owner"

ولتوليد سرّ جيد:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

شرح كل متغير في متغيرات البيئة.

3. أنشئ قاعدة البيانات والشركة التجريبية

npm run setup

ينفّذ هذا الأمر ثلاث خطوات: prisma generate (عميل قاعدة البيانات)، ثم prisma db push (ينشئ الجداول في prisma/nuzul.db)، ثم npm run db:seed (الإعدادات والوجهات والإقامات والحجوزات التجريبية والتقييمات والاستفسارات وحساب المالك). تشغيله مرة أخرى آمن، فالبيانات التجريبية لا تُضاف إلا إذا كانت الجداول فارغة.

تُوزَّع الحجوزات التجريبية حول يوم تشغيل الأمر، فيبدو التقويم والنظرة العامة حيّين دائماً. ولتبدأ من جديد بقاعدة بيانات نظيفة:

npm run db:reset

4. شغّل الموقع

npm run dev
العنوان ماذا تجد
http://localhost:3304 يحوّلك إلى الموقع العربي /ar
http://localhost:3304/en الموقع الإنجليزي
http://localhost:3304/ar/dashboard لوحة الحجوزات (ادخل بـ OWNER_EMAIL وOWNER_PASSWORD)
http://localhost:3304/ar/docs هذا التوثيق

تنشئ البيانات التجريبية أيضاً مشرفة ومضيفَين (maryam@ وsaif@ وlaila@nuzul.example) بكلمات مرور عشوائية لا يعرفها أحد. إن أردت تجربة الأدوار الأخرى فعيّن لهم كلمات مرور من اللوحة > المشرفون، أو أوقف حساباتهم.

5. تأكد أن كل شيء يعمل

npm run lint                     # فحص TypeScript، ولا أخطاء متوقعة
npm test                         # اختبارات الليالي والتداخل وأسعار المواسم والمجاميع والأدوار
npm run build                    # بناء نسخة الإنتاج
python scripts/e2e_api.py        # والخادم يعمل: نحو 95 فحصاً من البداية إلى النهاية

يحجز اختبار e2e ليالي ويغلقها ويلغيها على البيانات التجريبية، فشغّله على قاعدة تجريبية فقط، لا على بيانات شركتك الحقيقية.

الإنتاج

شغّل نسخة الإنتاج خلف HTTPS. الخطوات الكاملة (خادم مع PM2 وNginx، والنسخ الاحتياطي، والانتقال إلى PostgreSQL) في التثبيت اليدوي والنشر.