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,123 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
+
+import '../../../core/design/tokens.dart';
+import '../../../core/design/tripz_colors.dart';
+import '../../../core/di.dart';
+import '../../../core/l10n/l10n.dart';
+import '../../../core/ui/tripz_button.dart';
+import '../../../core/ui/tripz_scaffold.dart';
+import '../../../core/ui/tripz_text_field.dart';
+import '../cubit/rating_cubit.dart';
+import '../cubit/rating_state.dart';
+import '../data/rating_repository.dart';
+import 'star_row.dart';
+
+/// شاشة التقييم — **تُفرض عند فتح التطبيق** إن كانت هناك رحلة معلّقة
+/// (`GET /trips/rating/pending`، docs/38 §7). لذلك بلا زرّ رجوع في الشريط:
+/// الطريق الوحيد للخروج هو التقييم أو التخطّي الصريح.
+class RatingPage extends StatefulWidget {
+  const RatingPage({super.key, required this.pending, required this.onDone});
+
+  final PendingRating pending;
+  final VoidCallback onDone;
+
+  @override
+  State<RatingPage> createState() => _RatingPageState();
+}
+
+class _RatingPageState extends State<RatingPage> {
+  late final RatingCubit _cubit = sl<RatingCubit>()..attach(widget.pending);
+  final _comment = TextEditingController();
+
+  @override
+  void dispose() {
+    _comment.dispose();
+    _cubit.close();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = context.l10n;
+    // من يقيّم مَن: دور **هذا** المستخدم في الرحلة يأتي من الخادم، ولا
+    // يُستنتج من نوع التطبيق — الرقم نفسه قد يكون له حسابان (docs/38 §1).
+    final title = widget.pending.isDriver ? l10n.rateTitleDriver : l10n.rateTitle;
+
+    return BlocProvider.value(
+      value: _cubit,
+      child: BlocConsumer<RatingCubit, RatingState>(
+        listenWhen: (p, n) => p.status != n.status,
+        listener: (context, state) {
+          if (state.status == RatingStatus.done ||
+              state.status == RatingStatus.alreadyRated) {
+            widget.onDone();
+          }
+        },
+        builder: (context, state) {
+          return TripzScaffold(
+            showAppBar: false,
+            bottomAction: Column(
+              mainAxisSize: MainAxisSize.min,
+              children: [
+                TripzButton.primary(
+                  label: l10n.rateSubmit,
+                  loading: state.status == RatingStatus.submitting,
+                  onPressed: state.canSubmit ? _cubit.submit : null,
+                ),
+                TripzButton.text(
+                  label: l10n.rateSkip,
+                  onPressed: widget.onDone,
+                ),
+              ],
+            ),
+            child: ListView(
+              children: [
+                const SizedBox(height: Space.xxl),
+                Icon(
+                  Icons.star_rounded,
+                  size: 56,
+                  color: context.tripzColors.warning,
+                ),
+                const SizedBox(height: Space.md),
+                Text(
+                  title,
+                  textAlign: TextAlign.center,
+                  style: context.texts.headlineSmall,
+                ),
+                const SizedBox(height: Space.xs),
+                Text(
+                  l10n.rateLead,
+                  textAlign: TextAlign.center,
+                  style: context.texts.bodyMedium?.copyWith(
+                    color: context.colors.onSurfaceVariant,
+                  ),
+                ),
+                const SizedBox(height: Space.lg),
+                StarRow(value: state.stars, onChanged: _cubit.setStars),
+                const SizedBox(height: Space.lg),
+                TripzTextField(
+                  controller: _comment,
+                  hint: l10n.rateComment,
+                  onChanged: _cubit.setComment,
+                ),
+                if (state.status == RatingStatus.failed) ...[
+                  const SizedBox(height: Space.sm),
+                  Text(
+                    l10n.errorGeneric,
+                    textAlign: TextAlign.center,
+                    style: context.texts.bodySmall?.copyWith(
+                      color: context.tripzColors.danger,
+                    ),
+                  ),
+                ],
+                // مساحة للـCTA السفلي كي لا يغطّي الحقل عند فتح الكيبورد.
+                const SizedBox(height: Sizes.control),
+              ],
+            ),
+          );
+        },
+      ),
+    );
+  }
+}