Hamza-AyedandClaude Opus 5
1156299d09
## حسم تعارض الخرائط (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>
90 lines
2.3 KiB
Dart
90 lines
2.3 KiB
Dart
import 'package:equatable/equatable.dart';
|
|
|
|
import '../data/models/geo_point.dart';
|
|
import '../data/models/trip.dart';
|
|
|
|
/// حالة السائق. الفرق الجوهري عن الراكب: السائق **يستقبل** عملاً بدل أن
|
|
/// يطلبه، فالمحور هنا الاتصال والعرض لا التخطيط.
|
|
enum DutyPhase {
|
|
/// غير متصل — لا يصله شيء.
|
|
offline,
|
|
|
|
/// متصل بانتظار عرض.
|
|
waiting,
|
|
|
|
/// عرض معروض بمؤقّت.
|
|
offered,
|
|
|
|
/// رحلة مقبولة جارية.
|
|
active,
|
|
}
|
|
|
|
enum DutyError { none, goOnlineFailed, acceptFailed, offerTaken, statusFailed }
|
|
|
|
class DutyState extends Equatable {
|
|
const DutyState({
|
|
this.phase = DutyPhase.offline,
|
|
this.myLocation,
|
|
this.offer,
|
|
this.trip,
|
|
this.busy = false,
|
|
this.error = DutyError.none,
|
|
this.creditBalance,
|
|
this.creditBlocked = false,
|
|
});
|
|
|
|
final DutyPhase phase;
|
|
final GeoPoint? myLocation;
|
|
|
|
/// العرض المعروض حالياً — يختفي إن سبق إليه سائق آخر.
|
|
final Trip? offer;
|
|
|
|
final Trip? trip;
|
|
final bool busy;
|
|
final DutyError error;
|
|
|
|
/// الرصيد التشغيلي: العمولة تُخصم منه عند الإنهاء (docs/38 §5).
|
|
final String? creditBalance;
|
|
|
|
/// محجوب لنفاد الرصيد — لا يصله عمل، ولا بد أن يعرف السبب صراحةً.
|
|
final bool creditBlocked;
|
|
|
|
bool get isOnline => phase != DutyPhase.offline;
|
|
|
|
DutyState copyWith({
|
|
DutyPhase? phase,
|
|
GeoPoint? myLocation,
|
|
Trip? offer,
|
|
Trip? trip,
|
|
bool? busy,
|
|
DutyError? error,
|
|
String? creditBalance,
|
|
bool? creditBlocked,
|
|
bool clearOffer = false,
|
|
bool clearTrip = false,
|
|
}) {
|
|
return DutyState(
|
|
phase: phase ?? this.phase,
|
|
myLocation: myLocation ?? this.myLocation,
|
|
offer: clearOffer ? null : (offer ?? this.offer),
|
|
trip: clearTrip ? null : (trip ?? this.trip),
|
|
busy: busy ?? this.busy,
|
|
error: error ?? this.error,
|
|
creditBalance: creditBalance ?? this.creditBalance,
|
|
creditBlocked: creditBlocked ?? this.creditBlocked,
|
|
);
|
|
}
|
|
|
|
@override
|
|
List<Object?> get props => [
|
|
phase,
|
|
myLocation,
|
|
offer,
|
|
trip,
|
|
busy,
|
|
error,
|
|
creditBalance,
|
|
creditBlocked,
|
|
];
|
|
}
|