دليل التشغيل والاستخدام التفصيلي v1.0

الدليل الشامل لنظام MenuPlay

مرجع كامل ومُصمّم لصاحب المطعم، طاقم الإدارة، وكادر المطبخ لإدارة الطلبات والمنيو الرقمي بكفاءة

1️⃣ نظرة عامة ورؤية النظام (System Overview)

MenuPlay

نظام MenuPlay هو حل برلمجي متكامل يربط بين المنيو الرقمي للزبائن وشاشة تحضير الوجبات الحية بالمطبخ لوحة التحكم الإدارية، مصمم ليعمل بمرونة عالية كـ نظام داخل المطعم (In-House) وكـ متجر إلكتروني أونلاين (Online Ordering) في الوقت ذاته.

داخل المطعم (Dine-In)

يمسح الزبون رمز الـ QR المطبوع على الطاولة، فيُسجل رقم الطاولة تلقائياً وتصل الطلبات مباشرة إلى شاشة المطبخ محددة برقم الطاولة.

خارج المطعم (Takeout & Delivery)

يمكن نشر رابط الموقع على خرائط جوجل، الانستغرام والواتساب، حيث يستطيع العميل الطلب من المنزل مع إدخال اسمه وهاتفه وعنوانه إجبارياً للحماية.

سرعة وأمان فائقان: النظام مبني بتقنيات برمجية خفيفة وقواعد بيانات محميّة بالكامل من ثغرات SQL و XSS، ويتميز باستجابة سرعة ممتازة على الهواتف والأجهزة اللوحية.

2️⃣ دليل العميل ورحلة الطلب (Customer Journey)

كيف يتصفح ويطلب العميل من المنيو الرقمي؟
الخطوة 1: الدخول للمنيو الرقمي (`index.php`)

عند مسح رمز QR أو فتح الرابط المباشر، يتصفح العميل الوجبات الموزعة حسب الأقسام، مع إمكانية التصفح السريع عبر شريط الأقسام العائم وتفقد السعرات الحرارية والأسعار.

الخطوة 2: إضافة الوجبات لسلة الطلبات

يضغط العميل على زر "إعانة/طلب"، فتُضاف الوجبة أوتوماتيكياً لسلة الطلبات بحدث تفاعلي بدون إعادة تحميل الصفحة (AJAX)، ويحدث العداد العلوي والشريط العائم بالأسفل.

الخطوة 3: معالجة السلة واختيار نوع الطلب (`cart.php`)

في صفحة السلة، يستطيع العميل زيادة/إنقاص الكميات أو حذف الوجبات، ثم يختار نوع الطلب عبر القائمة المنسدلة:

  • 🍽️ تناول في المطعم (طاولة): يُقفل حقل العنوان وتصبح بيانات الاسم والهاتف اختنائية للتسهيل، ويُعتمد رقم الطاولة المعين.
  • 🛍️ سفري / توصيل خارجي: يختفي حقل رقم الطاولة، وتتحول حقول الاسم الكامل، رقم الهاتف، وعنوان التوصيل إلى حقول إجبارية بصرامة لحماية المطبخ من الطلبات الوهمية.
الخطوة 4: تأكيد وإرسال الطلب للمطبخ

عند الضغط على الزر الأزرق الكبير، يُنشئ النظام كود طلب فريد (مثل `#ORD-20261003-4821`) وتظهر شاشة تأكيد خضراء تفاعلية، ويصل الطلب فوراً لشاشة المطبخ.

حماية التلاعب بالأسعار: كافّة حسابات الأسعار والإجماليات تُحسب بداخل سيرفر النظام خلفياً، ولا يمكن لأي زبون التلاعب بأسعار المنيو من المتصفح.

3️⃣ دليل المطبخ وتلقي الطلبات الحية (`admin/orders.php`)

تحديث حي 10 ثواني

تعتبر شاشة المطبخ الحية قلب النظام النابض، حيث تم تصميمها لتُعرض على شاشة تلفزيون داخل المطبخ أو جهازي أيباد/تابلت لطاقم الطهاة.

بانتظار التحضير

طلبات جديدة وصلت فوراً وتتطلب تأكيد المطبخ والبدء بطهيها.

قيد التحضير

الوجبات قيد الإعداد على موقد الطهي حالياً.

مكتمل ومسَلّم

تم تحضير الطلب وتقديمه للطاولة أو للزبون الخارجي.

ميزة التنبيه الصوتي الذكي (Audio Alerts)

الشاشة مزودة بنظام توليد نغمات صوتية برمجية تلقائية عبر Web Audio API. فور وصول أي طلب جديد، تصدر الشاشة صوت جرس رنان لتنبيه الطهاة دون الحاجة لرفع ملفات صوتية أو الاتصال بإنترنت خارجي.

التحديث التلقائي الشامل (Auto Polling)

تقوم الصفحة بعمل فحص خلفي لسيرفر النظام كل 10 ثوانٍ للتأكد من وجود طلبات جديدة وإدراجها بكتل تفاعلية ملونة تبين التفاصيل المكتوبة ورقم الطاولة ورقم هاتف العميل للطلبات الخارجية.

4️⃣ إدارة أقسام القائمة (`admin/categories.php`)

تُتيح هذه الشاشة لمدير النظام تنظيم وتبويب المنيو الرقمي لتسهيل تصفحه من قبل الزوار.

إضافة وتعديل قسم
  • تحديد اسم القسم (مثل: المشاوي، البيتزا، المشروبات).
  • تحديد ترتيب العرض (القسم ذو الترتيب الأقل يظهر أولاً).
  • رفع صورة توضيحية للقسم.
تعطيل/تجميد قسم
  • يمكن بضغطة زر تحويل حالة القسم إلى "غير نشط" لإخفاء كافة الوجبات التابعة له من المنيو مؤقتاً.
  • تطبيق قواعد حماية تمنع حذف الأقسام التي تحتوي وجبات مسجلة.

5️⃣ إدارة الوجبات والأسعار (`admin/products.php`)

الشاشة الرئيسية للتحكم بالأطباق والوجبات المعروضة للزبائن مع خيارات دقيقة للحالة والأسعار.

الحقل / الميزة الوظيفة والأهمية
السعر والعملة تحديد سعر الوجبة بدقة، ويُعرض تلقائياً بالعملة المعتمدة بالمطعم.
السعرات الحرارية إدخال عدد الكالوري لظهر بشارة صفراء أنيقة للزبائن المهتمين بالصحة.
حالة التوفر (Stock Status) إذا نفذت إحدى الوجبات بالمطبخ، يمكن إيقافها فوراً لتصبح "غير متاحة" بدلاً من حذفها.
رفع الصور وتصفيتها دعم رفع صور عالية الجودة وتصفية الوجبات حسب القسم المسجلة فيه.

6️⃣ إدارة الطاولات وطباعة رموز QR (`admin/tables.php`)

تمكنك هذه الصفحة من إنشاء الطاولات داخل المطعم وتوليد بطاقات الـ QR المخصصة لكل طاولة.

آلية توليد وتثبيت أكواد الطاولات:
  1. قم بإضافة الطاولات برقمها وسعتها (مثلاً: طاولة 1، طاولة 2، طاولة VIP).
  2. اضغط على زر "طباعة QR" المباشر لأي طاولة.
  3. تفتح نافذة طباعة مخصصة تحوي بطاقة أنيقة باسم المطعم ورقم الطاولة ورمز الـ QR والتعليمات.
  4. قم بطباعة البطاقة وتثبيتها على حوامل الأكريليك فوق الطاولة المحددة.
كيف يقرأ النظام الطاولة؟ عندما يمسح العميل الكود بكاميرا هاتفه، يفتح الرابط محتسباً المعامل `?table=1` ويخزن رقم الطاولة في جلسة الزبون تلقائياً.

7️⃣ إدارة الموظفين والصلاحيات (`admin/users.php`)

يتيح النظام توزيع الصلاحيات بين إدارة المطعم وطاقم المطبخ للحفاظ على سرية البيانات والإعدادات.

دور: مدير النظام (Admin)

يمتلك صلاحيات كاملة للوصول إلى كافة الصفحات (الإحصائيات، الوجبات، الأقسام، الطاولات، إعدادات SEO، والمستخدمين وتغيير الإعدادات العامة).

دور: طاقم المطبخ (Kitchen)

مستعد للوصول المباشر لشاشة الطلبات الحية (`admin/orders.php`) والمبيعات السريعة، ويحظر النظام دخوله لصفحات الإعدادات والوجبات.

أمان الحسابات: كلمة المرور تُشفر في قاعدة البيانات باستخدام خوارزمية `password_hash` القوية، كما يتضمن النظام حماية تمنع المدير من حذف حسابه المفتوح حالياً.

8️⃣ إعدادات محركات البحث وSEO (`admin/seo.php`)

تخصيص الكلمات المفتاحية وميتا المشاركة لكل صفحة لزيادة ظهور المطعم في نتائج جوجل والواتساب.

  • عنوان الصفحة (Meta Title): النص الذي يظهر في أعلى المتصفح وعلى نتائج بحث جوجل.
  • الوصف (Meta Description): السطر التوضيحي المكتوب تحت رابط المطعم عند مشاركته على الواتساب أو الفيسبوك.
  • الكلمات المفتاحية (Keywords): المصطلحات التي يبحث عنها الزبائن (مثل: منيو مطعم، طلبات اونلاين، كافيه).

9️⃣ إعدادات المطعم العامة (`admin/settings.php`)

المركز الرئيسي للتحكم بهوية المطعم والخيارات التشغيلية المباشرة للنظام.

الهوية والعملة

تحديث اسم المطعم، رفع الشعار، وتحديد العملة المعتمدة (مثل JOD, SAR, $).

أرقام التواصل

ضبط رقم هاتف المطعم ورقم الواتساب المباشر لخدمة الزبائن.

مفاتيح التشغيل

تفعيل/تعطيل الطلب من الطاولات، أو إظهار زر الواتساب في الفوتر.

🔟 الأسئلة الشائعة وحلول المشكلات (FAQ)

تتطلب متصفحات الشابكة الحديثة (مثل Chrome و Safari) إعطاء إذن صوتي أولي. تأكد من النقر مرة واحدة في أي مكان على شاشة المطبخ عند فتحها لتشغيل الصوت التلقائي.

لا، النظام يقفل البيانات ويقوم بحفظ الطلب في قاعدة البيانات فور الضغط على تأكيد. وتعديل حالة الطلب أو حذفه محصور بطاقم المطبخ والإدارة فقط من لوحة التحكم.

يمكنك الانتقال لصفحة **إعدادات المطعم** وإلغاء تفعيل خيار الطلبات المباشرة أو إلغاء إظهار رقم الواتساب، فيتحول النظام للعمل الداخلي فقط.