feat(apps): التقييم والمحفظتان ومسار الرحلة — المرحلة 5

## التقييم مفروض لا اختياري
SessionCubit يفحص GET /trips/rating/pending بعد إثبات الجلسة، ووجود رحلة
معلّقة يحجز التطبيق كله عند /rating حتى تُحسم. دور المستخدم في الرحلة يأتي
من الخادم لا من نوع التطبيق — نفس الرقم قد يكون له حسابان (docs/38 §1).
التقييم المزدوج يرجّع 400، وهو نجاح من منظور المستخدم: الرحلة مُقيَّمة فعلاً
فلا يُحبس في شاشة بلا مخرج.

الجلسة تحتاج معرفة التقييم المعلّق، و core لا يجوز أن يستورد ميزة التقييم —
فأُضيفت الطريقة لواجهة SessionSource ونفّذها AuthRepository.

## core/format/money.dart
كل المبالغ تصل نصوصاً ("0.000")؛ التحويل والعرض من نقطة واحدة. عدد المنازل
من العملة (JOD ثلاث)، والعملة من إعداد المستأجر لا من ثابت في التطبيق.

## المحفظتان لا تُوحَّدان
- الراكب WalletPage: رصيد + شحن = التزام على المنصّة
- السائق EarningsPage: أرباح + سحب = إيراد له
شكلهما متقارب وحسابهما مختلف؛ دمجهما خطأ محاسبي لا اختصار (docs/39 §4).

## السحب بخطوتين
request يرسل رمزاً بلا خصم، و confirm هو ما يخصم ويحجز. شاشة سيرو كانت خطوة
واحدة ولم تُقلَّد. الرمز الخاطئ لا يُرجع المستخدم لخطوة المبلغ.

الرصيد التشغيلي معروض منفصلاً عن الأرباح: منه تُخصم العمولة ونفاده يوقف
وصول الطلبات — خلطه بالأرباح يخفي سبب توقّف العمل عن السائق.

FareSummary يعرض رقم كلّ طرف: price_for_passenger للراكب و price_for_driver
للسائق — حقلان منفصلان والفرق عمولة (docs/38 §4).

الإلغاء بتأكيد صريح مع سبب؛ السبب لا يقبله عقد الخادم بعد لكن السؤال يخفض
الإلغاء العرضي ويجهّز الحقل.

flutter analyze نظيف · الراكب 86 ملف/6,280 سطر · السائق 83 ملف/5,818 سطر.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

apps/driver_new/lib/core/di.dart

@@ -6,8 +6,13 @@ import 'package:shared_preferences/shared_preferences.dart';
 
 import '../features/auth/cubit/login_cubit.dart';
 import '../features/auth/data/auth_repository.dart';
+import '../features/rating/cubit/rating_cubit.dart';
+import '../features/rating/data/rating_repository.dart';
 import '../features/settings/cubit/settings_cubit.dart';
 import '../features/trip/cubit/duty_cubit.dart';
+import '../features/wallet/cubit/payout_cubit.dart';
+import '../features/wallet/cubit/wallet_cubit.dart';
+import '../features/wallet/data/wallet_repository.dart';
 import '../features/trip/data/maps_repository.dart';
 import '../features/trip/data/trip_repository.dart';
 import 'api/antlaq_api.dart';
@@ -15,6 +20,7 @@ import 'api/api_client.dart';
 import 'location/location_service.dart';
 import 'realtime/realtime_service.dart';
 import 'session/session_cubit.dart';
+import 'build_config.dart';
 import 'storage/token_store.dart';
 
 final sl = GetIt.instance;
@@ -58,6 +64,16 @@ Future<void> setupInjector() async {
   sl.registerSingleton<LocationService>(LocationService());
   sl.registerSingleton<RealtimeService>(RealtimeService(tokens));
 
+  sl.registerSingleton<RatingRepository>(RatingRepository(sl()));
+  sl.registerFactory<RatingCubit>(() => RatingCubit(sl()));
+
+  // المحفظة خلف علم الاستحقاق: الميزة المطفأة لا تُسجَّل أصلاً (docs/23 §5).
+  if (Features.wallet) {
+    sl.registerSingleton<WalletRepository>(WalletRepository(sl()));
+    sl.registerFactory<WalletCubit>(() => WalletCubit(sl()));
+    sl.registerFactory<PayoutCubit>(() => PayoutCubit(sl()));
+  }
+
   sl.registerFactory<DutyCubit>(() => DutyCubit(
         trips: sl(),
         location: sl(),

apps/driver_new/lib/core/format/money.dart

@@ -0,0 +1,34 @@
+import 'package:intl/intl.dart';
+
+/// كل المبالغ تصل من الخادم **نصوصاً** لا أرقاماً (`"0.000"` — docs/38 §12.2).
+/// تمريرها لعملية حسابية بلا تحويل يعطي نتائج صامتة خاطئة، لذلك التحويل
+/// والعرض يمرّان من هنا وحدهما.
+class Money {
+  const Money._();
+
+  /// `null` عند نصّ غير صالح — لا صفر: الصفر رصيدٌ حقيقي، والغياب ليس رصيداً.
+  static double? parse(String? raw) =>
+      raw == null ? null : double.tryParse(raw);
+
+  /// العملة ورمزها من إعداد المستأجر (country pack)، لا ثابتة في التطبيق
+  /// (docs/26 §5). الأرقام لاتينية في اللغتين.
+  static String format(String? raw, String currency, {String locale = 'en'}) {
+    final value = parse(raw);
+    if (value == null) return '—';
+    final digits = currency == 'JOD' ? 3 : 2;
+    final text = NumberFormat.decimalPatternDigits(
+      locale: locale,
+      decimalDigits: digits,
+    ).format(value);
+    return currency.isEmpty ? text : '$text $currency';
+  }
+
+  static String formatNum(num value, String currency, {int? decimalDigits}) {
+    final digits = decimalDigits ?? (currency == 'JOD' ? 3 : 2);
+    final text = NumberFormat.decimalPatternDigits(
+      locale: 'en',
+      decimalDigits: digits,
+    ).format(value);
+    return currency.isEmpty ? text : '$text $currency';
+  }
+}

apps/driver_new/lib/core/l10n/app_ar.arb

@@ -123,5 +123,43 @@
   "driverArrivedAction": "وصلت لموقع الراكب",
   "driverStartTrip": "بدء الرحلة",
   "driverEndTrip": "إنهاء الرحلة",
-  "driverOnTheWay": "في الطريق للراكب"
+  "driverOnTheWay": "في الطريق للراكب",
+  "rateTitle": "كيف كانت رحلتك؟",
+  "rateTitleDriver": "كيف كان الراكب؟",
+  "rateLead": "تقييمك يساعدنا على تحسين الخدمة",
+  "rateComment": "أضف ملاحظة (اختياري)",
+  "rateSubmit": "إرسال التقييم",
+  "rateSkip": "لاحقاً",
+  "rateAlready": "سبق أن قيّمت هذه الرحلة",
+  "tripFareTitle": "تفاصيل الأجرة",
+  "tripFare": "الأجرة",
+  "tripEarnings": "أرباحك",
+  "tripCommission": "العمولة",
+  "tripCancelTitle": "سبب الإلغاء",
+  "tripCancelReasonWait": "الانتظار طويل",
+  "tripCancelReasonMistake": "طلبت بالخطأ",
+  "tripCancelReasonOther": "سبب آخر",
+  "tripCancelConfirm": "تأكيد الإلغاء",
+  "tripCancelKeep": "متابعة الرحلة",
+  "walletTitle": "المحفظة",
+  "walletBalance": "الرصيد",
+  "walletTopup": "شحن الرصيد",
+  "walletTopupAmount": "المبلغ",
+  "walletTransactions": "الحركات",
+  "walletEmpty": "لا حركات بعد",
+  "walletTopupFailed": "تعذّر الشحن",
+  "creditTitle": "الرصيد التشغيلي",
+  "creditLead": "تُخصم منه العمولة عند إنهاء كل رحلة",
+  "creditBlocked": "رصيدك التشغيلي نفد — اشحنه لتستقبل الطلبات",
+  "payoutTitle": "سحب الأرباح",
+  "payoutAmount": "مبلغ السحب",
+  "payoutChannel": "قناة الاستلام",
+  "payoutRequest": "أرسل رمز التأكيد",
+  "payoutOtpTitle": "أكّد السحب",
+  "payoutOtpLead": "أرسلنا رمزاً إلى رقمك لتأكيد السحب",
+  "payoutConfirm": "تأكيد السحب",
+  "payoutDone": "تم إرسال طلب السحب",
+  "payoutFailed": "تعذّر إتمام السحب",
+  "payoutInsufficient": "الرصيد لا يكفي",
+  "payoutHistory": "طلبات السحب"
 }

apps/driver_new/lib/core/l10n/app_en.arb

@@ -123,5 +123,43 @@
   "driverArrivedAction": "I've arrived",
   "driverStartTrip": "Start trip",
   "driverEndTrip": "End trip",
-  "driverOnTheWay": "Heading to rider"
+  "driverOnTheWay": "Heading to rider",
+  "rateTitle": "How was your ride?",
+  "rateTitleDriver": "How was your rider?",
+  "rateLead": "Your rating helps us improve",
+  "rateComment": "Add a note (optional)",
+  "rateSubmit": "Submit rating",
+  "rateSkip": "Later",
+  "rateAlready": "You already rated this trip",
+  "tripFareTitle": "Fare breakdown",
+  "tripFare": "Fare",
+  "tripEarnings": "Your earnings",
+  "tripCommission": "Commission",
+  "tripCancelTitle": "Why are you cancelling?",
+  "tripCancelReasonWait": "The wait is too long",
+  "tripCancelReasonMistake": "I requested by mistake",
+  "tripCancelReasonOther": "Another reason",
+  "tripCancelConfirm": "Confirm cancellation",
+  "tripCancelKeep": "Keep the ride",
+  "walletTitle": "Wallet",
+  "walletBalance": "Balance",
+  "walletTopup": "Top up",
+  "walletTopupAmount": "Amount",
+  "walletTransactions": "Transactions",
+  "walletEmpty": "No transactions yet",
+  "walletTopupFailed": "Top-up failed",
+  "creditTitle": "Operating credit",
+  "creditLead": "Commission is deducted from it when each trip ends",
+  "creditBlocked": "Your operating credit ran out — top it up to receive requests",
+  "payoutTitle": "Withdraw earnings",
+  "payoutAmount": "Amount",
+  "payoutChannel": "Payout channel",
+  "payoutRequest": "Send confirmation code",
+  "payoutOtpTitle": "Confirm withdrawal",
+  "payoutOtpLead": "We sent a code to your number to confirm this withdrawal",
+  "payoutConfirm": "Confirm withdrawal",
+  "payoutDone": "Withdrawal request sent",
+  "payoutFailed": "Withdrawal failed",
+  "payoutInsufficient": "Insufficient balance",
+  "payoutHistory": "Withdrawal requests"
 }

apps/driver_new/lib/core/router.dart

@@ -7,7 +7,10 @@ import 'session/session_cubit.dart';
 import 'session/session_state.dart';
 import '../features/auth/view/login_page.dart';
 import '../features/auth/view/profile_page.dart';
+import '../features/rating/data/rating_repository.dart';
+import '../features/rating/view/rating_page.dart';
 import '../features/trip/view/duty_page.dart';
+import '../features/wallet/view/earnings_page.dart';
 import '../features/splash/view/splash_page.dart';
 import 'di.dart';
 
@@ -17,6 +20,8 @@ class Routes {
   static const login = '/login';
   static const profile = '/profile';
   static const home = '/home';
+  static const rating = '/rating';
+  static const wallet = '/wallet';
 }
 
 /// التوجيه يُشتقّ من `SessionCubit` وحده — لا `Navigator.push` بعد الدخول
@@ -35,10 +40,16 @@ final appRouter = GoRouter(
       SessionStatus.unauthenticated =>
         loc == Routes.login ? null : Routes.login,
       SessionStatus.needsProfile => loc == Routes.profile ? null : Routes.profile,
-      SessionStatus.authenticated =>
-        (loc == Routes.login || loc == Routes.profile || loc == Routes.splash)
-            ? Routes.home
-            : null,
+      // التقييم المعلّق يحجز التطبيق كله: لا شاشة أخرى قبل حسمه
+      // (docs/38 §7 — يُفرض عند الفتح).
+      SessionStatus.authenticated when session.pendingRating != null =>
+        loc == Routes.rating ? null : Routes.rating,
+      SessionStatus.authenticated => (loc == Routes.login ||
+              loc == Routes.profile ||
+              loc == Routes.splash ||
+              loc == Routes.rating)
+          ? Routes.home
+          : null,
       SessionStatus.unknown => Routes.splash,
     };
   },
@@ -55,6 +66,23 @@ final appRouter = GoRouter(
       path: Routes.profile,
       builder: (context, state) => const ProfilePage(),
     ),
+    GoRoute(
+      path: Routes.rating,
+      builder: (context, state) {
+        final pending = sl<SessionCubit>().state.pendingRating!;
+        return RatingPage(
+          pending: PendingRating(
+            tripId: pending.tripId,
+            role: pending.role,
+          ),
+          onDone: sl<SessionCubit>().onRatingResolved,
+        );
+      },
+    ),
+    GoRoute(
+      path: Routes.wallet,
+      builder: (context, state) => const EarningsPage(),
+    ),
     GoRoute(
       path: Routes.home,
       builder: (context, state) => const DutyPage(),

apps/driver_new/lib/core/session/session_cubit.dart

@@ -1,3 +1,5 @@
+import 'dart:async';
+
 import 'package:flutter_bloc/flutter_bloc.dart';
 
 import '../api/api_exception.dart';
@@ -46,12 +48,34 @@ class SessionCubit extends Cubit<SessionState> {
     emit(const SessionState(status: SessionStatus.unauthenticated));
   }
 
+  /// يُنادى بعد التقييم أو تخطّيه — يرفع الحجز عن بقية التطبيق.
+  void onRatingResolved() =>
+      emit(state.copyWith(clearPendingRating: true));
+
   void _apply(AppUser user) {
     emit(SessionState(
       status: user.needsProfile
           ? SessionStatus.needsProfile
           : SessionStatus.authenticated,
       user: user,
+      pendingRating: state.pendingRating,
     ));
+    // التقييم المعلّق يُفحص بعد إثبات الجلسة لا قبلها.
+    if (!user.needsProfile) unawaited(_checkPendingRating());
+  }
+
+  Future<void> _checkPendingRating() async {
+    try {
+      final pending = await _repo.pendingRating();
+      if (isClosed || pending == null) return;
+      emit(state.copyWith(
+        pendingRating: PendingRatingRef(
+          tripId: pending.tripId,
+          role: pending.role,
+        ),
+      ));
+    } on ApiException {
+      // فحصٌ مساعد لا حاجز دخول.
+    }
   }
 }

apps/driver_new/lib/core/session/session_source.dart

@@ -8,6 +8,9 @@ import 'app_user.dart';
 /// ويُنفّذها `AuthRepository` في ميزة المصادقة.
 abstract interface class SessionSource {
   Future<AppUser> me();
+
+  /// رحلة تنتظر تقييماً، أو `null`. يُنفّذها `RatingRepository`.
+  Future<({String tripId, String role})?> pendingRating();
   Future<void> logout();
   bool get hasSession;
 }

apps/driver_new/lib/core/session/session_state.dart

@@ -2,6 +2,16 @@ import 'package:equatable/equatable.dart';
 
 import 'app_user.dart';
 
+/// رحلة تنتظر تقييماً — تُفحص عند كل فتح للتطبيق (docs/38 §7).
+class PendingRatingRef {
+  const PendingRatingRef({required this.tripId, required this.role});
+
+  final String tripId;
+  final String role;
+
+  bool get isDriver => role == 'driver';
+}
+
 enum SessionStatus {
   /// قبل أن نعرف — تُعرض شاشة الإقلاع، ولا يُتّخذ قرار توجيه.
   unknown,
@@ -13,20 +23,34 @@ enum SessionStatus {
 }
 
 class SessionState extends Equatable {
-  const SessionState({this.status = SessionStatus.unknown, this.user});
+  const SessionState({
+    this.status = SessionStatus.unknown,
+    this.user,
+    this.pendingRating,
+  });
 
   final SessionStatus status;
   final AppUser? user;
 
+  /// وجودها يفرض شاشة التقييم قبل أي شاشة أخرى.
+  final PendingRatingRef? pendingRating;
+
   bool get isReady => status != SessionStatus.unknown;
 
-  SessionState copyWith({SessionStatus? status, AppUser? user}) {
+  SessionState copyWith({
+    SessionStatus? status,
+    AppUser? user,
+    PendingRatingRef? pendingRating,
+    bool clearPendingRating = false,
+  }) {
     return SessionState(
       status: status ?? this.status,
       user: user ?? this.user,
+      pendingRating:
+          clearPendingRating ? null : (pendingRating ?? this.pendingRating),
     );
   }
 
   @override
-  List<Object?> get props => [status, user];
+  List<Object?> get props => [status, user, pendingRating?.tripId];
 }