feat(ui): 交付第8个子页面【设备数据库管理】UI重构与全链路功能联动
- 页面交付清单 (已累计完成 8/11 个页面):
1. 语言设置 (已完工)
2. 版型切换 (已完工)
3. 心率区间设置 (已完工)
4. 自动连接配置 (已完工)
5. 手环配置 (已完工)
6. DFU固件升级 (已完工)
7. 用户管理 (已完工)
8. 设备数据库管理 (本次交付·已完工)
- 核心重构亮点:
1. 采纳 Master-Detail Inset Station 经典双栏比例 (360px 1fr);
2. 全量遵循 #2563EB 核心主色蓝体系与柔和调和语义色规范;
3. 严格对齐原版文字:【📡 设备数据库 (统一充电与状态管理)】、【默认同步天数】与【批量解绑全部】;
4. 完备支持任意手环设备单选/多选/全选联动,动态响应同步台数;
5. 支持自由配置 1天/3天/7天/14天/30天 同步时间范围;
6. 集齐 6 件套交付物 (baseline_ui.html, image.png, DESIGN_SPEC.md, implementation_plan.md, CARD 任务卡, README 更新)。
This commit is contained in:
@@ -0,0 +1,48 @@
|
||||
# 设备数据库管理 - 工程实施方案 (Implementation Plan)
|
||||
|
||||
## 1. 数据模型与接口规范 (Data Model & Schema)
|
||||
|
||||
```typescript
|
||||
export interface BleDeviceRecord {
|
||||
id: string; // 设备唯一标识 (UUID / MAC)
|
||||
broadcastName: string; // 广播名 (例: 33X_BLE_62200024)
|
||||
batteryLevel: number | null; // 电量百分比 (null 代表未知)
|
||||
firmwareVersion: string | null; // 固件版本号 (例: "v1.4.2" 或 null)
|
||||
lastSyncTimestamp: string; // 最后同步时间 ISO 格式
|
||||
isBound: boolean; // 是否绑定学员
|
||||
boundStudentId?: string; // 绑定学员 ID
|
||||
selectedForSync: boolean; // 批量同步勾选状态
|
||||
}
|
||||
|
||||
export interface SyncConfig {
|
||||
syncDaysRange: 1 | 3 | 7 | 14 | 30; // 默认同步天数
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 状态机与联动流程 (State Machine & Workflow)
|
||||
|
||||
```mermaid
|
||||
stateDiagram-v2
|
||||
[*] --> IdleLoaded: 载入已登记手环列表 (7台)
|
||||
IdleLoaded --> DeviceSelected: 用户勾选/点击卡片 (任意 1~N 台)
|
||||
DeviceSelected --> IdleLoaded: 用户取消勾选 (0台禁用主按钮)
|
||||
DeviceSelected --> BatchSyncing: 点击【开始同步已选手环 (N台)】
|
||||
BatchSyncing --> SyncSuccess: BLE 数据包多通道回传完成
|
||||
SyncSuccess --> IdleLoaded: 刷新最后同步时间戳
|
||||
IdleLoaded --> EmptyState: 点击【批量解绑全部】并确认二次弹窗
|
||||
EmptyState --> IdleLoaded: 点击【+ 重新扫描/注册设备】恢复列表
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 原生实施映射 (Native Implementation Mapping)
|
||||
|
||||
- **Android (Kotlin / Jetpack Compose)**:
|
||||
- 左侧采用 `Card(modifier = Modifier.width(360.dp))` 配合 `DropdownMenu` 实现同步时间配置;
|
||||
- 右侧采用 `LazyColumn` 配合 `Checkbox` 与 `SelectableCard` 实现高流畅度多选列表;
|
||||
- 批量同步调度器基于 `WorkManager` + BLE GATT 并发多连接队列。
|
||||
- **Flutter**:
|
||||
- `Row(children: [SizedBox(width: 360, child: StationControlPanel()), Expanded(child: DeviceListView())])`;
|
||||
- 状态管理推荐 `Riverpod` 或 `Bloc` 管理 `selectedDeviceIds` 集合与 `syncDays`。
|
||||
Reference in New Issue
Block a user