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) في التثبيت اليدوي والنشر.