كيف يطلب الضيوف — المساران
هناك طريقتان لضيف في عقارك ليقدّم طلب طعام وشراب، وكلتاهما تنتهيان في المكان نفسه: يرى المطبخ طلبًا، ويصل الرسم إلى فاتورته (أو، عندما لا تكون هناك فاتورة مفتوحة، يحصل على رابط Stripe آمن).
يُنظَّم تناول الطعام حسب منفذ البيع — يظهر مطعمك وبارك ومقهاك وعمليات خدمة الغرف لديك كل منها كوجهة مستقلة بصورة ووصف وساعات وحالة مفتوح/مغلق مباشرة.
المسار 1: Lucy في المحادثة
يصل معظم الضيوف إلى هنا بشكل طبيعي. يفتحون المحادثة — من بوابة الضيف أو صفحة WiFi أو WhatsApp — وينقرون على الطعام والشراب أو يسألون ببساطة:
- "ما الموجود في قائمة خدمة الغرف؟"
- "أنا جائع، ماذا يمكنني أن آخذ؟"
- "هل يمكنني حجز طاولة لأربعة الليلة؟"
- "أرسل لي قهوة."
تسأل المحادثة أولًا عمّا يريدون فعله: حجز طاولة أو طلب طعام.
طلب الطعام
يتصفح الضيف منافذ بيعك. تعرض كل بطاقة منفذ بيع صورتها ووصفها وشارة خضراء مفتوح أو رمادية مغلق. ويعرض اختيار منفذ بيع مفتوح قائمته مع صور العناصر والأسعار والوسوم الغذائية. تدخل العناصر إلى سلة، وتعرض السلة الصورة الكاملة قبل تقديم أي شيء:
- المجموع الفرعي للعناصر
- الإكرامية كسطر منفصل، عندما يتطلبها منفذ البيع (مع عرض النسبة المئوية)
- رسوم التوصيل، عندما يفرضها منفذ البيع لخدمة الغرف
- ملاحظة "الأسعار تشمل ضريبة بنسبة X%" عند الاقتضاء
إذا اختار الضيف منفذ بيع مغلقًا، يوضح إشعار كهرماني أنه مغلق ومتى يفتح تاليًا — لا يمكن طلب شيء حتى ذلك الحين.
حجز طاولة
بالنسبة لمنافذ البيع التي تقبل الحجوزات، يختار الضيف عدد الأشخاص والتاريخ والوقت مباشرةً في المحادثة. يعرض منتقي الأوقات التوفر المباشر: فقط الفترات القابلة للحجز فعليًا قابلة للاختيار، وتُعتم الأوقات الممتلئة أو الماضية. ويحصل الضيف على بطاقة تأكيد بمجرد تقديم الحجز.

المسار 2: صفحة /room-service
للضيوف الذين يحبون التصفح:
- يفتحون
/room-serviceمن بطاقة الإجراء السريع في لوحة التحكم (تظهر تلقائيًا بمجرد ضبط سياق الإدراج أثناء الوصول أو عبر المحادثة). - تُحمَّل القائمة مجمّعة حسب منفذ البيع والفئة مع الصور والأسعار والوسوم الغذائية.
- انقر على عنصر لإضافته إلى السلة. وتعرض حبة عائمة "عرض السلة" في الأسفل الإجمالي الجاري.
- افتح ورقة السلة، وعدّل الكميات أو أزل العناصر، وانقر على متابعة للتأكيد. تعرض السلة تفصيل الإكرامية ورسوم التوصيل والضريبة نفسه الموجود في المحادثة.
- تطلب نافذة التأكيد الغرفة/الموقع وأي طلبات خاصة، ثم يرسله زر قدّم الطلب — $X.YZ.
يرى الضيوف لافتة تأكيد خضراء مع رسالة النتيجة.
"على غرفتك" مقابل "رابط الدفع" — متى يحدث كل منهما
تختار نقطة نهاية الطلب تلقائيًا:
- فاتورة مفتوحة + بطاقة مسجلة ← يُضاف الرسم إلى الفاتورة المفتوحة. يرى الضيف "أُضيف إلى غرفتك — أُشعِر الموظفون." تُسوّى عند إغلاق الفاتورة.
- فاتورة مفتوحة لكن الزيادة تفشل ← يتراجع إلى دفع لكل رسم على البطاقة نفسها. رسالة التجربة نفسها، مجرد كائن Stripe مختلف خلف الكواليس.
- لا فاتورة مفتوحة ← يُنشأ طلب معلّق ويُعاد رابط دفع Stripe. يرى الضيف زر "ادفع وأكّد" (في المحادثة) أو رابط دفع (على التطبيق أحادي الصفحة).
منافذ البيع وساعات الخدمة
يحمل كل منفذ بيع ساعاته الخاصة، ويمكن أن يكون للقوائم داخل منفذ البيع نوافذ خدمة خاصة بها (قائمة المقهى، الميني بار، قائمة العشاء). يرى الضيوف دائمًا كل منفذ بيع وكل قائمة، لكن لا يمكن طلب العناصر إلا بينما منفذ بيعها وقائمتها ضمن النافذة:
- تعرض بطاقات منافذ البيع شارة مفتوح / مغلق مباشرة؛ وتعرض منافذ البيع المغلقة متى تفتح تاليًا.
- يعرض كل رأس مجموعة قائمة حالته الحالية، مثل "الخدمة الآن · 7ص–11ص" (أخضر) أو "مغلق · يفتح 5م" (رمادي).
- تعرض عناصر القائمة المغلقة زر إضافة مُعتمًا مع تلميحة ("متاح 5م–11م"). والنقر لا يفعل شيئًا.
- إذا كان لدى ضيف عنصر في سلته أصبح منذ ذلك الحين خارج النافذة (أُغلقت القائمة أثناء تصفحه)، تعلّمه ورقة السلة بالكهرماني ويتعطّل زر قدّم الطلب حتى يزيله.
- تنطبق القاعدة نفسها على Lucy في المحادثة — فالطلبات خارج النافذة تعيد رسالة واضحة "متاح فقط 5م–11م".
القوائم التي لا يوجد لها نافذة خدمة محددة تُعامَل كـمفتوحة دائمًا، والعناصر غير المسندة إلى مجموعة قائمة تبقى قابلة للطلب دائمًا.
المواد المسببة للحساسية ووقت التحضير
يمكن أن تحمل العناصر وسومًا غذائية (نباتي صرف، نباتي، خالٍ من الغلوتين، خالٍ من الألبان، حار، يحتوي على مكسرات) — تظهر كحبات صغيرة تحت الوصف. ويظهر وقت التحضير، عند ضبطه، بجوار العنصر ("8 دقائق")، وتعرض منافذ بيع خدمة الغرف وقت توصيل تقديريًا.
يمكن للضيوف أصحاب الحساسية إضافتها في حقل الطلبات الخاصة في نافذة التأكيد. وتُرسَل تلك الملاحظة إلى الموظفين في إشعار المطبخ.
سياق الإدراج — لماذا تختفي نقطة دخول خدمة الغرف أحيانًا
لا تظهر بطاقة لوحة التحكم وموجّهات بدء المحادثة إلا عندما يعرف التطبيق أحادي الصفحة في أي عقار يوجد الضيف. يُضبط معرّف الإدراج تلقائيًا:
- عندما يكمل الضيف مسار الوصول على
/arrive/[token] - عندما يصل إلى
/room-service?listing_id=…مباشرةً بسلسلة استعلام (رابط عميق) - عندما يرسل له الموظفون رابطًا سحريًا بمعرّف الإدراج مُرمَّزًا فيه
إذا وصل ضيف إلى لوحة التحكم بلا سياق إدراج، تُخفى بطاقة خدمة الغرف بدلًا من إزعاجه بدعوة إجراء فارغة. ويمكن للموظفين إصلاح ذلك بإرسال رابط وصول جديد له أو بطلب بدء المحادثة من صفحة WiFi، وكلاهما يضبط ملف تعريف الارتباط.