优化配置，修复 demo bug

1，network 框架完善
2，websocket 机制完善
3，设计文档整理到架构文档
4，脚本，配置完善

apps/im_app/lib/features/chat/presentation/chat_db_test_view_model.dart

@@ -1,7 +1,6 @@
 import 'dart:math';
 
 import 'package:drift/drift.dart';
-import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:im_app/app/di/db_provider.dart';
 import 'package:im_app/data/local/drift/app_database.dart';
@@ -45,13 +44,12 @@ class ChatDbTestState {
 
 @riverpod
 class ChatDbTestViewModel extends _$ChatDbTestViewModel {
-
   @override
   ChatDbTestState build() {
     // 这里就是 onInit
     final List<TestResult> testResults = List.generate(
       1000,
-          (i) => TestResult(
+      (i) => TestResult(
         title: '用户 ${Random().nextInt(9999)}',
         subtitle: 'uid: ${Random().nextInt(999999)}',
         duration: '${Random().nextInt(500)}ms',
@@ -86,7 +84,7 @@ class ChatDbTestViewModel extends _$ChatDbTestViewModel {
     for (var i = 0; i < count; i += chunkSize) {
       final chunk = List.generate(
         chunkSize.clamp(0, count - i),
-            (j) => UsersCompanion.insert(
+        (j) => UsersCompanion.insert(
           uid: Value(i + j),
           nickname: Value('User ${i + j}'),
         ),
@@ -98,13 +96,13 @@ class ChatDbTestViewModel extends _$ChatDbTestViewModel {
       // 让出主线程
       await Future.delayed(Duration.zero);
 
-      debugPrint('已完成: $completed / $count (${stopwatch.elapsedMilliseconds}ms)');
+      debugPrint(
+        '已完成: $completed / $count (${stopwatch.elapsedMilliseconds}ms)',
+      );
 
       // 更新 UI 状态
       if (ref.mounted) {
-        state = state.copyWith(
-          currentState: '已插入 $completed / $count 条',
-        );
+        state = state.copyWith(currentState: '已插入 $completed / $count 条');
       }
     }
 
@@ -116,4 +114,4 @@ class ChatDbTestViewModel extends _$ChatDbTestViewModel {
       );
     }
   }
-}
+}

apps/im_app/lib/features/chat/view/chat_detail_page.dart

@@ -1,4 +1,5 @@
 import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
 
 import '../../../../core/ui/base/context_theme_ext.dart';
 
@@ -12,7 +13,7 @@ import '../../../../core/ui/base/context_theme_ext.dart';
 ///
 /// 将 [conversationId] 传给对应的 Riverpod `.family` provider 加载完整会话数据。
 /// 构造参数保持不变，数据来源从 `extra` 换成 provider 即可。
-class ChatDetailPage extends StatelessWidget {
+class ChatDetailPage extends ConsumerWidget {
   const ChatDetailPage({
     super.key,
     required this.conversationId,
@@ -23,7 +24,7 @@ class ChatDetailPage extends StatelessWidget {
   final String title;
 
   @override
-  Widget build(BuildContext context) {
+  Widget build(BuildContext context, WidgetRef ref) {
     final s = context.styles;
 
     return Scaffold(

apps/im_app/lib/features/chat/view/chat_page.dart

@@ -20,8 +20,6 @@ class ChatPage extends ConsumerWidget {
 
   @override
   Widget build(BuildContext context, WidgetRef ref) {
-    final vm = ref.read(chatViewModelProvider.notifier);
-
     return Scaffold(
       appBar: AppBar(title: const Text('聊天')),
       body: Center(
@@ -32,36 +30,48 @@ class ChatPage extends ConsumerWidget {
             // 切换 Tab：用 go，替换整个历史栈，不可返回
             AppButton.inverse(
               label: '切换 Tab（go）',
-              onPressed: () => vm.goToContact(context),
+              onPressed: () =>
+                  ref.read(chatViewModelProvider.notifier).goToContact(context),
             ),
             // 带参数 push：extra 传 Dart Record，适合已有对象的场景
             AppButton.inverse(
               label: '有参 push（extra）',
-              onPressed: () => vm.pushChatDetailWithExtra(context),
+              onPressed: () => ref
+                  .read(chatViewModelProvider.notifier)
+                  .pushChatDetailWithExtra(context),
             ),
             // 带参数 push：id 内嵌在路径中，适合需要深链接 / 分享的场景
             AppButton.inverse(
               label: '有参 push（路径参数）',
-              onPressed: () => vm.pushChatDetailById(context),
+              onPressed: () => ref
+                  .read(chatViewModelProvider.notifier)
+                  .pushChatDetailById(context),
             ),
             // 无参 push：压栈，自动显示返回按钮，不切 Tab
             AppButton.inverse(
               label: '无参 push',
-              onPressed: () => vm.pushSettingsTheme(context),
+              onPressed: () => ref
+                  .read(chatViewModelProvider.notifier)
+                  .pushSettingsTheme(context),
             ),
             // 无参 go：替换历史，切换到对应 Tab，TabBar 可见，不可返回
             AppButton.inverse(
               label: '无参 go',
-              onPressed: () => vm.goToSettings(context),
+              onPressed: () => ref
+                  .read(chatViewModelProvider.notifier)
+                  .goToSettings(context),
             ),
             AppButton.inverse(
               label: '测试数据库性能',
-              onPressed: () => vm.goToDatabaseTest(context),
+              onPressed: () => ref
+                  .read(chatViewModelProvider.notifier)
+                  .goToDatabaseTest(context),
             ),
             AppButton.secondary(
               label: '退出登录',
               fullWidth: false,
-              onPressed: () => vm.logout(),
+              onPressed: () =>
+                  ref.read(chatViewModelProvider.notifier).logout(),
             ),
           ],
         ),