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,140 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
+
+import '../../../core/design/tokens.dart';
+import '../../../core/design/tripz_colors.dart';
+import '../../../core/di.dart';
+import '../../../core/l10n/l10n.dart';
+import '../../../core/ui/status_banner.dart';
+import '../cubit/duty_cubit.dart';
+import '../cubit/duty_state.dart';
+import '../data/models/geo_point.dart';
+import 'widgets/active_duty_sheet.dart';
+import 'widgets/duty_toggle.dart';
+import 'widgets/offer_sheet.dart';
+import 'widgets/ride_map.dart';
+
+/// شاشة السائق: خريطة + مفتاح الاتصال أعلى + ورقة تتبدّل بالمرحلة.
+class DutyPage extends StatefulWidget {
+  const DutyPage({super.key});
+
+  @override
+  State<DutyPage> createState() => _DutyPageState();
+}
+
+class _DutyPageState extends State<DutyPage> {
+  late final DutyCubit _cubit = sl<DutyCubit>()..init();
+
+  @override
+  void dispose() {
+    _cubit.close();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return BlocProvider.value(
+      value: _cubit,
+      child: Scaffold(
+        body: Stack(
+          children: [
+            // الخريطة معزولة عن بقية الحالة: نبضة موقع كل 25 متراً يجب ألّا
+            // تعيد بناء الورقة والمفتاح معها.
+            BlocSelector<DutyCubit, DutyState, GeoPoint?>(
+              selector: (s) => s.myLocation,
+              builder: (context, me) => RideMap(origin: me, cameraTarget: me),
+            ),
+
+            SafeArea(
+              child: Padding(
+                padding: Space.page,
+                child: Column(
+                  children: [
+                    BlocSelector<DutyCubit, DutyState, ({bool online, bool busy})>(
+                      selector: (s) => (online: s.isOnline, busy: s.busy),
+                      builder: (context, d) => DutyToggle(
+                        isOnline: d.online,
+                        busy: d.busy,
+                        onToggle: _cubit.toggleOnline,
+                      ),
+                    ),
+                    const SizedBox(height: Space.xs),
+                    BlocSelector<DutyCubit, DutyState, bool>(
+                      selector: (s) => s.creditBlocked,
+                      builder: (context, blocked) => blocked
+                          ? StatusBanner(
+                              message: context.l10n.errorGeneric,
+                              tone: BannerTone.danger,
+                              icon: Icons.account_balance_wallet_outlined,
+                            )
+                          : const SizedBox.shrink(),
+                    ),
+                  ],
+                ),
+              ),
+            ),
+
+            Align(
+              alignment: Alignment.bottomCenter,
+              child: BlocBuilder<DutyCubit, DutyState>(
+                builder: (context, state) => _Sheet(state: state),
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class _Sheet extends StatelessWidget {
+  const _Sheet({required this.state});
+
+  final DutyState state;
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = context.l10n;
+
+    final child = switch (state.phase) {
+      DutyPhase.offline => const SizedBox.shrink(),
+      DutyPhase.waiting => Padding(
+          padding: const EdgeInsets.symmetric(vertical: Space.md),
+          child: Text(
+            state.error == DutyError.offerTaken
+                ? l10n.driverOfferTaken
+                : l10n.driverNoOffers,
+            textAlign: TextAlign.center,
+            style: context.texts.bodyMedium?.copyWith(
+              color: context.colors.onSurfaceVariant,
+            ),
+          ),
+        ),
+      DutyPhase.offered => OfferSheet(offer: state.offer!),
+      DutyPhase.active =>
+        ActiveDutySheet(trip: state.trip!, busy: state.busy),
+    };
+
+    if (state.phase == DutyPhase.offline) return const SizedBox.shrink();
+
+    return Container(
+      width: double.infinity,
+      decoration: BoxDecoration(
+        color: context.colors.surface,
+        borderRadius: Radii.sheetTop,
+      ),
+      child: SafeArea(
+        top: false,
+        child: Padding(
+          padding: Space.page,
+          child: AnimatedSize(
+            duration: Motion.inScreen,
+            curve: Motion.curve,
+            alignment: Alignment.bottomCenter,
+            child: child,
+          ),
+        ),
+      ),
+    );
+  }
+}