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/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');