متغيرات البيئة
كل إعداد في ملف .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 (التوفر والأسعار).