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>
2026-08-04 23:52:27 +03:00
parent 66e28acc58
commit 096acae74e
138 changed files with 2716 additions and 125 deletions
@@ -1,38 +0,0 @@
-import '../../../core/api/api_exception.dart';
-
-/// سبب الفشل كـ**رمز** لا كنصّ.
-///
-/// docs/23 §3 يقول إن الـCubit يحوّل خطأ الشبكة إلى رسالة عربية؛ وdocs/26 §4
-/// (الأحدث، وهو الذي «يفعّل قاعدة docs/23 §2 التي كانت بلا أداة») يوجب مرور
-/// كل نص مرئي بطبقة الترجمة. والـCubit لا يعرف `BuildContext` (docs/23 §3).
-/// الجمع بينها: الـCubit يُصدر الرمز، والواجهة تترجمه سطراً واحداً — فتبقى
-/// الشاشة بلا منطق، والنص بلغتين.
-enum AuthFailure {
-  /// رمز خاطئ أو منتهي الصلاحية.
-  invalidCode,
-
-  /// تجاوز عدد المحاولات — الخادم يُبطل الرمز فوراً (docs/38 §2).
-  tooManyAttempts,
-
-  /// تجاوز حدّ طلب الرمز: ثلاثة كل خمس دقائق.
-  rateLimited,
-
-  network,
-  timeout,
-  server,
-}
-
-extension AuthFailureX on ApiException {
-  AuthFailure toAuthFailure() {
-    if (isRateLimited) return AuthFailure.rateLimited;
-    if (kind == ApiErrorKind.network) return AuthFailure.network;
-    if (kind == ApiErrorKind.timeout) return AuthFailure.timeout;
-    if (isUnauthorized) {
-      // الخادم يفرّق بين «رمز خاطئ» و«محاولات كثيرة» بالنصّ وحده.
-      return message.contains('Too many')
-          ? AuthFailure.tooManyAttempts
-          : AuthFailure.invalidCode;
-    }
-    return AuthFailure.server;
-  }
-}
@@ -1,14 +1,21 @@
 import 'dart:async';

 import 'package:flutter_bloc/flutter_bloc.dart';
+
 import 'package:permission_handler/permission_handler.dart';
+
 import 'package:shared_preferences/shared_preferences.dart';

 import '../../../core/api/api_exception.dart';
+
+import '../../../core/api/api_failure.dart';
+
 import '../../../core/config.dart';
+
 import '../data/auth_repository.dart';
-import 'auth_failure.dart';
+
 import 'login_state.dart';
+
 import 'phone_error.dart';

 /// تدفّق الدخول كاملاً: الشروط ← إذن الموقع ← الهاتف ← الرمز.
@@ -1,7 +1,9 @@
 import 'package:equatable/equatable.dart';

+import '../../../core/api/api_failure.dart';
+
 import '../../../core/session/app_user.dart';
-import 'auth_failure.dart';
+
 import 'phone_error.dart';

 /// خطوات الدخول بالترتيب الميداني المثبت في سيرو (docs/39 §2): بوابتان
@@ -1,8 +1,11 @@
 import '../../../core/api/api_client.dart';
-import '../../../core/storage/token_store.dart';
+
 import '../../../core/session/app_user.dart';
+
 import '../../../core/session/session_source.dart';

+import '../../../core/storage/token_store.dart';
+
 /// كل نداءات المصادقة (docs/38 §2). الـCubit لا ينادي Dio مباشرة أبداً
 /// (docs/23 §3).
 class AuthRepository implements SessionSource {
@@ -1,14 +1,22 @@
 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/l10n/l10n.dart';
+
 import '../../../core/ui/tripz_button.dart';
+
 import '../../../core/ui/tripz_scaffold.dart';
+
 import '../cubit/login_cubit.dart';
+
 import '../cubit/login_state.dart';
-import 'widgets/auth_header.dart';
+
+import '../../../core/ui/form_header.dart';

 /// البوابة الأولى: شاشة كاملة لا حوار، وزر متابعة **معطّل حتى يُؤشَّر**
 /// (docs/39 §2). تُحفظ الموافقة فلا تتكرر.
@@ -31,7 +39,7 @@ class AgreementView extends StatelessWidget {
          child: ListView(
            children: [
              const SizedBox(height: Space.xl),
-              AuthHeader(
+              FormHeader(
                icon: Icons.policy_outlined,
                title: l10n.agreementTitle,
                lead: l10n.agreementLead,
@@ -1,13 +1,21 @@
 import 'package:flutter/material.dart';
+
 import 'package:flutter_bloc/flutter_bloc.dart';

 import '../../../core/di.dart';
+
 import '../../../core/session/session_cubit.dart';
+
 import '../cubit/login_cubit.dart';
+
 import '../cubit/login_state.dart';
+
 import 'agreement_view.dart';
+
 import 'otp_view.dart';
+
 import 'permission_view.dart';
+
 import 'phone_view.dart';

 /// مضيف تدفّق الدخول: خطوة واحدة معروضة في كل لحظة، والانتقال بينها من
@@ -1,16 +1,26 @@
 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/l10n/l10n.dart';
+
+import '../../../core/ui/failure_text.dart';
+
 import '../../../core/ui/tripz_button.dart';
+
 import '../../../core/ui/tripz_otp_field.dart';
+
 import '../../../core/ui/tripz_scaffold.dart';
+
 import '../cubit/login_cubit.dart';
+
 import '../cubit/login_state.dart';
-import 'widgets/auth_failure_text.dart';
-import 'widgets/auth_header.dart';
+
+import '../../../core/ui/form_header.dart';

 class OtpView extends StatefulWidget {
  const OtpView({super.key});
@@ -44,7 +54,7 @@ class _OtpViewState extends State<OtpView> {
          child: ListView(
            children: [
              const SizedBox(height: Space.xl),
-              AuthHeader(
+              FormHeader(
                icon: Icons.mark_email_read_outlined,
                title: l10n.otpTitle,
                lead: l10n.otpLead(state.phone),
@@ -1,14 +1,22 @@
 import 'package:flutter/material.dart';
+
 import 'package:flutter_bloc/flutter_bloc.dart';

 import '../../../core/design/tokens.dart';
+
 import '../../../core/l10n/l10n.dart';
+
 import '../../../core/ui/status_banner.dart';
+
 import '../../../core/ui/tripz_button.dart';
+
 import '../../../core/ui/tripz_scaffold.dart';
+
 import '../cubit/login_cubit.dart';
+
 import '../cubit/login_state.dart';
-import 'widgets/auth_header.dart';
+
+import '../../../core/ui/form_header.dart';

 /// البوابة الثانية: إذن الموقع. عند الرفض النهائي لا يبقى إلا فتح إعدادات
 /// النظام — والعودة منها يلتقطها `LoginPage` بمراقبة دورة الحياة.
@@ -35,7 +43,7 @@ class PermissionView extends StatelessWidget {
          child: ListView(
            children: [
              const SizedBox(height: Space.xl),
-              AuthHeader(
+              FormHeader(
                icon: Icons.my_location_rounded,
                title: l10n.permissionTitle,
                lead: l10n.permissionLead,
@@ -1,15 +1,24 @@
 import 'package:flutter/material.dart';
+
 import 'package:flutter_bloc/flutter_bloc.dart';

 import '../../../core/design/tokens.dart';
+
 import '../../../core/l10n/l10n.dart';
+
+import '../../../core/ui/failure_text.dart';
+
 import '../../../core/ui/tripz_button.dart';
+
 import '../../../core/ui/tripz_scaffold.dart';
+
 import '../../../core/ui/tripz_text_field.dart';
+
 import '../cubit/login_cubit.dart';
+
 import '../cubit/login_state.dart';
-import 'widgets/auth_failure_text.dart';
-import 'widgets/auth_header.dart';
+
+import '../../../core/ui/form_header.dart';

 class PhoneView extends StatelessWidget {
  const PhoneView({super.key});
@@ -34,7 +43,7 @@ class PhoneView extends StatelessWidget {
          child: ListView(
            children: [
              const SizedBox(height: Space.xl),
-              AuthHeader(
+              FormHeader(
                icon: Icons.phone_outlined,
                title: l10n.phoneTitle,
                lead: l10n.phoneLead,
@@ -1,61 +0,0 @@
-import 'package:flutter/material.dart';
-
-import '../../../../core/design/tokens.dart';
-import '../../../../core/design/tripz_colors.dart';
-import '../../../../core/l10n/l10n.dart';
-import '../../cubit/auth_failure.dart';
-import '../../cubit/phone_error.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,
-              ),
-            ),
-          ),
-        ],
-      ),
-    );
-  }
-}
@@ -1,49 +0,0 @@
-import 'package:flutter/material.dart';
-
-import '../../../../core/design/tokens.dart';
-import '../../../../core/design/tripz_colors.dart';
-
-/// ترويسة موحّدة لشاشات الدخول: أيقونة ثم عنوان ثم سطر شارح.
-/// «الشاشة مهمة واحدة» — سؤال واحد وزر أساسي واحد أسفلها (docs/26 §8.1).
-class AuthHeader extends StatelessWidget {
-  const AuthHeader({
-    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,10 +1,14 @@
 import 'package:flutter_bloc/flutter_bloc.dart';

 import '../../../core/api/api_exception.dart';
-import '../../../core/ui/view_status.dart';
-import '../data/auth_repository.dart';
+
+import '../../../core/api/api_failure.dart';
+
 import '../../../core/session/app_user.dart';
-import 'auth_failure.dart';
+
+import '../../../core/ui/view_status.dart';
+
+import '../data/profile_repository.dart';

 class ProfileState {
  const ProfileState({
@@ -40,12 +44,12 @@ class ProfileState {
 class ProfileCubit extends Cubit<ProfileState> {
  ProfileCubit(this._repo) : super(const ProfileState());

-  final AuthRepository _repo;
+  final ProfileRepository _repo;

  Future<AppUser?> save(String name) async {
    emit(state.copyWith(saving: true, clearFailure: true));
    try {
-      final user = await _repo.updateProfile(name: name.trim());
+      final user = await _repo.update(name: name.trim());
      emit(state.copyWith(saving: false, user: user));
      return user;
    } on ApiException catch (e) {
@@ -0,0 +1,20 @@
+import '../../../core/api/api_client.dart';
+import '../../../core/session/app_user.dart';
+
+/// `PATCH /users/me` — يقبل `{ name, language }` فقط (docs/38 §3).
+///
+/// مستودع مستقلّ عن `AuthRepository` عمداً: تعديل الملف ليس مصادقة، وربطهما
+/// كان يجعل ميزة الملف تستورد ميزة المصادقة — وهو ممنوع (docs/23 §1).
+class ProfileRepository {
+  ProfileRepository(this._api);
+
+  final ApiClient _api;
+
+  Future<AppUser> update({String? name, String? language}) async {
+    final res = await _api.patch<Map<String, dynamic>>(
+      '/users/me',
+      body: {'name': ?name, 'language': ?language},
+    );
+    return AppUser.fromJson(res);
+  }
+}
@@ -0,0 +1,102 @@
+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/session/session_cubit.dart';
+
+import '../../../core/ui/tripz_button.dart';
+
+import '../../../core/ui/tripz_scaffold.dart';
+
+import '../../../core/ui/tripz_text_field.dart';
+
+import '../cubit/profile_cubit.dart';
+
+/// تعديل الاسم. **الرقم لا يُعدَّل**: هو هوية الحساب على الخادم، وتغييره
+/// يعني حساباً آخر (docs/38 §1) — فيُعرض معطّلاً مع سبب واضح لا مخفياً.
+class ProfileEditPage extends StatefulWidget {
+  const ProfileEditPage({super.key});
+
+  @override
+  State<ProfileEditPage> createState() => _ProfileEditPageState();
+}
+
+class _ProfileEditPageState extends State<ProfileEditPage> {
+  late final TextEditingController _name;
+
+  @override
+  void initState() {
+    super.initState();
+    _name = TextEditingController(
+      text: sl<SessionCubit>().state.user?.name ?? '',
+    );
+  }
+
+  @override
+  void dispose() {
+    _name.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = context.l10n;
+    return BlocProvider(
+      create: (_) => ProfileCubit(sl()),
+      child: BlocBuilder<ProfileCubit, ProfileState>(
+        builder: (context, state) {
+          final user = context.watch<SessionCubit>().state.user;
+          return TripzScaffold(
+            title: l10n.profileEditTitle,
+            bottomAction: TripzButton.primary(
+              label: l10n.actionSave,
+              loading: state.saving,
+              onPressed: () => _save(context),
+            ),
+            child: ListView(
+              children: [
+                TripzTextField(
+                  controller: _name,
+                  label: l10n.profileNameLabel,
+                  enabled: !state.saving,
+                ),
+                const SizedBox(height: Space.md),
+                TripzTextField(
+                  controller: TextEditingController(text: user?.phone ?? ''),
+                  label: l10n.profilePhone,
+                  enabled: false,
+                  numeric: true,
+                ),
+                const SizedBox(height: Space.xxs),
+                Text(
+                  l10n.profilePhoneLocked,
+                  style: context.texts.bodySmall?.copyWith(
+                    color: context.colors.onSurfaceVariant,
+                  ),
+                ),
+              ],
+            ),
+          );
+        },
+      ),
+    );
+  }
+
+  Future<void> _save(BuildContext context) async {
+    final l10n = context.l10n;
+    final messenger = ScaffoldMessenger.of(context);
+    final session = context.read<SessionCubit>();
+    final user = await context.read<ProfileCubit>().save(_name.text);
+    if (user == null) return;
+    session.onProfileCompleted(user);
+    messenger.showSnackBar(SnackBar(content: Text(l10n.profileSaved)));
+  }
+}
@@ -1,25 +1,35 @@
 import 'package:flutter/material.dart';
+
 import 'package:flutter_bloc/flutter_bloc.dart';

 import '../../../core/design/tokens.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/profile_cubit.dart';
-import '../../../core/session/session_cubit.dart';
-import 'widgets/auth_failure_text.dart';
-import 'widgets/auth_header.dart';

-class ProfilePage extends StatefulWidget {
-  const ProfilePage({super.key});
+import '../../../core/di.dart';
+
+import '../../../core/l10n/l10n.dart';
+
+import '../../../core/session/session_cubit.dart';
+
+import '../../../core/ui/failure_text.dart';
+
+import '../../../core/ui/tripz_button.dart';
+
+import '../../../core/ui/tripz_scaffold.dart';
+
+import '../../../core/ui/tripz_text_field.dart';
+
+import '../../../core/ui/form_header.dart';
+
+import '../cubit/profile_cubit.dart';
+
+class ProfileSetupPage extends StatefulWidget {
+  const ProfileSetupPage({super.key});

  @override
-  State<ProfilePage> createState() => _ProfilePageState();
+  State<ProfileSetupPage> createState() => _ProfileSetupPageState();
 }

-class _ProfilePageState extends State<ProfilePage> {
+class _ProfileSetupPageState extends State<ProfileSetupPage> {
  final _name = TextEditingController();
  String? _error;

@@ -46,7 +56,7 @@ class _ProfilePageState extends State<ProfilePage> {
            child: ListView(
              children: [
                const SizedBox(height: Space.xl),
-                AuthHeader(
+                FormHeader(
                  icon: Icons.person_outline_rounded,
                  title: l10n.profileTitle,
                  lead: l10n.profileLead,
@@ -1,7 +1,9 @@
 import 'package:flutter_bloc/flutter_bloc.dart';

 import '../../../core/api/api_exception.dart';
+
 import '../data/rating_repository.dart';
+
 import 'rating_state.dart';

 class RatingCubit extends Cubit<RatingState> {
@@ -1,16 +1,27 @@
 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';

 /// شاشة التقييم — **تُفرض عند فتح التطبيق** إن كانت هناك رحلة معلّقة
@@ -1,6 +1,7 @@
 import 'package:flutter/material.dart';

 import '../../../core/design/tokens.dart';
+
 import '../../../core/design/tripz_colors.dart';

 /// خمس نجوم — أهداف لمس ≥ 48 لأن الشاشة تُستعمل عادةً والمستخدم مستعجل.
@@ -1,5 +1,7 @@
 import 'package:flutter/material.dart';
+
 import 'package:flutter_bloc/flutter_bloc.dart';
+
 import 'package:shared_preferences/shared_preferences.dart';

 import 'settings_state.dart';
@@ -1,4 +1,5 @@
 import 'package:equatable/equatable.dart';
+
 import 'package:flutter/material.dart';

 /// المظهر واللغة (docs/26 §4) — محفوظان محلياً، وليسا سرّاً فيذهبان إلى
@@ -0,0 +1,84 @@
+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/l10n/l10n.dart';
+
+import '../../../core/ui/tripz_scaffold.dart';
+
+import '../cubit/settings_cubit.dart';
+
+import '../cubit/settings_state.dart';
+
+/// المظهر واللغة. تبديل اللغة **يقلب الاتجاه كاملاً** بلا إعادة تشغيل —
+/// `MaterialApp` يشتقّ RTL/LTR من الـlocale (docs/26 §4).
+class SettingsPage extends StatelessWidget {
+  const SettingsPage({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = context.l10n;
+    return BlocBuilder<SettingsCubit, SettingsState>(
+      builder: (context, state) {
+        final cubit = context.read<SettingsCubit>();
+        return TripzScaffold(
+          title: l10n.settingsTitle,
+          child: ListView(
+            children: [
+              Text(l10n.settingsTheme, style: context.texts.titleMedium),
+              const SizedBox(height: Space.xs),
+              RadioGroup<ThemeMode>(
+                groupValue: state.themeMode,
+                onChanged: (v) => cubit.setThemeMode(v ?? ThemeMode.system),
+                child: Column(
+                  children: [
+                    RadioListTile(
+                      value: ThemeMode.system,
+                      contentPadding: EdgeInsets.zero,
+                      title: Text(l10n.settingsThemeSystem),
+                    ),
+                    RadioListTile(
+                      value: ThemeMode.light,
+                      contentPadding: EdgeInsets.zero,
+                      title: Text(l10n.settingsThemeLight),
+                    ),
+                    RadioListTile(
+                      value: ThemeMode.dark,
+                      contentPadding: EdgeInsets.zero,
+                      title: Text(l10n.settingsThemeDark),
+                    ),
+                  ],
+                ),
+              ),
+              const Divider(height: Space.xl),
+              Text(l10n.settingsLanguage, style: context.texts.titleMedium),
+              const SizedBox(height: Space.xs),
+              RadioGroup<String>(
+                groupValue: state.locale.languageCode,
+                onChanged: (v) => cubit.setLocale(Locale(v ?? 'ar')),
+                child: Column(
+                  children: [
+                    RadioListTile(
+                      value: 'ar',
+                      contentPadding: EdgeInsets.zero,
+                      title: Text(l10n.settingsLanguageArabic),
+                    ),
+                    RadioListTile(
+                      value: 'en',
+                      contentPadding: EdgeInsets.zero,
+                      title: Text(l10n.settingsLanguageEnglish),
+                    ),
+                  ],
+                ),
+              ),
+            ],
+          ),
+        );
+      },
+    );
+  }
+}
@@ -1,13 +1,21 @@
 import 'package:flutter/material.dart';
+
 import 'package:flutter_bloc/flutter_bloc.dart';

 import '../../../core/build_config.dart';
+
 import '../../../core/config.dart';
+
 import '../../../core/design/tokens.dart';
+
 import '../../../core/design/tripz_colors.dart';
+
 import '../../../core/l10n/l10n.dart';
+
 import '../../../core/session/session_cubit.dart';

+import '../../../core/tenant/tenant_cubit.dart';
+
 /// شاشة الإقلاع: تستعيد الجلسة ثم يتولّى الراوتر التوجيه. لا تنقّل من هنا —
 /// قرار الوجهة في مكان واحد (`core/router.dart`).
 class SplashPage extends StatefulWidget {
@@ -23,7 +31,10 @@ class _SplashPageState extends State<SplashPage> {
    super.initState();
    // بعد أول إطار: `restore` قد يُصدر حالة فوراً، وإصدارها أثناء البناء خطأ.
    WidgetsBinding.instance.addPostFrameCallback((_) {
-      if (mounted) context.read<SessionCubit>().restore();
+      if (!mounted) return;
+      // إعداد المستأجر بلا توكن — يُجلب بالتوازي مع استعادة الجلسة لا بعدها.
+      context.read<TenantCubit>().load();
+      context.read<SessionCubit>().restore();
    });
  }

@@ -0,0 +1,62 @@
+import 'package:flutter/material.dart';
+
+import '../../../core/build_config.dart';
+
+import '../../../core/design/tokens.dart';
+
+import '../../../core/design/tripz_colors.dart';
+
+import '../../../core/l10n/l10n.dart';
+
+import '../../../core/ui/tripz_card.dart';
+
+import '../../../core/ui/tripz_scaffold.dart';
+
+/// المساعدة و«عن التطبيق». محتوى محلّي عمداً: الخادم لا يوفّر نقطة أسئلة
+/// شائعة، وربطها بنصّ من الشبكة يعني شاشة فارغة حين ينقطع الاتصال — وهو
+/// بالضبط الوقت الذي يفتح فيه المستخدم المساعدة.
+class SupportPage extends StatelessWidget {
+  const SupportPage({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = context.l10n;
+    return TripzScaffold(
+      title: l10n.supportTitle,
+      child: ListView(
+        children: [
+          TripzCard(
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Text(l10n.supportContact, style: context.texts.titleMedium),
+                const SizedBox(height: Space.xs),
+                Text(
+                  l10n.supportWhatsapp,
+                  style: context.texts.bodyMedium?.copyWith(
+                    color: context.colors.onSurfaceVariant,
+                  ),
+                ),
+              ],
+            ),
+          ),
+          const SizedBox(height: Space.md),
+          TripzCard(
+            child: Row(
+              mainAxisAlignment: MainAxisAlignment.spaceBetween,
+              children: [
+                Text(l10n.aboutVersion, style: context.texts.bodyMedium),
+                Text(
+                  BuildConfig.appName,
+                  style: context.texts.bodyMedium?.copyWith(
+                    color: context.colors.onSurfaceVariant,
+                  ),
+                ),
+              ],
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}
@@ -0,0 +1,44 @@
+import 'package:flutter_bloc/flutter_bloc.dart';
+
+import '../../../core/api/api_exception.dart';
+
+import '../../../core/ui/view_status.dart';
+
+import '../data/history_repository.dart';
+
+import '../data/models/trip.dart';
+
+class HistoryState {
+  const HistoryState({
+    this.status = ViewStatus.idle,
+    this.trips = const [],
+    this.error,
+  });
+
+  final ViewStatus status;
+  final List<Trip> trips;
+  final String? error;
+}
+
+class HistoryCubit extends Cubit<HistoryState> {
+  HistoryCubit(this._repo) : super(const HistoryState());
+
+  final HistoryRepository _repo;
+
+  Future<void> load() async {
+    emit(const HistoryState(status: ViewStatus.loading));
+    try {
+      final trips = await _repo.trips();
+      if (isClosed) return;
+      // قائمة فارغة ليست خطأ — لها حالتها الخاصة في TripzScaffold.
+      emit(HistoryState(
+        status: trips.isEmpty ? ViewStatus.empty : ViewStatus.success,
+        trips: trips,
+      ));
+    } on ApiException catch (e) {
+      if (!isClosed) {
+        emit(HistoryState(status: ViewStatus.error, error: e.message));
+      }
+    }
+  }
+}
@@ -0,0 +1,19 @@
+import '../../../core/api/api_client.dart';
+
+import 'models/trip.dart';
+
+/// سجلّ الرحلات. لا يستورد ميزة الرحلة كمنطق — يعيد استعمال نموذجها فقط،
+/// وهو الشكل الذي يرجّعه الخادم نفسه لكلا النقطتين.
+class HistoryRepository {
+  HistoryRepository(this._api);
+
+  final ApiClient _api;
+
+  Future<List<Trip>> trips() async {
+    final res = await _api.get<List<dynamic>>('/trips/mine');
+    return res
+        .whereType<Map<String, dynamic>>()
+        .map(Trip.fromJson)
+        .toList(growable: false);
+  }
+}
@@ -1,6 +1,9 @@
 import '../../../core/api/antlaq_api.dart';
+
 import 'models/geo_point.dart';
+
 import 'models/place.dart';
+
 import 'models/route_info.dart';

 /// كل الخرائط من map-saas مباشرة (قرار 2026-07-20). نقاط `/maps/*` في باك إند
@@ -1,7 +1,11 @@
 import '../../../core/api/api_client.dart';
+
 import 'models/fare_quote.dart';
+
 import 'models/geo_point.dart';
+
 import 'models/ride_type.dart';
+
 import 'models/trip.dart';

 class TripRepository {
@@ -6,6 +6,7 @@ import '../../../core/design/tripz_colors.dart';
 import '../../../core/di.dart';
 import '../../../core/l10n/l10n.dart';
 import '../../../core/ui/status_banner.dart';
+import '../../../core/ui/app_drawer.dart';
 import '../cubit/duty_cubit.dart';
 import '../cubit/duty_state.dart';
 import '../data/models/geo_point.dart';
@@ -36,6 +37,7 @@ class _DutyPageState extends State<DutyPage> {
    return BlocProvider.value(
      value: _cubit,
      child: Scaffold(
+        drawer: const AppDrawer(),
        body: Stack(
          children: [
            // الخريطة معزولة عن بقية الحالة: نبضة موقع كل 25 متراً يجب ألّا
@@ -50,6 +52,24 @@ class _DutyPageState extends State<DutyPage> {
                padding: Space.page,
                child: Column(
                  children: [
+                    Builder(
+                      builder: (context) => Align(
+                        alignment: AlignmentDirectional.topStart,
+                        child: Material(
+                          color: context.tripzColors.surfaceRaised,
+                          shape: const CircleBorder(),
+                          clipBehavior: Clip.antiAlias,
+                          child: InkWell(
+                            onTap: Scaffold.of(context).openDrawer,
+                            child: const Padding(
+                              padding: EdgeInsets.all(Space.sm),
+                              child: Icon(Icons.menu_rounded, size: Sizes.icon),
+                            ),
+                          ),
+                        ),
+                      ),
+                    ),
+                    const SizedBox(height: Space.xs),
                    BlocSelector<DutyCubit, DutyState, ({bool online, bool busy})>(
                      selector: (s) => (online: s.isOnline, busy: s.busy),
                      builder: (context, d) => DutyToggle(
@@ -0,0 +1,112 @@
+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/design/typography.dart';
+
+import '../../../core/di.dart';
+
+import '../../../core/format/money.dart';
+
+import '../../../core/l10n/l10n.dart';
+
+import '../../../core/ui/empty_view.dart';
+
+import '../../../core/ui/tripz_card.dart';
+
+import '../../../core/ui/tripz_scaffold.dart';
+
+import '../cubit/history_cubit.dart';
+
+import '../data/models/trip.dart';
+
+class HistoryPage extends StatefulWidget {
+  const HistoryPage({super.key});
+
+  @override
+  State<HistoryPage> createState() => _HistoryPageState();
+}
+
+class _HistoryPageState extends State<HistoryPage> {
+  late final HistoryCubit _cubit = sl<HistoryCubit>()..load();
+
+  @override
+  void dispose() {
+    _cubit.close();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = context.l10n;
+    return BlocProvider.value(
+      value: _cubit,
+      child: BlocBuilder<HistoryCubit, HistoryState>(
+        builder: (context, state) => TripzScaffold(
+          title: l10n.historyTitle,
+          status: state.status,
+          error: state.error,
+          onRetry: _cubit.load,
+          empty: EmptyView(
+            icon: Icons.route_outlined,
+            message: l10n.historyEmpty,
+          ),
+          child: ListView.separated(
+            itemCount: state.trips.length,
+            separatorBuilder: (context, i) => const SizedBox(height: Space.xs),
+            itemBuilder: (context, i) => _TripCard(trip: state.trips[i]),
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _TripCard extends StatelessWidget {
+  const _TripCard({required this.trip});
+
+  final Trip trip;
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = context.l10n;
+    final colors = context.tripzColors;
+
+    final (label, color) = switch (trip.status) {
+      TripStatus.completed || TripStatus.paid => (
+          l10n.historyStatusCompleted,
+          colors.success,
+        ),
+      TripStatus.cancelled ||
+      TripStatus.expired ||
+      TripStatus.noDrivers =>
+        (l10n.historyStatusCancelled, colors.danger),
+      _ => (l10n.historyStatusLive, colors.info),
+    };
+
+    return TripzCard(
+      child: Row(
+        children: [
+          Container(
+            width: 8,
+            height: 8,
+            decoration: BoxDecoration(color: color, shape: BoxShape.circle),
+          ),
+          const SizedBox(width: Space.sm),
+          Expanded(
+            child: Text(label, style: context.texts.bodyMedium),
+          ),
+          Text(
+            Money.format(trip.priceForPassenger ?? trip.quotedFare,
+                trip.currency),
+            style: numericStyle(context.texts.titleSmall),
+          ),
+        ],
+      ),
+    );
+  }
+}
@@ -1,8 +1,11 @@
 import 'package:flutter/material.dart';

 import '../../../../core/design/tokens.dart';
+
 import '../../../../core/design/tripz_colors.dart';
+
 import '../../../../core/design/typography.dart';
+
 import '../../data/models/trip.dart';

 /// بطاقة السائق ولوحة المركبة — أهم ما يبحث عنه الراكب في الشارع، فيأخذ
@@ -1,10 +1,15 @@
 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';

 /// ملخّص الأجرة عند الإنهاء.
@@ -1,9 +1,13 @@
 import 'package:flutter/material.dart';
+
 import 'package:intaleq_maps/intaleq_maps.dart' as im;

 import '../../../../core/config.dart';
+
 import '../../../../core/design/tripz_colors.dart';
+
 import '../../data/models/geo_point.dart';
+
 import '../../data/models/route_info.dart';

 /// الخريطة — **الطبقة الوحيدة التي تعرف `intaleq_maps`**. ما فوقها يتعامل
@@ -1,8 +1,11 @@
 import 'package:flutter_bloc/flutter_bloc.dart';

 import '../../../core/api/api_exception.dart';
+
 import '../../../core/ui/view_status.dart';
+
 import '../data/wallet_repository.dart';
+
 import 'wallet_state.dart';

 class WalletCubit extends Cubit<WalletState> {
@@ -1,7 +1,9 @@
 import 'package:equatable/equatable.dart';

 import '../../../core/ui/view_status.dart';
+
 import '../data/models/wallet.dart';
+
 import '../data/models/wallet_txn.dart';

 enum WalletAction { none, toppingUp, topupFailed, topupDone }
@@ -1,5 +1,7 @@
 import '../../../core/api/api_client.dart';
+
 import 'models/wallet.dart';
+
 import 'models/wallet_txn.dart';

 class WalletRepository {
@@ -1,8 +1,11 @@
 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';

 /// بطاقة الرصيد — الرقم هو بطل الشاشة، فيأخذ أكبر حجم وأعلى تباين.
@@ -1,9 +1,13 @@
 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 '../../data/models/wallet_txn.dart';

 class TxnTile extends StatelessWidget {