توثيق إدارة الخدمات الميدانية لأودو

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

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

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

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

1. في أودو اضغط إنشاء فاتورة على أمر منجز (أو جده في الفوترة ← للفوترة)، وراجع المسودة وأكّدها كالمعتاد.
2. يؤكد إرسال الفاتورة الفاتورة عند الحاجة ويرسلها بالبريد مع ملف PDF إلى جهة اتصال الفاتورة لدى العميل؛ ويمكنك فعل ذلك من التطبيق أيضًا.
3. يطبع تقرير الخدمة ملف PDF بقائمة التحقق والقطع والصور والتوقيع؛ ويُرسل إلى العميل تلقائيًا إذا كان الإعداد مفعّلًا.

1. ثبّت Flutter (3.41 أو أحدث) وAndroid Studio، وعلى Mac ثبّت Xcode مع CocoaPods؛ ونفّذ flutter doctor وأصلح ما يبلغ عنه.
2. فُكّ ضغط flutter-app-source.zip في مجلد بلا مسافات.
3. شغّل سكربت الإعداد بعنوان أودو لديك واسم الحزمة الخاص بك: dart run tools/setup.dart --url https://odoo.example.com --package com.yourcompany.fieldservice. يكتب العنوان والمعرّفات في المشروع؛ وأضف --name "Your Company Service" و--color "#0f766e" و--icon your-icon-1024.png لضبط اسم التطبيق ولون العلامة والأيقونة (تشغيل السكربت مجددًا آمن).
4. نفّذ flutter pub get ثم flutter run لتجربته، مسجّلًا الدخول بفني من أودو لديك.

cd flutter-app
dart run tools/setup.dart --url https://odoo.example.com --package com.yourcompany.fieldservice
flutter pub get
flutter run --dart-define=SITE_URL=https://odoo.example.com

# is the server reachable?
curl https://odoo.example.com/api/fsm/v1/ping
# {"ok": true, "api_version": 1, "server_time": "2026-10-26T08:00:00Z"}

# sign in (returns a token and the configuration)
curl -X POST https://odoo.example.com/api/fsm/v1/auth/login -H 'Content-Type: application/json' \
  -d '{"login": "sara@example.com", "password": "...", "device": {"id": "abc", "platform": "android"}}'

# send buffered location points
curl -X POST https://odoo.example.com/api/fsm/v1/tracking/batch -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"points": [{"uuid": "1", "lat": 25.2, "lng": 55.27, "speed": 8.3, "heading": 90, "battery": 80, "network": "cellular", "recorded_at": "2026-10-26T08:00:00Z"}]}'

# push the queued actions and pull the changes
curl -X POST https://odoo.example.com/api/fsm/v1/sync -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"cursor": null, "ops": [{"uuid": "9d1c...", "type": "transition", "order_id": 12, "device_time": "2026-10-26T08:01:00Z", "payload": {"to": "en_route", "lat": 25.2, "lng": 55.27}}]}'

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