كيفية إعداد الكافتيريا

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

ما ستحتاج إليه

• رخصة HandyCafe نشطة. تستخدم الكافتيريا المصادقة عبر الرخصة تلقائيًا؛ لا تحتاج إلى لصق مفتاح يدويًا.
• اتصال بالإنترنت على الخادم. الكافتيريا تعتمد على السحابة، لذا يتطلب التجهيز ومزامنة القائمة واستطلاع الطلبات الوصول الخارجي إلى واجهة برمجة التطبيقات السحابية.
• عنوان URL ترغب في استخدامه لقائمة العملاء العامة. الأحرف المسموح بها هي الأحرف الصغيرة والأرقام والشرطات. الطول من 3 إلى 62 حرفًا.
• اختياري: شعار وصورة رأس. التنسيق الموصى به هو WebP حتى 2 ميجابايت.
• اختياري: طابعة إيصالات TCP على الشبكة المحلية.

الخطوة 1: تفعيل الكافتيريا

1. افتح HandyCafe Server.
2. انتقل إلى الإعدادات في الشريط الجانبي.
3. افتح علامة تبويب الكافتيريا.
4. فعّل تفعيل الكافتيريا.
5. يتصل الخادم بواجهة برمجة التطبيقات السحابية باستخدام رخصتك كرمز تفويض. إذا نجح، يفتح معالج التجهيز.

النتيجة المتوقعة: تظهر شاشة معالج التجهيز. إذا رأيت خطأ يتعلق بالرخصة أو الاتصال، تحقق من اتصالك بالإنترنت وتأكد من أن رخصة HandyCafe نشطة.

الخطوة 2: تجهيز الكافيه

يطلب المعالج أربعة حقول.

1. Slug. اكتب لاحقة URL التي ترغب بها. يتم تحديث مؤشر التوفر خلال ثانية. إذا كان الـ slug مأخوذًا أو محجوزًا، اختر آخر.
2. اسم العرض. الاسم المقروء الذي يظهر في أعلى قائمة العملاء، مثل "صالة ألعاب أتيلا".
3. الدولة والعملة. اختر الدولة التي يعمل فيها الكافيه. العملة الافتراضية تعتمد على الدولة ويمكن تغييرها.
4. المنطقة الزمنية. اختر المنطقة الزمنية لأوقات الطلب والتسوية.
5. انقر على إنشاء كافيه.

النتيجة المتوقعة: يغلق المعالج ويفتح مساحة عمل الكافتيريا. عنوان URL العام الخاص بك handy.cafe/{slug} أصبح الآن مباشرًا، رغم أن القائمة فارغة.

الخطوة 3: ملء ملف تعريف العمل

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

النتيجة المتوقعة: يظهر الشعار والرأس في معاينة. زيارة handy.cafe/{slug} في المتصفح الآن تعرض الرأس المميز ولكن لا يزال المحتوى فارغًا.

الخطوة 4: إنشاء الطوابق

1. في الإعدادات > الكافتيريا، ابحث عن قسم الطوابق.
2. انقر على إضافة طابق وسمّه (مثل "القاعة الرئيسية").
3. أضف طوابق إضافية إذا كان لديك مناطق متعددة (مثل "الميزانين"، "الفناء الخارجي").
4. أعد ترتيب الطوابق باستخدام أزرار التحريك لأعلى ولأسفل. يصبح الطابق العلوي هو الافتراضي في محرر مخطط الطابق.

النتيجة المتوقعة: تظهر طوابقك في القائمة. علامة تبويب الكافتيريا > مخطط الطابق تعرض الآن حبوب الطوابق في الأعلى.

الخطوة 5: بناء مخطط الطابق

1. افتح الكافتيريا > مخطط الطابق.
2. اختر الطابق الأول من الحبوب.
3. انقر على إضافة طاولة. تظهر طاولة مربعة في أصل اللوحة.
4. اسحب الطاولة إلى الموضع المطلوب. حرر للحفظ.
5. انقر على الطاولة لفتح لوحة خصائصها. قم بتكوين:
   • الرمز (مثل "T1"، "نافذة 3").
   • اسم العرض (تسمية أطول اختيارية).
   • عدد المقاعد (عدد المقاعد).
   • الشكل (مربع، مستطيل أفقي، مستطيل عمودي، أو دائري).
   • الحجم (من 1 إلى 10).
6. كرر لكل طاولة في الطابق.
7. اختياريًا، انتقل إلى عرض ثلاثي الأبعاد لمراجعة التخطيط من منظور معماري.

النتيجة المتوقعة: يعرض مخطط الطابق جميع الطاولات في مواقعها الواقعية. السحب معطل في العرض ثلاثي الأبعاد؛ عد إلى العرض ثنائي الأبعاد لتحريك الطاولات.

الخطوة 6: بناء القائمة

1. افتح الكافتيريا > القائمة.
2. انقر على إضافة فئة. أدخل اسمًا واختر أيقونة MDI من منتقي الأيقونات. انقر على حفظ.
3. كرر لكل فئة (مثل "مشروبات ساخنة"، "مشروبات باردة"، "برجر"، "حلويات").
4. داخل فئة، انقر على إضافة منتج. أدخل:
   • الاسم.
   • الوصف (يدعم Markdown).
   • سطر المكونات.
   • السعر الأساسي.
   • معدل ضريبة القيمة المضافة.
   • وقت التحضير (قيمة ثابتة احتياطية).
   • اختياري: تسمية الوحدة، علم تتبع المخزون، عدد المخزون المتاح.
5. ارفع صورة المنتج. أي تنسيق مقبول؛ يوصى بـ WebP حتى 2 ميجابايت.
6. انقر على حفظ.
7. إذا كان للمنتج خيارات، انتقل إلى قسم المتغيرات وانقر على إضافة متغير. أنشئ صفًا لكل خيار مع فرق السعر. فعّل مطلوب إذا كان يجب على العميل اختيار واحد.
8. كرر لكل منتج في قائمتك.

النتيجة المتوقعة: تعرض قائمة العملاء على handy.cafe/{slug} الآن فئاتك ومنتجاتك. قم بزيارتها في المتصفح للتحقق.

الخطوة 7: إعداد الطابعة (اختياري)

1. لا تزال تحت الإعدادات > الكافتيريا، انتقل إلى إعدادات الطابعة.
2. اضبط النوع على TCP.
3. أدخل IP الطابعة والمنفذ. تستمع معظم طابعات ESC POS TCP على المنفذ 9100.
4. فعّل القطع التلقائي إذا كانت الطابعة تدعمه.
5. فعّل الطباعة التلقائية عند الطلب الجديد لتفعيل الطباعة لكل طلب وارد.
6. فعّل إشعار الصوت لتنبيه صوتي بجانب إشعار سطح المكتب.
7. انقر على اختبار الطباعة. يجب أن تطبع إيصال عينة خلال بضع ثوانٍ.

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

الخطوة 8: جلوس طاولة وإجراء طلب اختبار

1. افتح الكافتيريا > الطاولات (أو استخدم قائمة إجراءات مخطط الطابق).
2. اختر طاولة واحدة وانقر على جلوس العميل (أيضًا مسماة "فتح الطاولة").
3. لاحظ رمز الأمان المكون من 6 أرقام المعروض. اكتبه أو اترك الحوار مفتوحًا.
4. على الهاتف، انتقل إلى handy.cafe/{slug}/{table-code}. يمكنك أيضًا مسح QR إذا كان لديك ملصق مطبوع.
5. أدخل الرمز المكون من 6 أرقام.
6. تصفح القائمة وأضف عنصرًا إلى السلة.
7. تابع إلى الدفع. اختر نقدًا كطريقة الدفع (إعداد Stripe اختياري ويمكن إضافته لاحقًا).
8. أرسل الطلب.
9. على الخادم، انتقل إلى الكافتيريا > الطلبات.

النتيجة المتوقعة: خلال 3 ثوانٍ، يظهر بطاقة طلب جديدة على لوحة الطلبات. يتم إطلاق إشعار سطح المكتب. يتم تشغيل تنبيه صوتي إذا كانت إشعارات الصوت مفعلة. يزيد شارة عدد الطلبات المعلقة في علامة تبويب الطلبات.

الخطوة 9: تقدم وتسوية طلب الاختبار

1. على بطاقة الطلب، انقر على زر الحالة التالية. ينتقل الطلب من تم الإرسال إلى مؤكد.
2. استمر في النقر للتقدم عبر قيد التحضير، جاهز، وتم التقديم.
3. في صفحة الطاولات، افتح نفس الطاولة وانقر على تسوية الفاتورة.
4. اختر نقدًا كطريقة الدفع ووافق.

النتيجة المتوقعة: تعود الطاولة إلى خاملة. ينتهي صلاحية رمز الأمان. يتم إنشاء سجل تسوية ويمكن مراجعته لاحقًا.

الأخطاء الشائعة التي يجب تجنبها

• تخطي ملف تعريف العمل. يرى العملاء اسم العرض الافتراضي ومنطقة الشعار المكسورة إذا قمت بالإطلاق قبل حفظ الملف الشخصي.
• عدم إعادة طباعة رموز QR بعد تغييرات الـ slug. تغيير الـ slug يبطل كل رمز QR موجود. اطبع ملصقات جديدة واستبدلها على كل طاولة.
• نشر الكثير من الفئات عند الإطلاق. استهدف 6 إلى 10 فئات رئيسية. يتصفح العملاء بشكل أسرع عندما تتناسب القائمة مع الشاشة.
• نسيان إعداد الطابعة قبل أول نوبة حقيقية. بدون الطباعة التلقائية عند الطلب الجديد، قد يفوت الموظفون الطلبات خلال فترة مزدحمة. قم دائمًا بإجراء اختبار طباعة واحد على الأقل.
• ترك الإعداد الافتراضي لإظهار وقت التحضير في القائمة مفعلاً بدون تاريخ ديناميكي. لأول 30 يومًا، القيمة الثابتة هي ما يراه العملاء. اضبط أوقات ثابتة واقعية أو عطل الشريحة حتى يتم تدريب التقدير الديناميكي.
• استخدام نفس الجهاز لاختبار الموظفين والعملاء. تستمر جلسة العميل لمدة 24 ساعة؛ إذا تم تسليم جهاز الاختبار لاحقًا إلى عميل، فسيكونون بالفعل على القائمة بدون تحقق. امسح الجهاز أو استخدم ملف تعريف متصفح نظيف للاختبارات.