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
@@ -3,12 +3,13 @@ import 'package:flutter_bloc/flutter_bloc.dart';
import '../../../../core/design/tokens.dart';
import '../../../../core/design/tripz_colors.dart';
import '../../../../core/design/typography.dart';
import '../../../../core/l10n/l10n.dart';
import '../../../../core/ui/tripz_button.dart';
import '../../cubit/ride_cubit.dart';
import '../../data/models/trip.dart';
import 'cancel_sheet.dart';
import 'driver_badge.dart';
import 'fare_summary.dart';
/// بطاقة الرحلة الجارية: حالة واضحة ثم بيانات السائق ثم فعل واحد.
class ActiveTripSheet extends StatelessWidget {
@@ -33,28 +34,18 @@ class ActiveTripSheet extends StatelessWidget {
DriverBadge(trip: trip),
if (trip.priceForPassenger != null) ...[
const SizedBox(height: Space.md),
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Text(
l10n.rideConfirmTrip,
style: context.texts.bodyMedium?.copyWith(
color: context.colors.onSurfaceVariant,
),
),
Text(
'${trip.priceForPassenger} ${trip.currency}',
style: numericStyle(context.texts.titleLarge),
),
],
),
FareSummary(trip: trip),
],
if (canCancel) ...[
const SizedBox(height: Space.md),
TripzButton.text(
label: l10n.rideCancelTrip,
expanded: true,
onPressed: context.read<RideCubit>().cancelTrip,
// تأكيد صريح: الإلغاء أثناء رحلة مسندة له كلفة على الطرفين.
onPressed: () async {
final cubit = context.read<RideCubit>();
if (await CancelSheet.confirm(context)) await cubit.cancelTrip();
},
),
],
],
@@ -0,0 +1,60 @@
import 'package:flutter/material.dart';
import '../../../../core/design/tokens.dart';
import '../../../../core/l10n/l10n.dart';
import '../../../../core/ui/tripz_button.dart';
import '../../../../core/ui/tripz_sheet.dart';
/// الإلغاء لا يقع بضغطة واحدة: تأكيدٌ صريح مع سبب.
///
/// السبب لا يُرسَل للخادم (لا يقبله عقد `POST /trips/:id/cancel` — docs/38
/// §4)، لكن السؤال نفسه يخفض الإلغاء العرضي، ويجهّز الحقل حين يقبله الخادم.
class CancelSheet {
const CancelSheet._();
static Future<bool> confirm(BuildContext context) async {
final l10n = context.l10n;
var reason = 0;
final result = await TripzSheet.show<bool>(
context,
title: l10n.tripCancelTitle,
child: StatefulBuilder(
builder: (context, setState) => RadioGroup<int>(
groupValue: reason,
onChanged: (v) => setState(() => reason = v ?? 0),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
for (final (i, label) in [
l10n.tripCancelReasonWait,
l10n.tripCancelReasonMistake,
l10n.tripCancelReasonOther,
].indexed)
RadioListTile<int>(
value: i,
contentPadding: EdgeInsets.zero,
title: Text(label),
),
],
),
),
),
bottomAction: Column(
mainAxisSize: MainAxisSize.min,
children: [
TripzButton.primary(
label: l10n.tripCancelKeep,
onPressed: () => Navigator.of(context).pop(false),
),
const SizedBox(height: Space.xxs),
TripzButton.text(
label: l10n.tripCancelConfirm,
onPressed: () => Navigator.of(context).pop(true),
),
],
),
);
return result ?? false;
}
}
@@ -0,0 +1,51 @@
import 'package:flutter/material.dart';
import '../../../../core/design/tokens.dart';
import '../../../../core/design/tripz_colors.dart';
import '../../../../core/design/typography.dart';
import '../../../../core/format/money.dart';
import '../../../../core/l10n/l10n.dart';
import '../../data/models/trip.dart';
/// ملخّص الأجرة عند الإنهاء.
///
/// ⚠️ `price_for_passenger` و`price_for_driver` **حقلان منفصلان** والفرق
/// بينهما هو العمولة (docs/38 §4). كلٌّ يرى رقمه: الراكب ما يدفع، والسائق ما
/// يكسب — عرض رقم واحد للطرفين خطأ لا اختصار.
class FareSummary extends StatelessWidget {
const FareSummary({super.key, required this.trip, this.forDriver = false});
final Trip trip;
final bool forDriver;
@override
Widget build(BuildContext context) {
final l10n = context.l10n;
final amount = forDriver ? trip.priceForDriver : trip.priceForPassenger;
return Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
Text(l10n.tripFareTitle, style: context.texts.titleMedium),
const SizedBox(height: Space.sm),
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Text(
forDriver ? l10n.tripEarnings : l10n.tripFare,
style: context.texts.bodyMedium?.copyWith(
color: context.colors.onSurfaceVariant,
),
),
Text(
Money.format(amount, trip.currency),
style: numericStyle(context.texts.headlineSmall).copyWith(
color: forDriver ? context.tripzColors.success : null,
),
),
],
),
],
);
}
}