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

apps/rider/lib/features/auth/data/auth_repository.dart

@@ -1,3 +1,4 @@
+import 'dart:convert';
 import 'package:dio/dio.dart';
 import '../../../core/api/api_client.dart';
 import '../../../core/storage/token_store.dart';
@@ -16,6 +17,13 @@ class AppUser {
         name: j['name'] as String?,
         role: (j['role'] ?? 'rider') as String,
       );
+
+  Map<String, dynamic> toJson() => {
+        'id': id,
+        'phone': phone,
+        'name': name,
+        'role': role,
+      };
 }
 
 class AuthRepository {
@@ -37,17 +45,42 @@ class AuthRepository {
       r.data['access_token'] as String,
       r.data['refresh_token'] as String,
     );
-    return AppUser.fromJson(Map<String, dynamic>.from(r.data['user'] as Map));
+    final user = AppUser.fromJson(Map<String, dynamic>.from(r.data['user'] as Map));
+    await _store.saveUser(jsonEncode(user.toJson()));
+    return user;
   }
 
-  Future<AppUser?> me() async {
+  Future<AppUser?> getCachedUser() async {
+    final raw = await _store.readUser();
+    if (raw == null || raw.isEmpty) return null;
     try {
-      final r = await _api.dio.get('/users/me');
-      return AppUser.fromJson(Map<String, dynamic>.from(r.data as Map));
-    } on DioException {
+      final map = jsonDecode(raw) as Map<String, dynamic>;
+      return AppUser.fromJson(map);
+    } catch (_) {
       return null;
     }
   }
 
+  Future<bool> hasSavedToken() => _store.hasToken();
+
+  Future<AppUser?> me() async {
+    try {
+      final r = await _api.dio.get('/users/me');
+      final user = AppUser.fromJson(Map<String, dynamic>.from(r.data as Map));
+      await _store.saveUser(jsonEncode(user.toJson()));
+      return user;
+    } on DioException {
+      return getCachedUser();
+    }
+  }
+
   Future<void> logout() => _store.clear();
+
+  Future<AppUser> updateName(String name) async {
+    final r = await _api.dio.patch('/users/me', data: {'name': name});
+    final user = AppUser.fromJson(Map<String, dynamic>.from(r.data as Map));
+    await _store.saveUser(jsonEncode(user.toJson()));
+    return user;
+  }
 }
+