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
@@ -0,0 +1,31 @@
|
||||
import 'package:equatable/equatable.dart';
|
||||
|
||||
/// المحفظة كما يرجّعها `GET /wallet` (شكل مُتحقَّق حيّاً، docs/38 §6).
|
||||
///
|
||||
/// ⚠️ **محفظتان لا واحدة**: محفظة الراكب **التزام** على المنصّة (رصيدٌ دفعه
|
||||
/// ولم يستهلكه بعد)، ومحفظة السائق **إيراد** له. دمجهما في شاشة أو حساب
|
||||
/// واحد خطأ محاسبي لا تجميلي — لذلك لا تُوحَّد شاشتاهما (docs/39 §4).
|
||||
class Wallet extends Equatable {
|
||||
const Wallet({
|
||||
required this.id,
|
||||
required this.balance,
|
||||
required this.currency,
|
||||
});
|
||||
|
||||
final String id;
|
||||
|
||||
/// نصّ لا رقم (`"0.000"`) — يُحوَّل عبر `Money` عند الحاجة فقط.
|
||||
final String balance;
|
||||
|
||||
/// من إعداد المستأجر: `JOD`/`EGP`/`SYP` — لا تُثبَّت في التطبيق.
|
||||
final String currency;
|
||||
|
||||
factory Wallet.fromJson(Map<String, dynamic> json) => Wallet(
|
||||
id: json['id'] as String? ?? '',
|
||||
balance: json['balance']?.toString() ?? '0',
|
||||
currency: json['currency'] as String? ?? '',
|
||||
);
|
||||
|
||||
@override
|
||||
List<Object?> get props => [id, balance, currency];
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
import 'package:equatable/equatable.dart';
|
||||
|
||||
class WalletTxn extends Equatable {
|
||||
const WalletTxn({
|
||||
required this.id,
|
||||
required this.amount,
|
||||
required this.reason,
|
||||
this.createdAt,
|
||||
});
|
||||
|
||||
final String id;
|
||||
|
||||
/// موجب = دخول، سالب = خروج. النصّ كما وصل، والإشارة تُقرأ منه.
|
||||
final String amount;
|
||||
final String reason;
|
||||
final DateTime? createdAt;
|
||||
|
||||
factory WalletTxn.fromJson(Map<String, dynamic> json) => WalletTxn(
|
||||
id: json['id']?.toString() ?? '',
|
||||
amount: json['amount']?.toString() ?? '0',
|
||||
reason: json['reason'] as String? ?? json['type'] as String? ?? '',
|
||||
createdAt: DateTime.tryParse(json['created_at']?.toString() ?? ''),
|
||||
);
|
||||
|
||||
bool get isCredit => !amount.trim().startsWith('-');
|
||||
|
||||
@override
|
||||
List<Object?> get props => [id, amount, reason, createdAt];
|
||||
}
|
||||
Reference in New Issue
Block a user