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
@@ -0,0 +1,66 @@
+import 'package:firebase_core/firebase_core.dart';
+
+import 'package:firebase_messaging/firebase_messaging.dart';
+
+import 'package:flutter/foundation.dart';
+
+import '../api/api_client.dart';
+
+import '../api/api_exception.dart';
+
+/// إشعارات FCM — **الطبقة الوحيدة التي تعرف Firebase**.
+///
+/// عقد الخادم نقطة واحدة: `POST /notifications/token { token, platform }`
+/// (docs/38 §11). لا نقطة سرد إشعارات، فلا شاشة «صندوق إشعارات» تُبنى على
+/// وهم — ما يصل يصل من النظام.
+///
+/// الإعداد الأصلي جاهز مسبقاً: `google-services.json` و
+/// `GoogleService-Info.plist` منقولان مع الطبقة الأصلية، و`build.gradle`
+/// يطبّق `com.google.gms.google-services` أصلاً.
+class PushService {
+  PushService(this._api);
+
+  final ApiClient _api;
+
+  /// يُنادى **بعد** الدخول: التسجيل يربط الجهاز بالمستخدم، فقبل الجلسة
+  /// لا معنى له.
+  Future<void> register() async {
+    try {
+      await Firebase.initializeApp();
+      final messaging = FirebaseMessaging.instance;
+
+      final settings = await messaging.requestPermission();
+      if (settings.authorizationStatus == AuthorizationStatus.denied) return;
+
+      final token = await messaging.getToken();
+      if (token != null) await _send(token);
+
+      // الرمز يُدوَّر من Google دورياً — بلا هذا الاشتراك تتوقّف الإشعارات
+      // بصمت بعد أسابيع.
+      messaging.onTokenRefresh.listen(_send);
+    } catch (_) {
+      // غياب الإشعارات لا يمنع استعمال التطبيق — لا يُسقط الإقلاع.
+    }
+  }
+
+  Future<void> _send(String token) async {
+    try {
+      await _api.post<Map<String, dynamic>>(
+        '/notifications/token',
+        body: {
+          'token': token,
+          'platform': defaultTargetPlatformName,
+        },
+      );
+    } on ApiException {
+      // يُعاد في الإقلاع التالي.
+    }
+  }
+}
+
+/// المنصّة كما يتوقّعها الخادم — تُقرأ من المنصّة الفعلية لا من عَلَم بناء.
+String get defaultTargetPlatformName => switch (defaultTargetPlatform) {
+      TargetPlatform.iOS => 'ios',
+      TargetPlatform.android => 'android',
+      _ => 'unknown',
+    };