متغيرات البيئة
كل إعداد في ملف .env، وماذا يفعل، وماذا يحدث إن تُرك فارغاً.
الإعدادات التي نادراً ما تتغير والأسرار توجد في .env (منسوخ من .env.example). أما ما يغيّره المالك يومياً (الاسم والساعات والأسعار وطرق الدفع) فهو في اللوحة > الإعدادات ومحفوظ في قاعدة البيانات. أعد تشغيل الخادم بعد تعديل .env.
#إلزامية
| المتغير |
مثال |
ماذا يفعل |
DATABASE_URL |
file:./sufra.db |
قاعدة البيانات. المسار يعني SQLite (نسبة إلى مجلد prisma/)، و postgresql://... لـ PostgreSQL (الطريقة) |
AUTH_SECRET |
64 حرفاً سداسياً |
يوقّع كوكي جلسة الموظفين. 16 حرفاً على الأقل، ويُنصح بـ 32 أو أكثر. تغييره يُخرج الجميع |
SITE_URL |
https://order.your-restaurant.com |
العنوان العام: روابط العودة من الدفع، وخريطة الموقع، وبيانات الصفحات، والكوكيز الآمنة. بدون / في النهاية |
#حساب المالك الأول
يستخدمه npm run db:seed فقط عندما لا يوجد أي حساب موظف بعد. التغييرات اللاحقة تتم من اللوحة > الموظفون.
| المتغير |
الافتراضي |
|
OWNER_EMAIL |
owner@sufra.test |
بريد المالك الأول |
OWNER_PASSWORD |
sufra-demo-2026 |
غيّره قبل أول تشغيل للبيانات التجريبية |
#المطعم
| المتغير |
الافتراضي |
|
RESTAURANT_TIMEZONE |
Asia/Muscat |
المنطقة الزمنية لساعات العمل (أسماء IANA) |
DEMO_HINT |
0 |
القيمة 1 تعرض بريد المالك وكلمة مروره في صفحة الدخول. للعروض التجريبية العامة فقط، وليس لمطعم حقيقي أبداً |
#الدفع بالبطاقة (ثواني)
| المتغير |
الافتراضي |
|
THAWANI_MODE |
uat |
uat = بيئة ثواني التجريبية، live = دفع حقيقي |
THAWANI_SECRET_KEY |
فارغ |
المفتاح السري من بوابة التاجر في ثواني (على الخادم فقط) |
THAWANI_PUBLISHABLE_KEY |
فارغ |
المفتاح العام، يُستخدم في رابط صفحة الدفع |
إن كان أي مفتاح فارغاً يبقى الدفع بالبطاقة متوقفاً مهما كان إعداد اللوحة. التفاصيل في الدفع.
#الذكاء الاصطناعي (اختياري)
| المتغير |
الافتراضي |
|
AI_BASE_URL |
فارغ |
عنوان API متوافق مع OpenAI، مثل https://api.openai.com/v1 أو https://openrouter.ai/api/v1 أو http://localhost:11434/v1 (Ollama) |
AI_API_KEY |
فارغ |
يُرسل كـ Authorization: Bearer ... إن وُجد |
AI_MODEL |
gpt-4o-mini |
اسم النموذج لدى ذلك المزوّد |
ترك AI_BASE_URL فارغاً يوقف الذكاء الاصطناعي، انظر الذكاء الاصطناعي.