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:
co-authored by
Claude Opus 5
parent
66e28acc58
commit
096acae74e
@@ -0,0 +1,14 @@
|
||||
import 'package:flutter/widgets.dart';
|
||||
|
||||
import 'package:flutter_bloc/flutter_bloc.dart';
|
||||
|
||||
import 'tenant_cubit.dart';
|
||||
|
||||
extension FeatureGateX on BuildContext {
|
||||
/// هل الميزة مفعّلة **لهذا المستأجر** وقت التشغيل؟
|
||||
///
|
||||
/// تُقرأ مع علم `Features` الثابت: الأول يقرّر ما بُني، وهذا ما يُعرض.
|
||||
/// أيّهما `false` يُخفي الميزة.
|
||||
bool tenantHas(String feature) =>
|
||||
watch<TenantCubit>().state.has(feature);
|
||||
}
|
||||
@@ -0,0 +1,79 @@
|
||||
import 'dart:convert';
|
||||
|
||||
import 'package:equatable/equatable.dart';
|
||||
|
||||
/// إعداد المستأجر من `GET /tenant/config/:slug` (شكل مُتحقَّق حيّاً،
|
||||
/// docs/38 §10) — بلا توكن، فيُجلب قبل الدخول.
|
||||
///
|
||||
/// **طبقتا الميزات**، ولكلٍّ دورها:
|
||||
/// - `Features` (`const` في `build_config.dart`) يقرّر ما **يُبنى** في
|
||||
/// الـbinary — إطفاؤه يحذف الكود فلا يُستخرج (docs/23 §5).
|
||||
/// - هذا الإعداد يقرّر ما **يُعرض** ممّا بُني، حسب ما اشتراه المستأجر فعلاً.
|
||||
/// الشاشة تتحقّق من الاثنتين: `Features.wallet && tenant.has('wallet')`.
|
||||
class TenantConfig extends Equatable {
|
||||
const TenantConfig({
|
||||
required this.slug,
|
||||
required this.name,
|
||||
required this.countryPack,
|
||||
required this.plan,
|
||||
required this.features,
|
||||
});
|
||||
|
||||
final String slug;
|
||||
final String name;
|
||||
|
||||
/// يحدّد مزوّد الرسائل والعملة وصيغة الهاتف — `jo`/`eg`/`sy`.
|
||||
final String countryPack;
|
||||
|
||||
final String plan;
|
||||
final Map<String, bool> features;
|
||||
|
||||
static const empty = TenantConfig(
|
||||
slug: '',
|
||||
name: '',
|
||||
countryPack: '',
|
||||
plan: '',
|
||||
features: {},
|
||||
);
|
||||
|
||||
/// الافتراض `false` عند غياب المفتاح: ميزة غير معلنة = غير مشتراة.
|
||||
bool has(String feature) => features[feature] ?? false;
|
||||
|
||||
factory TenantConfig.fromJson(Map<String, dynamic> json) {
|
||||
final raw = json['features'];
|
||||
return TenantConfig(
|
||||
slug: json['slug'] as String? ?? '',
|
||||
name: json['name'] as String? ?? '',
|
||||
countryPack: json['countryPack'] as String? ?? '',
|
||||
plan: json['plan'] as String? ?? '',
|
||||
features: raw is Map
|
||||
? {
|
||||
for (final e in raw.entries)
|
||||
e.key.toString(): e.value == true,
|
||||
}
|
||||
: const {},
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, dynamic> toJson() => {
|
||||
'slug': slug,
|
||||
'name': name,
|
||||
'countryPack': countryPack,
|
||||
'plan': plan,
|
||||
'features': features,
|
||||
};
|
||||
|
||||
String encode() => json.encode(toJson());
|
||||
|
||||
static TenantConfig? decode(String? raw) {
|
||||
if (raw == null || raw.isEmpty) return null;
|
||||
try {
|
||||
return TenantConfig.fromJson(json.decode(raw) as Map<String, dynamic>);
|
||||
} catch (_) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
@override
|
||||
List<Object?> get props => [slug, name, countryPack, plan, features];
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
import 'package:flutter_bloc/flutter_bloc.dart';
|
||||
|
||||
import 'package:shared_preferences/shared_preferences.dart';
|
||||
|
||||
import '../api/api_client.dart';
|
||||
|
||||
import '../api/api_exception.dart';
|
||||
|
||||
import '../build_config.dart';
|
||||
|
||||
import 'tenant_config.dart';
|
||||
|
||||
/// يجلب إعداد المستأجر مرة عند الإقلاع، ويخزّنه محلياً.
|
||||
///
|
||||
/// **النسخة المخزّنة تُعرض فوراً** ثم تُحدَّث من الشبكة: إقلاعٌ بلا إنترنت
|
||||
/// يجب أن يعرض التطبيق بميزاته المعروفة آخر مرة، لا شاشة فارغة.
|
||||
class TenantCubit extends Cubit<TenantConfig> {
|
||||
TenantCubit(this._api, this._prefs)
|
||||
: super(TenantConfig.decode(_prefs.getString(_key)) ?? TenantConfig.empty);
|
||||
|
||||
final ApiClient _api;
|
||||
final SharedPreferences _prefs;
|
||||
|
||||
static const _key = 'tenant.config';
|
||||
|
||||
Future<void> load() async {
|
||||
try {
|
||||
final res = await _api.get<Map<String, dynamic>>(
|
||||
'/tenant/config/${BuildConfig.tenantSlug}',
|
||||
);
|
||||
final config = TenantConfig.fromJson(res);
|
||||
emit(config);
|
||||
await _prefs.setString(_key, config.encode());
|
||||
} on ApiException {
|
||||
// الفشل يُبقي النسخة المخزّنة — لا يُطفئ ميزات المستخدم لأن الشبكة
|
||||
// تعثّرت لحظة الإقلاع.
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user