فحص آليّ لنقاط docs/38 مقابل الكود كشف ثغرات لم تظهر بالقراءة. ## تسجيل السائق — أخطر ثغرة لم يكن موجوداً أصلاً: سائق جديد يسجّل دخوله ثم يقف. بُنيت features/onboarding كاملة — تقديم ← ملف ← مركبة ← وثائق ← انتظار الاعتماد. - الخطوة تُشتقّ من حالة الخادم لا من تقدّم محلّي: سائق يعيد تثبيت التطبيق يعود إلى حيث وقف لا إلى البداية - الاعتماد يقع على الخادم تلقائياً حين تكتمل الوثائق؛ التطبيق لا يعتمد أحداً - عند الاعتماد خروج إجباري: الدور يتغيّر على الخادم والتوكن القديم يحمل القديم، فتفشل نقاط السائق بـ403 (مصيدة docs/38 §5) - بوابة توجيه: مستخدم دوره ليس driver يُحجز في /onboarding - الوثائق تُصوَّر بالكاميرا لا من المعرض: أصعب تزويراً ## الدردشة والكوبون - Features.chat كان مفعّلاً بلا ميزة. features/chat باستطلاع كل خمس ثوان — قائمة أحداث الخادم لا تتضمّن الرسائل (docs/38 §9)، فالاستطلاع قيد خادم لا اختيار تصميمي - الكوبون: حقل في ورقة التأكيد خلف طبقتَي الميزات، يُقيَّم على الخادم ## Features.calls أُطفئ صراحةً الخادم يدعم WebRTC والتطبيق لا. عَلَم مفعّل بلا ميزة كذبٌ على القارئ التالي. ## بنية - ApiClient.upload للرفع متعدّد الأجزاء - AuthFailure → ApiFailure في core/api: يخدم المصادقة والملف والتسجيل - tool/sync_from_rider.sh: المزامنة اليدوية بين التوأمين انكسرت أربع مرات، فصارت سكربتاً واحداً يعرّف ما يملكه كل تطبيق flutter analyze نظيف · الراكب 101 ملف/7,809 سطر · السائق 110 ملف/8,116 سطر. فحوص آلية: صفر استيراد بين ميزتين · صفر عَلَم مفعّل بلا ميزة · كل نقاط العقد المخصّصة للتطبيقين مستهلكة. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
388 lines
12 KiB
Dart
388 lines
12 KiB
Dart
import 'dart:async';
|
|
|
|
import 'package:flutter_bloc/flutter_bloc.dart';
|
|
|
|
import '../../../core/api/api_exception.dart';
|
|
|
|
import '../../../core/config.dart';
|
|
|
|
import '../../../core/location/location_service.dart';
|
|
|
|
import '../../../core/realtime/realtime_service.dart';
|
|
|
|
import '../data/maps_repository.dart';
|
|
|
|
import '../data/models/geo_point.dart';
|
|
|
|
import '../data/models/place.dart';
|
|
|
|
import '../data/models/ride_type.dart';
|
|
|
|
import '../data/models/trip.dart';
|
|
|
|
import '../data/trip_repository.dart';
|
|
|
|
import 'ride_state.dart';
|
|
|
|
/// شاشة الراكب كاملة: التخطيط ← التسعيرة ← الطلب ← البحث ← الرحلة الجارية.
|
|
///
|
|
/// لا حساب أجرة ولا قرار مطابقة هنا — الخادم مصدر الحقيقة (docs/23 §0.2).
|
|
/// دور الكيوبت جمع المدخلات وعرض ما يُعطى.
|
|
class RideCubit extends Cubit<RideState> {
|
|
RideCubit({
|
|
required TripRepository trips,
|
|
required MapsRepository maps,
|
|
required LocationService location,
|
|
required RealtimeService realtime,
|
|
}) : _trips = trips,
|
|
_maps = maps,
|
|
_location = location,
|
|
_realtime = realtime,
|
|
super(const RideState());
|
|
|
|
final TripRepository _trips;
|
|
final MapsRepository _maps;
|
|
final LocationService _location;
|
|
final RealtimeService _realtime;
|
|
|
|
StreamSubscription<RealtimeEvent>? _events;
|
|
Timer? _searchTimeout;
|
|
Timer? _searchPoll;
|
|
Timer? _debounce;
|
|
|
|
@override
|
|
Future<void> close() {
|
|
_events?.cancel();
|
|
_searchTimeout?.cancel();
|
|
_searchPoll?.cancel();
|
|
_debounce?.cancel();
|
|
return super.close();
|
|
}
|
|
|
|
// ── الإقلاع ────────────────────────────────────────────────────────────
|
|
|
|
Future<void> init() async {
|
|
_events = _realtime.events.listen(_onRealtime);
|
|
await _realtime.connect();
|
|
|
|
// الكاميرا تتوسّط الموقع **فوراً**، ولا تنتظر العنوان — انتظارها كان
|
|
// باگ سيرو المُصلَح 2026-07-20.
|
|
unawaited(_locateMe());
|
|
unawaited(_loadRideTypes());
|
|
unawaited(_resumeLiveTrip());
|
|
}
|
|
|
|
Future<void> _locateMe() async {
|
|
final pos = await _location.current();
|
|
if (pos == null || isClosed) return;
|
|
final point = GeoPoint(pos.lat, pos.lng);
|
|
emit(state.copyWith(origin: point, cameraTarget: point));
|
|
|
|
final place = await _maps.reverse(point);
|
|
if (isClosed || place == null) return;
|
|
emit(state.copyWith(originLabel: place.label));
|
|
}
|
|
|
|
Future<void> _loadRideTypes() async {
|
|
try {
|
|
final types = await _trips.rideTypes();
|
|
if (isClosed || types.isEmpty) return;
|
|
emit(state.copyWith(
|
|
rideTypes: types,
|
|
selectedRideType: state.selectedRideType ?? types.first,
|
|
));
|
|
} on ApiException {
|
|
// قائمة الأنواع ليست حاجزاً للخريطة — تُعاد المحاولة عند التأكيد.
|
|
}
|
|
}
|
|
|
|
/// رحلة جارية من جلسة سابقة (التطبيق أُغلق أثناءها) تُستأنف بلا تدخّل.
|
|
Future<void> _resumeLiveTrip() async {
|
|
try {
|
|
final live = (await _trips.mine()).where((t) => t.status.isLive);
|
|
if (isClosed || live.isEmpty) return;
|
|
_attachTrip(live.first);
|
|
} on ApiException {
|
|
// لا شيء يُستأنف — تجربة عادية لا خطأ يُعرض.
|
|
}
|
|
}
|
|
|
|
// ── التخطيط ────────────────────────────────────────────────────────────
|
|
|
|
void couponChanged(String code) => emit(state.copyWith(couponCode: code));
|
|
|
|
void openPlanner() => emit(state.copyWith(phase: RidePhase.planning));
|
|
|
|
void collapsePlanner() => emit(state.copyWith(phase: RidePhase.idle));
|
|
|
|
void selectRideType(RideType type) {
|
|
emit(state.copyWith(selectedRideType: type));
|
|
unawaited(_priceIt());
|
|
}
|
|
|
|
/// بحث نصّي عن مكان، بمهلة ارتداد: كل ضغطة زر لا تُطلق نداءً.
|
|
void searchPlaces(String query) {
|
|
_debounce?.cancel();
|
|
if (query.trim().length < 2) {
|
|
emit(state.copyWith(searchResults: const [], searching: false));
|
|
return;
|
|
}
|
|
emit(state.copyWith(searching: true));
|
|
_debounce = Timer(const Duration(milliseconds: 350), () async {
|
|
try {
|
|
final results = await _maps.search(query, near: state.origin);
|
|
if (!isClosed) {
|
|
emit(state.copyWith(searchResults: results, searching: false));
|
|
}
|
|
} on ApiException {
|
|
if (!isClosed) {
|
|
emit(state.copyWith(searchResults: const [], searching: false));
|
|
}
|
|
}
|
|
});
|
|
}
|
|
|
|
Future<void> pickPlace(Place place, PickTarget target) async {
|
|
emit(state.copyWith(
|
|
origin: target == PickTarget.origin ? place.point : null,
|
|
originLabel: target == PickTarget.origin ? place.label : null,
|
|
destination: target == PickTarget.destination ? place.point : null,
|
|
destinationLabel:
|
|
target == PickTarget.destination ? place.label : null,
|
|
searchResults: const [],
|
|
cameraTarget: place.point,
|
|
));
|
|
await _routeAndPrice();
|
|
}
|
|
|
|
/// اختيار من الخريطة: المستخدم يحرّك **الخريطة** لا الدبّوس (docs/39 §3).
|
|
void startMapPick(PickTarget target) => emit(state.copyWith(
|
|
phase: RidePhase.pickingOnMap,
|
|
pickTarget: target,
|
|
));
|
|
|
|
Future<void> confirmMapPick(GeoPoint point) async {
|
|
final isOrigin = state.pickTarget == PickTarget.origin;
|
|
emit(state.copyWith(
|
|
phase: RidePhase.planning,
|
|
origin: isOrigin ? point : null,
|
|
destination: isOrigin ? null : point,
|
|
));
|
|
|
|
final place = await _maps.reverse(point);
|
|
if (isClosed) return;
|
|
emit(state.copyWith(
|
|
originLabel: isOrigin ? (place?.label ?? '') : null,
|
|
destinationLabel: isOrigin ? null : (place?.label ?? ''),
|
|
));
|
|
await _routeAndPrice();
|
|
}
|
|
|
|
void addStop(GeoPoint stop) =>
|
|
emit(state.copyWith(stops: [...state.stops, stop]));
|
|
|
|
void removeStop(int index) {
|
|
final next = [...state.stops]..removeAt(index);
|
|
emit(state.copyWith(stops: next));
|
|
}
|
|
|
|
void clearDestination() => emit(state.copyWith(
|
|
clearDestination: true,
|
|
clearRoute: true,
|
|
phase: RidePhase.planning,
|
|
));
|
|
|
|
// ── المسار والتسعيرة ───────────────────────────────────────────────────
|
|
|
|
Future<void> _routeAndPrice() async {
|
|
final from = state.origin;
|
|
final to = state.destination;
|
|
if (from == null || to == null) return;
|
|
|
|
emit(state.copyWith(busy: true, error: RideError.none));
|
|
try {
|
|
final route = await _maps.route(from, to);
|
|
if (isClosed) return;
|
|
emit(state.copyWith(route: route, phase: RidePhase.confirming));
|
|
await _priceIt();
|
|
} on ApiException {
|
|
if (!isClosed) {
|
|
emit(state.copyWith(busy: false, error: RideError.routeFailed));
|
|
}
|
|
}
|
|
}
|
|
|
|
/// التعرفة تحتاج مسافة ومدة محسوبتين — لا إحداثيات (docs/38 §7).
|
|
Future<void> _priceIt() async {
|
|
final route = state.route;
|
|
final type = state.selectedRideType;
|
|
if (route == null || type == null) return;
|
|
|
|
emit(state.copyWith(busy: true));
|
|
try {
|
|
final quote = await _trips.quote(
|
|
city: '',
|
|
serviceClass: type.code,
|
|
distanceKm: route.distanceKm,
|
|
durationMin: route.durationMin,
|
|
);
|
|
if (isClosed) return;
|
|
// 200 بقيم `null` ليس نجاحاً — لا يُعرض رقم غير صالح للمستخدم.
|
|
emit(state.copyWith(
|
|
quote: quote,
|
|
busy: false,
|
|
error: quote.isUsable ? RideError.none : RideError.quoteFailed,
|
|
));
|
|
} on ApiException {
|
|
if (!isClosed) {
|
|
emit(state.copyWith(busy: false, error: RideError.quoteFailed));
|
|
}
|
|
}
|
|
}
|
|
|
|
// ── الطلب والبحث ───────────────────────────────────────────────────────
|
|
|
|
Future<void> requestTrip() async {
|
|
final from = state.origin;
|
|
final to = state.destination;
|
|
final type = state.selectedRideType;
|
|
if (from == null || to == null || type == null) return;
|
|
|
|
emit(state.copyWith(busy: true, error: RideError.none));
|
|
try {
|
|
final res = await _trips.request(
|
|
origin: from,
|
|
destination: to,
|
|
serviceClass: type.code,
|
|
stops: state.stops,
|
|
couponCode: state.couponCode.trim().isEmpty
|
|
? null
|
|
: state.couponCode.trim(),
|
|
);
|
|
if (isClosed) return;
|
|
|
|
// صفر سائقين = جواب نهائي فوري، لا داعي لانتظار مهلة كاملة.
|
|
if (res.offeredDrivers == 0) {
|
|
emit(state.copyWith(
|
|
busy: false,
|
|
error: RideError.noDrivers,
|
|
phase: RidePhase.confirming,
|
|
));
|
|
unawaited(_trips.cancel(res.trip.id));
|
|
return;
|
|
}
|
|
|
|
_attachTrip(res.trip);
|
|
_startSearchGuards(res.trip.id);
|
|
} on ApiException {
|
|
if (!isClosed) {
|
|
emit(state.copyWith(busy: false, error: RideError.requestFailed));
|
|
}
|
|
}
|
|
}
|
|
|
|
/// حارسان أثناء البحث:
|
|
/// 1. **مهلة محليّة** — الخادم قد لا يُطلق `expired`/`no_drivers` أبداً
|
|
/// (ثغرة R1، docs/38 §4)، فبلا هذه المهلة تدور الشاشة إلى الأبد.
|
|
/// 2. **استطلاع دوري** — يلتقط القبول لو ضاع حدث `trip:update`.
|
|
void _startSearchGuards(String tripId) {
|
|
_searchTimeout?.cancel();
|
|
_searchPoll?.cancel();
|
|
|
|
_searchTimeout = Timer(AppConfig.searchingTimeout, () async {
|
|
if (isClosed || state.phase != RidePhase.searching) return;
|
|
await cancelTrip();
|
|
if (!isClosed) emit(state.copyWith(error: RideError.noDrivers));
|
|
});
|
|
|
|
_searchPoll = Timer.periodic(const Duration(seconds: 5), (_) async {
|
|
if (isClosed || state.phase != RidePhase.searching) return;
|
|
try {
|
|
_attachTrip(await _trips.get(tripId));
|
|
} on ApiException {
|
|
// الاستطلاع شبكة أمان لا مصدر حقيقة — فشلُه لا يُعرض.
|
|
}
|
|
});
|
|
}
|
|
|
|
Future<void> cancelTrip() async {
|
|
final trip = state.trip;
|
|
if (trip == null) return;
|
|
_stopSearchGuards();
|
|
try {
|
|
await _trips.cancel(trip.id);
|
|
} on ApiException {
|
|
// حتى لو فشل الإلغاء على الخادم، المستخدم خرج من الشاشة — وحالة
|
|
// الرحلة تُصحَّح عند الاستئناف التالي.
|
|
}
|
|
if (!isClosed) _resetToIdle();
|
|
}
|
|
|
|
void _stopSearchGuards() {
|
|
_searchTimeout?.cancel();
|
|
_searchPoll?.cancel();
|
|
_searchTimeout = null;
|
|
_searchPoll = null;
|
|
}
|
|
|
|
void _resetToIdle() {
|
|
emit(state.copyWith(
|
|
phase: RidePhase.idle,
|
|
clearTrip: true,
|
|
clearRoute: true,
|
|
clearDestination: true,
|
|
busy: false,
|
|
stops: const [],
|
|
));
|
|
}
|
|
|
|
// ── الواقع اللحظي ──────────────────────────────────────────────────────
|
|
|
|
void _attachTrip(Trip trip) {
|
|
// الانضمام قبل أي انتقال حالة، وإلا فاتت الأحداث (docs/38 §9).
|
|
_realtime.joinTrip(trip.id);
|
|
|
|
if (trip.status.isOver) {
|
|
_stopSearchGuards();
|
|
emit(state.copyWith(
|
|
trip: trip,
|
|
busy: false,
|
|
phase: RidePhase.idle,
|
|
error: trip.status == TripStatus.noDrivers ||
|
|
trip.status == TripStatus.expired
|
|
? RideError.noDrivers
|
|
: RideError.none,
|
|
));
|
|
return;
|
|
}
|
|
|
|
if (trip.status != TripStatus.searching) _stopSearchGuards();
|
|
|
|
emit(state.copyWith(
|
|
trip: trip,
|
|
busy: false,
|
|
phase: trip.status == TripStatus.searching
|
|
? RidePhase.searching
|
|
: RidePhase.active,
|
|
));
|
|
}
|
|
|
|
void _onRealtime(RealtimeEvent event) {
|
|
switch (event.name) {
|
|
case RealtimeEvent.tripUpdate:
|
|
final id = event.data['id'] ?? event.data['tripId'];
|
|
if (id != null && id != state.trip?.id) return;
|
|
_attachTrip(Trip.fromJson(event.data));
|
|
|
|
case RealtimeEvent.driverLocation:
|
|
final lat = event.data['lat'];
|
|
final lng = event.data['lng'];
|
|
if (lat is num && lng is num) {
|
|
emit(state.copyWith(
|
|
driverLocation: GeoPoint(lat.toDouble(), lng.toDouble()),
|
|
));
|
|
}
|
|
}
|
|
}
|
|
}
|