Files
tripz-llc/apps/rider_new/lib/features/trip/view/ride_page.dart
T
Hamza-AyedandClaude Opus 5 1156299d09 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

189 lines
5.8 KiB
Dart

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/tripz_button.dart';
import '../cubit/ride_cubit.dart';
import '../cubit/ride_state.dart';
import '../data/models/geo_point.dart';
import 'widgets/active_trip_sheet.dart';
import 'widgets/center_pin.dart';
import 'widgets/confirm_sheet.dart';
import 'widgets/planner_sheet.dart';
import 'widgets/ride_map.dart';
import 'widgets/searching_sheet.dart';
/// شاشة الراكب: خريطة ثابتة + ورقة سفلية تتبدّل بالمرحلة (docs/39 §3).
///
/// الخريطة **لا تُعاد بناؤها** عند تبدّل الورقة: هي خارج الـ`BlocBuilder`
/// الذي يبني الورقة، ولها `BlocSelector` خاص بما تحتاجه وحدها. هذا هو الفرق
/// بين خريطة سلسة وأخرى تهتزّ عند كل تحديث حالة.
class RidePage extends StatefulWidget {
const RidePage({super.key});
@override
State<RidePage> createState() => _RidePageState();
}
class _RidePageState extends State<RidePage> {
late final RideCubit _cubit = sl<RideCubit>()..init();
GeoPoint? _mapCenter;
@override
void dispose() {
_cubit.close();
super.dispose();
}
@override
Widget build(BuildContext context) {
return BlocProvider.value(
value: _cubit,
child: Scaffold(
body: Stack(
children: [
// ── الخريطة ────────────────────────────────────────────────
BlocSelector<RideCubit, RideState, _MapData>(
selector: (s) => _MapData(
origin: s.origin,
destination: s.destination,
driver: s.driverLocation,
route: s.route,
camera: s.cameraTarget,
),
builder: (context, data) => RideMap(
origin: data.origin,
destination: data.destination,
driver: data.driver,
route: data.route,
cameraTarget: data.camera,
onCameraIdle: (p) => _mapCenter = p,
),
),
// ── دبّوس الاختيار ─────────────────────────────────────────
BlocSelector<RideCubit, RideState, bool>(
selector: (s) => s.phase == RidePhase.pickingOnMap,
builder: (context, picking) =>
picking ? const CenterPin() : const SizedBox.shrink(),
),
// ── الورقة السفلية ─────────────────────────────────────────
Align(
alignment: Alignment.bottomCenter,
child: BlocBuilder<RideCubit, RideState>(
builder: (context, state) => _Sheet(
state: state,
onConfirmPick: () {
final center = _mapCenter;
if (center != null) _cubit.confirmMapPick(center);
},
),
),
),
],
),
),
);
}
}
/// ما تحتاجه الخريطة وحدها — تغيّرُ أي شيء آخر في الحالة لا يعيد بناءها.
class _MapData {
const _MapData({
this.origin,
this.destination,
this.driver,
this.route,
this.camera,
});
final GeoPoint? origin;
final GeoPoint? destination;
final GeoPoint? driver;
final dynamic route;
final GeoPoint? camera;
@override
bool operator ==(Object other) =>
other is _MapData &&
other.origin == origin &&
other.destination == destination &&
other.driver == driver &&
other.route == route &&
other.camera == camera;
@override
int get hashCode => Object.hash(origin, destination, driver, route, camera);
}
class _Sheet extends StatelessWidget {
const _Sheet({required this.state, required this.onConfirmPick});
final RideState state;
final VoidCallback onConfirmPick;
@override
Widget build(BuildContext context) {
final child = switch (state.phase) {
RidePhase.idle => const _Collapsed(),
RidePhase.planning => PlannerSheet(state: state),
RidePhase.pickingOnMap => _PickConfirm(onConfirm: onConfirmPick),
RidePhase.confirming => ConfirmSheet(state: state),
RidePhase.searching => const SearchingSheet(),
RidePhase.active => ActiveTripSheet(trip: state.trip!),
};
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,
),
),
),
);
}
}
class _Collapsed extends StatelessWidget {
const _Collapsed();
@override
Widget build(BuildContext context) {
return TripzButton.secondary(
label: context.l10n.rideWhereTo,
icon: Icons.search_rounded,
expanded: true,
onPressed: context.read<RideCubit>().openPlanner,
);
}
}
class _PickConfirm extends StatelessWidget {
const _PickConfirm({required this.onConfirm});
final VoidCallback onConfirm;
@override
Widget build(BuildContext context) {
return TripzButton.primary(
label: context.l10n.rideConfirmPoint,
onPressed: onConfirm,
);
}
}