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,108 @@
+import '../../../core/api/api_client.dart';
+import '../../../core/api/api_exception.dart';
+import 'models/document_requirement.dart';
+import 'models/driver_profile.dart';
+import 'models/vehicle.dart';
+
+class DriverRepository {
+  DriverRepository(this._api);
+
+  final ApiClient _api;
+
+  /// `null` حين لا سجلّ سائق بعد — 404 هنا حالة طبيعية لا عطل.
+  Future<DriverProfile?> me() async {
+    try {
+      final res = await _api.get<Map<String, dynamic>>('/drivers/me');
+      return DriverProfile.fromJson(res);
+    } on ApiException catch (e) {
+      if (e.statusCode == 404) return null;
+      rethrow;
+    }
+  }
+
+  Future<DriverProfile> apply({
+    required String vehicleMake,
+    required String serviceClass,
+  }) async {
+    final res = await _api.post<Map<String, dynamic>>('/drivers/apply', body: {
+      'vehicle_make': vehicleMake,
+      'service_class': serviceClass,
+    });
+    return DriverProfile.fromJson(res);
+  }
+
+  Future<void> setProfile({
+    required String nameArabic,
+    required String nationalNumber,
+    String? gender,
+    String? birthdate,
+    String? address,
+    String? licenseType,
+    String? licenseExpiry,
+  }) {
+    return _api.patch<Map<String, dynamic>>('/drivers/profile', body: {
+      'name_arabic': nameArabic,
+      'national_number': nationalNumber,
+      'gender': ?gender,
+      'birthdate': ?birthdate,
+      'address': ?address,
+      'license_type': ?licenseType,
+      'license_expiry': ?licenseExpiry,
+    });
+  }
+
+  Future<List<Vehicle>> vehicles() async {
+    final res = await _api.get<List<dynamic>>('/vehicles/mine');
+    return res
+        .whereType<Map<String, dynamic>>()
+        .map(Vehicle.fromJson)
+        .toList(growable: false);
+  }
+
+  Future<Vehicle> addVehicle({
+    required String make,
+    required String model,
+    required int year,
+    required String color,
+    required String plate,
+  }) async {
+    final res = await _api.post<Map<String, dynamic>>('/vehicles', body: {
+      'make': make,
+      'model': model,
+      'year': year,
+      'color': color,
+      'plate': plate,
+    });
+    return Vehicle.fromJson(res);
+  }
+
+  Future<({bool complete, List<DocumentRequirement> items})> requirements() async {
+    final res = await _api.get<Map<String, dynamic>>(
+      '/drivers/documents/requirements',
+    );
+    final raw = res['items'];
+    return (
+      complete: res['complete'] as bool? ?? false,
+      items: raw is List
+          ? raw
+              .whereType<Map<String, dynamic>>()
+              .map(DocumentRequirement.fromJson)
+              .toList(growable: false)
+          : const <DocumentRequirement>[],
+    );
+  }
+
+  /// رفع وثيقة. الاعتماد **يقع على الخادم تلقائياً** حين تكتمل كل الوثائق —
+  /// التطبيق لا يعتمد أحداً.
+  Future<void> uploadDocument({
+    required String filePath,
+    required String type,
+    required String side,
+  }) {
+    return _api.upload<Map<String, dynamic>>(
+      '/drivers/documents',
+      filePath: filePath,
+      fields: {'type': type, 'side': side},
+    );
+  }
+}
@@ -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];
+}