جبرانجبران

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

مطعم على السطح بقائمة كبيرة ومتنوعة، من الفطور إلى الستيك والحلويات والمشروبات والأراجيل، يصعب تصفحها على الجوال ويبطؤ الطلب منها وقت الذروة. يريد الزبون اقتراحات ويريد احترام طريقة الطبخ التي طلبها، ويحتاج الموظفون رؤية الصالة كلها دفعة واحدة. والنادل الذكي الذي يرسل الطلبات يجب ألا يُخدع بأسعار خاطئة أو طلبات غير مؤكدة.

رمز QR لكل طاولة يفتح تطبيق زبون مرتبطًا بها: قائمة بالصور على 27 تصنيفًا مع أزرار التصنيفات والبحث، وصفحة لكل طبق مع تعليمات خاصة، وسلة يُعاد تسعيرها على الخادم وتُؤكد، وتتبع مباشر للطلب، وخدمات طاولة بنقرة واحدة، وتعديل الطلب المرسل حتى يجهز.

يتحدث النادل الذكي الإنجليزية والعربية واللهجة الأردنية أو مزيجًا منها. يجيب من قائمة المطعم نفسها، ويقترح أطباقًا متناسقة، ويضيف الأطباق مع ملاحظات الطبخ مثل «ميديوم ويل»، ويلخص الطلب بالأسعار الدقيقة ولا يرسله إلا بعد تأكيد الزبون. ويدير الموظفون السهرة من خريطة مباشرة لصالة الطعام الحقيقية، ولوحة الطلبات الواردة، وقائمة الخدمات، وزيارات الطاولات مع الحساب الجاري، وإدارة كاملة للأطباق الـ 229، ورموز QR مع ملفات PDF، وإعدادات الذكاء الاصطناعي مع تقرير استخدام وتكلفة لآخر 7 أيام.

تطبيقات Next.js 16 للزبون والموظفين فوق واجهة خلفية FastAPI مع SQLAlchemy غير المتزامن وترحيلات Alembic وPostgreSQL مع pgvector. يستخدم النادل استدعاء الأدوات في Gemini، ويتحقق الخادم من كل إجراء. صُمم البحث في القائمة ليجمع مطابقة أسماء الأطباق مع التضمينات الشعاعية، ويبقى يعمل دائمًا عبر مطابقة الأسماء عند عدم توفر التضمينات. يغذي صندوق صادر ضمن المعاملة تحديثات WebSocket للزبائن والموظفين. تُضبط المزودات والنماذج لكل غرض، Gemini أو OpenAI للدردشة والتضمينات والتفريغ الصوتي والصوت المباشر، والمفاتيح المخزنة مشفرة.

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

النموذج يقترح والخادم يقرر، فتبقى الضوابط ثابتة مهما كتب الزبون. ملخص جديد مطلوب قبل كل تأكيد حتى لا تُرسل عبارة «أرسله» القديمة طلبًا غير محدث. تراجع إلى مطابقة الأسماء ليبقى البحث يعمل دون تضمينات. والأمان مفعل افتراضيًا: جلسات بكوكيز HttpOnly ورموز مجزأة، وحماية CSRF، وفحص مصدر WebSocket، وحدود للطلبات، وتحقق من الملفات المرفوعة، وترويسات أمان صارمة.

في تجربة مسجلة على Gemini 3.1 Flash Lite، سأل الزبون «What steaks do you have?» فحصل على نوعي الستيك بوصفهما وسعرهما الحقيقيين. ثم أضاف في رسالة واحدة ريب آي بدرجة ميديوم ويل ومسخنًا وكوبي مانجو تروبيك، فاقترح النادل حمصًا للمشاركة وعرض ملخصًا بالأسعار، وبعد «نعم» صريحة من الزبون أرسل الطلب JB-107 بقيمة 63.45 دينار مع ملاحظة الطبخ على سطر الستيك. وعندما قال الزبون «أرسله» أول مرة، اشترط الخادم ملخصًا جديدًا قبل القبول. ظهر الطلب على الطاولة T1 في خريطة الموظفين خلال ثانيتين تقريبًا، وحرّك زرا «ابدأ التحضير» و«جاهز» تتبع الزبون مباشرة. وملأت خدمة مبرمجة عبر الواجهة البرمجية الحقيقية 8 من 12 طاولة بطلبات في كل الحالات وطلبات خدمة مفتوحة.