Files
EAP_Interface_html/设置页面UI优化/设备数据库管理/implementation_plan.md
T
zhy200308 75a642f4e9 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 更新)。
2026-08-17 18:33:28 +08:00

49 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 设备数据库管理 - 工程实施方案 (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`。