توثيق تطبيق النادل وشاشة عرض المطبخ (KDS) لأودو 19 Community

1. فُكّ ضغط الحزمة. بداخلها taqnix_restaurant_kds.zip؛ فُكّه لتحصل على المجلد taqnix_restaurant_kds.
2. انسخ المجلد إلى أحد مجلدات addons_path في خادم أودو وأعد تشغيل أودو.
3. سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
4. أزل مرشح «التطبيقات» وابحث عن Restaurant Waiter App واضغط تثبيت.

# or from the command line
./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_restaurant_kds --stop-after-init

1. افتح المطعم ← الإعدادات ← المطاعم وافتح مطعمك (نقطة بيع من نوع مطعم). فعّل تطبيق النادل وشاشة المطبخ وأضف طرق الدفع والصالات.
2. أنشئ الصالات والطاولات (الفصل 7) ورتّبها في محرر خريطة الصالة.
3. ضع أطباقك في نقطة البيع (متاح في نقطة البيع) مع فئة القائمة الخاصة بها؛ وأنشئ المحطات وحدّد لكل محطة الفئات التي تحضّرها (الفصلان 8 و10).
4. أضف مجموعات الخيارات إلى الأطباق التي تحتاج إليها (الفصل 9).
5. أنشئ قائمة المواد للأطباق واختر مواقع المخزون للمطبخ والبار (الفصل 11).
6. أنشئ المستخدمين: النوادل، ومستخدمي المطبخ مع محطتهم، ومديرًا (الفصل 13).
7. افتح جلسة نقطة بيع للمطعم (يفعل ذلك أمين الصندوق أو المدير من نقطة البيع ← لوحة المعلومات) ليتمكن النظام من تسجيل المدفوعات.
8. ابنِ التطبيق بسكربت الإعداد (الفصل 24) وثبّته على الأجهزة وسجّل الدخول وجرّب طلبًا تجريبيًا.

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

location /websocket {
    proxy_pass http://127.0.0.1:8072;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_read_timeout 3600s;
}

1. ثبّت Flutter 3.41 أو أحدث (يجب أن يكون flutter doctor أخضر لمنصاتك).
2. شغّل سكربت الإعداد بعنوان خادمك واسم الحزمة، واختياريًا الوضع الذي يُقفل عليه الجهاز:

   dart run tools/setup.dart --url http://192.168.1.10:8069 --package com.yourrestaurant.tableservice

3. استبدل الأيقونة المؤقتة (assets/branding)، ونفّذ flutter pub get.
4. أندرويد: flutter build apk --release (أو appbundle لـ Google Play). آيفون وآيباد: flutter build ios --release ثم أرشِف في Xcode.
5. ثبّت نسخة النادل على الهواتف والتطبيق نفسه على أجهزة المطبخ اللوحية: يتبع الوضع دور المستخدم، أو اقفل الجهاز على KDS بسكربت الإعداد.
6. أجهزة المطبخ اللوحية: استخدم وضع الوصول الموجَّه / الكشك (kiosk) في الجهاز كي لا يمكن إغلاق التطبيق، وأبقِها موصولة بالكهرباء.

# is the server reachable?
curl http://192.168.1.10:8069/api/kds/v1/ping
# {"ok": true, "api_version": 1, "server_time": "2026-10-27T18:30:00Z"}

# sign in (returns a token and the restaurants of the account)
curl -X POST http://192.168.1.10:8069/api/kds/v1/auth/login -H 'Content-Type: application/json' \
  -d '{"login": "maya@coppergrill.example", "password": "...", "device": {"id": "tablet-1", "platform": "ios", "mode": "waiter"}}'

# send an order (idempotent: the same operation uuid is applied once)
curl -X POST http://192.168.1.10:8069/api/kds/v1/op/order_push -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"uuid": "4c1f...", "order_uuid": "a9d2...", "table_id": 12, "guests": 4, "fire": true,
       "lines": [{"uuid": "7b0e...", "product_id": 82, "qty": 2, "option_ids": [31], "note": "Severe peanut allergy"}]}'

# watch the kitchen events live (Odoo websocket; send an Origin header)
#   ws://192.168.1.10:8069/websocket   then   {"event_name":"subscribe","data":{"channels":["kds.1.9f3a..."],"last":0}}

المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.