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

apps/rider/lib/features/home/cubit/destination_cubit.dart

@@ -1,6 +1,7 @@
 import 'dart:async';
 import 'package:equatable/equatable.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
+import 'package:flutter/foundation.dart';
 import '../data/maps_repository.dart';
 import '../data/models/place_model.dart';
 
@@ -62,10 +63,11 @@ class DestinationCubit extends Cubit<DestinationState> {
 
   Future<void> _search(String query) async {
     try {
-      final results = await _mapsRepo.autocomplete(query);
+      final results = await _mapsRepo.search(query);
       emit(state.copyWith(results: results, searching: false));
     } catch (e) {
-      emit(state.copyWith(searching: false, error: e.toString()));
+      emit(state.copyWith(
+          searching: false, error: e.toString(), clearError: false));
     }
   }
 
@@ -74,10 +76,27 @@ class DestinationCubit extends Cubit<DestinationState> {
     if (query.trim().length < 2) return;
     emit(state.copyWith(searching: true, clearError: true));
     try {
-      final results = await _mapsRepo.autocomplete(query);
+      final results = await _mapsRepo.search(query);
       emit(state.copyWith(results: results, searching: false));
-    } catch (e) {
-      emit(state.copyWith(searching: false, error: e.toString()));
+    } catch (e, st) {
+      debugPrint('Map Search Error: $e\n$st');
+      emit(state.copyWith(
+          searching: false, error: e.toString(), clearError: false));
+    }
+  }
+
+  Future<void> searchVoiceDirectly(String query,
+      {double? lat, double? lng}) async {
+    _debounce?.cancel();
+    if (query.trim().isEmpty) return;
+    emit(state.copyWith(searching: true, clearError: true));
+    try {
+      final results = await _mapsRepo.voiceSearch(query, lat: lat, lng: lng);
+      emit(state.copyWith(results: results, searching: false));
+    } catch (e, st) {
+      debugPrint('Map Voice Search Error: $e\n$st');
+      emit(state.copyWith(
+          searching: false, error: e.toString(), clearError: false));
     }
   }
 

apps/rider/lib/features/home/cubit/home_cubit.dart

@@ -82,15 +82,22 @@ class HomeCubit extends Cubit<HomeState> {
       );
       final loc = LatLng(pos.latitude, pos.longitude);
 
-      // جلب العنوان العكسي للموقع الحالي.
-      final place = await _mapsRepo.reverseGeocode(pos.latitude, pos.longitude);
-
+      // نوسّط الكاميرا على الموقع فوراً — لا ننتظر العنوان العكسي.
       emit(state.copyWith(
         loading: false,
         currentLocation: loc,
         cameraTarget: loc,
-        pickup: place,
       ));
+
+      // العنوان العكسي تحسين إضافي: فشله يجب ألّا يمنع توسيط الخريطة.
+      try {
+        final place = await _mapsRepo.reverseGeocode(pos.latitude, pos.longitude);
+        emit(state.copyWith(pickup: place));
+      } catch (_) {
+        emit(state.copyWith(
+          pickup: PlaceModel(name: '', lat: loc.latitude, lng: loc.longitude),
+        ));
+      }
     } catch (e) {
       emit(state.copyWith(
         loading: false,

apps/rider/lib/features/home/cubit/saved_places_cubit.dart

@@ -0,0 +1,79 @@
+import 'package:flutter_bloc/flutter_bloc.dart';
+
+import '../../../core/storage/saved_places_store.dart';
+
+class SavedPlacesState {
+  final List<SavedPlace> places;
+  final bool loading;
+  final String? error;
+
+  const SavedPlacesState({
+    this.places = const [],
+    this.loading = false,
+    this.error,
+  });
+
+  SavedPlacesState copyWith({
+    List<SavedPlace>? places,
+    bool? loading,
+    String? error,
+  }) {
+    return SavedPlacesState(
+      places: places ?? this.places,
+      loading: loading ?? this.loading,
+      error: error,
+    );
+  }
+}
+
+class SavedPlacesCubit extends Cubit<SavedPlacesState> {
+  final SavedPlacesStore _store;
+
+  SavedPlacesCubit(this._store) : super(const SavedPlacesState());
+
+  Future<void> load() async {
+    emit(state.copyWith(loading: true, error: null));
+    try {
+      final places = await _store.getAll();
+      emit(SavedPlacesState(places: places));
+    } catch (e) {
+      emit(state.copyWith(loading: false, error: e.toString()));
+    }
+  }
+
+  Future<void> addPlace(SavedPlace place) async {
+    try {
+      await _store.add(place);
+      await load();
+    } catch (e) {
+      emit(state.copyWith(error: e.toString()));
+    }
+  }
+
+  Future<void> removePlace(String id) async {
+    try {
+      await _store.remove(id);
+      await load();
+    } catch (e) {
+      emit(state.copyWith(error: e.toString()));
+    }
+  }
+
+  Future<void> setFavorite(String id, FavoriteType type) async {
+    try {
+      await _store.setFavorite(id, type);
+      await load();
+    } catch (e) {
+      emit(state.copyWith(error: e.toString()));
+    }
+  }
+
+  Future<void> clearFavorite(FavoriteType type) async {
+    try {
+      await _store.clearFavorite(type);
+      await load();
+    } catch (e) {
+      emit(state.copyWith(error: e.toString()));
+    }
+  }
+}