استكشاف الأخطاء وإصلاحها
صفحة القائمة تعرض “غير منشورة”
Section titled “صفحة القائمة تعرض “غير منشورة””السبب: إما أن المنشأة لم تُنشر قط، أو أن الـslug غير موجود، أو أن المنشأة حُذفت — تعرض الحالات الثلاث الصفحة نفسها بحيث لا يمكن اختبار الـslug تجريبيًا.
الإصلاح: انشر المسودة من /app/menu أو اطلب من وكيلك استدعاء publish_menu. إذا كنت قد غيّرت الـslug للتو، استخدم الجديد — العنوان القديم يتوقف عن العمل فورًا.
رمز QR يفتح الطاولة الخطأ
Section titled “رمز QR يفتح الطاولة الخطأ”السبب: كل رمز مطبوع مرتبط في قاعدة البيانات برقم طاولة ثابت واحد لحظة إنشائه؛ يستخدم التحويل ذلك الرقم المخزَّن، لا أينما كانت الملصقة عالقة فعليًا. تبديل ملصقتين مطبوعتين بين طاولتين يرسل الزوار إلى الطاولة الخطأ.
الإصلاح: تحقق من رقم الطاولة الذي أُنشئ من أجله كل رمز في /app/qr، وأعد لصق الملصقات (لا إعادة طباعتها) بحيث يطابق الموضع الفعلي. راجع استوديو QR.
صنف نافد لا يزال يظهر متاحًا
Section titled “صنف نافد لا يزال يظهر متاحًا”السبب: تستطلع القائمة العامة availability.json كل 30 ثانية، وهذه النقطة نفسها مخزَّنة مؤقتًا لمدة 30 ثانية — فقد تتأخر صفحة الزائر عن تغيير حي بما يصل إلى دقيقة تقريبًا في أسوأ الحالات.
الإصلاح: انتظر الاستطلاع التالي — لا حاجة لإعادة النشر. ما زال خاطئًا بعد دقيقة؟ تحقق من /app/sold-out أو list_unavailable_items: نافذة نفاد منقضية تعيد الصنف تلقائيًا، فربما انتهت صلاحيتها فحسب. راجع تعليم الأصناف بأنها نفدت.
نطاق مخصص عالق على “بانتظار”
Section titled “نطاق مخصص عالق على “بانتظار””السبب: يحتاج التفعيل أن يعود كل من اسم المضيف وشهادته نشطين من Cloudflare معًا؛ ولا يحدث ذلك إلا بعد إضافة سجلي CNAME وTXT الظاهرين في /app/settings لدى مزود DNS الخاص بك وانتشارهما. يعيد فحص ليلي التحقق من كل نطاق معلَّق، لذا قد يستغرق سجل صحيح حتى يوم كامل ليتحول.
الإصلاح: أعد التحقق من السجلات مقابل ما تعرضه /app/settings بالضبط، وامنح انتشار DNS وقته. راجع النطاقات المخصصة.
وكيلي يقول “missing scope”
Section titled “وكيلي يقول “missing scope””السبب: الأداة التي استدعاها تحتاج صلاحية لم يُمنحها اتصالك — venue:read أو venue:write أو menu:read أو menu:write.
الإصلاح: أعد الاتصال من /app/connections (أو إعدادات الموصّل في عميلك) وامنح الصلاحية هذه المرة. راجع الأسئلة الشائعة عن الوكيل.
الاستيراد محظور — “5 imports waiting for review”
Section titled “الاستيراد محظور — “5 imports waiting for review””السبب: يمكن أن تحمل المنشأة الواحدة 5 عمليات استيراد معلَّقة كحد أقصى في الوقت نفسه؛ وترفض import_menu استيرادًا سادسًا.
الإصلاح: أكِّد إحدى المهام المعلَّقة أو تجاهلها من /app/imports (أو باستخدام confirm_import / discard_import) قبل وضع استيراد آخر في مرحلة المراجعة.
تغييرات المظهر لا تُحفظ — خطأ تباين
Section titled “تغييرات المظهر لا تُحفظ — خطأ تباين”السبب: يرفض محرر المظهر حفظ لوحة ألوان لا تجتاز معيار WCAG AA للتباين ما لم تقبلها صراحة.
الإصلاح: استخدم الألوان المصححة المقترحة التي يقدّمها المحرر، أو اقبل اللوحة رغم ذلك (force: true إذا كان وكيلك من يضبط المظهر). راجع محرر المظهر.
Apple Pay غير متاح عند الدفع
Section titled “Apple Pay غير متاح عند الدفع”السبب: لا يظهر Apple Pay إلا بعد ضبط APPLE_PAY_DOMAIN_ASSOCIATION للمنصة؛ ودونه، يعرض الدفع البطاقات فقط. هذا إعداد على مستوى المنصة، لا على مستوى منشأة واحدة.
الإصلاح: لا شيء لتفعله من جهتك — تواصل مع الدعم إن كنت تتوقع توفر Apple Pay ولم يكن متاحًا.
اقتراح “إضافة إلى الشاشة الرئيسية” لا يظهر أبدًا
Section titled “اقتراح “إضافة إلى الشاشة الرئيسية” لا يظهر أبدًا”السبب: لا يظهر إلا لزيارة استلام أو توصيل (لا داخل المطعم أبدًا)، بعد أن يزور الجهاز نفسه في يومين مختلفين خلال آخر 30 يومًا، ويتوقف لمدة 60 يومًا بعد رفضه — ولا يظهر إطلاقًا إذا كنت قد عطّلته من الروابط.
الإصلاح: تأكد من تفعيل الاقتراح في /app/links، وزر قائمة الاستلام أو التوصيل في يومين منفصلين لتفعيله. راجع الروابط والتوصيل ومتابعتنا.