feat(apps): تسجيل السائق والدردشة والكوبون — إكمال التغطية

فحص آليّ لنقاط 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>
2026-08-05 00:04:28 +03:00
parent 096acae74e
commit bb2c0de478
56 changed files with 1936 additions and 68 deletions
@@ -0,0 +1,39 @@
+import 'package:equatable/equatable.dart';
+
+/// وثيقة مطلوبة وحالتها — من `GET /drivers/documents/requirements`.
+/// الخادم يعتمد السائق **تلقائياً** حين تصير كلها `approved`.
+class DocumentRequirement extends Equatable {
+  const DocumentRequirement({
+    required this.type,
+    required this.nameAr,
+    required this.side,
+    required this.status,
+    this.documentId,
+  });
+
+  final String type;
+  final String nameAr;
+
+  /// وجه المستند: `front` أو `back` — بعضها يحتاج الوجهين.
+  final String side;
+
+  /// `missing` · `pending` · `approved` · `rejected`.
+  final String status;
+
+  final String? documentId;
+
+  factory DocumentRequirement.fromJson(Map<String, dynamic> json) =>
+      DocumentRequirement(
+        type: json['type'] as String? ?? '',
+        nameAr: json['name_ar'] as String? ?? '',
+        side: json['side'] as String? ?? 'front',
+        status: json['status'] as String? ?? 'missing',
+        documentId: json['document_id'] as String?,
+      );
+
+  bool get isMissing => status == 'missing' || status == 'rejected';
+  bool get isApproved => status == 'approved';
+
+  @override
+  List<Object?> get props => [type, side, status];
+}
@@ -0,0 +1,48 @@
+import 'package:equatable/equatable.dart';
+
+/// حالة اعتماد السائق كما يعرّفها الخادم: `pending` · `approved` · `rejected`.
+enum VerificationStatus {
+  pending,
+  approved,
+  rejected,
+
+  /// لا سجلّ سائق بعد — لم يقدّم أصلاً.
+  none;
+
+  static VerificationStatus parse(String? raw) => switch (raw) {
+        'approved' => VerificationStatus.approved,
+        'rejected' => VerificationStatus.rejected,
+        'pending' => VerificationStatus.pending,
+        _ => VerificationStatus.none,
+      };
+}
+
+class DriverProfile extends Equatable {
+  const DriverProfile({
+    required this.id,
+    required this.verification,
+    this.serviceClass = 'economy',
+    this.nameArabic,
+    this.online = false,
+  });
+
+  final String id;
+  final VerificationStatus verification;
+  final String serviceClass;
+  final String? nameArabic;
+  final bool online;
+
+  factory DriverProfile.fromJson(Map<String, dynamic> json) => DriverProfile(
+        id: json['id'] as String? ?? '',
+        verification:
+            VerificationStatus.parse(json['verification_status'] as String?),
+        serviceClass: json['service_class'] as String? ?? 'economy',
+        nameArabic: json['name_arabic'] as String?,
+        online: json['online'] as bool? ?? false,
+      );
+
+  bool get isApproved => verification == VerificationStatus.approved;
+
+  @override
+  List<Object?> get props => [id, verification, serviceClass, online];
+}
@@ -0,0 +1,45 @@
+import 'package:equatable/equatable.dart';
+
+class Vehicle extends Equatable {
+  const Vehicle({
+    required this.id,
+    this.make,
+    this.model,
+    this.year,
+    this.color,
+    this.plate,
+    this.isDefault = false,
+    this.status = 'pending',
+  });
+
+  final String id;
+  final String? make;
+  final String? model;
+  final int? year;
+  final String? color;
+  final String? plate;
+
+  /// أول مركبة تصير الافتراضية تلقائياً على الخادم (docs/38 §5).
+  final bool isDefault;
+
+  final String status;
+
+  factory Vehicle.fromJson(Map<String, dynamic> json) => Vehicle(
+        id: json['id'] as String? ?? '',
+        make: json['make'] as String?,
+        model: json['model'] as String?,
+        year: (json['year'] as num?)?.toInt(),
+        color: json['color'] as String?,
+        plate: json['plate'] as String?,
+        isDefault: json['is_default'] as bool? ?? false,
+        status: json['status'] as String? ?? 'pending',
+      );
+
+  String get label => [make, model, year?.toString()]
+      .whereType<String>()
+      .where((s) => s.isNotEmpty)
+      .join(' ');
+
+  @override
+  List<Object?> get props => [id, plate, isDefault, status];
+}