## حسم تعارض الخرائط (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>
126 lines
3.7 KiB
Dart
126 lines
3.7 KiB
Dart
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];
|
|
}
|