feat: implement splash and onboarding flows, update app assets, and add project design documentation

apps/rider/lib/features/home/data/maps_repository.dart

@@ -1,34 +1,40 @@
+import '../../../core/api/antlaq_api.dart';
 import '../../../core/api/api_client.dart';
 import 'models/place_model.dart';
 import 'models/route_model.dart';
 
-/// نقطة وصول وحيدة لبيانات الخرائط — كل نداء يمرّ عبر سيرفرنا
-/// (docs/23 §4) لحماية المفتاح وتفعيل التخزين المؤقت على Redis.
+/// نقطة وصول وحيدة لبيانات الخرائط والبحث الصوتي الذكي عبر الباك إند.
 class MapsRepository {
-  final ApiClient _api;
-  MapsRepository(this._api);
+  final AntlaqApi _api;
+  final ApiClient? _apiClient;
 
-  /// بحث مكاني — يمرّ عبر `GET /maps/geocode`.
-  Future<List<PlaceModel>> autocomplete(String query) async {
-    if (query.trim().length < 2) return [];
-    final r = await _api.dio.get(
-      '/maps/geocode',
-      queryParameters: {'q': query.trim(), 'country': 'JO'},
-    );
-    final items = (r.data['items'] ?? r.data ?? []) as List;
-    return items
-        .map((e) => PlaceModel.fromJson(e as Map<String, dynamic>))
-        .toList();
+  MapsRepository(this._api, [this._apiClient]);
+
+  /// بحث صوتي ذكي يمر عبر الباك إند (Gemini AI).
+  Future<List<PlaceModel>> voiceSearch(String text, {double? lat, double? lng}) async {
+    if (text.trim().isEmpty) return [];
+    try {
+      if (_apiClient != null) {
+        final res = await _apiClient.dio.post('/maps/voice-search', data: {
+          'text': text,
+          if (lat != null) 'lat': lat,
+          if (lng != null) 'lng': lng,
+        });
+        final list = res.data as List?;
+        if (list != null) {
+          return list
+              .map((e) => PlaceModel.fromJson(e as Map<String, dynamic>))
+              .toList();
+        }
+      }
+    } catch (_) {}
+    return search(text);
   }
 
-  /// بحث حرّ (geocode).
-  Future<List<PlaceModel>> geocode(String query) async {
+  /// بحث أماكن — يمر عبر GET /api/geocoding/search.
+  Future<List<PlaceModel>> search(String query) async {
     if (query.trim().length < 2) return [];
-    final r = await _api.dio.get(
-      '/maps/geocode',
-      queryParameters: {'q': query.trim(), 'country': 'JO'},
-    );
-    final items = (r.data['items'] ?? r.data ?? []) as List;
+    final items = await _api.search(query);
     return items
         .map((e) => PlaceModel.fromJson(e as Map<String, dynamic>))
         .toList();
@@ -36,48 +42,44 @@ class MapsRepository {
 
   /// تفكيك عنوان عكسي (إحداثيات → نص).
   Future<PlaceModel> reverseGeocode(double lat, double lng) async {
-    final r = await _api.dio.get(
-      '/maps/reverse',
-      queryParameters: {'lat': lat, 'lng': lng},
-    );
-    final j = r.data as Map<String, dynamic>;
+    final j = await _api.reverse(lat, lng);
+    final name = (j['name_ar'] ?? j['name'] ?? j['formattedAddress'] ?? '') as String;
+    final addr = (j['address'] ?? j['full_address'] ?? j['formattedAddress'] ?? '') as String;
     return PlaceModel.fromJson({
-      'name': j['formattedAddress'] ?? '',
-      'address': j['formattedAddress'],
-      'lat': lat,
-      'lng': lng,
+      'name': name,
+      'full_address': addr.isNotEmpty ? addr : name,
+      'latitude': lat,
+      'longitude': lng,
     });
   }
 
-  /// تفاصيل مكان بالـ placeId — يمرّ عبر geocode.
-  Future<PlaceModel> placeDetails(String placeId) async {
-    final r = await _api.dio.get(
-      '/maps/geocode',
-      queryParameters: {'q': placeId, 'country': 'JO'},
-    );
-    final items = (r.data['items'] ?? r.data ?? []) as List;
-    if (items.isEmpty) {
-      throw Exception('Place not found');
-    }
-    return PlaceModel.fromJson(items.first as Map<String, dynamic>);
-  }
-
-  /// حساب المسار بين نقطتين.
+  /// حساب المسار بين نقطتين عبر الباك إند (GET /maps/route).
   Future<RouteModel> getRoute({
     required double fromLat,
     required double fromLng,
     required double toLat,
     required double toLng,
   }) async {
-    final r = await _api.dio.get(
-      '/maps/route',
-      queryParameters: {
-        'fromLat': fromLat,
-        'fromLng': fromLng,
-        'toLat': toLat,
-        'toLng': toLng,
-      },
+    try {
+      if (_apiClient != null) {
+        final res = await _apiClient.dio.get('/maps/route', queryParameters: {
+          'fromLat': fromLat,
+          'fromLng': fromLng,
+          'toLat': toLat,
+          'toLng': toLng,
+        });
+        if (res.data != null && res.data is Map<String, dynamic>) {
+          return RouteModel.fromJson(res.data as Map<String, dynamic>);
+        }
+      }
+    } catch (_) {}
+
+    final j = await _api.route(
+      fromLat: fromLat,
+      fromLng: fromLng,
+      toLat: toLat,
+      toLng: toLng,
     );
-    return RouteModel.fromJson(r.data as Map<String, dynamic>);
+    return RouteModel.fromJson(j);
   }
 }