docs: 补充JSON序列化选型规范、ViewModel规则及项目目录结构

This commit is contained in:
2026-08-04 18:13:14 +08:00
parent 2b6fc78334
commit 48dc443a31
2 changed files with 43 additions and 8 deletions

View File

@@ -50,17 +50,19 @@
```
com.ttstd.controller
├── App.java // Application 子类:初始化 MMKV、Room、全局依赖
├── MainActivity.java // 唯一入口 Activity,承载 NavHost
│
├── ui/ // 表现层(UI)
├── ui/ // 表现层 UI (按 Feature 分包)
│ ├── base/ // 基类
│ ├── main/ // 主功能
│ │ ├── MainActivity.java
│ │ ├── MainViewModel.java
│ │ └── MainUiState.java
│ ├── home/ // 首页 / 设备列表
│ │ ├── HomeFragment.java
│ │ ├── HomeViewModel.java
│ │ └── fragment_home.xml
│ │ └── HomeViewModel.java
│ ├── control/ // 远程控制界面(投屏观看 + 触控下发)
│ │ ├── ControlFragment.java
│ │ ├── ControlViewModel.java
│ │ └── fragment_control.xml
│ │ └── ControlViewModel.java
│ ├── login/ // 激活 / 登录
│ └── common/ // 共享 UI(BaseFragment、适配器、自定义 View)
│
@@ -74,8 +76,9 @@ com.ttstd.controller
│ │ ├── secure/ // EncryptedSharedPreferences 封装(凭据存储)
│ │ └── pref/ // MMKV 封装(非敏感)
│ ├── remote/ // 网络(Retrofit API 接口、WebSocket 信令客户端)
│ │ ├── api/ // REST 接口定义
│ │ └── signaling/ // WebSocket 信令连接与消息收发
│ │ ├── api/ // REST 接口定义
│ │ ├── model/
│ │ └── signaling/ // WebSocket 信令连接与消息收发
│ ├── signaling/ // 信令消息(JSON)数据类 / 解析
│ ├── proto/ // 由 app/src/main/proto/*.proto 生成的指令类 + 编解码封装
│ └── repository/ // 仓储:向 UI 暴露单一数据源(组合 local + remote)
@@ -93,6 +96,10 @@ com.ttstd.controller
├── service/ // 前台 / 后台 Service(如保活、长连接)
│ └── SignalingService.java
│
├── receiver/ # 全局 BroadcastReceiver(系统级广播)
│ ├── BootCompletedReceiver.java # 开机启动
│ └── NetworkChangeReceiver.java # 网络变化
│
└── utils/ // 工具类(线程、日志、权限、网络状态)
```