## التقييم مفروض لا اختياري
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>
124 lines
4.5 KiB
Dart
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),
|
|
],
|
|
),
|
|
);
|
|
},
|
|
),
|
|
);
|
|
}
|
|
}
|