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
@@ -1,3 +1,5 @@
import 'dart:async';
import 'package:flutter_bloc/flutter_bloc.dart';
import '../api/api_exception.dart';
@@ -46,12 +48,34 @@ class SessionCubit extends Cubit<SessionState> {
emit(const SessionState(status: SessionStatus.unauthenticated));
}
/// يُنادى بعد التقييم أو تخطّيه — يرفع الحجز عن بقية التطبيق.
void onRatingResolved() =>
emit(state.copyWith(clearPendingRating: true));
void _apply(AppUser user) {
emit(SessionState(
status: user.needsProfile
? SessionStatus.needsProfile
: SessionStatus.authenticated,
user: user,
pendingRating: state.pendingRating,
));
// التقييم المعلّق يُفحص بعد إثبات الجلسة لا قبلها.
if (!user.needsProfile) unawaited(_checkPendingRating());
}
Future<void> _checkPendingRating() async {
try {
final pending = await _repo.pendingRating();
if (isClosed || pending == null) return;
emit(state.copyWith(
pendingRating: PendingRatingRef(
tripId: pending.tripId,
role: pending.role,
),
));
} on ApiException {
// فحصٌ مساعد لا حاجز دخول.
}
}
}
@@ -8,6 +8,9 @@ import 'app_user.dart';
/// ويُنفّذها `AuthRepository` في ميزة المصادقة.
abstract interface class SessionSource {
Future<AppUser> me();
/// رحلة تنتظر تقييماً، أو `null`. يُنفّذها `RatingRepository`.
Future<({String tripId, String role})?> pendingRating();
Future<void> logout();
bool get hasSession;
}
@@ -2,6 +2,16 @@ import 'package:equatable/equatable.dart';
import 'app_user.dart';
/// رحلة تنتظر تقييماً — تُفحص عند كل فتح للتطبيق (docs/38 §7).
class PendingRatingRef {
const PendingRatingRef({required this.tripId, required this.role});
final String tripId;
final String role;
bool get isDriver => role == 'driver';
}
enum SessionStatus {
/// قبل أن نعرف — تُعرض شاشة الإقلاع، ولا يُتّخذ قرار توجيه.
unknown,
@@ -13,20 +23,34 @@ enum SessionStatus {
}
class SessionState extends Equatable {
const SessionState({this.status = SessionStatus.unknown, this.user});
const SessionState({
this.status = SessionStatus.unknown,
this.user,
this.pendingRating,
});
final SessionStatus status;
final AppUser? user;
/// وجودها يفرض شاشة التقييم قبل أي شاشة أخرى.
final PendingRatingRef? pendingRating;
bool get isReady => status != SessionStatus.unknown;
SessionState copyWith({SessionStatus? status, AppUser? user}) {
SessionState copyWith({
SessionStatus? status,
AppUser? user,
PendingRatingRef? pendingRating,
bool clearPendingRating = false,
}) {
return SessionState(
status: status ?? this.status,
user: user ?? this.user,
pendingRating:
clearPendingRating ? null : (pendingRating ?? this.pendingRating),
);
}
@override
List<Object?> get props => [status, user];
List<Object?> get props => [status, user, pendingRating?.tripId];
}