HandyCafe Docs
owner it-admin

الكافتيريا

الكافتيريا هي وحدة خدمة الطعام والشراب المدمجة في HandyCafe. تتيح لك إنشاء مخطط رقمي لطاولاتك، ونشر قائمة ذاتية بعلامتك التجارية على الويب عبر handy.cafe/{your-slug}، وتتبع كل طلب وارد لحظة بلحظة من لوحة الخادم.

يمسح العملاء رمز QR الموجود على طاولتهم، ويدخلون رمز الأمان المكوّن من 6 أرقام، ويتصفحون القائمة بلغتهم الخاصة، ثم يرسلون الطلب. يظهر الطلب في شاشة طلبات الكافتيريا خلال ثوانٍ. يؤكد الموظفون كل مرحلة من مراحل التحضير، وعند اكتمال الخدمة تؤدي عملية "تصفية الحساب" إلى إغلاق الفاتورة بخطوة واحدة.

لمن هذه الميزة؟

صُممت الكافتيريا لمقاهي الإنترنت ومراكز الألعاب وساحات الرياضات الإلكترونية التي تقدم الطعام والشراب عند مقاعد العملاء. وهي تستبدل أوراق الطلبات والطلبات الشفهية على الكاونتر. وتعمل جنبًا إلى جنب مع نظام الجلسات والتسعير القياسي في HandyCafe؛ إذ تُسجّل طلبات الكافتيريا بشكل منفصل ولكن على نفس ترخيص المقهى.

القدرات الأساسية

الميزة الملخص
مخطط الطوابق محرر بصري يدعم عدة طوابق. اسحب الطاولات إلى أماكنها، وانتقل إلى العرض ثلاثي الأبعاد، وضع الطاولات خارج الخدمة.
الطاولات اضبط عدد المقاعد والشكل والحجم (من 1 إلى 10) ورمز العرض لكل طاولة. ولّد رموز QR ودوّرها عند الحاجة.
القائمة فئات بأيقونات MDI، ومنتجات بصور، وأوصاف Markdown، وقوائم مكوّنات، ومجموعات خيارات مثل الحجم والإضافات.
الطلبات لوحة مباشرة مع تحديث كل 3 ثوانٍ، وشارة لعدد الطلبات المعلّقة، وإشعارات سطح المكتب والصوت، وحالة لكل طلب ولكل عنصر.
تصفية الحساب إجراء بنقرة واحدة لتسوية جميع الطلبات المفتوحة على طاولة واحدة باستخدام طريقة الدفع المختارة.
قائمة الزبون قائمة ويب بعلامتك التجارية متاحة بـ 24 لغة على handy.cafe/{slug}، مع سمة فاتحة وداكنة وتحديد تلقائي للغة بحسب الجهاز.
الدفع عبر الإنترنت تكامل اختياري مع Stripe Checkout للدفع عند الطلب، مع بديل الدفع النقدي عند الطاولة.
الطابعة طابعة إيصالات TCP اختيارية مع القص التلقائي والطباعة التلقائية عند وصول طلب جديد.

أين تظهر الكافتيريا في واجهة الخادم؟

للكافتيريا نقطتا دخول:

  1. قسم الكافتيريا في الشريط الجانبي. هذه هي مساحة العمل التشغيلية للاستخدام اليومي. تتضمن خمس علامات تبويب: الطاولات، ومخطط الطوابق، والقائمة، والطلبات، والجدول. تعرض علامة تبويب الطلبات شارة معلّقة كلما كانت هناك طلبات جديدة تنتظر المعالجة.
  2. الإعدادات > الكافتيريا. هذه هي منطقة الإعداد. تحتوي على الملف التجاري (slug، واسم العرض، والشعار، وصورة الرأس، والعنوان، والعملة، والمنطقة الزمنية)، وإعدادات الطابعة، وإدارة الطوابق، ومفاتيح تفعيل الميزات الاختيارية.

إنشاء مقهى

عند تفعيل الكافتيريا لأول مرة، يستخدم الخادم ترخيص HandyCafe تلقائيًا كرمز تفويض. لا تحتاج إلى لصق أي شيء يدويًا. بعد ذلك يطلب منك معالج الإعداد أربع معلومات:

  1. Slug. يصبح هذا هو عنوانك العام على handy.cafe/{slug}. الأحرف المسموح بها هي الأحرف الصغيرة والأرقام والشرطات. يتراوح طول الـ slug بين 3 و62 حرفًا. يتحقق النظام من التوفر في الوقت الفعلي ويرفض الأسماء المحجوزة مثل "admin" و"api" و"dashboard".
  2. اسم العرض. الاسم المقروء الذي يظهر أعلى قائمة الزبون.
  3. البلد والعملة. العملة الافتراضية لأسعار القائمة. تُخزَّن الأسعار بوحدات فرعية (مثل السنتات) وتُعرض مع رمز العملة المكوّن.
  4. المنطقة الزمنية. تُستخدم لحساب أزمنة التحضير الديناميكية، والطوابع الزمنية على الطلبات، وسجلات التسوية.

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

الملف التجاري

يمكن تعديل الملف التجاري في أي وقت من خلال الإعدادات > الكافتيريا. الحقول الأساسية:

الحقل الغرض
Slug جزء عنوان URL العام. تغيير الـ slug يكسر رموز QR الحالية حتى تُعاد طباعتها.
اسم العرض يظهر أعلى قائمة الزبون.
الشعار صورة مربعة. يُنصح بـ WebP حتى 2 ميجابايت.
صورة الرأس صورة بانر عريضة أعلى قائمة الزبون. يُنصح بـ WebP حتى 2 ميجابايت.
العنوان والهاتف اختياريان. يظهران في تذييل القائمة.
العملة تُطبق على كل أسعار المنتجات في القائمة.
البلد يُستخدم للضرائب والإعدادات الإقليمية الافتراضية.
المنطقة الزمنية تُطبق على الطوابع الزمنية للطلبات والتسوية.
إظهار وقت التحضير في القائمة مفتاح تبديل. عند تفعيله يعرض كل منتج شارة بوقت التحضير التقديري.

إعدادات الطابعة

يقبل قسم الطابعة الإعدادات التالية:

  • النوع. إما معطل أو TCP. لا يوجد دعم للطباعة المباشرة عبر USB في هذا الإصدار.
  • IP والمنفذ. عنوان الشبكة لطابعة الإيصالات. تستمع معظم طابعات ESC POS TCP على المنفذ 9100.
  • القص التلقائي. يضيف أمر قص الورق بعد كل إيصال مطبوع.
  • الطباعة التلقائية عند طلب جديد. عند تفعيله يُطلق كل طلب وارد عملية طباعة إيصال تلقائيًا.
  • إشعار صوتي. يشغل تنبيهًا صوتيًا إضافة إلى إشعار سطح المكتب عند وصول طلب جديد.
  • اختبار الطباعة. يرسل إيصالًا تجريبيًا إلى الطابعة المحددة للتحقق من الاتصال.

ملخص البنية

تعتمد الكافتيريا على نموذج بيانات سحابي أولًا. تُخزَّن كل طاولة وفئة ومنتج وطلب وسجل تسوية في قاعدة بيانات handy.cafe السحابية. يعكس خادم HandyCafe المحلي هذه الحالة ويستعلم من نقطة نهاية الطلبات كل 3 ثوانٍ بحثًا عن نشاط جديد. تُقدَّم الصفحات الموجهة للعملاء مباشرة من سحابة handy.cafe؛ ولا تحتاج إلى أن يكون خادمك متاحًا من الإنترنت.

وبما أن البيانات موجودة في السحابة:

  • تواصل رموز QR العمل حتى عندما يكون الخادم غير متصل، لكن الموظفين لن يروا الطلبات في اللوحة حتى تعود الاتصالية.
  • تُرسل تغييرات القائمة إلى handy.cafe خلال ثوانٍ من الحفظ.
  • تصل الطلبات التي ينشئها العملاء إلى لوحة الطلبات بعد الاستعلام التالي كل 3 ثوانٍ.

الخطوات التالية