كيف يعمل OrderGer

شرح بسيط لكل صاحب مطعم — تقني وغير تقني.

الفكرة بإيجاز

أنت عندك موقع/متجر إلكتروني، وعندك تطبيق OrderGer على موبايل الكاشير. لما عميل يطلب من موقعك، الطلب يصل التطبيق فوراً مع إنذار صوتي عالي ما يطفي إلا لما تقبل أو ترفض. وأنت تحدّث حالة الطلب من التطبيق، موقعك بدوره يستلم التحديث تلقائياً.

الخطوات بالتفصيل

1. العميل يفتح موقعك ويرسل الطلب من الـ checkout عادي.
2. موقعك (بعد ما يخزن الطلب عنده) يبعت POST إلى /api/v1/orders فيه بيانات الطلب الكاملة.
3. OrderGer يستلم الطلب، يخزنه، ويرسل Push Notification للموبايل + يفتح شاشة عاجلة مع إنذار صوتي.
4. الموظف يضغط قبول → الإنذار يتوقف، تتسجل سرعة قبوله، ويُرسل Webhook لموقعك (order.accepted).
5. الموظف ينقل الطلب عبر "قيد التحضير → بانتظار التوصيل → بالطريق → تم التوصيل". مع كل خطوة Webhook يصل لموقعك.
6. لما الطلب يصير "تم التوصيل"، يخصم 0.05$ من رصيد OrderGer (مرة واحدة فقط، حتى لو ضغطت "تم التوصيل" 10 مرات).

المزامنة الثنائية

من الموقع إلى OrderGer: إنشاء طلب، تعديل، إلغاء، استعلام حالة، قائمة الفروع.

من OrderGer إلى الموقع (Webhooks):

• order.created
• order.accepted
• order.rejected (مع سبب الرفض)
• order.preparing / order.waiting_for_courier / order.on_the_way
• order.delivered
• order.cancelled
• order.updated (مع changed_fields)

كل Webhook موقّع بـ HMAC-SHA256 على البودي، عبر هيدر X-OrderGer-Signature: sha256=<hex> باستخدام السر اللي حطّيته في إعدادات الـ Webhook.

الإنذار الصوتي

الطلب الجديد يفتح شاشة عاجلة على كامل الموبايل بزرَّين كبيرَين: قبول / رفض. الصوت يدور لوب مع اهتزاز مستمر. ما يطفي إلا لما تقبل/ترفض. إذا في طلب ثاني بانتظار، التطبيق ينتقل له تلقائياً بعد ما تخلّص الحالي.

QR للمندوب

لكل طلب رابط سري قصير. تعطيه للمندوب، يفتحه على موبايله، يشوف اسم العميل، الهاتف، العنوان الكامل، رابط Google Maps، وزر WhatsApp — بدون ما تشاركه أي بيانات حساسة أخرى. الرابط بصلاحية محدودة وبتقدر تلغيه.