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:
co-authored by
Claude Opus 5
parent
1156299d09
commit
66e28acc58
@@ -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];
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user