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

apps/rider/lib/core/router.dart

@@ -2,10 +2,14 @@ import 'dart:async';
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:go_router/go_router.dart';
+import 'package:intaleq_maps/intaleq_maps.dart';
 import '../features/auth/cubit/auth_cubit.dart';
 import '../features/auth/cubit/auth_state.dart';
+import '../features/splash/view/splash_screen.dart';
+import '../features/onboarding/view/onboarding_screen.dart';
 import '../features/auth/view/phone_screen.dart';
 import '../features/auth/view/otp_screen.dart';
+import '../features/auth/view/name_screen.dart';
 import '../features/home/view/home_screen.dart';
 import '../features/home/view/destination_screen.dart';
 import '../features/home/view/route_preview_screen.dart';
@@ -15,45 +19,67 @@ import '../features/trip/view/rating_screen.dart';
 import '../features/home/cubit/home_cubit.dart';
 import '../features/home/cubit/destination_cubit.dart';
 import '../features/home/cubit/quote_cubit.dart';
+import '../features/home/cubit/saved_places_cubit.dart';
 import '../features/home/data/models/place_model.dart';
 import '../features/home/data/maps_repository.dart';
 import '../features/home/data/tariff_repository.dart';
+import '../core/storage/saved_places_store.dart';
+import '../core/l10n/app_localizations.dart';
 import 'di.dart';
 
 GoRouter buildRouter(AuthCubit auth) {
   return GoRouter(
-    initialLocation: '/phone',
+    initialLocation: '/splash',
     refreshListenable: _StreamRefresh(auth.stream),
     redirect: (context, state) {
       final status = auth.state.status;
       final loc = state.matchedLocation;
-      final onAuthPages = loc == '/phone' || loc == '/otp';
+      final onSplash = loc == '/splash';
+      final onOnboarding = loc == '/onboarding';
+      final onAuthPages = loc == '/phone' || loc == '/otp' || loc == '/name';
+      final onNamePage = loc == '/name';
 
       if (status == AuthStatus.authenticated) {
-        return onAuthPages ? '/home' : null;
+        final hasName = auth.state.user?.name != null &&
+            auth.state.user!.name!.trim().isNotEmpty;
+        if (!hasName && !onNamePage) return '/name';
+        if (hasName && onNamePage) return '/home';
+        if (onAuthPages || onSplash || onOnboarding) return hasName ? '/home' : '/name';
+        return null;
       }
+      
+      if (onSplash || onOnboarding) return null;
+
       if (status == AuthStatus.codeSent && loc == '/phone') return '/otp';
       if (status != AuthStatus.authenticated && !onAuthPages) return '/phone';
       return null;
     },
     routes: [
+      GoRoute(path: '/splash', builder: (_, __) => const SplashScreen()),
+      GoRoute(path: '/onboarding', builder: (_, __) => const OnboardingScreen()),
       GoRoute(path: '/phone', builder: (_, __) => const PhoneScreen()),
       GoRoute(path: '/otp', builder: (_, __) => const OtpScreen()),
+      GoRoute(path: '/name', builder: (_, __) => const NameScreen()),
       GoRoute(
         path: '/home',
         builder: (_, __) => MultiBlocProvider(
           providers: [
             BlocProvider(create: (_) => HomeCubit(getIt<MapsRepository>())),
+            BlocProvider(create: (_) => SavedPlacesCubit(getIt<SavedPlacesStore>())),
           ],
           child: const HomeScreen(),
         ),
       ),
       GoRoute(
         path: '/destination',
-        builder: (_, __) => BlocProvider(
-          create: (_) => DestinationCubit(getIt<MapsRepository>()),
-          child: const DestinationScreen(),
-        ),
+        builder: (_, state) {
+          final extra = state.extra as Map<String, dynamic>?;
+          final currentLocation = extra?['currentLocation'] as LatLng?;
+          return BlocProvider(
+            create: (_) => DestinationCubit(getIt<MapsRepository>()),
+            child: DestinationScreen(currentLocation: currentLocation),
+          );
+        },
       ),
       GoRoute(
         path: '/route-preview',
@@ -62,7 +88,13 @@ GoRouter buildRouter(AuthCubit auth) {
           final pickup = extra?['pickup'] as PlaceModel?;
           final destination = extra?['destination'] as PlaceModel?;
           if (pickup == null || destination == null) {
-            return const Scaffold(body: Center(child: Text('Missing data')));
+            return Builder(
+              builder: (ctx) => Scaffold(
+                body: Center(
+                  child: Text(AppLocalizations.of(ctx)?.missingDataError ?? ''),
+                ),
+              ),
+            );
           }
           return BlocProvider(
             create: (_) => QuoteCubit(getIt<TariffRepository>()),