فحص آليّ لنقاط 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>
124 lines
3.7 KiB
Dart
124 lines
3.7 KiB
Dart
import 'package:flutter_bloc/flutter_bloc.dart';
|
|
|
|
import '../../../core/api/api_exception.dart';
|
|
import '../../../core/api/api_failure.dart';
|
|
import '../data/driver_repository.dart';
|
|
import 'onboarding_state.dart';
|
|
|
|
/// تسجيل السائق حتى الاعتماد.
|
|
///
|
|
/// **الخطوة تُشتقّ من حالة الخادم لا من تقدّم محلّي**: سائق يعيد تثبيت
|
|
/// التطبيق يجب أن يعود إلى حيث وقف، لا أن يبدأ من الصفر.
|
|
class OnboardingCubit extends Cubit<OnboardingState> {
|
|
OnboardingCubit(this._repo) : super(const OnboardingState());
|
|
|
|
final DriverRepository _repo;
|
|
|
|
Future<void> load() async {
|
|
emit(state.copyWith(step: OnboardingStep.loading, clearFailure: true));
|
|
try {
|
|
final driver = await _repo.me();
|
|
if (isClosed) return;
|
|
|
|
if (driver == null) {
|
|
emit(state.copyWith(step: OnboardingStep.apply, driver: null));
|
|
return;
|
|
}
|
|
if (driver.isApproved) {
|
|
emit(state.copyWith(step: OnboardingStep.approved, driver: driver));
|
|
return;
|
|
}
|
|
|
|
// الملف ناقص ما لم يُدخل الاسم العربي — أول ما يطلبه الخادم.
|
|
if (driver.nameArabic == null || driver.nameArabic!.isEmpty) {
|
|
emit(state.copyWith(step: OnboardingStep.profile, driver: driver));
|
|
return;
|
|
}
|
|
|
|
final vehicles = await _repo.vehicles();
|
|
if (isClosed) return;
|
|
if (vehicles.isEmpty) {
|
|
emit(state.copyWith(
|
|
step: OnboardingStep.vehicle,
|
|
driver: driver,
|
|
vehicles: vehicles,
|
|
));
|
|
return;
|
|
}
|
|
|
|
final reqs = await _repo.requirements();
|
|
if (isClosed) return;
|
|
emit(state.copyWith(
|
|
// اكتملت الوثائق ولم يُعتمد بعد: مراجعة بشرية جارية.
|
|
step: reqs.complete ? OnboardingStep.pending : OnboardingStep.documents,
|
|
driver: driver,
|
|
vehicles: vehicles,
|
|
requirements: reqs.items,
|
|
));
|
|
} on ApiException catch (e) {
|
|
if (!isClosed) {
|
|
emit(state.copyWith(
|
|
step: OnboardingStep.apply,
|
|
failure: e.toApiFailure(),
|
|
));
|
|
}
|
|
}
|
|
}
|
|
|
|
Future<void> apply({required String vehicleMake, required String serviceClass}) =>
|
|
_run(() => _repo.apply(vehicleMake: vehicleMake, serviceClass: serviceClass));
|
|
|
|
Future<void> saveProfile({
|
|
required String nameArabic,
|
|
required String nationalNumber,
|
|
String? gender,
|
|
}) =>
|
|
_run(() => _repo.setProfile(
|
|
nameArabic: nameArabic,
|
|
nationalNumber: nationalNumber,
|
|
gender: gender,
|
|
));
|
|
|
|
Future<void> addVehicle({
|
|
required String make,
|
|
required String model,
|
|
required int year,
|
|
required String color,
|
|
required String plate,
|
|
}) =>
|
|
_run(() => _repo.addVehicle(
|
|
make: make,
|
|
model: model,
|
|
year: year,
|
|
color: color,
|
|
plate: plate,
|
|
));
|
|
|
|
Future<void> uploadDocument({
|
|
required String filePath,
|
|
required String type,
|
|
required String side,
|
|
}) =>
|
|
_run(() => _repo.uploadDocument(
|
|
filePath: filePath,
|
|
type: type,
|
|
side: side,
|
|
));
|
|
|
|
/// كل فعل ينتهي بإعادة قراءة الحالة من الخادم — فلا يتقدّم التطبيق خطوةً
|
|
/// لم يقبلها الخادم فعلاً.
|
|
Future<void> _run(Future<dynamic> Function() action) async {
|
|
emit(state.copyWith(busy: true, clearFailure: true));
|
|
try {
|
|
await action();
|
|
if (isClosed) return;
|
|
emit(state.copyWith(busy: false));
|
|
await load();
|
|
} on ApiException catch (e) {
|
|
if (!isClosed) {
|
|
emit(state.copyWith(busy: false, failure: e.toApiFailure()));
|
|
}
|
|
}
|
|
}
|
|
}
|