Hamza-AyedandClaude Opus 5
1156299d09
## حسم تعارض الخرائط (docs/38 §7) لصالح القرار الأحدث 2026-07-20: كل الخرائط — البلاطات والبحث والعكسي والمسار — مباشرة إلى map-saas بترويسة x-api-key، بلا مرور بباك إند تريبز. نقاط /maps/* في الباك إند لا تُستعمل، وإحداها (geocode) معطوبة على المنشور. العقد تُحقّق حيّاً بـcurl قبل كتابة سطر. ## النواة المشتركة - core/api/antlaq_api.dart: عميل منفصل بلا AuthInterceptor — توكن تريبز لا شأن لخادم الخرائط به، وإرساله إليه تسريب بلا مقابل - core/realtime: Socket.IO واحد (trip:update · driver:location · trip:offer · trip:offer_taken) - core/location: نقطة الموقع الوحيدة بمرشّح 25 متراً - features/trip/data: سبعة نماذج + MapsRepository + TripRepository متطابق حرفياً بين التوأمين ## الراكب RideCubit بستّ مراحل + RidePage وثمانية ويدجت: الخريطة · دبّوس المنتصف · المخطّط · الخط الزمني · اختيار النوع · التأكيد · البحث عن سائق · الرحلة. ## السائق DutyCubit بأربع مراحل + DutyPage: مفتاح الاتصال · العرض بمؤقّت · الرحلة. ## قرارات تحمي الأداء والصحّة - GeoPoint مستقلّ عن حزمة الخريطة؛ intaleq_maps مستوردة في ملف واحد فقط لكل تطبيق. تبديل محرّك الخريطة لا يلمس منطقاً - الخريطة خارج BlocBuilder الورقة ولها BlocSelector خاص: نبضة موقع كل 25م لا تعيد بناء الشاشة - مهلة بحث محليّة 90ث + استطلاع كل 5ث: الخادم قد لا يُطلق expired/no_drivers أبداً (ثغرة R1)، وانتظار حدث قد لا يصل = شاشة بحث أبدية - offeredDrivers == 0 جواب نهائي فوري بلا انتظار المهلة - الأجرة لا تُعرض إلا إن كانت صالحة: /tariff/quote يرجّع 200 بقيم null صامتة - موقع السائق بمسارين عمداً: REST لمطابقة Redis والسوكت لخريطة الراكب flutter analyze نظيف · الراكب 70 ملف/5,294 سطر · السائق 67 ملف/4,771 سطر. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
67 lines
3.6 KiB
Dart
67 lines
3.6 KiB
Dart
/// إعداد وقت التشغيل — يُمرَّر بـ`--dart-define` عند البناء (docs/23 §1).
|
|
///
|
|
/// ما يخصّ **هوية المستأجر البصرية** (لون · لوغو · اسم) يعيش في
|
|
/// `build_config.dart` المُولَّد، لا هنا.
|
|
class AppConfig {
|
|
const AppConfig._();
|
|
|
|
/// أصل الـAPI **مع** `/api` (docs/38).
|
|
static const String apiBaseUrl = String.fromEnvironment(
|
|
'API_BASE_URL',
|
|
defaultValue: 'https://tripz-api.intaleqapp.com/api',
|
|
);
|
|
|
|
/// أصل الـWebSocket — بلا `/api` (docs/38 §9).
|
|
static const String wsBaseUrl = String.fromEnvironment(
|
|
'WS_BASE_URL',
|
|
defaultValue: 'https://tripz-api.intaleqapp.com',
|
|
);
|
|
|
|
/// يحدّد هوية المستخدم على الخادم: نفس الرقم بدورين = حسابان منفصلان
|
|
/// (docs/38 §1). **يُثبَّت عند البناء ولا يتغيّر في وقت التشغيل أبداً.**
|
|
static const String appRole = 'driver';
|
|
|
|
// ── الخرائط ──────────────────────────────────────────────────────────
|
|
// قرار المالك 2026-07-20: كل الخرائط — البلاطات والجيوكودنغ والمسار —
|
|
// **مباشرة** إلى map-saas بلا مرور بباك إند تريبز. map-saas مِلك المالك،
|
|
// والمفتاح يُقيَّد ببصمة التطبيق (نفس نموذج Google Maps SDK). هذا يُلغي
|
|
// نقاط `/maps/*` في باك إند تريبز، وهو ما حسم التعارض المسجّل في
|
|
// docs/38 §7 — ومنها `/maps/geocode` المعطوب على الخادم المنشور.
|
|
|
|
static const String mapBaseUrl = String.fromEnvironment(
|
|
'MAP_BASE_URL',
|
|
defaultValue: 'https://map-saas.intaleqapp.com/api',
|
|
);
|
|
|
|
/// المفتاح ترويسة **`x-api-key`** لا معامل استعلام — map-saas يرفض
|
|
/// المفتاح في الـquery بـ400. الحالي مفتاح سيرو حتى يُصدر المالك مفتاح
|
|
/// تريبز المقيّد بالبصمة.
|
|
static const String mapApiKey = String.fromEnvironment(
|
|
'MAP_API_KEY',
|
|
defaultValue: 'in_9478b32836d19cff73db3063',
|
|
);
|
|
|
|
/// كل كم متر يُرفع موقع السائق. أقل من ذلك يستنزف البطارية بلا فائدة.
|
|
static const int locationFilterMeters = 25;
|
|
|
|
/// مهلة البحث عن سائق قبل عرض «لا يوجد سائقون».
|
|
///
|
|
/// **إلزامية**: الخادم قد لا يُطلق `expired`/`no_drivers` أبداً (ثغرة R1،
|
|
/// docs/38 §4)، فانتظار حدثٍ قد لا يصل يعني شاشة بحث أبدية.
|
|
static const Duration searchingTimeout = Duration(seconds: 90);
|
|
|
|
/// طول رمز التحقّق كما يولّده الخادم (docs/38 §2).
|
|
static const int otpLength = 4;
|
|
|
|
/// مهلة إعادة إرسال الرمز. الخادم يحدّ `send-otp` بثلاثة طلبات كل خمس
|
|
/// دقائق، فبلا عدّاد تنازلي يُحظر المستخدم بثلاث ضغطات (docs/39 §2).
|
|
static const Duration otpResendCooldown = Duration(seconds: 60);
|
|
|
|
/// هامش التجديد الاستباقي. عمر التوكن 15 دقيقة فقط (docs/38 §2)،
|
|
/// فالانتظار حتى 401 يعني فشل طلب في منتصف رحلة.
|
|
static const Duration tokenRefreshLeeway = Duration(seconds: 60);
|
|
|
|
static const Duration connectTimeout = Duration(seconds: 20);
|
|
static const Duration receiveTimeout = Duration(seconds: 30);
|
|
}
|