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>
This commit is contained in:
Hamza-Ayed
2026-08-04 23:42:07 +03:00
co-authored by Claude Opus 5
parent 1156299d09
commit 66e28acc58
56 changed files with 2301 additions and 52 deletions
+32 -4
View File
@@ -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/ride_page.dart';
import '../features/wallet/view/wallet_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 WalletPage(),
),
GoRoute(
path: Routes.home,
builder: (context, state) => const RidePage(),