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

حل المشكلات

أكثر المشكلات تكراراً وطريقة حلها.

«AUTH_SECRET is missing or too short»

توقّع اللوحة كوكي الجلسة بالمتغير AUTH_SECRET. اضبطه في .env على 32 حرفاً عشوائياً أو أكثر ثم أعد تشغيل الخادم. تغييره لاحقاً يُخرج الجميع من اللوحة فقط، ولا يؤثر على شيء آخر.

«Settings row missing: run npm run db:seed»

قاعدة البيانات موجودة لكنها فارغة. شغّل npm run db:seed (أو npm run setup في نسخة جديدة).

الموقع يقول إن المطعم مغلق

الطلب يتبع اللوحة > الإعدادات > ساعات العمل بتوقيت المطعم (RESTAURANT_TIMEZONE، والافتراضي Asia/Muscat). تأكد أن اليوم غير معلَّم كمغلق، وأن المنطقة الزمنية صحيحة. وقت إغلاق أبكر من وقت الفتح (مثلاً من 12:00 إلى 00:30) يعني أن المطعم يغلق بعد منتصف الليل.

إن ظهرت رسالة «الطلبات متوقفة مؤقتاً» فقد أوقفها أحد الموظفين من لوحة المطبخ: اضغط استئناف الطلبات.

خيار «بطاقة (ثواني)» لا يظهر في صفحة الطلب

يجب أن تتحقق كل هذه الشروط:

  1. THAWANI_SECRET_KEY و THAWANI_PUBLISHABLE_KEY مضبوطان في .env (أعد التشغيل بعد التعديل).
  2. اللوحة > الإعدادات > الدفع > الدفع بالبطاقة (ثواني) مفعّل.
  3. العملة OMR: ثواني يحصّل بالريال العماني فقط.

انظر الدفع.

صفحة الدخول تعود في كل مرة

  • المتصفح يمنع الكوكيز لهذا الموقع: اسمح بها.
  • في الإنتاج يبدأ SITE_URL بـ https:// لكن الموقع مفتوح بـ http://: الكوكي الآمن لا يُرسل. استخدم HTTPS أو صحّح SITE_URL.
  • الحساب معطّل من اللوحة > الموظفون.

لا يوجد صوت في لوحة المطبخ

المتصفحات لا تشغّل الصوت إلا بعد نقرة. اضغط التنبيه الصوتي مرة واحدة في اللوحة، ويُحفظ الإعداد على ذلك الجهاز.

فشل رفع صورة طبق

  • المقبول فقط JPEG أو PNG أو WebP حتى 4 ميجابايت، ويُفحص النوع الحقيقي للملف وليس اسمه.
  • خلف Nginx اضبط client_max_body_size 5m;.
  • على الاستضافات ذات القرص للقراءة فقط لا يمكن الحفظ في public/uploads: انظر التثبيت اليدوي والنشر.

«طلبات كثيرة خلال وقت قصير»

النماذج العامة محدودة لكل زائر: 8 طلبات و5 طلبات حجز في الدقيقة، و10 محاولات دخول في الدقيقة (و8 لكل بريد كل 15 دقيقة). العدّادات في ذاكرة الخادم وتُصفَّر عند إعادة تشغيله. خلف وسيط تأكد أنه يرسل X-Forwarded-For، وإلا يشترك كل الزوار في عدّاد واحد.

غيّرت prisma/schema.prisma وتوقف التطبيق

طبّق التغيير وأعد توليد العميل:

npx prisma db push
npx prisma generate

الأسعار تظهر خاطئة

تُحفظ الأسعار بأصغر وحدة للعملة (في الريال العماني: الريال = 1000 بيسة) وتُعرض حسب الإعدادات > الخانات العشرية. إن غيّرت العملة إلى عملة بخانتين (مثل الدولار) فأعد إدخال أسعارك: 1.500 ريال محفوظة كـ 1500، وستصبح 15.00 دولاراً.