سُفرة التوثيق · سُفرة

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

كل إعداد في ملف .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 فارغاً يوقف الذكاء الاصطناعي، انظر الذكاء الاصطناعي.