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

متغيرات البيئة

كل إعداد في ملف ‎.env، ماذا يفعل وماذا تضع فيه.

انسخ .env.example إلى .env وعدّله، وأعد تشغيل الخادم بعد كل تغيير. الإعدادات التي قد يغيّرها المالك في أي وقت (اسم الشركة والضرائب ووقت الوصول ومفاتيح الدفع) ليست هنا، بل في اللوحة > إعدادات الشركة.

إلزامية

المتغير مثال ماذا يفعل
DATABASE_URL file:./nuzul.db مكان البيانات. افتراضياً ملف SQLite بجانب prisma/schema.prisma، أو عنوان postgresql:// لقاعدة PostgreSQL (الطريقة)
SITE_URL https://stays.example.com العنوان العام للموقع. تستخدمه روابط العودة من الدفع وخريطة الموقع والبيانات المنظمة وملف الجلسة الآمن
AUTH_SECRET 64 حرفاً سداسياً عشوائياً يوقّع ملف جلسة اللوحة. 16 حرفاً على الأقل، ويُفضّل 32 فأكثر

حساب المالك الأول

المتغير مثال ماذا يفعل
OWNER_EMAIL owner@your-company.com بريد حساب المالك الذي ينشئه npm run db:seed إن لم يكن موجوداً
OWNER_PASSWORD 10 أحرف فأكثر كلمة مروره. تُقرأ عند إنشاء الحساب فقط، وبعدها تُعيَّن كلمات المرور من اللوحة > المشرفون
OWNER_NAME Ahmed الاسم الظاهر في اللوحة
DEMO_HINT 0 القيمة 1 تعرض بريد المالك وكلمة مروره في صفحة الدخول، وهذا للعروض التجريبية العامة فقط

الشركة

المتغير الافتراضي ماذا يفعل
COMPANY_TIMEZONE Asia/Muscat المنطقة الزمنية للإقامات. يحدد «اليوم»: أي التواريخ مضى، ومتى يُسمح بتسجيل الوصول، ومتى يظهر رمز الباب

الدفع بالبطاقة (ثواني)

المتغير الافتراضي ماذا يفعل
THAWANI_MODE uat uat لبيئة الاختبار في ثواني، وlive للدفع الحقيقي
THAWANI_SECRET_KEY فارغ المفتاح السري من بوابة التاجر في ثواني، ويبقى على الخادم
THAWANI_PUBLISHABLE_KEY فارغ المفتاح العام، ويُستخدم في رابط صفحة الدفع

إذا كان المفتاحان فارغين يبقى الدفع بالبطاقة متوقفاً أياً كان مفتاح اللوحة. انظر الدفع.

الذكاء الاصطناعي (اختياري)

المتغير مثال ماذا يفعل
AI_BASE_URL https://api.openai.com/v1 أي واجهة متوافقة مع OpenAI. فارغ = الميزة متوقفة
AI_API_KEY sk-... يُرسل كرمز Bearer، ويُترك فارغاً مع Ollama المحلي
AI_MODEL gpt-4o-mini اسم النموذج لدى المزوّد

انظر الذكاء الاصطناعي.

أشياء ليست متغيرات

  • المنفذ: -p 3304 في سكربتي dev وstart داخل package.json.
  • الألوان والخطوط: src/app/globals.css وsrc/app/[locale]/layout.tsx (الهوية والألوان).
  • مدة حجز الليالي لحجز بطاقة لم يُدفع (30 دقيقة)، وليلتا نهاية الأسبوع (الخميس والجمعة)، وأطول إقامة (60 ليلة): ثوابت في أعلى src/lib/booking-rules.ts (التوفر والأسعار).