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,40 @@
+import '../../../core/api/api_client.dart';
+
+/// رحلة تنتظر تقييماً — يرجّعها الخادم عند كل فتح للتطبيق (docs/38 §7).
+class PendingRating {
+  const PendingRating({required this.tripId, required this.role});
+
+  final String tripId;
+
+  /// الدور يحدّد نصّ السؤال: الراكب يقيّم السائق والعكس.
+  final String role;
+
+  bool get isDriver => role == 'driver';
+}
+
+class RatingRepository {
+  RatingRepository(this._api);
+
+  final ApiClient _api;
+
+  /// `{"pending": null, "count": 0}` حين لا شيء — شكل مُتحقَّق حيّاً.
+  Future<PendingRating?> pending() async {
+    final res = await _api.get<Map<String, dynamic>>('/trips/rating/pending');
+    final pending = res['pending'];
+    if (pending is! Map<String, dynamic>) return null;
+    final tripId = pending['tripId'] as String?;
+    if (tripId == null) return null;
+    return PendingRating(
+      tripId: tripId,
+      role: pending['role'] as String? ?? 'rider',
+    );
+  }
+
+  /// التقييم المزدوج يرجّع **400** — تُعامَل كحالة معروفة لا كعطل.
+  Future<void> rate(String tripId, int stars, {String? comment}) {
+    return _api.post<Map<String, dynamic>>(
+      '/trips/$tripId/rate',
+      body: {'stars': stars, 'comment': ?comment},
+    );
+  }
+}