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

تشغيل الإدارة والمنصة

هذا الدليل يغطي الأسطح الإدارية الجديدة التي أصبحت جزءاً من سير العمل اليومي:

  • /waitlist لمراجعة طلبات الشركات القادمة من صفحات الانتظار
  • /settings لإدارة وضع الصيانة وتشغيل مهام الصيانة يدوياً
  • /analytics لتصدير مؤشرات المنصة إلى CSV أو JSON

قائمة الانتظار​

استخدم صفحة /waitlist عندما تصل طلبات شركات جديدة من صفحات التسويق أو من بوابات التسجيل التجريبية.

ما الذي يمكنك فعله؟​

  • البحث بالبريد أو اسم الشركة أو الهاتف
  • تصفية الطلبات حسب الحالة
  • تحديث الحالة إلى:
    • contacted
    • converted
    • rejected
  • تصدير القائمة الحالية إلى CSV

ملاحظات تشغيلية​

  • الواجهة تعتمد على GET /api/waitlist و PATCH /api/waitlist
  • الوصول محمي بصلاحيات الإدارة، مع استمرار دعم التوكن القديم للعمليات الخلفية عند الحاجة
  • إذا لم يكن جدول waitlist موجوداً في بيئة ما، ستظهر رسالة توضح أن الجدول غير مهيأ

وضع الصيانة​

استخدم صفحة /settings عندما تحتاج إلى:

  • تفعيل وضع صيانة معلن
  • تعديل الرسالة الظاهرة أثناء الصيانة
  • تشغيل مهام الصيانة الدورية يدوياً
  • مراجعة آخر سجلات التشغيل

ما الذي يتم تخزينه؟​

  • إعدادات وضع الصيانة في جدول platform_maintenance_settings
  • سجل التشغيل في جدول platform_maintenance_runs

مهام الصيانة اليدوية الحالية​

  • run_periodic_cleanup
  • refresh_company_stats
  • تدقيق دورة حياة الرحلات من دون تغيير حالتها: يحصي الرحلات المجدولة التي تجاوزت موعد الانطلاق، والرحلات النشطة التي تجاوز موعد وصولها 24 ساعة بلا وصول فعلي، ويضيف عدد الحالات التي تحتاج مراجعة إلى ملخص التشغيل
  • إلغاء الحجوزات المعلقة المنتهية

حالة الرحلة حقيقة تشغيلية يملكها المشغل. لا يجوز لمهمة زمنية تحويل SCHEDULED مباشرةً إلى DEPARTED لأنها تتجاوز فحص الجاهزية وتسلسل BOARDING وتكليف السائق وسجل أحداث التشغيل. نفّذ التصحيح من غرفة تشغيل الرحلة وعبر transition_company_trip فقط. لا تُصلح السجلات القديمة بتحديث جماعي قبل تحديد الشركة والرحلات المستهدفة وسياسة الوصول/الإكمال الآمنة.

في التحقق القرائي للإنتاج بتاريخ 2026-08-21 لم توجد رحلة SCHEDULED متأخرة، لكن وُجدت 9,194 رحلة نشطة قديمة بلا وصول فعلي ضمن شركة واحدة نشطة وغير تجريبية. هذا دين بيانات معروف، وليس رحلة صالحة لإغلاق آلي؛ يبقى بحاجة إلى خطة تسوية محكومة ومنفصلة.

تصدير التحليلات​

تدعم صفحة /analytics الآن التصدير من الواجهة مباشرة.

الصيغ المتاحة​

  • CSV للتقارير التشغيلية السريعة
  • JSON للتكاملات الداخلية أو التحليل الإضافي

الصلاحيات​

  • عرض التحليلات يحتاج analytics.view
  • التصدير يحتاج analytics.export

التحقق بعد النشر​

بعد أي نشر يمس هذه الأسطح:

  1. افتح /waitlist وتأكد من ظهور الحالة الفارغة أو الصفوف بشكل صحيح.
  2. افتح /settings وتأكد من إمكان تحميل إعدادات الصيانة وسجل التشغيل.
  3. شغّل تصدير CSV من /analytics وتأكد من تنزيل الملف.
  4. راجع أن الترحيل 00109_admin_platform_operations.sql طُبّق في البيئة المستهدفة.