feat(apps): الخريطة وطلب الرحلة ودورة السائق — المرحلة 4

## حسم تعارض الخرائط (docs/38 §7) لصالح القرار الأحدث 2026-07-20: كل الخرائط — البلاطات والبحث والعكسي والمسار — مباشرة إلى map-saas بترويسة x-api-key، بلا مرور بباك إند تريبز. نقاط /maps/* في الباك إند لا تُستعمل، وإحداها (geocode) معطوبة على المنشور. العقد تُحقّق حيّاً بـcurl قبل كتابة سطر. ## النواة المشتركة - core/api/antlaq_api.dart: عميل منفصل بلا AuthInterceptor — توكن تريبز لا شأن لخادم الخرائط به، وإرساله إليه تسريب بلا مقابل - core/realtime: Socket.IO واحد (trip:update · driver:location · trip:offer · trip:offer_taken) - core/location: نقطة الموقع الوحيدة بمرشّح 25 متراً - features/trip/data: سبعة نماذج + MapsRepository + TripRepository متطابق حرفياً بين التوأمين ## الراكب RideCubit بستّ مراحل + RidePage وثمانية ويدجت: الخريطة · دبّوس المنتصف · المخطّط · الخط الزمني · اختيار النوع · التأكيد · البحث عن سائق · الرحلة. ## السائق DutyCubit بأربع مراحل + DutyPage: مفتاح الاتصال · العرض بمؤقّت · الرحلة. ## قرارات تحمي الأداء والصحّة - GeoPoint مستقلّ عن حزمة الخريطة؛ intaleq_maps مستوردة في ملف واحد فقط لكل تطبيق. تبديل محرّك الخريطة لا يلمس منطقاً - الخريطة خارج BlocBuilder الورقة ولها BlocSelector خاص: نبضة موقع كل 25م لا تعيد بناء الشاشة - مهلة بحث محليّة 90ث + استطلاع كل 5ث: الخادم قد لا يُطلق expired/no_drivers أبداً (ثغرة R1)، وانتظار حدث قد لا يصل = شاشة بحث أبدية - offeredDrivers == 0 جواب نهائي فوري بلا انتظار المهلة - الأجرة لا تُعرض إلا إن كانت صالحة: /tariff/quote يرجّع 200 بقيم null صامتة - موقع السائق بمسارين عمداً: REST لمطابقة Redis والسوكت لخريطة الراكب flutter analyze نظيف · الراكب 70 ملف/5,294 سطر · السائق 67 ملف/4,771 سطر. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 23:33:56 +03:00
parent c52338f3bb
commit 1156299d09
59 changed files with 4652 additions and 181 deletions
@@ -0,0 +1,125 @@
+import 'package:equatable/equatable.dart';
+
+import 'geo_point.dart';
+
+/// حالات الرحلة كما يعرّفها الخادم (docs/38 §4).
+enum TripStatus {
+  searching,
+  assigned,
+  driverArriving,
+  driverArrived,
+  inProgress,
+  completed,
+  paid,
+  cancelled,
+  expired,
+  noDrivers,
+  unknown;
+
+  static TripStatus parse(String? raw) => switch (raw) {
+        'searching' => TripStatus.searching,
+        'assigned' => TripStatus.assigned,
+        'driver_arriving' => TripStatus.driverArriving,
+        'driver_arrived' => TripStatus.driverArrived,
+        'in_progress' => TripStatus.inProgress,
+        'completed' => TripStatus.completed,
+        'paid' => TripStatus.paid,
+        'cancelled' => TripStatus.cancelled,
+        'expired' => TripStatus.expired,
+        'no_drivers' => TripStatus.noDrivers,
+        _ => TripStatus.unknown,
+      };
+
+  String get wire => switch (this) {
+        TripStatus.driverArriving => 'driver_arriving',
+        TripStatus.driverArrived => 'driver_arrived',
+        TripStatus.inProgress => 'in_progress',
+        TripStatus.noDrivers => 'no_drivers',
+        _ => name,
+      };
+
+  /// رحلة جارية تُستأنف عند فتح التطبيق.
+  bool get isLive => const {
+        TripStatus.searching,
+        TripStatus.assigned,
+        TripStatus.driverArriving,
+        TripStatus.driverArrived,
+        TripStatus.inProgress,
+      }.contains(this);
+
+  bool get isOver => const {
+        TripStatus.completed,
+        TripStatus.paid,
+        TripStatus.cancelled,
+        TripStatus.expired,
+        TripStatus.noDrivers,
+      }.contains(this);
+}
+
+class Trip extends Equatable {
+  const Trip({
+    required this.id,
+    required this.status,
+    this.origin,
+    this.destination,
+    this.quotedFare,
+    this.priceForPassenger,
+    this.priceForDriver,
+    this.currency = '',
+    this.driverName,
+    this.driverPhone,
+    this.vehiclePlate,
+    this.vehicleModel,
+    this.driverRating,
+  });
+
+  final String id;
+  final TripStatus status;
+  final GeoPoint? origin;
+  final GeoPoint? destination;
+
+  /// أجرة مقفولة عند الطلب.
+  final String? quotedFare;
+
+  /// **حقلان منفصلان** لا حقل واحد — الفرق هو العمولة (docs/38 §4).
+  final String? priceForPassenger;
+  final String? priceForDriver;
+
+  final String currency;
+  final String? driverName;
+  final String? driverPhone;
+  final String? vehiclePlate;
+  final String? vehicleModel;
+  final String? driverRating;
+
+  factory Trip.fromJson(Map<String, dynamic> json) {
+    GeoPoint? point(String key) {
+      final v = json[key];
+      return v is Map<String, dynamic> ? GeoPoint.fromJson(v) : null;
+    }
+
+    final driver = json['driver'] as Map<String, dynamic>?;
+    return Trip(
+      id: json['id'] as String,
+      status: TripStatus.parse(json['status'] as String?),
+      origin: point('origin'),
+      destination: point('destination'),
+      // كل المبالغ نصوص (docs/38 §12.2) — تُحفظ كما وصلت ولا تُحوَّل هنا.
+      quotedFare: json['quoted_fare']?.toString(),
+      priceForPassenger: json['price_for_passenger']?.toString(),
+      priceForDriver: json['price_for_driver']?.toString(),
+      currency: json['currency'] as String? ?? '',
+      driverName: driver?['name'] as String? ?? json['driver_name'] as String?,
+      driverPhone:
+          driver?['phone'] as String? ?? json['driver_phone'] as String?,
+      vehiclePlate:
+          driver?['vehicle_plate'] as String? ?? json['vehicle_plate'] as String?,
+      vehicleModel:
+          driver?['vehicle_model'] as String? ?? json['vehicle_model'] as String?,
+      driverRating: driver?['rating']?.toString(),
+    );
+  }
+
+  @override
+  List<Object?> get props => [id, status, priceForPassenger, driverName];
+}