feat(apps): الدراور وطبقتا الميزات والإشعارات — المرحلة 6

## طبقتا الميزات مُطبَّقتان معاً
AppDrawer يفحص: Features.wallet && context.tenantHas('wallet')
- Features.x ثابت const: يقرّر ما يُبنى في الـbinary. إطفاؤه يحذف الكود
  فلا يُستخرج (docs/23 §5)
- tenantHas من GET /tenant/config/:slug: يقرّر ما يُعرض ممّا بُني حسب اشتراك
  المستأجر (docs/38 §10)
هذا هو ربط lite/pro/max عملياً. TenantCubit يعرض النسخة المخزّنة فوراً ثم
يحدّثها: إقلاع بلا إنترنت يعرض الميزات المعروفة آخر مرة لا شاشة فارغة.

## الشاشات
الدراور · تعديل الحساب · سجلّ الرحلات · الإعدادات (مظهر + لغة) · المساعدة.
الرقم في تعديل الحساب معطّل مع سبب معروض لا مخفي: هو هوية الحساب على الخادم
وتغييره يعني حساباً آخر (docs/38 §1).

## الإشعارات
PushService معزول — الملف الوحيد الذي يعرف Firebase. التسجيل بعد إثبات
الجلسة عبر خطّاف في SessionCubit، ومع اشتراك onTokenRefresh: بدونه تتوقّف
الإشعارات بصمت بعد أسابيع. الإعداد الأصلي كان جاهزاً مسبقاً.

## تصحيحات بنيوية كشفها فحص آلي
docs/23 §1 يمنع أن تستورد ميزة من أخرى — وكانت خمس مخالفات:
1. features/history أُدمجت في features/trip — السجلّ جزء من ميزة الرحلة
2. AppDrawer صعد إلى core/ui — هيكل تطبيق لا ميزة
3. AuthFailure → core/api/api_failure.dart، ومترجمه → core/ui/failure_text.dart
4. AuthHeader → core/ui/form_header.dart
5. ProfileRepository مستقلّ عن AuthRepository: تعديل الملف ليس مصادقة

flutter analyze نظيف · الراكب 98 ملف/7,497 سطر · السائق 95 ملف/6,931 سطر.
فحوص آلية نظيفة: صفر استيراد بين ميزتين · core يستورد features من di و
router وحدهما · Firebase و intaleq_maps و geolocator و socket_io كلٌّ معزول.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Hamza-Ayed
2026-08-04 23:52:27 +03:00
co-authored by Claude Opus 5
parent 66e28acc58
commit 096acae74e
138 changed files with 2716 additions and 125 deletions
+186
View File
@@ -0,0 +1,186 @@
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:go_router/go_router.dart';
import '../build_config.dart';
import '../config.dart';
import '../design/tokens.dart';
import '../design/tripz_colors.dart';
import '../l10n/l10n.dart';
import '../router.dart';
import '../session/session_cubit.dart';
import '../session/session_state.dart';
import '../tenant/feature_gate.dart';
/// الدراور — نقطة تطبيق **طبقتَي الميزات** معاً (docs/23 §5 + docs/38 §10):
///
/// * `Features.x` ثابت: يقرّر ما بُني في الـbinary. إطفاؤه يحذف الكود.
/// * `context.tenantHas('x')`: يقرّر ما يُعرض ممّا بُني، حسب اشتراك المستأجر.
///
/// أيّهما `false` يُخفي المدخل — ولا يُكتب `if` ثانٍ في أي شاشة.
class AppDrawer extends StatelessWidget {
const AppDrawer({super.key});
@override
Widget build(BuildContext context) {
final l10n = context.l10n;
final isDriver = AppConfig.appRole == 'driver';
return Drawer(
child: SafeArea(
child: Column(
children: [
const _Header(),
const Divider(height: 1),
Expanded(
child: ListView(
padding: const EdgeInsets.symmetric(vertical: Space.xs),
children: [
_Item(
icon: Icons.person_outline_rounded,
label: l10n.menuProfile,
route: Routes.profileEdit,
),
_Item(
icon: Icons.route_outlined,
label: l10n.menuTrips,
route: Routes.history,
),
if (Features.wallet && context.tenantHas('wallet'))
_Item(
icon: Icons.account_balance_wallet_outlined,
label: isDriver ? l10n.menuEarnings : l10n.menuWallet,
route: Routes.wallet,
),
_Item(
icon: Icons.settings_outlined,
label: l10n.menuSettings,
route: Routes.settings,
),
_Item(
icon: Icons.help_outline_rounded,
label: l10n.menuSupport,
route: Routes.support,
),
],
),
),
const Divider(height: 1),
ListTile(
leading: Icon(
Icons.logout_rounded,
color: context.tripzColors.danger,
),
title: Text(
l10n.menuLogout,
style: TextStyle(color: context.tripzColors.danger),
),
onTap: () => _confirmLogout(context),
),
],
),
),
);
}
Future<void> _confirmLogout(BuildContext context) async {
final l10n = context.l10n;
final session = context.read<SessionCubit>();
final ok = await showDialog<bool>(
context: context,
builder: (context) => AlertDialog(
content: Text(l10n.menuLogoutConfirm),
actions: [
TextButton(
onPressed: () => Navigator.of(context).pop(false),
child: Text(l10n.actionCancel),
),
TextButton(
onPressed: () => Navigator.of(context).pop(true),
child: Text(l10n.menuLogout),
),
],
),
);
// الخروج يمرّ بالجلسة وحدها؛ الراوتر يعيد التوجيه من تلقائه.
if (ok == true) await session.logout();
}
}
class _Header extends StatelessWidget {
const _Header();
@override
Widget build(BuildContext context) {
return BlocBuilder<SessionCubit, SessionState>(
builder: (context, session) {
final user = session.user;
return Padding(
padding: Space.page,
child: Row(
children: [
CircleAvatar(
radius: 26,
backgroundColor: context.colors.primaryContainer,
child: Icon(
Icons.person_rounded,
color: context.colors.onPrimaryContainer,
),
),
const SizedBox(width: Space.sm),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
user?.name ?? BuildConfig.appName,
style: context.texts.titleMedium,
overflow: TextOverflow.ellipsis,
),
Text(
user?.phone ?? '',
textDirection: TextDirection.ltr,
style: context.texts.bodySmall?.copyWith(
color: context.colors.onSurfaceVariant,
),
),
],
),
),
],
),
);
},
);
}
}
class _Item extends StatelessWidget {
const _Item({required this.icon, required this.label, required this.route});
final IconData icon;
final String label;
final String route;
@override
Widget build(BuildContext context) {
return ListTile(
leading: Icon(icon),
title: Text(label),
onTap: () {
Navigator.of(context).pop();
context.push(route);
},
);
}
}
@@ -1,8 +1,11 @@
import 'package:flutter/material.dart';
import '../design/tokens.dart';
import '../design/tripz_colors.dart';
import '../l10n/l10n.dart';
import 'tripz_button.dart';
/// حالة الفراغ: رسالة **تدلّ على الفعل التالي** لا مجرّد «لا يوجد»
@@ -1,8 +1,11 @@
import 'package:flutter/material.dart';
import '../design/tokens.dart';
import '../design/tripz_colors.dart';
import '../l10n/l10n.dart';
import 'tripz_button.dart';
/// حالة الخطأ: رسالة **بالعربية** مع «أعد المحاولة» — لا شاشة صامتة
@@ -0,0 +1,65 @@
import 'package:flutter/material.dart';
import '../../features/auth/cubit/phone_error.dart';
import '../api/api_failure.dart';
import '../design/tokens.dart';
import '../design/tripz_colors.dart';
import '../l10n/l10n.dart';
/// النقطة **الوحيدة** التي تُترجَم فيها رموز الفشل إلى نصّ.
/// الشاشات لا تكتب رسائل خطأ، والـCubit لا يعرف اللغة (راجع `auth_failure.dart`).
class AuthFailureText extends StatelessWidget {
const AuthFailureText({super.key, required this.failure});
final AuthFailure failure;
static String messageOf(BuildContext context, AuthFailure failure) {
final l10n = context.l10n;
return switch (failure) {
AuthFailure.invalidCode => l10n.otpErrInvalid,
AuthFailure.tooManyAttempts => l10n.otpErrTooManyAttempts,
AuthFailure.rateLimited => l10n.otpErrRateLimited,
AuthFailure.network => l10n.errorNetwork,
AuthFailure.timeout => l10n.errorTimeout,
AuthFailure.server => l10n.errorGeneric,
};
}
static String phoneMessageOf(BuildContext context, PhoneError error) {
final l10n = context.l10n;
return switch (error) {
PhoneError.empty => l10n.phoneErrEmpty,
PhoneError.leadingZero => l10n.phoneErrLeadingZero,
PhoneError.tooShort => l10n.phoneErrShort,
};
}
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.only(top: Space.sm),
child: Row(
children: [
Icon(
Icons.error_outline_rounded,
size: Sizes.iconSm,
color: context.tripzColors.danger,
),
const SizedBox(width: Space.xs),
Expanded(
child: Text(
messageOf(context, failure),
style: context.texts.bodySmall?.copyWith(
color: context.tripzColors.danger,
),
),
),
],
),
);
}
}
@@ -0,0 +1,50 @@
import 'package:flutter/material.dart';
import '../design/tokens.dart';
import '../design/tripz_colors.dart';
/// ترويسة موحّدة لشاشات الدخول: أيقونة ثم عنوان ثم سطر شارح.
/// «الشاشة مهمة واحدة» — سؤال واحد وزر أساسي واحد أسفلها (docs/26 §8.1).
class FormHeader extends StatelessWidget {
const FormHeader({
super.key,
required this.icon,
required this.title,
required this.lead,
});
final IconData icon;
final String title;
final String lead;
@override
Widget build(BuildContext context) {
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Container(
padding: const EdgeInsets.all(Space.sm),
decoration: BoxDecoration(
color: context.colors.primaryContainer,
borderRadius: Radii.card_,
),
child: Icon(
icon,
size: Sizes.icon,
color: context.colors.onPrimaryContainer,
),
),
const SizedBox(height: Space.md),
Text(title, style: context.texts.headlineSmall),
const SizedBox(height: Space.xs),
Text(
lead,
style: context.texts.bodyMedium?.copyWith(
color: context.colors.onSurfaceVariant,
),
),
],
);
}
}
@@ -1,6 +1,7 @@
import 'package:flutter/material.dart';
import '../design/tokens.dart';
import '../design/tripz_colors.dart';
/// هيكل تحميل — **لا spinner فارغ** (docs/26 §8.4).
@@ -1,6 +1,7 @@
import 'package:flutter/material.dart';
import '../design/tokens.dart';
import '../design/tripz_colors.dart';
enum BannerTone { info, success, warning, danger }
@@ -1,7 +1,9 @@
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import '../design/tokens.dart';
import '../design/typography.dart';
/// حقل رمز التحقّق — أربع خانات (طول رمز تريبز، docs/38 §2).
@@ -1,9 +1,13 @@
import 'package:flutter/material.dart';
import '../design/tokens.dart';
import 'empty_view.dart';
import 'error_view.dart';
import 'skeleton.dart';
import 'view_status.dart';
/// نقطة التنظيم المركزية (docs/26 §6). **ممنوع `Scaffold` خام في
@@ -1,7 +1,9 @@
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import '../design/tokens.dart';
import '../design/typography.dart';
/// حقل الإدخال الموحّد (docs/26 §7): نصّ · هاتف · بحث.