chore: استيراد أولي من سيرو (ecfe7568) — بلا أي تعديل

نسخة كاملة من مستودع سيرو عند ecfe7568 لتكون أساس تطبيق «انطلق».
نُسخ المتعقَّب في git فقط (12,509 ملفاً / 302 م.ب) بـ git archive، لا
`cp -r` — فاستُثنيت تلقائياً مخلفات البناء (build · node_modules ·
.dart_tool · .gradle · Pods ≈ 10.7 غ.ب) وكل ما يستثنيه .gitignore.

هذا الكوميت **بلا أي تعديل عمداً** حتى يكون كل ما يليه فرقاً مقروءاً
مقابل سيرو الأصلي. سيرو نفسه لم يُمسّ.

⚠️ لا يبني بعد: `.env` و`lib/env/env.g.dart` غير متعقَّبين في سيرو (وهذا
صحيح — أسرار لكل مستأجر). كل تطبيق فلاتر هنا يحتاج .env خاصاً بانطلق ثم
توليد env.g.dart عبر build_runner. لا تُنسخ أسرار سيرو.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

backend/transit/trip/board_passenger.php

@@ -0,0 +1,72 @@
+<?php
+// transit/trip/board_passenger.php — سائق الباص يسجل صعود راكب (عبر QR أو يدوي)
+// POST: trip_id (from active trip), stop_id, passenger_id
+
+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');
+
+if (!$stopId || !$passengerId) {
+    jsonError('Missing parameters', 400);
+}
+
+// استخرج سجل السائق من JWT (Redis read-through) — لا نثق بأي معرّف سائق من العميل
+$driverRec = transitResolveDriver((string)$transit_user_id);
+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"
+);
+$stTrip->execute([$transit_driver_id]);
+$trip = $stTrip->fetch();
+
+if (!$trip) {
+    jsonError('لا توجد رحلة نشطة حالياً لتسجيل الصعود', 403);
+}
+
+$tripId = (int)$trip['id'];
+$orgId  = (int)$trip['org_id'];
+
+// 2. تأكد من أن الراكب مشترك وفعال في هذه المؤسسة
+$stEnroll = $transit_con->prepare(
+    "SELECT id, member_name FROM transit_enrollments 
+     WHERE org_id=? AND passenger_id=? AND status='active' LIMIT 1"
+);
+$stEnroll->execute([$orgId, $passengerId]);
+$enroll = $stEnroll->fetch();
+
+if (!$enroll) {
+    jsonError('هذا الراكب غير مسجل أو اشتراكه غير فعال', 403);
+}
+
+$enrollId = (int)$enroll['id'];
+
+// 3. تأكد أنه لم يُسجل صعوده من قبل في هذه الرحلة
+$stCheck = $transit_con->prepare(
+    "SELECT id FROM transit_boardings WHERE trip_id=? AND enrollment_id=? LIMIT 1"
+);
+$stCheck->execute([$tripId, $enrollId]);
+if ($stCheck->fetch()) {
+    jsonError('تم تسجيل صعود هذا الراكب مسبقاً في هذه الرحلة', 400);
+}
+
+// 4. تسجيل الصعود
+$stInsert = $transit_con->prepare(
+    "INSERT INTO transit_boardings (trip_id, enrollment_id, stop_id, boarded_at, method) 
+     VALUES (?, ?, ?, NOW(), 'qr')"
+);
+$stInsert->execute([$tripId, $enrollId, $stopId]);
+
+// 5. إرسال إشعار صعود — لولي الأمر (إن وُجد) وللطالب نفسه (تأكيد بمحفظته)
+$title = "صعود الحافلة 🚌";
+$body  = "لقد صعد " . ($enroll['member_name'] ?? 'الطالب') . " إلى الحافلة بنجاح.";
+
+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/delay.php

@@ -0,0 +1,38 @@
+<?php
+// transit/trip/delay.php — السائق يبلغ عن تأخير
+
+require_once __DIR__ . '/../../transit/connect_app.php';
+
+if ($transit_user_role !== 'driver') jsonError('Only drivers can access this endpoint', 403);
+
+$tripId = filterRequest('trip_id', 'int');
+$delay  = min((int)filterRequest('delay_minutes'), 120);
+$reason = filterRequest('reason');
+if (!$tripId || $delay <= 0) jsonError('trip_id and delay_minutes are required', 400);
+
+// استخرج سجل السائق من JWT (Redis read-through)
+$driverRec = transitResolveDriver((string)$transit_user_id);
+if (!$driverRec) jsonError('Driver not found or not active', 403);
+$driverId = (int)$driverRec['id'];
+
+$st = $transit_con->prepare(
+    "SELECT t.id, 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.driver_id=? AND t.status='started' LIMIT 1"
+);
+$st->execute([$tripId, $driverId]);
+$trip = $st->fetch();
+if (!$trip) jsonError('Active trip not found', 404);
+
+$transit_con->prepare(
+    "UPDATE transit_trips SET delay_minutes=?, delay_reason=?, updated_at=NOW() WHERE id=?"
+)->execute([$delay, $reason, $tripId]);
+
+transitSendTopicNotification(
+    transitRouteTopic((int)$trip['route_id']),
+    'تأخير في الباص',
+    'خط ' . $trip['route_name'] . ' متأخر ' . $delay . ' دقيقة' . ($reason ? " — $reason" : ''),
+    ['type' => 'transit_delay', 'trip_id' => (string)$tripId, 'delay' => (string)$delay]
+);
+
+jsonSuccess(['delay_minutes' => $delay], 'Delay reported and passengers notified');

backend/transit/trip/end.php

@@ -0,0 +1,54 @@
+<?php
+// transit/trip/end.php — السائق ينهي الرحلة
+
+require_once __DIR__ . '/../../transit/connect_app.php';
+
+if ($transit_user_role !== 'driver') jsonError('Only drivers can access this endpoint', 403);
+
+$tripId = filterRequest('trip_id', 'int');
+if (!$tripId) jsonError('trip_id is required', 400);
+
+// استخرج سجل السائق من JWT (Redis read-through)
+$driverRec = transitResolveDriver((string)$transit_user_id);
+if (!$driverRec) jsonError('Driver not found or not active', 403);
+$driverId = (int)$driverRec['id'];
+
+$st = $transit_con->prepare(
+    "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();
+
+if (!$trip) jsonError('Trip not found', 404);
+if ($trip['status'] !== 'started') jsonError('Trip is not in started state', 409);
+
+$transit_con->prepare(
+    "UPDATE transit_trips SET status='completed', completed_at=NOW(), updated_at=NOW() WHERE id=?"
+)->execute([$tripId]);
+
+global $redis;
+if ($redis) $redis->del("transit:trip:{$tripId}:status");
+
+// موقع الباص + ملكية الرحلة على Redis سيرفر الموقع
+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/live.php

@@ -0,0 +1,53 @@
+<?php
+// transit/trip/live.php — الراكب يسأل عن موقع الباص الحي
+
+require_once __DIR__ . '/../../transit/connect_app.php';
+
+$tripId  = filterRequest('trip_id', 'int');
+$routeId = filterRequest('route_id', 'int');
+
+if (!$tripId && $routeId) {
+    $st = $transit_con->prepare(
+        "SELECT id FROM transit_trips WHERE route_id=? AND trip_date=? AND status='started' LIMIT 1"
+    );
+    $st->execute([$routeId, date('Y-m-d')]);
+    $row = $st->fetch();
+    $tripId = $row ? (int)$row['id'] : 0;
+}
+
+if (!$tripId) jsonError('No active trip found', 404);
+
+$st = $transit_con->prepare(
+    "SELECT t.id, t.org_id, t.status, t.delay_minutes, t.current_stop_seq, t.started_at,
+            r.name_ar AS route_name, r.polyline AS route_polyline, sc.departure_time, d.name AS driver_name
+     FROM transit_trips t
+     JOIN transit_routes    r  ON r.id  = t.route_id
+     JOIN transit_schedules sc ON sc.id = t.schedule_id
+     JOIN transit_drivers   d  ON d.id  = t.driver_id
+     WHERE t.id=? LIMIT 1"
+);
+$st->execute([$tripId]);
+$trip = $st->fetch();
+if (!$trip) jsonError('Trip not found', 404);
+
+// الراكب يحتاج عضوية نشطة في مؤسسة هذا الخط قبل رؤية موقع الباص
+$chk = $transit_con->prepare(
+    "SELECT id FROM transit_enrollments WHERE org_id=? AND passenger_id=? AND status='active' LIMIT 1"
+);
+$chk->execute([$trip['org_id'], $transit_user_id]);
+if (!$chk->fetch()) jsonError('Active enrollment required', 403);
+
+$stStops = $transit_con->prepare(
+    "SELECT s.id, s.sequence, s.name_ar, s.latitude, s.longitude,
+            s.geofence_radius, s.eta_offset_min, s.is_major
+     FROM transit_stops s
+     JOIN transit_trips t ON t.route_id = s.route_id
+     WHERE t.id=? ORDER BY s.sequence ASC"
+);
+$stStops->execute([$tripId]);
+
+jsonSuccess([
+    'trip'         => $trip,
+    'bus_position' => transitGetBusPosition($tripId),
+    'stops'        => $stStops->fetchAll(),
+]);

backend/transit/trip/start.php

@@ -0,0 +1,69 @@
+<?php
+// transit/trip/start.php — السائق يبدأ الرحلة
+
+require_once __DIR__ . '/../../transit/connect_app.php';
+
+if ($transit_user_role !== 'driver') jsonError('Only drivers can access this endpoint', 403);
+
+requireTransitFields(['trip_id', 'lat', 'lng']);
+$tripId = filterRequest('trip_id', 'int');
+$lat    = (float)filterRequest('lat');
+$lng    = (float)filterRequest('lng');
+
+// استخرج سجل السائق من JWT (Redis read-through) — تحقق أن الرحلة تخصه
+$driverRec = transitResolveDriver((string)$transit_user_id);
+if (!$driverRec) jsonError('Driver not found or not active', 403);
+$driverId = (int)$driverRec['id'];
+
+$st = $transit_con->prepare(
+    "SELECT t.id, t.route_id, t.status, 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.driver_id=? LIMIT 1"
+);
+$st->execute([$tripId, $driverId]);
+$trip = $st->fetch();
+
+if (!$trip) jsonError('Trip not found', 404);
+if ($trip['status'] === 'started')   jsonError('Trip already started', 409);
+if ($trip['status'] === 'completed') jsonError('Trip already completed', 409);
+if ($trip['status'] === 'cancelled') jsonError('Trip was cancelled', 409);
+
+$transit_con->prepare(
+    "UPDATE transit_trips SET status='started', started_at=NOW(), current_stop_seq=1 WHERE id=?"
+)->execute([$tripId]);
+
+transitUpdateBusPosition($tripId, $lat, $lng);
+
+// تخزين ملكية الرحلة — يتحقق منها driver_socket قبل أي بثّ حي للراكبين
+// transit_user_id هو main_driver_id بالفعل (يُستخرج من JWT السائق)
+transitSetTripOwner($tripId, (string)$transit_user_id, (int)$trip['route_id']);
+
+global $redis;
+if ($redis) {
+    $redis->set("transit:trip:{$tripId}:status", 'started');
+    $redis->expire("transit:trip:{$tripId}:status", 86400);
+}
+
+transitSendTopicNotification(
+    transitRouteTopic((int)$trip['route_id']),
+    'الباص انطلق الآن',
+    'خط ' . $trip['route_name'] . ' بدأ رحلته',
+    ['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

@@ -0,0 +1,49 @@
+<?php
+// transit/trip/stop_passengers.php — جلب قائمة ركاب المحطة (للسائق)
+// POST: stop_id
+
+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);
+
+// استخرج سجل السائق من JWT (Redis read-through) — لا نثق بأي معرّف سائق من العميل
+$driverRec = transitResolveDriver((string)$transit_user_id);
+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"
+);
+$stTrip->execute([$transit_driver_id]);
+$trip = $stTrip->fetch();
+
+if (!$trip) {
+    jsonError('لا توجد رحلة نشطة حالياً', 403);
+}
+
+$tripId = (int)$trip['id'];
+$orgId  = (int)$trip['org_id'];
+
+// 2. جلب جميع الركاب المشتركين الذين محطتهم المفضلة هي هذه المحطة (أو جميع ركاب الخط إن لم يكن هناك تخصيص)
+// سنكتفي بجلب المخصصين لهذه المحطة + عرض حالة صعودهم
+$stPass = $transit_con->prepare(
+    "SELECT e.passenger_id, e.student_id, e.member_name AS name,
+            (SELECT COUNT(id) FROM transit_boardings b 
+             WHERE b.trip_id = ? AND b.enrollment_id = e.id) AS is_boarded
+     FROM transit_enrollments e
+     WHERE e.org_id = ? AND e.status = 'active' AND e.preferred_stop_id = ?"
+);
+$stPass->execute([$tripId, $orgId, $stopId]);
+$passengers = $stPass->fetchAll();
+
+// تحويل 0/1 إلى true/false
+foreach ($passengers as &$p) {
+    $p['is_boarded'] = (bool)$p['is_boarded'];
+}
+unset($p);
+
+jsonSuccess($passengers);

backend/transit/trip/today.php

@@ -0,0 +1,67 @@
+<?php
+// transit/trip/today.php — السائق يجلب رحلاته اليوم (تُنشأ تلقائياً من الجداول)
+
+require_once __DIR__ . '/../../transit/connect_app.php';
+
+if ($transit_user_role !== 'driver') jsonError('Only drivers can access this endpoint', 403);
+
+// استخرج سجل السائق من JWT (Redis read-through) — لا نثق بـ driver_transit_id من العميل
+$driver = transitResolveDriver((string)$transit_user_id);
+if (!$driver) jsonError('Driver not found or not active — activate your account first', 403);
+$driverTransitId = (int)$driver['id'];
+
+$today = date('Y-m-d');
+
+// أنشئ رحلات اليوم من الجداول النشطة إن لم تُنشأ بعد
+$stScheds = $transit_con->prepare(
+    "SELECT id AS schedule_id, route_id, vehicle_id, days_mask
+     FROM transit_schedules
+     WHERE driver_id=? AND org_id=? AND is_active=1
+       AND valid_from <= ? AND (valid_until IS NULL OR valid_until >= ?)"
+);
+$stScheds->execute([$driverTransitId, $driver['org_id'], $today, $today]);
+
+foreach ($stScheds->fetchAll() as $sch) {
+    if (!transitDayActive((int)$sch['days_mask'])) continue;
+    $ex = $transit_con->prepare("SELECT id FROM transit_trips WHERE schedule_id=? AND trip_date=? LIMIT 1");
+    $ex->execute([$sch['schedule_id'], $today]);
+    if (!$ex->fetch()) {
+        $transit_con->prepare(
+            "INSERT INTO transit_trips
+             (schedule_id, route_id, org_id, driver_id, vehicle_id, trip_date, status)
+             VALUES (?,?,?,?,?,?,'scheduled')"
+        )->execute([
+            $sch['schedule_id'], $sch['route_id'], $driver['org_id'],
+            $driverTransitId, $sch['vehicle_id'], $today,
+        ]);
+    }
+}
+
+// اجلب رحلات اليوم مع التفاصيل
+$stTrips = $transit_con->prepare(
+    "SELECT t.id, t.route_id, t.status, t.delay_minutes, t.current_stop_seq,
+            t.started_at, t.completed_at,
+            r.name_ar AS route_name, r.polyline,
+            sc.departure_time,
+            v.plate AS vehicle_plate, v.capacity
+     FROM transit_trips t
+     JOIN transit_routes    r  ON r.id  = t.route_id
+     JOIN transit_schedules sc ON sc.id = t.schedule_id
+     LEFT JOIN transit_vehicles v ON v.id = t.vehicle_id
+     WHERE t.driver_id=? AND t.trip_date=?
+     ORDER BY sc.departure_time ASC"
+);
+$stTrips->execute([$driverTransitId, $today]);
+$trips = $stTrips->fetchAll();
+
+$stStops = $transit_con->prepare(
+    "SELECT sequence, name_ar, latitude, longitude, geofence_radius, eta_offset_min
+     FROM transit_stops WHERE route_id=? ORDER BY sequence ASC"
+);
+foreach ($trips as &$trip) {
+    $stStops->execute([$trip['route_id']]);
+    $trip['stops'] = $stStops->fetchAll();
+}
+unset($trip);
+
+jsonSuccess(['date' => $today, 'trips' => $trips]);