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>
2026-08-04 23:42:07 +03:00
parent 1156299d09
commit 66e28acc58
56 changed files with 2301 additions and 52 deletions
@@ -0,0 +1,31 @@
+import 'package:equatable/equatable.dart';
+
+/// المحفظة كما يرجّعها `GET /wallet` (شكل مُتحقَّق حيّاً، docs/38 §6).
+///
+/// ⚠️ **محفظتان لا واحدة**: محفظة الراكب **التزام** على المنصّة (رصيدٌ دفعه
+/// ولم يستهلكه بعد)، ومحفظة السائق **إيراد** له. دمجهما في شاشة أو حساب
+/// واحد خطأ محاسبي لا تجميلي — لذلك لا تُوحَّد شاشتاهما (docs/39 §4).
+class Wallet extends Equatable {
+  const Wallet({
+    required this.id,
+    required this.balance,
+    required this.currency,
+  });
+
+  final String id;
+
+  /// نصّ لا رقم (`"0.000"`) — يُحوَّل عبر `Money` عند الحاجة فقط.
+  final String balance;
+
+  /// من إعداد المستأجر: `JOD`/`EGP`/`SYP` — لا تُثبَّت في التطبيق.
+  final String currency;
+
+  factory Wallet.fromJson(Map<String, dynamic> json) => Wallet(
+        id: json['id'] as String? ?? '',
+        balance: json['balance']?.toString() ?? '0',
+        currency: json['currency'] as String? ?? '',
+      );
+
+  @override
+  List<Object?> get props => [id, balance, currency];
+}
@@ -0,0 +1,29 @@
+import 'package:equatable/equatable.dart';
+
+class WalletTxn extends Equatable {
+  const WalletTxn({
+    required this.id,
+    required this.amount,
+    required this.reason,
+    this.createdAt,
+  });
+
+  final String id;
+
+  /// موجب = دخول، سالب = خروج. النصّ كما وصل، والإشارة تُقرأ منه.
+  final String amount;
+  final String reason;
+  final DateTime? createdAt;
+
+  factory WalletTxn.fromJson(Map<String, dynamic> json) => WalletTxn(
+        id: json['id']?.toString() ?? '',
+        amount: json['amount']?.toString() ?? '0',
+        reason: json['reason'] as String? ?? json['type'] as String? ?? '',
+        createdAt: DateTime.tryParse(json['created_at']?.toString() ?? ''),
+      );
+
+  bool get isCredit => !amount.trim().startsWith('-');
+
+  @override
+  List<Object?> get props => [id, amount, reason, createdAt];
+}
@@ -0,0 +1,55 @@
+import '../../../core/api/api_client.dart';
+import 'models/wallet.dart';
+import 'models/wallet_txn.dart';
+
+class WalletRepository {
+  WalletRepository(this._api);
+
+  final ApiClient _api;
+
+  Future<Wallet> wallet() async {
+    final res = await _api.get<Map<String, dynamic>>('/wallet');
+    return Wallet.fromJson(res);
+  }
+
+  Future<List<WalletTxn>> transactions() async {
+    final res = await _api.get<List<dynamic>>('/wallet/transactions');
+    return res
+        .whereType<Map<String, dynamic>>()
+        .map(WalletTxn.fromJson)
+        .toList(growable: false);
+  }
+
+  Future<void> topup(num amount) =>
+      _api.post<Map<String, dynamic>>('/wallet/topup', body: {'amount': amount});
+
+  // ── السحب: خطوتان لا خطوة ────────────────────────────────────────────
+  // `request` يرسل رمزاً **بلا خصم**، و`confirm` هو ما يخصم ويحجز
+  // (docs/38 §6). شاشة سيرو كانت خطوة واحدة — لا تُقلَّد.
+
+  Future<({String payoutId, String? devCode})> requestPayout({
+    required num amount,
+    required String channel,
+  }) async {
+    final res = await _api.post<Map<String, dynamic>>(
+      '/payouts/request',
+      body: {'amount': amount, 'channel': channel},
+    );
+    final payout = res['payout'] as Map<String, dynamic>?;
+    return (
+      payoutId: payout?['id'] as String? ?? '',
+      devCode: res['dev_code']?.toString(),
+    );
+  }
+
+  Future<void> confirmPayout(String payoutId, String code) =>
+      _api.post<Map<String, dynamic>>(
+        '/payouts/$payoutId/confirm',
+        body: {'code': code},
+      );
+
+  Future<List<Map<String, dynamic>>> payouts() async {
+    final res = await _api.get<List<dynamic>>('/payouts/mine');
+    return res.whereType<Map<String, dynamic>>().toList(growable: false);
+  }
+}