لوحة تحكم الفريق

الصفحات

كل صفحة موجودة بالإنجليزية تحت /en وبالعربية تحت /ar. تُفتح لوحة الإدارة على /en/dashboard، بعد تسجيل الدخول على /en/auth/login.

يحتوي الجرس في الشريط العلوي على الإشعارات، وتجد لوحة البحث الأطباق والطلبات والعملاء، ويفتح رابط «عرض المتجر» NEXT_PUBLIC_STOREFRONT_URL. لا تفهرس محركات البحث لوحة التحكم أبدًا.

على البيانات التجريبية، تبدأ أرقام اليوم في النظرة العامة من يوم نموذجي محفوظ، مضافًا إليه الطلبات المدفوعة منذ تعبئة البيانات، والأمس هو اليوم المحفوظ الذي قبله. لا يرى حساب المطبخ النظرة العامة أبدًا، لأنها تعرض الأموال.

المالك، والمدير، والمطبخ

• كل الحسابات التجريبية تستخدم كلمة المرور FoodDemo2026!. يبدأ نموذج تسجيل الدخول فارغًا: اكتب البريد الإلكتروني وكلمة المرور للحساب الذي تريده. العرض التجريبي العام وحده، مع تفعيل وضع العرض التجريبي، يعبّئ النموذج ويعرض زرًا لكل حساب. غيّر كلمات المرور هذه، أو احذف الحسابات، قبل الإطلاق.
• تُسمّى الصلاحيات مثل orders.view أو products.edit، وتتحقق واجهة API من إحداها في كل مسار خاص بالفريق، أيًا كان ما تعرضه الشاشة.
• يُخفي الشريط الجانبي ولوحة البحث ما لا يستطيع الحساب فتحه، والصفحة التي تُفتح بعنوانها تعرض تنبيهًا بعدم الصلاحية بدلًا من ذلك.
• يرتبط حساب المطبخ بمطبخ واحد من «الفريق». يرى طلبات ذلك المطبخ المؤكدة وقيد التحضير والجاهزة وفي الطريق والتي تم توصيلها فقط، ولا يرى النظرة العامة أبدًا، لأنها تعرض الأموال.

الطلبات وقائمة انتظار المطبخ

تبحث القائمة برقم الطلب والعميل، وتصفّي حسب الحالة، والتوصيل أو الاستلام، والتاريخ، ويُحسب اليوم بحسب المنطقة الزمنية لكل مطبخ. يعرض الطلب المحدد عميله، وعنوان التوصيل، والأصناف مع خياراتها وملاحظاتها، والإجماليات، والجدول الزمني.

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

القائمة

• متوفر الآن هو المفتاح الذي يقلبه المطبخ أثناء الخدمة: يبقى الطبق في القائمة ولا يمكن طلبه.
• الأرشفة تنقل الطبق إلى «الأطباق المؤرشفة»، حيث يمكن استعادته. وتُؤرشف الفئات وتُستعاد بالطريقة نفسها.
• الكومبو وخياراته ورسومها الإضافية عرضٌ تحفظه واجهة API؛ ويستطيع المساعد تشغيله وإيقافه.

العملاء

تبحث قائمة العملاء في العملاء وتصفّيهم، مع الأعداد فوقها. يستطيع الفريق إضافة عميل، وفتح تفاصيله، وتغيير كلمة مروره، وتعليم بريده الإلكتروني كموثَّق، وحذفه واستعادته. يعدّل العملاء بياناتهم بأنفسهم من حساباتهم على الموقع.

الصفحة الرئيسية للموقع

تعرض «الصفحة الرئيسية» الأقسام التسعة بترتيب الصفحة. اسحبها، أو استخدم الأسهم، لإعادة ترتيبها؛ وشغّل كل قسم أو أوقفه؛ وافتح أي قسم لتعديل نصه باللغتين. تُحفظ التغييرات أثناء الكتابة.

تعديل قسم يحتاج إلى الصلاحية products.edit.

استوديو الذكاء الاصطناعي والمساعد الذكي

• استوديو الذكاء الاصطناعي يختار طبقًا، ويعيد تنسيق صورته بخلفية وإضاءة ووصف يحدد ما يجب الإبقاء عليه، ويقارن الأصلية بالنتيجة. «حفظ كمسودة» يُبقي النتيجة في مسودة الطبق حتى تحفظ الطبق. ويقص زر «إزالة الخلفية» الطبق من صورته عندما يكون ملف النموذج مثبتًا.
• الاستوديو في نموذج الطبق فيه وضع «المساعد»، الذي يكتب تفاصيل الطبق من صوره ويعدّل الصور عند الطلب، ووضع «تحريك»، الذي يحوّل صورة إلى مقطع قصير. تظهر النتائج في قائمة «الإنشاءات»؛ أضف ما يعجبك منها إلى الطبق.
• المساعد الذكي يبحث في الطلبات والأطباق والمبيعات ويرسم المخططات. أي شيء سيغيّر البيانات يُعرض أولًا كفرق بين القديم والجديد، ولا يُنفَّذ إلا عندما تؤكده.
• من دون مفتاح Google AI في واجهة API، يقول الاستوديو «إنشاء الصور غير متصل» ويقول المساعد «لا يوجد نموذج ذكاء اصطناعي متصل». كل شيء آخر في لوحة التحكم يعمل.

• ميزات الذكاء الاصطناعي

الفريق والأدوار

• الأعضاء تعرض أعضاء الفريق وتضيفهم وتعدّلهم وتحذفهم. يحمل كل عضو دورًا واحدًا أو أكثر، ويرتبط عضو المطبخ بمطبخ واحد.
• الأدوار تنشئ الأدوار وتعيد تسميتها وتحذفها، وتمنح صلاحياتها من شبكة مقسّمة حسب الأقسام. يحمل العضو كل صلاحيات كل أدواره، ويصل التغيير إلى العضو المسجّل دخوله فورًا.
• لا يرى «الفريق» إلا المالك: لا يحمل دورا المدير والمطبخ أي صلاحية خاصة بالفريق أو الأدوار.

تنشئ تعبئة البيانات ثمانية حسابات للفريق: المالك، وثلاثة مديرين، وحساب مطبخ لكل واحد من المطابخ الأربعة.

الإعدادات

في «الإعدادات» ثلاث علامات تبويب. «الملف الشخصي» و«الأمان» خاصان بالحساب المسجّل ومتاحان لكل عضو. أما «المطعم» فيحتاج إلى الصلاحية settings.view للقراءة وsettings.edit للتغيير.

الإشعارات

• الطلب الجديد يُشعر أعضاء الفريق الذين يستطيعون رؤيته، وانتهاء إنشاء في استوديو الذكاء الاصطناعي أو فشله يُشعر العضو الذي بدأه. لا يُبلَّغ حساب المطبخ إلا بطلبات مطبخه بعد أن تصل إلى قائمة انتظاره.
• تصل مباشرة، مع رسالة قصيرة على الشاشة، وتبقى في قائمة الجرس حتى تُقرأ أو تُحذف، لمدة 30 يومًا.
• يستخدم الاتصال المباشر NEXT_PUBLIC_WEBSOCKET_BASE_URL، وهو عنوان واجهة API من دون /api، ولا تقبله واجهة API إلا من FRONTEND_URL. على نطاقاتك الخاصة، اضبط الاثنين.

وضع العرض التجريبي

كيف تترابط أجزاء كود لوحة الإدارة