Files
tripz-llc/apps/driver_new/lib/features/rating/view/rating_page.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

124 lines
4.5 KiB
Dart

import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import '../../../core/design/tokens.dart';
import '../../../core/design/tripz_colors.dart';
import '../../../core/di.dart';
import '../../../core/l10n/l10n.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../../../core/ui/tripz_text_field.dart';
import '../cubit/rating_cubit.dart';
import '../cubit/rating_state.dart';
import '../data/rating_repository.dart';
import 'star_row.dart';
/// شاشة التقييم — **تُفرض عند فتح التطبيق** إن كانت هناك رحلة معلّقة
/// (`GET /trips/rating/pending`، docs/38 §7). لذلك بلا زرّ رجوع في الشريط:
/// الطريق الوحيد للخروج هو التقييم أو التخطّي الصريح.
class RatingPage extends StatefulWidget {
const RatingPage({super.key, required this.pending, required this.onDone});
final PendingRating pending;
final VoidCallback onDone;
@override
State<RatingPage> createState() => _RatingPageState();
}
class _RatingPageState extends State<RatingPage> {
late final RatingCubit _cubit = sl<RatingCubit>()..attach(widget.pending);
final _comment = TextEditingController();
@override
void dispose() {
_comment.dispose();
_cubit.close();
super.dispose();
}
@override
Widget build(BuildContext context) {
final l10n = context.l10n;
// من يقيّم مَن: دور **هذا** المستخدم في الرحلة يأتي من الخادم، ولا
// يُستنتج من نوع التطبيق — الرقم نفسه قد يكون له حسابان (docs/38 §1).
final title = widget.pending.isDriver ? l10n.rateTitleDriver : l10n.rateTitle;
return BlocProvider.value(
value: _cubit,
child: BlocConsumer<RatingCubit, RatingState>(
listenWhen: (p, n) => p.status != n.status,
listener: (context, state) {
if (state.status == RatingStatus.done ||
state.status == RatingStatus.alreadyRated) {
widget.onDone();
}
},
builder: (context, state) {
return TripzScaffold(
showAppBar: false,
bottomAction: Column(
mainAxisSize: MainAxisSize.min,
children: [
TripzButton.primary(
label: l10n.rateSubmit,
loading: state.status == RatingStatus.submitting,
onPressed: state.canSubmit ? _cubit.submit : null,
),
TripzButton.text(
label: l10n.rateSkip,
onPressed: widget.onDone,
),
],
),
child: ListView(
children: [
const SizedBox(height: Space.xxl),
Icon(
Icons.star_rounded,
size: 56,
color: context.tripzColors.warning,
),
const SizedBox(height: Space.md),
Text(
title,
textAlign: TextAlign.center,
style: context.texts.headlineSmall,
),
const SizedBox(height: Space.xs),
Text(
l10n.rateLead,
textAlign: TextAlign.center,
style: context.texts.bodyMedium?.copyWith(
color: context.colors.onSurfaceVariant,
),
),
const SizedBox(height: Space.lg),
StarRow(value: state.stars, onChanged: _cubit.setStars),
const SizedBox(height: Space.lg),
TripzTextField(
controller: _comment,
hint: l10n.rateComment,
onChanged: _cubit.setComment,
),
if (state.status == RatingStatus.failed) ...[
const SizedBox(height: Space.sm),
Text(
l10n.errorGeneric,
textAlign: TextAlign.center,
style: context.texts.bodySmall?.copyWith(
color: context.tripzColors.danger,
),
),
],
// مساحة للـCTA السفلي كي لا يغطّي الحقل عند فتح الكيبورد.
const SizedBox(height: Sizes.control),
],
),
);
},
),
);
}
}