Update: 2026-07-13 22:23:21

backend/transit/trip/board_passenger.php

@@ -4,6 +4,8 @@
 
 require_once __DIR__ . '/../../transit/connect_app.php';
 
+if ($transit_user_role !== 'driver') jsonError('Only drivers can access this endpoint', 403);
+
 $stopId      = (int)filterRequest('stop_id');
 $passengerId = filterRequest('passenger_id');
 
@@ -11,7 +13,16 @@ if (!$stopId || !$passengerId) {
     jsonError('Missing parameters', 400);
 }
 
-// 1. تحقق من السائق ورحلته الحالية
+// استخرج سجل السائق من JWT — لا نثق بأي معرّف سائق من العميل
+$driverRow = $transit_con->prepare(
+    "SELECT id FROM transit_drivers WHERE main_driver_id=? AND status='active' LIMIT 1"
+);
+$driverRow->execute([(string)$transit_user_id]);
+$driverRec = $driverRow->fetch();
+if (!$driverRec) jsonError('Driver not found or not active', 403);
+$transit_driver_id = (int)$driverRec['id'];
+
+// 1. تحقق من رحلة السائق الحالية
 $stTrip = $transit_con->prepare(
     "SELECT id, org_id FROM transit_trips WHERE driver_id=? AND status='started' LIMIT 1"
 );
@@ -55,27 +66,11 @@ $stInsert = $transit_con->prepare(
 );
 $stInsert->execute([$tripId, $enrollId, $stopId]);
 
-// 5. إرسال إشعار FCM لولي الأمر (إن وُجد)
-$stGuard = $transit_con->prepare(
-    "SELECT guardian_passenger_id FROM transit_guardians 
-     WHERE enrollment_id=? AND notify_board=1"
-);
-$stGuard->execute([$enrollId]);
-$guardians = $stGuard->fetchAll(PDO::FETCH_COLUMN);
+// 5. إرسال إشعار صعود — لولي الأمر (إن وُجد) وللطالب نفسه (تأكيد بمحفظته)
+$title = "صعود الحافلة 🚌";
+$body  = "لقد صعد " . ($enroll['member_name'] ?? 'الطالب') . " إلى الحافلة بنجاح.";
 
-// إذا كان الطالب نفسه يملك التطبيق، أرسل له أيضاً (للتأكيد في محفظته)
-$guardians[] = $passengerId;
-
-if (!empty($guardians)) {
-    $title = "صعود الحافلة 🚌";
-    $body  = "لقد صعد " . ($enroll['member_name'] ?? 'الطالب') . " إلى الحافلة بنجاح.";
-    
-    // إرسال الإشعار باستخدام دالة الإشعارات الأساسية بالنظام (عبر passenger_id)
-    foreach ($guardians as $gId) {
-        // يمكنك هنا مناداة دالة sendFCMToPassenger الموجودة في functions.php الأساسية
-        // للتبسيط، نكتفي بافتراض وجود دالة transitSendNotificationToPassenger أو نستخدم FCM_Engine
-        transitSendNotificationToPassenger($gId, $title, $body);
-    }
-}
+transitNotifyGuardians($enrollId, 'board', $title, $body);
+transitSendNotificationToPassenger((string)$passengerId, $title, $body, ['type' => 'transit_boarded']);
 
 jsonSuccess(['boarded' => true]);

backend/transit/trip/cancel.php

@@ -0,0 +1,47 @@
+<?php
+// transit/trip/cancel.php — المشرف يلغي رحلة (قبل بدئها عادة — عطل مركبة، غياب سائق...)
+// POST: trip_id, [reason]
+
+require_once __DIR__ . '/../../transit/connect_admin.php';
+
+$tripId = filterRequest('trip_id', 'int');
+if (!$tripId) jsonError('trip_id is required', 400);
+
+$st = $transit_con->prepare(
+    "SELECT t.id, t.status, t.route_id, r.name_ar AS route_name
+     FROM transit_trips t JOIN transit_routes r ON r.id = t.route_id
+     WHERE t.id=? AND t.org_id=? LIMIT 1"
+);
+$st->execute([$tripId, $transit_org_id]);
+$trip = $st->fetch();
+if (!$trip) jsonError('Trip not found or access denied', 404);
+
+if (in_array($trip['status'], ['completed', 'cancelled'])) {
+    jsonError('Trip is already ' . $trip['status'], 409);
+}
+
+$wasStarted = $trip['status'] === 'started';
+
+$transit_con->prepare(
+    "UPDATE transit_trips SET status='cancelled', delay_reason=?, updated_at=NOW() WHERE id=?"
+)->execute([filterRequest('reason'), $tripId]);
+
+// إن كانت الرحلة قد بدأت فعلياً، أوقف بث الباص وحرّر ملكية الرحلة فوراً
+if ($wasStarted) {
+    transitClearTripOwner($tripId);
+    global $redisLocation;
+    if ($redisLocation) $redisLocation->del("transit:trip:{$tripId}:pos");
+    global $redis;
+    if ($redis) $redis->del("transit:trip:{$tripId}:status");
+}
+
+transitSendTopicNotification(
+    transitRouteTopic((int)$trip['route_id']),
+    'تم إلغاء الرحلة',
+    'أُلغيت رحلة خط ' . $trip['route_name'] . ' اليوم.',
+    ['type' => 'transit_cancelled', 'trip_id' => (string)$tripId]
+);
+
+appLog("[TRANSIT][TRIP][cancel] trip #{$tripId} org#{$transit_org_id} cancelled by admin #{$transit_admin_id}");
+
+jsonSuccess(['trip_id' => $tripId, 'status' => 'cancelled'], 'Trip cancelled');

backend/transit/trip/end.php

@@ -18,7 +18,9 @@ if (!$driverRec) jsonError('Driver not found or not active', 403);
 $driverId = (int)$driverRec['id'];
 
 $st = $transit_con->prepare(
-    "SELECT id, route_id, status FROM transit_trips WHERE id=? AND driver_id=? LIMIT 1"
+    "SELECT t.id, t.route_id, t.status, r.name_ar AS route_name, r.direction
+     FROM transit_trips t JOIN transit_routes r ON r.id = t.route_id
+     WHERE t.id=? AND t.driver_id=? LIMIT 1"
 );
 $st->execute([$tripId, $driverId]);
 $trip = $st->fetch();
@@ -38,4 +40,19 @@ transitClearTripOwner($tripId);
 global $redisLocation;
 if ($redisLocation) $redisLocation->del("transit:trip:{$tripId}:pos");
 
+// إشعار أولياء الأمور — وصول (ذهاب) أو عودة (إياب) حسب اتجاه الخط
+$guardEvent = ($trip['direction'] === 'inbound') ? 'return' : 'arrive';
+$guardTitle = ($guardEvent === 'return') ? 'عاد الباص 🏠' : 'وصل الباص 🎓';
+$guardBody  = ($guardEvent === 'return')
+    ? 'وصل باص خط ' . $trip['route_name'] . ' إلى محطته الأخيرة.'
+    : 'وصل باص خط ' . $trip['route_name'] . ' إلى وجهته.';
+
+$stGuardEnroll = $transit_con->prepare(
+    "SELECT id FROM transit_enrollments WHERE preferred_route_id=? AND status='active'"
+);
+$stGuardEnroll->execute([(int)$trip['route_id']]);
+foreach ($stGuardEnroll->fetchAll(PDO::FETCH_COLUMN) as $enrollId) {
+    transitNotifyGuardians((int)$enrollId, $guardEvent, $guardTitle, $guardBody);
+}
+
 jsonSuccess(['trip_id' => $tripId, 'status' => 'completed'], 'Trip completed');

backend/transit/trip/start.php

@@ -56,4 +56,18 @@ transitSendTopicNotification(
     ['type' => 'transit_started', 'trip_id' => (string)$tripId]
 );
 
+// إشعار أولياء أمور جميع الأعضاء المسجَّلين على هذا الخط بانطلاق الباص
+$stGuardEnroll = $transit_con->prepare(
+    "SELECT id FROM transit_enrollments WHERE preferred_route_id=? AND status='active'"
+);
+$stGuardEnroll->execute([(int)$trip['route_id']]);
+foreach ($stGuardEnroll->fetchAll(PDO::FETCH_COLUMN) as $enrollId) {
+    transitNotifyGuardians(
+        (int)$enrollId,
+        'depart',
+        'انطلق الباص 🚌',
+        'انطلق باص خط ' . $trip['route_name'] . ' الآن.'
+    );
+}
+
 jsonSuccess(['trip_id' => $tripId, 'status' => 'started', 'started_at' => date('Y-m-d H:i:s')], 'Trip started');

backend/transit/trip/stop_passengers.php

@@ -4,10 +4,21 @@
 
 require_once __DIR__ . '/../../transit/connect_app.php';
 
+if ($transit_user_role !== 'driver') jsonError('Only drivers can access this endpoint', 403);
+
 $stopId = (int)filterRequest('stop_id');
 if (!$stopId) jsonError('Missing stop_id', 400);
 
-// 1. تحقق من السائق ورحلته
+// استخرج سجل السائق من JWT — لا نثق بأي معرّف سائق من العميل
+$driverRow = $transit_con->prepare(
+    "SELECT id FROM transit_drivers WHERE main_driver_id=? AND status='active' LIMIT 1"
+);
+$driverRow->execute([(string)$transit_user_id]);
+$driverRec = $driverRow->fetch();
+if (!$driverRec) jsonError('Driver not found or not active', 403);
+$transit_driver_id = (int)$driverRec['id'];
+
+// 1. تحقق من رحلة السائق
 $stTrip = $transit_con->prepare(
     "SELECT id, org_id FROM transit_trips WHERE driver_id=? AND status='started' LIMIT 1"
 );