إنتقل إلى المحتوى الرئيسي

تتبع الرحلات

هذا المرجع يشرح كيف تعمل شاشة تتبع الرحلات الحالية في لوحة الشركات، وما الذي تعنيه الحالات المختلفة للرحلات والبيانات الميدانية.

الغرض​

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

أين تظهر؟​

  • صفحة التتبع في لوحة الشركات
  • بعض بيانات التتبع نفسها قد تأتي من تطبيق السائق أو آخر موقع معروف للحافلة

ما الذي تعرضه الصفحة؟​

  • عدد الرحلات النشطة
  • إحصاءات الرحلات ذات التتبع المباشر أو المتأخر أو غير المتاح
  • اسم السائق والحافلة عند توفرهما
  • وقت المغادرة، آخر تحديث، السرعة، و ETA عندما تكون البيانات متاحة
  • حالة التتبع مع رسالة تفسيرية واضحة لكل رحلة

مخطط الحالات​

flowchart TD
    A["رحلة نشطة"] --> B{"هل توجد بيانات تتبع؟"}
    B -->|نعم، ومحدثة| C["مباشر (live)"]
    B -->|نعم، لكنها قديمة| D["متأخر (stale)"]
    B -->|لا| E["غير متوفر (unavailable)"]
    C --> F["يمكن الاعتماد على الخريطة والمؤشرات الحالية"]
    D --> G["تظهر آخر بيانات مع تنبيه بأن التتبع غير حديث"]
    E --> H["يستخدم المشغل بيانات الرحلة الأساسية فقط ويؤكد ميدانياً عند الحاجة"]

مصفوفة الحالات​

الحالةماذا تعنيما الذي يتوقعه المشغل
لا توجد رحلات نشطةلا توجد رحلات مناسبة للعرض حالياًتظهر حالة فارغة واضحة بدلاً من قائمة أو خريطة مضللة
مباشرالتتبع نشط والبيانات محدثةيمكن متابعة الموقع والمؤشرات الحالية بثقة تشغيلية
متأخرآخر موقع معروف موجود لكن البيانات ليست حديثةلا يعتمد على ETA أو الموقع على أنه لحظي، وقد يحتاج متابعة مع السائق
غير متوفرلا توجد بيانات تتبع كافية حالياًيعتمد على تفاصيل الرحلة الأساسية فقط ويتعامل مع التتبع على أنه غير متاح
فشل تحميلتعذر تحميل الرحلات أو تحديثهايعيد المحاولة أو يراجع حالة الجلسة والاتصال

الحالات التشغيلية داخل القائمة​

إلى جانب حالة التتبع، تعرض القائمة أيضاً حالة الرحلة التشغيلية نفسها:

  • مجدولة
  • صعود الركاب
  • في الطريق
  • مكتملة
  • ملغاة

هذه الحالة ليست بديلاً عن حالة التتبع. قد تكون الرحلة في الطريق لكن التتبع متأخر أو غير متوفر.

الصلاحيات والتوفر​

  • الصفحة مخصصة للمشغلين داخل لوحة الشركة
  • ما يظهر فيها يجب أن يبقى ضمن حدود الشركة الحالية فقط
  • عدم ظهور بعض الإجراءات أو التفاصيل قد يكون سببه صلاحيات الحساب أو نقص البيانات الفعلية، وليس بالضرورة خطأ في النظام

حالات الفشل والبدائل​

  • إذا تعذر جلب البيانات، تبقى الشاشة مرجعاً ناقصاً مؤقتاً ولا يجب اعتبارها مرجعاً لحظياً
  • إذا ظهرت الرحلة بحالة متأخر، فآخر تحديث معروف أهم من موضع الخريطة نفسه
  • إذا ظهرت بحالة غير متوفر، يجب استخدام مسارات التشغيل الأخرى مثل التواصل مع السائق أو مراجعة تفاصيل الرحلة
  • إذا كانت الخريطة غير متاحة مؤقتاً، لا يعني هذا إلغاء الرحلة أو فقدان بيانات الرحلة الأساسية

ما الذي لا يجب افتراضه؟​

  • لا تفترض أن كل رحلة تمتلك تتبعاً مباشراً دائماً
  • لا تفترض أن ETA متاح أو دقيق في كل الحالات
  • لا تفترض أن غياب بيانات الموقع يعني غياب الرحلة نفسها

APIs المرتبطة​

  • GET /api/tracking/active-trips

source of truth​

المرجع النهائي هو شاشة التتبع نفسها، مكوّن قائمة الرحلات النشطة، ومسار API الخاص بالرحلات النشطة في لوحة الشركات.