Files
tripz-llc/apps/driver_new/lib/features/wallet/view/earnings_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

104 lines
3.7 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/empty_view.dart';
import '../../../core/ui/status_banner.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../../../core/ui/tripz_sheet.dart';
import '../cubit/payout_cubit.dart';
import '../cubit/wallet_cubit.dart';
import '../cubit/wallet_state.dart';
import 'widgets/balance_card.dart';
import 'widgets/payout_sheet.dart';
import 'widgets/txn_tile.dart';
/// شاشة السائق المالية — **مختلفة عن محفظة الراكب عمداً**.
///
/// محفظة السائق **إيراد** له (أرباح تُسحب)، ومحفظة الراكب **التزام** على
/// المنصّة (رصيد مدفوع لم يُستهلك). دمجهما في شاشة واحدة خطأ محاسبي، ولذلك
/// لا تُوحَّد الشاشتان مهما تشابه شكلهما (docs/39 §4).
class EarningsPage extends StatefulWidget {
const EarningsPage({super.key});
@override
State<EarningsPage> createState() => _EarningsPageState();
}
class _EarningsPageState extends State<EarningsPage> {
late final WalletCubit _wallet = sl<WalletCubit>()..load();
@override
void dispose() {
_wallet.close();
super.dispose();
}
@override
Widget build(BuildContext context) {
final l10n = context.l10n;
return BlocProvider.value(
value: _wallet,
child: BlocBuilder<WalletCubit, WalletState>(
builder: (context, state) {
return TripzScaffold(
title: l10n.payoutTitle,
status: state.status,
error: state.error,
onRetry: _wallet.load,
child: ListView(
children: [
BalanceCard(
label: l10n.tripEarnings,
balance: state.wallet?.balance,
currency: state.currency,
action: TripzButton.primary(
label: l10n.payoutTitle,
onPressed: () => _openPayout(context),
),
),
const SizedBox(height: Space.md),
// الرصيد التشغيلي **ليس** أرباحاً: منه تُخصم العمولة، ونفاده
// يوقف وصول الطلبات. يُعرض منفصلاً كي لا يُخلط بالأرباح.
StatusBanner(
message: l10n.creditLead,
tone: BannerTone.info,
icon: Icons.account_balance_wallet_outlined,
),
const SizedBox(height: Space.lg),
Text(l10n.walletTransactions, style: context.texts.titleMedium),
const SizedBox(height: Space.xs),
if (state.transactions.isEmpty)
Padding(
padding: const EdgeInsets.only(top: Space.xl),
child: EmptyView(
icon: Icons.receipt_long_outlined,
message: l10n.walletEmpty,
),
)
else
for (final txn in state.transactions)
TxnTile(txn: txn, currency: state.currency),
],
),
);
},
),
);
}
void _openPayout(BuildContext context) {
TripzSheet.show(
context,
child: BlocProvider(
create: (_) => sl<PayoutCubit>(),
child: PayoutSheet(onDone: _wallet.load),
),
);
}
}