Files
tripz-llc/apps/rider_new/lib/core/router.dart
T
Hamza-AyedandClaude Opus 5 66e28acc58 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

107 lines
3.3 KiB
Dart

import 'dart:async';
import 'package:flutter/widgets.dart';
import 'package:go_router/go_router.dart';
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';
class Routes {
const Routes._();
static const splash = '/';
static const login = '/login';
static const profile = '/profile';
static const home = '/home';
static const rating = '/rating';
static const wallet = '/wallet';
}
/// التوجيه يُشتقّ من `SessionCubit` وحده — لا `Navigator.push` بعد الدخول
/// موزّعة في الشاشات، فلا تتناقض حالتان.
final appRouter = GoRouter(
initialLocation: Routes.splash,
refreshListenable: _CubitListenable(sl<SessionCubit>().stream),
redirect: (context, state) {
final session = sl<SessionCubit>().state;
final loc = state.matchedLocation;
// قبل أن نعرف: نبقى على الإقلاع ولا نقرّر شيئاً.
if (!session.isReady) return loc == Routes.splash ? null : Routes.splash;
return switch (session.status) {
SessionStatus.unauthenticated =>
loc == Routes.login ? null : Routes.login,
SessionStatus.needsProfile => loc == Routes.profile ? null : Routes.profile,
// التقييم المعلّق يحجز التطبيق كله: لا شاشة أخرى قبل حسمه
// (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,
};
},
routes: [
GoRoute(
path: Routes.splash,
builder: (context, state) => const SplashPage(),
),
GoRoute(
path: Routes.login,
builder: (context, state) => const LoginPage(),
),
GoRoute(
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(),
),
],
);
/// جسر بين تيّار الـCubit و`refreshListenable` الذي يطلبه go_router.
class _CubitListenable extends ChangeNotifier {
_CubitListenable(Stream<dynamic> stream) {
_sub = stream.listen((_) => notifyListeners());
}
late final StreamSubscription<dynamic> _sub;
@override
void dispose() {
_sub.cancel();
super.dispose();
}
}