feat: استيراد كود سيرو إلى تريبز (سيرو @ecfe7568) — بلا تعديل

قرار المالك 2026-07-27: باك إند سيرو PHP هو المعتمد، وتطبيقاته المجرّبة
ميدانياً تحل محل إعادة البناء المؤرشفة. سيرو نفسه لم يُمسّ.

الخريطة:
  backend · payment_server · loction_server · ride_server ·
  passenger_server · docker · dashboard · stress_test  → الجذر
  siro_rider  → apps/rider          siro_driver  → apps/driver
  siro_admin  → dashboards/admin    siro_service → dashboards/service
  android_bot → apps/android_bot    socialBot    → apps/socialBot

نُسخ المتعقَّب في git سيرو فقط عبر `git archive` (3,198 ملفاً / ~169 م.ب)
لا `cp -r` — فاستُثنيت مخلفات البناء تلقائياً. بلا أي تعديل محتوى عمداً:
كل ما يلي يصير فرقاً مقروءاً مقابل المصدر.

لم يُستورد وسببه: siromove.com (الموقع التسويقي يبقى marketing/ في تريبز،
سيرو فيه 8 ملفات) · docs و planning (تريبز له docs/ الخاص) · deploy.sh
(ليس نشراً على سيرفر بل `git add . && git push origin --all` — فخّ في
مستودع آخر) · transit_dashboard (بانتظار قرار مصير backend-transit و
dashboards/transit-web).

⚠️ لا يبني بعد — ثلاثة نواقص متوقعة ومقصودة:
1. `.env` و `lib/env/env.g.dart` غير متعقَّبين في سيرو (أسرار لكل مستأجر):
   كل تطبيق فلاتر يحتاج .env خاصاً ثم توليد env.g.dart بـ build_runner.
2. إعدادات Firebase (9 ملفات google-services.json و GoogleService-Info.plist)
   يستبعدها .gitignore تريبز — ولكل مستأجر مشروع Firebase خاص أصلاً.
3. apps/driver في سيرو يشير إلى `../../Intaleq/packages/get` خارج المستودع →
   يجب ضمّ الحزم داخله أسوة بـ apps/rider.

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

apps/driver/lib/controller/transit/transit_driver_controller.dart

@@ -0,0 +1,220 @@
+// transit_driver_controller.dart — تحكم وضع الباص (جهة السائق)
+import 'package:geolocator/geolocator.dart';
+import 'package:get/get.dart';
+import 'package:intaleq_maps/intaleq_maps.dart' show LatLng;
+
+import '../../views/widgets/error_snakbar.dart';
+import '../functions/location_controller.dart';
+import 'transit_driver_models.dart';
+import 'transit_driver_service.dart';
+
+class TransitDriverController extends GetxController {
+  bool isCheckingBusDriver = true;
+  bool isBusDriver = false;
+  int? driverTransitId;
+  String orgName = '';
+
+  bool isLoadingTrips = false;
+  List<TransitDriverTrip> todayTrips = [];
+
+  TransitDriverTrip? activeTrip;
+  bool isActionInProgress = false;
+
+  // ── حالة التفعيل ──────────────────────────────────────────────
+  bool isActivating = false;
+  String activationError = '';
+
+  // ── جيوفينس المحطات — آخر محطة تم الإعلان عنها ──────────────
+  int _lastAnnouncedStopSeq = 0;
+
+  @override
+  void onInit() {
+    super.onInit();
+    checkBusDriverStatus();
+  }
+
+  Future<void> checkBusDriverStatus() async {
+    isCheckingBusDriver = true;
+    update();
+
+    final res = await TransitDriverService.checkIsBusDriver();
+    if (res.success && res.data != null) {
+      isBusDriver = res.data!['is_bus_driver'] == true;
+      if (isBusDriver) {
+        driverTransitId =
+            int.tryParse(res.data!['driver_transit_id'].toString());
+        orgName = res.data!['org_name']?.toString() ?? '';
+        await fetchTodayTrips();
+      }
+    }
+    isCheckingBusDriver = false;
+    update();
+  }
+
+  /// تفعيل الحساب بتوكن الدعوة
+  Future<void> activateWithToken(String token) async {
+    if (token.trim().isEmpty) return;
+    isActivating = true;
+    activationError = '';
+    update();
+
+    final res = await TransitDriverService.activateByInviteToken(token.trim());
+    if (res.success) {
+      // أعد فحص الحالة بعد التفعيل
+      await checkBusDriverStatus();
+    } else {
+      activationError = res.message;
+    }
+    isActivating = false;
+    update();
+  }
+
+  Future<void> fetchTodayTrips() async {
+    isLoadingTrips = true;
+    update();
+
+    final res = await TransitDriverService.getTodayTrips();
+    if (res.success) {
+      todayTrips = res.data ?? [];
+      final started = todayTrips.where((t) => t.status == 'started');
+      activeTrip = started.isNotEmpty ? started.first : null;
+
+      // إن كانت هناك رحلة قيد التشغيل بالفعل (إعادة فتح التطبيق)
+      if (activeTrip != null && Get.isRegistered<LocationController>()) {
+        Get.find<LocationController>().setBusMode(
+          enabled: true,
+          tripId: activeTrip!.id,
+          routeId: activeTrip!.routeId,
+        );
+      }
+    }
+    isLoadingTrips = false;
+    update();
+  }
+
+  Future<bool> startTrip(TransitDriverTrip trip) async {
+    if (isActionInProgress) return false;
+    isActionInProgress = true;
+    update();
+
+    LatLng pos = const LatLng(0, 0);
+    if (Get.isRegistered<LocationController>()) {
+      pos = Get.find<LocationController>().myLocation;
+    }
+
+    final res = await TransitDriverService.startTrip(
+      tripId: trip.id,
+      lat: pos.latitude,
+      lng: pos.longitude,
+    );
+
+    if (res.success) {
+      _lastAnnouncedStopSeq = 0;
+      if (Get.isRegistered<LocationController>()) {
+        Get.find<LocationController>().setBusMode(
+          enabled: true,
+          tripId: trip.id,
+          routeId: trip.routeId,
+        );
+      }
+      await fetchTodayTrips();
+    } else {
+      mySnackbarError(res.message);
+    }
+
+    isActionInProgress = false;
+    update();
+    return res.success;
+  }
+
+  Future<bool> endTrip(TransitDriverTrip trip) async {
+    if (isActionInProgress) return false;
+    isActionInProgress = true;
+    update();
+
+    final res = await TransitDriverService.endTrip(tripId: trip.id);
+
+    if (res.success) {
+      _lastAnnouncedStopSeq = 0;
+      if (Get.isRegistered<LocationController>()) {
+        Get.find<LocationController>().setBusMode(enabled: false);
+      }
+      await fetchTodayTrips();
+    } else {
+      mySnackbarError(res.message);
+    }
+
+    isActionInProgress = false;
+    update();
+    return res.success;
+  }
+
+  Future<bool> reportDelay(TransitDriverTrip trip, int minutes,
+      {String? reason}) async {
+    final res = await TransitDriverService.reportDelay(
+      tripId: trip.id,
+      delayMinutes: minutes,
+      reason: reason,
+    );
+    if (!res.success) mySnackbarError(res.message);
+    return res.success;
+  }
+
+  Future<bool> boardPassenger(int stopId, String passengerId) async {
+    final res = await TransitDriverService.boardPassenger(stopId, passengerId);
+    return res.success;
+  }
+
+  Future<List<Map<String, dynamic>>> getStopPassengers(int stopId) async {
+    final res = await TransitDriverService.getStopPassengers(stopId);
+    if (res.success && res.data != null) {
+      return res.data!;
+    }
+    return [];
+  }
+
+  // ── كشف الوصول للمحطات (جيوفينس) ────────────────────────────
+  // تُستدعى من LocationController عند كل تحديث للموقع أثناء وضع الباص
+  void onLocationUpdate(LatLng pos) {
+    if (activeTrip == null || activeTrip!.stops.isEmpty) return;
+
+    final stops = activeTrip!.stops;
+    int? nextSeq;
+
+    // الاتجاه للمحطة التالية بعد آخر معلنة
+    for (final stop in stops) {
+      if (stop.sequence <= _lastAnnouncedStopSeq) continue;
+      final dist = Geolocator.distanceBetween(
+        pos.latitude,
+        pos.longitude,
+        stop.latitude,
+        stop.longitude,
+      );
+      if (dist <= stop.geofenceRadius) {
+        nextSeq = stop.sequence;
+        break;
+      }
+    }
+
+    if (nextSeq != null && nextSeq > _lastAnnouncedStopSeq) {
+      _lastAnnouncedStopSeq = nextSeq;
+      // أرسل التسلسل الحالي عبر السوكيت
+      if (Get.isRegistered<LocationController>()) {
+        final lc = Get.find<LocationController>();
+        lc.emitBusLocationToSocket(pos, 0, 0, currentStopSeq: nextSeq);
+      }
+      update();
+    }
+  }
+
+  // عودة بالمحطة الحالية للعرض
+  TransitStop? get currentStop {
+    if (activeTrip == null || _lastAnnouncedStopSeq == 0) return null;
+    try {
+      return activeTrip!.stops
+          .firstWhere((s) => s.sequence == _lastAnnouncedStopSeq);
+    } catch (_) {
+      return null;
+    }
+  }
+}

apps/driver/lib/controller/transit/transit_driver_models.dart

@@ -0,0 +1,81 @@
+// transit_driver_models.dart — نماذج بيانات مواصلاتي (جهة سائق الباص)
+
+class TransitStopInfo {
+  final int id;
+  final int sequence;
+  final String nameAr;
+  final double latitude;
+  final double longitude;
+  final double geofenceRadius; // متر
+  final int? etaOffsetMin;
+
+  TransitStopInfo({
+    required this.id,
+    required this.sequence,
+    required this.nameAr,
+    required this.latitude,
+    required this.longitude,
+    this.geofenceRadius = 150,
+    this.etaOffsetMin,
+  });
+
+  factory TransitStopInfo.fromJson(Map<String, dynamic> j) => TransitStopInfo(
+        id: int.tryParse(j['id']?.toString() ?? '0') ?? 0,
+        sequence: int.tryParse(j['sequence'].toString()) ?? 0,
+        nameAr: j['name_ar']?.toString() ?? '',
+        latitude: double.tryParse(j['latitude']?.toString() ?? '0') ?? 0,
+        longitude: double.tryParse(j['longitude']?.toString() ?? '0') ?? 0,
+        geofenceRadius: double.tryParse(j['geofence_radius']?.toString() ?? '150') ?? 150,
+        etaOffsetMin: j['eta_offset_min'] == null
+            ? null
+            : int.tryParse(j['eta_offset_min'].toString()),
+      );
+}
+
+// alias للتوافق مع كود الجيوفينس
+typedef TransitStop = TransitStopInfo;
+
+class TransitDriverTrip {
+  final int id;
+  final int routeId;
+  final String status; // scheduled | started | completed | cancelled | no_show
+  final int delayMinutes;
+  final int? currentStopSeq;
+  final String routeName;
+  final String? departureTime;
+  final String? vehiclePlate;
+  final int? capacity;
+  final List<TransitStopInfo> stops;
+
+  TransitDriverTrip({
+    required this.id,
+    required this.routeId,
+    required this.status,
+    required this.delayMinutes,
+    required this.routeName,
+    this.currentStopSeq,
+    this.departureTime,
+    this.vehiclePlate,
+    this.capacity,
+    this.stops = const [],
+  });
+
+  factory TransitDriverTrip.fromJson(Map<String, dynamic> j) => TransitDriverTrip(
+        id: int.tryParse(j['id'].toString()) ?? 0,
+        routeId: int.tryParse(j['route_id']?.toString() ?? '0') ?? 0,
+        status: j['status']?.toString() ?? '',
+        delayMinutes: int.tryParse(j['delay_minutes']?.toString() ?? '0') ?? 0,
+        currentStopSeq: j['current_stop_seq'] == null
+            ? null
+            : int.tryParse(j['current_stop_seq'].toString()),
+        routeName: j['route_name']?.toString() ?? '',
+        departureTime: j['departure_time']?.toString(),
+        vehiclePlate: j['vehicle_plate']?.toString(),
+        capacity: j['capacity'] == null ? null : int.tryParse(j['capacity'].toString()),
+        stops: (j['stops'] is List)
+            ? (j['stops'] as List)
+                .map((s) => TransitStopInfo.fromJson(Map<String, dynamic>.from(s)))
+                .toList()
+            : const [],
+      );
+}

apps/driver/lib/controller/transit/transit_driver_service.dart

@@ -0,0 +1,139 @@
+// transit_driver_service.dart — طبقة الاتصال بـ backend/transit (جهة سائق الباص)
+import '../functions/crud.dart';
+import '../../constant/links.dart';
+import 'transit_driver_models.dart';
+
+class TransitApiResult<T> {
+  final bool success;
+  final T? data;
+  final String message;
+  TransitApiResult(this.success, this.data, this.message);
+}
+
+class TransitDriverService {
+  static String get _base => '${AppLink.server}/transit';
+
+  static String _errMsg(dynamic res) {
+    if (res == 'no_internet') return 'تحقق من اتصالك بالإنترنت';
+    if (res == 'token_expired') return 'انتهت الجلسة، حاول مجدداً';
+    if (res is Map && res['message'] is String) return res['message'];
+    return 'حدث خطأ، حاول مجدداً';
+  }
+
+  /// هل هذا الحساب سائق باص، وما معرّفه في مواصلاتي؟
+  static Future<TransitApiResult<Map<String, dynamic>>> checkIsBusDriver() async {
+    final res = await CRUD().post(link: '$_base/driver/me.php');
+    if (res is Map && res['status'] == 'success' && res['message'] is Map) {
+      return TransitApiResult(true, Map<String, dynamic>.from(res['message']), 'ok');
+    }
+    return TransitApiResult(false, null, _errMsg(res));
+  }
+
+  /// تفعيل حساب السائق بتوكن الدعوة (بعد IDOR fix لا نحتاج driver_transit_id)
+  static Future<TransitApiResult<Map<String, dynamic>>> activateByInviteToken(
+      String inviteToken) async {
+    final res = await CRUD().post(
+      link: '$_base/driver/activate_by_app.php',
+      payload: {'invite_token': inviteToken},
+    );
+    if (res is Map && res['status'] == 'success' && res['message'] is Map) {
+      return TransitApiResult(
+          true, Map<String, dynamic>.from(res['message']), 'ok');
+    }
+    return TransitApiResult(false, null, _errMsg(res));
+  }
+
+  /// رحلات اليوم — الخادم يجلب السائق من JWT، لا نمرر driver_transit_id
+  static Future<TransitApiResult<List<TransitDriverTrip>>> getTodayTrips() async {
+    final res = await CRUD().post(link: '$_base/trip/today.php');
+    if (res is Map && res['status'] == 'success' && res['message'] is Map) {
+      final msg = res['message'] as Map;
+      final list = (msg['trips'] is List)
+          ? (msg['trips'] as List)
+              .map((t) => TransitDriverTrip.fromJson(Map<String, dynamic>.from(t)))
+              .toList()
+          : <TransitDriverTrip>[];
+      return TransitApiResult(true, list, 'ok');
+    }
+    return TransitApiResult(false, null, _errMsg(res));
+  }
+
+  static Future<TransitApiResult<Map<String, dynamic>>> startTrip({
+    required int tripId,
+    required double lat,
+    required double lng,
+  }) async {
+    final res = await CRUD().post(
+      link: '$_base/trip/start.php',
+      payload: {
+        'trip_id': tripId.toString(),
+        'lat': lat.toString(),
+        'lng': lng.toString(),
+      },
+    );
+    if (res is Map && res['status'] == 'success') {
+      return TransitApiResult(true, Map<String, dynamic>.from(res['message'] ?? {}), 'ok');
+    }
+    return TransitApiResult(false, null, _errMsg(res));
+  }
+
+  static Future<TransitApiResult<Map<String, dynamic>>> endTrip({
+    required int tripId,
+  }) async {
+    final res = await CRUD().post(
+      link: '$_base/trip/end.php',
+      payload: {'trip_id': tripId.toString()},
+    );
+    if (res is Map && res['status'] == 'success') {
+      return TransitApiResult(true, Map<String, dynamic>.from(res['message'] ?? {}), 'ok');
+    }
+    return TransitApiResult(false, null, _errMsg(res));
+  }
+
+  static Future<TransitApiResult<void>> reportDelay({
+    required int tripId,
+    required int delayMinutes,
+    String? reason,
+  }) async {
+    final res = await CRUD().post(
+      link: '$_base/trip/delay.php',
+      payload: {
+        'trip_id': tripId.toString(),
+        'delay_minutes': delayMinutes.toString(),
+        if (reason != null) 'reason': reason,
+      },
+    );
+    if (res is Map && res['status'] == 'success') {
+      return TransitApiResult(true, null, 'ok');
+    }
+    return TransitApiResult(false, null, _errMsg(res));
+  }
+
+  static Future<TransitApiResult<bool>> boardPassenger(int stopId, String passengerId) async {
+    final res = await CRUD().post(
+      link: '$_base/trip/board_passenger.php',
+      payload: {
+        'stop_id': stopId.toString(),
+        'passenger_id': passengerId,
+      },
+    );
+    if (res is Map && res['status'] == 'success') {
+      return TransitApiResult(true, true, 'ok');
+    }
+    return TransitApiResult(false, false, _errMsg(res));
+  }
+
+  static Future<TransitApiResult<List<Map<String, dynamic>>>> getStopPassengers(int stopId) async {
+    final res = await CRUD().post(
+      link: '$_base/trip/stop_passengers.php',
+      payload: {
+        'stop_id': stopId.toString(),
+      },
+    );
+    if (res is Map && res['status'] == 'success' && res['message'] is List) {
+      final list = (res['message'] as List).map((e) => Map<String, dynamic>.from(e)).toList();
+      return TransitApiResult(true, list, 'ok');
+    }
+    return TransitApiResult(false, [], _errMsg(res));
+  }
+}