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,94 @@
+import 'dart:async';
+
+import 'package:socket_io_client/socket_io_client.dart' as io;
+
+import '../config.dart';
+import '../storage/token_store.dart';
+
+/// أحداث الخادم كما هي في `backend-archive/src/realtime` (docs/38 §9).
+class RealtimeEvent {
+  const RealtimeEvent(this.name, this.data);
+
+  final String name;
+  final Map<String, dynamic> data;
+
+  static const tripUpdate = 'trip:update';
+  static const driverLocation = 'driver:location';
+  static const tripOffer = 'trip:offer';
+  static const tripOfferTaken = 'trip:offer_taken';
+}
+
+/// اتصال Socket.IO واحد للتطبيق كله.
+///
+/// **الاتصال ليس مصدر الحقيقة**: كل ما يصل عبره يجب أن يكون قابلاً للاستنتاج
+/// من REST أيضاً. حدثٌ ضائع (شبكة سيّئة، أو ثغرة R1 التي قد تمنع
+/// `expired`/`no_drivers` أصلاً) يجب ألّا يُجمّد شاشة.
+class RealtimeService {
+  RealtimeService(this._tokens);
+
+  final TokenStore _tokens;
+
+  io.Socket? _socket;
+  final _events = StreamController<RealtimeEvent>.broadcast();
+
+  Stream<RealtimeEvent> get events => _events.stream;
+  bool get isConnected => _socket?.connected ?? false;
+
+  Future<void> connect() async {
+    if (_socket != null) return;
+    final token = _tokens.accessToken;
+    if (token == null) return;
+
+    // الأصل بلا `/api` — الـSocket.IO ليس على مسار الـREST (docs/38 §9).
+    final socket = io.io(
+      AppConfig.wsBaseUrl,
+      io.OptionBuilder()
+          .setTransports(['websocket'])
+          .setAuth({'token': token})
+          .enableReconnection()
+          .build(),
+    );
+
+    for (final name in const [
+      RealtimeEvent.tripUpdate,
+      RealtimeEvent.driverLocation,
+      RealtimeEvent.tripOffer,
+      RealtimeEvent.tripOfferTaken,
+    ]) {
+      socket.on(name, (data) {
+        if (data is Map) {
+          _events.add(RealtimeEvent(name, Map<String, dynamic>.from(data)));
+        }
+      });
+    }
+
+    _socket = socket;
+  }
+
+  /// الانضمام **قبل** أي انتقال حالة، وإلا فاتت الأحداث (docs/38 §9).
+  void joinTrip(String tripId) => _socket?.emit('trip:join', {'tripId': tripId});
+
+  void sendDriverLocation(double lat, double lng, {double? heading}) {
+    _socket?.emit(RealtimeEvent.driverLocation, {
+      'lat': lat,
+      'lng': lng,
+      'heading': ?heading,
+    });
+  }
+
+  /// عند تجديد التوكن أو تبديل المستخدم: قطعٌ وإعادة اتصال بالتوكن الجديد.
+  Future<void> reconnect() async {
+    disconnect();
+    await connect();
+  }
+
+  void disconnect() {
+    _socket?.dispose();
+    _socket = null;
+  }
+
+  Future<void> dispose() async {
+    disconnect();
+    await _events.close();
+  }
+}