# 设备数据库管理 - 工程实施方案 (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`。