Files
tripz-llc/apps/driver_new/lib/features/trip/data/models/trip.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

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];
}