Initial project

apps/im_app/lib/features/login/presentation/login_state.dart

@@ -0,0 +1,33 @@
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+import '../../../domain/entities/user.dart';
+
+part 'login_state.freezed.dart';
+
+/// 登录页面状态（@freezed 自动生成 copyWith / == / toString）
+///
+/// ViewModel 通过 `state = state.copyWith(...)` 更新状态，
+/// View 通过 `ref.watch(loginViewModelProvider)` 自动响应变化。
+///
+/// ## 状态流转
+///
+/// ```
+/// 初始 → LoginState()                          isLoading: false, user: null, error: null
+/// 点击登录 → state.copyWith(isLoading: true)    isLoading: true
+/// 登录成功 → state.copyWith(user: user)         isLoading: false, user: User
+/// 格式错误 → state.copyWith(error: '邮箱格式不正确')  isLoading: false, error: String
+/// 网络错误 → state.copyWith(error: '网络错误')   isLoading: false, error: String
+/// ```
+@freezed
+sealed class LoginState with _$LoginState {
+  const factory LoginState({
+    /// 登录成功后的用户信息（null = 未登录）
+    User? user,
+
+    /// 是否正在请求中（控制 loading 状态 / 按钮禁用）
+    @Default(false) bool isLoading,
+
+    /// 错误信息（null = 无错误）
+    String? error,
+  }) = _LoginState;
+}

apps/im_app/lib/features/login/presentation/login_view_model.dart

@@ -0,0 +1,96 @@
+import 'package:flutter/foundation.dart';
+import 'package:networks_sdk/networks_sdk.dart';
+import 'package:im_app/app/di/db_provider.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+import 'package:storage_sdk/storage_sdk.dart';
+
+import '../../../app/di/app_providers.dart';
+import '../di/auth_providers.dart';
+import 'login_state.dart';
+
+part 'login_view_model.g.dart';
+
+/// 登录 ViewModel（@riverpod 自动生成 `loginViewModelProvider`）
+///
+/// `@riverpod` 注解 → build_runner 自动生成 `login_view_model.g.dart`，
+/// 其中包含 `loginViewModelProvider`。View 层直接使用：
+///
+/// ```dart
+/// // View 层读取状态
+/// final state = ref.watch(loginViewModelProvider);
+///
+/// // View 层调用方法
+/// ref.read(loginViewModelProvider.notifier).login(email, password);
+/// ```
+///
+/// ## 手动 vs 自动 Provider 对比
+///
+/// ```
+/// loginViewModelProvider                    ← @riverpod 自动生成（本文件）
+///   → ref.read(loginUseCaseProvider)       ← di/ 手动装配
+///     → ref.read(authRepositoryProvider)   ← di/ 手动装配
+///       → ref.read(apiClientProvider)      ← app/di/ 手动装配
+/// ```
+///
+/// ## 数据流位置
+///
+/// ```
+/// View: ref.read(loginViewModelProvider.notifier).login(email, password)
+///   → ★ LoginViewModel.login() ★                  ← 你在这里
+///     → LoginUseCase.execute()                     ← 格式校验 + 调 Repository
+///       → AuthRepository.login()
+///         → _client.executeRequest(LoginRequest)
+///       ← LoginData → User
+///     ← User
+///   → state = state.copyWith(user: user)           ← 更新状态
+/// View: ref.watch → 自动 rebuild                    ← UI 刷新
+/// ```
+@riverpod
+class LoginViewModel extends _$LoginViewModel {
+  @override
+  LoginState build() => const LoginState();
+
+  /// Demo 登录（跳过 API，直接设置登录状态）
+  ///
+  /// 仅用于演示路由守卫行为，正式 UI 就绪后删除此方法，改用 [login]。
+  /// 正式 [login] 成功后同样需要调用 [AuthNotifier.login] 更新守卫状态。
+  Future<void> demoLogin() async {
+    final storageApi = ref.read(storageSdkProvider);
+    ///TODO: StorageSDKLifeCycle 需要只在主项目暴露
+    final storageLifeCycle = storageApi as StorageSdkLifecycle;
+    ref.read(authNotifierProvider).login();
+
+    await storageLifeCycle.openDatabase(1234567);
+    final rows = await storageApi.rawQuery("PRAGMA table_info('user')");
+    for (final row in rows) {
+      debugPrint('Schema: ${row.data}');
+    }
+  }
+
+  /// 执行登录
+  ///
+  /// 1. 设置 loading 状态（UI 显示加载指示器、禁用按钮）
+  /// 2. 调 UseCase（格式校验 → 登录 → 返回 User）
+  /// 3. 成功：写入 user；失败：写入 error
+  Future<void> login(String email, String password) async {
+    state = state.copyWith(isLoading: true, error: null);
+
+    try {
+      final user = await ref.read(loginUseCaseProvider).execute(
+            email: email,
+            password: password,
+          );
+
+      state = state.copyWith(user: user, isLoading: false);
+    } on FormatException catch (e) {
+      // 格式校验失败（UseCase 层抛出）
+      state = state.copyWith(error: e.message, isLoading: false);
+    } on ApiError catch (e) {
+      // 网络 / 服务端错误（Repository → SDK 透传）
+      state = state.copyWith(error: e.displayMessage, isLoading: false);
+    } catch (e) {
+      // 兜底：防止未预期的异常导致 isLoading 死锁
+      state = state.copyWith(error: e.toString(), isLoading: false);
+    }
+  }
+}