الفصل 1 — شاشة عرض المطبخ (KDS)

شاشة عرض المطبخ هي صفحة داخل المتصفح تُفتَح على شاشة عرض في المطبخ أو البار، وتعرض قسائم الطلبات بشكل حي. يستخدمها طاقم المطبخ لدفع الطلبات من «جديد» إلى «جاهز». وهي متصلة بالإنترنت وتستقبل الطلبات لحظيًا.

⚠️ لغة البرنامج: يُفتَح هذا البرنامج افتراضيًا بالألمانية، والترجمة الفارسية للمطبخ ناقصة — أي حتى لو غيّرت اللغة إلى الفارسية، تبقى بعض الملصقات (مثل Done وPreparing وRefresh) بالإنجليزية. الملصقات الواردة داخل الأقواس في هذا الفصل هي ذاتها ما تراه فعليًا على الشاشة.

1-1. تسجيل الدخول

• سجّل الدخول بـالبريد الإلكتروني وكلمة المرور (نفس حساب الصندوق). يحتوي تسجيل الدخول أيضًا على تبويب الهاتف، وإذا كان التحقق بخطوتين مفعّلًا، تُضاف خطوة رمز أيضًا؛ كما توجد خيارات تسجيل الدخول عبر مواقع التواصل وصفحات إنشاء الحساب/نسيان كلمة المرور.
• شاشة القفل / الرمز السريع (PIN): كما في الصندوق، إذا كان لدى المستخدم رمز (PIN)، يمكنه قفل اللوح وفتحه بالـرمز (دون تسجيل خروج كامل)، وتبديل المستخدم من القائمة أو إضافة أمين صندوق آخر.

1-2. اختيار الفرع والمحطة (قبل اللوح)

بعد تسجيل الدخول، تطلب منك صفحة منفصلة اختيار الفرع (Location) والمحطة (Station) لهذه الشاشة:

• أي محطة سبق أن حجزها مستخدم آخر تظهر معطّلة.
• بعد الاختيار، يقوم شريط تقدّم بنسبة مئوية بتحميل البيانات الأولية، ثم تدخل إلى اللوح. إذا لم يُخزَّن جزء من البيانات مؤقتًا، تظهر رسالة «يُفتَح اللوح لكن…» مع زر إعادة المحاولة.
• عند حدوث مشكلة: «تعذّر تحميل جلسة المطبخ» (← اذهب إلى تسجيل الدخول) أو «تعذّر تحميل الفروع» (← إعادة المحاولة).

تختلف هذه الخطوة عن اختيار الوجهة (Destination) داخل اللوح؛ وهذا الأخير موضّح في القسم 1-3.

1-3. لوح الطلبات

الصفحة الرئيسية هي لوح يضم أعمدة حالة يُمرَّر كل منها على حدة:

• جديد (New): الطلبات الواردة حديثًا.
• قيد التحضير (Preparing): الأعمال التي بدأت.
• جاهز/مكتمل (Completed): الأعمال المنجزة.
• ملغى (Cancelled): الطلبات الملغاة (بالأحمر).

يعرض رأس كل عمود عدد القسائم وعدد الأصناف فيه؛ وللعمود الفارغ رسالته الخاصة («No new work» و«Nothing preparing» و«No completed work» و«Nothing cancelled»).

الشريط أعلى اللوح

• اختيار الوجهة (Destination): تحديد أي شاشة/محطة مطبخ يعرضها هذا الجهاز (مثلًا «المطبخ الساخن» أو «البار»). إذا كانت هناك وجهة واحدة فقط، تُختار تلقائيًا ويُحفَظ آخر اختيار لك. وإذا لم تتوفّر أي وجهة، تظهر رسالة إرشادية ويجب اختيار الوجهة قبل التحميل.
• **زر التحديث (Refresh)**، وملصق «Refreshing» أثناء التحديث، ووقت آخر فحص، وعدد القسائم/الأصناف، وآخر حدث حي.
• إشعار الترقيم (التقسيم إلى صفحات): إذا كان لدى الخادم أكثر مما جرى تحميله، يظهر «Showing X of Y backend orders» — أي بعد تغيير المرشّح/الصفحة في جهة الخادم، اضغط تحديث.

ما تراه على كل قسيمة

• نوع المصدر: Open cart (سلة مفتوحة)، أو Finalized order (طلب مُنجَز نهائيًا)، أو Kitchen dispatch (إرسال إلى المطبخ)؛ ورقم النسخة («Rev N»).
• عنوان الطلب، وسطر المصدر، ووقت الإنشاء والتحديث، وملصق الحالة.
• صف الأصناف: الكمية بصيغة xN (وللمرتجَع رقم سالب)، واسم الصنف، و«Note:» للملاحظات، والإضافات، والأصناف التكميلية المتداخلة بملصق «Cross-sell for …»؛ وعند الضبط، خلفية ملوّنة لكل صنف.

1-4. دفع الطلب (Bump)

على كل قسيمة، لا تظهر إلا الأزرار المسموح بها لتلك الحالة:

• بدء التحضير (Start preparing) ← من حالة «جديد» فقط ← ينتقل إلى «قيد التحضير».
• جاهز (Done) ← من حالة «التحضير» فقط ← ينتقل إلى «جاهز/مكتمل».
• إلغاء (Cancel) ← من «جديد» أو «قيد التحضير» ← ينتقل إلى «ملغى» (زر أحمر).

يُسجَّل كل إجراء على الخادم وتُحدَّث الصفحة؛ وأثناء تسجيل إجراء ما، تُخفى بقية أزرار القسيمة نفسها. أما الإجراءات غير المسموح بها فلا يظهر لها زر أصلًا (مخفية، لا معطّلة). وإذا فشل تسجيل الحالة، يظهر شريط أحمر منفصل («Kitchen status could not be updated»).

طباعة القسيمة (Print)

• يظهر زر الطباعة على القسائم القابلة للطباعة فقط.
• عند النجاح: «Kitchen ticket sent to …».
• إذا لم يُضبَط قالب الطباعة: تحذير «No kitchen print template is configured…».
• تُصنَّف الأخطاء بحسب السبب: مشكلة القالب («…template could not be prepared…») مقابل مشكلة العتاد («…could not be printed… Check the printer connection»).

1-5. صوت التنبيه

• يُشغَّل صوت تنبيه/صافرة عند عمل جديد أو تغيير كي تنتبه حتى دون النظر إلى الشاشة.
• يُشغَّل الصوت فقط بعد تأكيد فعلي من الخادم (عمل جديد، أو نسخة أحدث، أو تغيير حالة) — لا عند فتح الصفحة أول مرة، ولا عند التحديث الذي يلي إعادة الاتصال. كما لا تتراكم الأصوات المتتالية فوق بعضها (بفاصل لا يقل عن 1.5 ثانية).
• شريط إذن الصوت: ما دام المتصفح لم يمنح إذن تشغيل الصوت، يظهر شريط أصفر أسفل الصفحة («Kitchen alerts need sound permission») مع زر «Enable kitchen sound».

💡 إذا لم يُشغَّل الصوت، فإن الضغط على زر «Enable kitchen sound» نفسه أو أي لمسة على الشاشة تحل المشكلة.

1-6. حالة الاتصال والاستعادة

أعلى الصفحة يوجد مؤشّر Live / Stale / Offline («Stale» تعني اتصالًا بطيئًا/إعادة اتصال جارية). وعند وجود مشكلة في الاتصال الحي، يظهر شريط بارز:

• «Live order updates are offline» (انقطاع)
• «Reconnecting to live order updates…» (جارٍ إعادة الاتصال)
• «Live updates may be behind» (فات تحديث واحد؛ يحدّث اللوح نفسه تلقائيًا)

إذا انقطع الاتصال الحي، فالطريقة المضمونة هي زر التحديث (Refresh) اليدوي أعلى الصفحة. يحتفظ اللوح بالقسائم الموجودة بين عمليات التحديث ويعرض الحالة الجديدة فقط.

• حالة «جارٍ تحديد الفرع» لها زرها الخاص («Retry location»)؛ وإذا لم يُحمَّل اللوح أصلًا، تظهر صفحة الاستعادة «Refresh board».
• للطلبات مهلة زمنية (إذا تأخّرت، تظهر رسالة «request timed out — use Refresh»).

1-7. الإعدادات

من قائمة المستخدم، إعدادات الحساب بتبويبات: الملف الشخصي، والأمان، والمظهر (السمة)، والإشعارات، والاتصال — وتسجيل الخروج. ⚠️ تبويب الاتصال (Integration) معطّل ولا يُفتَح.

إعدادات النظام لها تبويبان فقط: الكتالوج والمبيعات (ورابط «general» يذهب أيضًا إلى الكتالوج). إذا لم تكن لديك صلاحية الكتابة، تُفتَح بشريط للقراءة فقط؛ وإذا لم تكن لديك صلاحية العرض، فلا تُفتَح إطلاقًا.