توثيق يوميات موقع البناء وقائمة العيوب لأودو 19 Community

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

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

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

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

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

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

   dart run tools/setup.dart --url https://odoo.example.com --package com.yourcompany.jobsite

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

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

# sign in (returns a token, the roles and the sites of the user)
curl -X POST https://odoo.example.com/api/jobsite/v1/auth/login -H 'Content-Type: application/json' \
  -d '{"login": "faisal@example.com", "password": "...", "device": {"id": "phone-1", "platform": "ios"}}'

# drop a punch-list pin (idempotent: the same operation uuid is applied once; x and y are 0..1 of the page)
curl -X POST https://odoo.example.com/api/jobsite/v1/op/pin_create -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"uuid": "4c1f...", "pin": {"uuid": "a9d2...", "project_id": 2, "plan_id": 3, "page": 1, "x": 0.31, "y": 0.62,
       "title": "Exposed rebar in the slab edge", "severity": "critical", "trade_id": 4}}'

# receive a delivery against a purchase order (short quantities create a backorder in Inventory)
curl -X POST https://odoo.example.com/api/jobsite/v1/op/delivery_receive -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"uuid": "77aa...", "delivery": {"uuid": "b1c3...", "project_id": 2, "purchase_id": 7, "ticket_no": "DN-88213", "plate": "DXB L 45219",
       "lines": [{"po_line_id": 21, "received": 20}]}, "photos": [{"kind": "ticket", "image_b64": "..."}, {"kind": "plate", "image_b64": "..."}]}'

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