دورة الرحلة من البداية حتى التسوية

الدليل الكامل لمراحل الرحلة في WinTrack — من عرض السعر وإنشاء العقد حتى التسليم وحساب التسوية، مع كل الخطوات والأطراف المعنية.

دورة الرحلة (Trip) هي المحور الأساسي في WinTrack. تمر كل رحلة بسلسلة مراحل محدّدة، تنتقل المسؤولية خلالها بين عدة أطراف: مدير المبيعات، المدير التنفيذي/CEO، المشرف الإقليمي، والسائق. يوثّق النظام كل مرحلة بطابع زمني (Timestamp) لأغراض التقارير والمحاسبة.

لماذا الترتيب مهم؟

لا يمكن تخطّي مرحلة قبل إتمام التي تسبقها. مثلاً: لا يمكن للسائق بدء الحركة حتى يعتمد المشرف قائمة التحميل المسبق، ولا تُرفع قائمة ما بعد التحميل حتى يُرفق المشرف وثيقة البايان (Bayan al-Naql).

المراحل بالتفصيل

إنشاء عرض السعر والموافقات

يبدأ كل شيء بطلب عرض سعر (Quotation). يوافق عليه مدير المبيعات، ثم العميل، ثم المدير التنفيذي (CEO). بعد الموافقات الثلاث يتحوّل عرض السعر إلى عقد (Contract).

إنشاء العقد والمسارات

بعد اعتماد العقد، تُضاف إليه المسارات (Routes). كل مسار يحدّد نقطة التحميل ونقطة التفريغ، نوع الحمولة، الكمية، وسعر الوحدة. تُحسب إيرادات الرحلة لاحقاً من هذه القيم — لا تُقسّم إجمالي العقد تقريبياً.

تخصيص الأصول (Asset Assignment)

تُسنَد المركبة (الشاحنة) والمقطورة والسائق إلى المسار عبر تخصيص الأصول. يجب على السائق الإقرار باستلام المعدات (محضر التسليم) قبل المضيّ قدماً.

إرسال الرحلة (Dispatch)

يُرسِل المشرف الإقليمي تعليمات الرحلة إلى السائق. تتلقّاها تطبيقه على الجوال وتظهر ضمن رحلاته المعيّنة. يمكن للسائق قبول الرحلة أو رفضها.

تعرض شاشة الإرسال السائقين الجاهزين فقط (مجهّز بمركبة نشطة ومستندات سارية)؛ ومن لا يستوفي الشروط يظهر مُعطَّلاً مع سبب عدم الجاهزية، ويُعاد التحقق تلقائياً قبل الحفظ حتى لا تفشل العملية في الخطوة الأخيرة.

قائمة التحميل المسبق (Pre-loading Checklist)

بعد القبول، يُكمل السائق قائمة فحص جاهزية المركبة قبل التحميل. تتطلّب هذه المرحلة موافقة المشرف (اعتماد عمليات) قبل المتابعة.

تحقق على الخادم

منذ v0.47 يرفض الخادم إرسال أي قائمة تحقق لم تُؤشَّر فيها كل البنود، وكذلك أي إرسال يحوي بنداً لا ينتمي لقائمة الرحلة، وترتيب المراحل خارج التسلسل (مثل رفع وثيقة الوزن قبل الوصول لمحطة الوزن) برسالة واضحة. إعادة الإرسال بعد الإكمال آمنة — الخادم يتعامل معها كعملية مكررة بلا أثر.

التحميل ومحطة الوزن

تُحمّل الشاحنة، ثم تمرّ بمحطة الوزن. يرفع السائق وثيقة الوزن عبر التطبيق.

إرفاق البايان (Bayan al-Naql)

يُرفق المشرف وثيقة البايان. لا يمكن رفع قائمة ما بعد التحميل حتى تُرفق هذه الوثيقة — هي البوابة الإلزامية للمرحلة التالية.

قائمة ما بعد التحميل (Post-loading Checklist)

بعد البايان، يُكمل السائق قائمة ما بعد التحميل (تتضمّن البايان ووثيقة الوزن). عند اعتمادها يُمنح إذن بالتحرّك (Cleared to move).

في الطريق (In Transit)

تبدأ الحركة. يتتبّع النظام موقع المركبة لحظياً عبر تكامل Afaqy (لو كان IMEI الجهاز مرتبطاً بالمركبة).

الوصول والتفريغ

عند الوصول إلى نقطة التسليم، يبدأ التفريغ.

التسليم والإثبات

يُكمل السائق التسليم مع التوقيع وصورة إثبات التسليم. تُختتم الرحلة.

التسوية (Settlement)

تُحسب التسوية المالية للرحلة: الإيرادات ناقص (الوقود، الصيانة، المخالفات، التأمين، الإهلاك، مستحقات السائق، ومصاريف أخرى) = إجمالي الربح + هامش الربح. كما يُحدَّث تقييم السائق.

الطوابع الزمنية الموثّقة (16 نقطة)

يحفظ النظام هذه الطوابع لكل رحلة لأغراض التقارير:

الطابع	المعنى
`dispatchedAt`	إرسال الرحلة للسائق
`acceptedAt`	قبول السائق
`arrivedLoadingAt`	الوصول لموقع التحميل
`preLoadingChecklistAt`	رفع قائمة ما قبل التحميل
`preLoadingApprovedAt`	اعتماد المشرف للقائمة
`loadingStartedAt`	بدء التحميل
`atWeightStationAt`	الوصول لمحطة الوزن
`weightDocumentUploadedAt`	رفع وثيقة الوزن
`bayanAlNaqlAttachedAt`	إرفاق البايان
`postLoadingChecklistAt`	رفع قائمة ما بعد التحميل
`clearedToMoveAt`	الإذن بالتحرّك
`inTransitAt`	بدء الحركة
`arrivedDeliveryAt`	الوصول للتسليم
`unloadingStartedAt`	بدء التفريغ
`deliveredAt`	التسليم
`completedAt`	إكمال الرحلة

نقاط أساسية

القوائم اثنتان: pre_loading (جاهزية المركبة قبل التحميل) وpost_loading (البايان + وثيقة الوزن بعد التحميل).
البايان يسبق قائمة ما بعد التحميل دائماً — لا يمكن للسائق رفعها قبله.
الإيراد يُحسب لكل رحلة من route.quantityUnit وسعر الوحدة — لا يُجزّأ إجمالي العقد.
حالة المركبة تتزامن تلقائياً مع تقدّم الرحلة.