diff --git a/.preview/device_database/option_1_subview_batch_sync.html b/.preview/device_database/option_1_subview_batch_sync.html new file mode 100644 index 0000000..aeabbbb --- /dev/null +++ b/.preview/device_database/option_1_subview_batch_sync.html @@ -0,0 +1,164 @@ + + + + + +批量历史数据同步 - 附属页面预览 (支持任意勾选与自由时间选择) + + + +
+
+
+ +

批量历史数据同步

+
+
+ +
+
+ 默认同步天数: + +
+ +
+ + +
+
+ +
+
+
+ +
+ 33X_BLE_62200024 +
最后同步: 2026-08-12 14:32:25 · 待回传 7 天心率数据
+
+
+ 已就绪 +
+ +
+
+ +
+ 33X_BLE_2200002 +
最后同步: 2026-08-12 14:32:25 · 待回传 7 天心率数据
+
+
+ 已就绪 +
+ +
+
+ +
+ 33X_BLE_62200025 +
最后同步: 2026-08-12 14:32:25 · 待回传 7 天心率数据
+
+
+ 未勾选 +
+
+ + +
+ + diff --git a/.preview/device_database/option_1_subview_empty_state.html b/.preview/device_database/option_1_subview_empty_state.html new file mode 100644 index 0000000..d5914be --- /dev/null +++ b/.preview/device_database/option_1_subview_empty_state.html @@ -0,0 +1,89 @@ + + + + + +设备数据库管理 - 空状态预览 + + + +
+
+
+ +

设备数据库管理

+
+
+ +
+ 📡 设备数据库 (统一充电与状态管理) +
+ + +
+
+ +
+
+ +
+
没有发现已注册的设备
+
+
+ + diff --git a/.preview/device_database/option_1_telemetry_flow.html b/.preview/device_database/option_1_telemetry_flow.html index 4b9c74c..88aea81 100644 --- a/.preview/device_database/option_1_telemetry_flow.html +++ b/.preview/device_database/option_1_telemetry_flow.html @@ -3,21 +3,29 @@ -方案 1:Telemetry Card Flow 流式遥测设备库 (推荐·家族风) +方案 1:Fluid Telemetry Pro 现代工控流 (条目流式 + 精准时间与设备勾选)
-
-
- -

设备数据库管理

-
- -
+ + + +
+
+
+ +

设备数据库管理

+
+ +
-
- - -
- -
-
-
-
-
33X_BLE_62200024
-
- 电量: 未知 - 固件: 未知 - 最后同步: 2026-08-12 14:32:25 -
-
+ + + +
+
+
+ +

批量历史数据同步

+
+
+ +
+
+ 默认同步天数: + +
+ +
+ +
-
未绑定
- -
-
-
-
-
33X_BLE_2200002
-
- 电量: 未知 - 固件: 未知 - 最后同步: 2026-08-12 14:32:25 +
+
+
+ +
+ 33X_BLE_62200024 +
最后同步: 2026-08-12 14:32:25 · 待回传 7 天心率数据
+ 已就绪
-
未绑定
-
- -
-
-
-
-
33X_BLE_62200025
-
- 电量: 未知 - 固件: 未知 - 最后同步: 2026-08-12 14:32:25 +
+
+ +
+ 33X_BLE_2200002 +
最后同步: 2026-08-12 14:32:25 · 待回传 7 天心率数据
+ 已就绪
-
未绑定
-
-
+ +
+
+ +
+ 33X_BLE_62200025 +
最后同步: 2026-08-12 14:32:25 · 待回传 7 天心率数据
+
+
+ 已就绪 +
+ + +
+ +
+
+ + diff --git a/.preview/device_database/option_2_split_station.html b/.preview/device_database/option_2_split_station.html new file mode 100644 index 0000000..d4075f5 --- /dev/null +++ b/.preview/device_database/option_2_split_station.html @@ -0,0 +1,214 @@ + + + + + +方案 2:Master-Detail Inset Station 经典双栏 (360px 1fr + 任意勾选与自由时间) + + + +
+
+
+ +

设备数据库管理

+
+ +
+ +
+ +
+
+
+

📡 充电机柜遥测大盘

+

统一供电、固件巡检与广播遥测

+
+ +
+ 已登记手环 + 7 台 +
+ +
+
默认同步时间范围
+ +
+
+ +
+ + +
+
+ + +
+
+ 手环设备清单 (支持任意单选与多选) +
+ + +
+
+ +
+
+ +
+ 33X_BLE_62200024 +
电量: 未知 · 固件: 未知 · 同步: 2026-08-12 14:32:25
+
+
+ 未绑定 +
+ +
+
+ +
+ 33X_BLE_2200002 +
电量: 未知 · 固件: 未知 · 同步: 2026-08-12 14:32:25
+
+
+ 未绑定 +
+ +
+
+ +
+ 33X_BLE_62200025 +
电量: 未知 · 固件: 未知 · 同步: 2026-08-12 14:32:25
+
+
+ 未绑定 +
+
+
+
+ + + + diff --git a/.preview/device_database/option_3_bento_charging_matrix.html b/.preview/device_database/option_3_bento_charging_matrix.html new file mode 100644 index 0000000..7462a26 --- /dev/null +++ b/.preview/device_database/option_3_bento_charging_matrix.html @@ -0,0 +1,129 @@ + + + + + +方案 3:Neo-Bento 充电机柜网格 (时间选择与动态勾选) + + + +
+
+
+ +

设备数据库管理

+
+ +
+ +
+ +
+
+
已登记总手环
+
7 台
+
+
+
默认同步时间周期
+ +
+
+
+
已勾选同步手环: 2 台
+
支持任意选择要同步的设备
+
+ +
+
+ + +
+
+
+ +
+ 33X_BLE_62200024 +
电量: 未知 · 固件: 未知
+
+
+ 未绑定 +
+ +
+
+ +
+ 33X_BLE_2200002 +
电量: 未知 · 固件: 未知
+
+
+ 未绑定 +
+
+
+
+ + diff --git a/.preview/device_database/option_4_nordic_compact_sheet.html b/.preview/device_database/option_4_nordic_compact_sheet.html new file mode 100644 index 0000000..69c3aec --- /dev/null +++ b/.preview/device_database/option_4_nordic_compact_sheet.html @@ -0,0 +1,101 @@ + + + + + +方案 4:Nordic Slate 极净设备清单 (全功能可选同步) + + + +
+
+
+ +

设备数据库管理

+
+ +
+ +
+
+ 同步天数: + +
+
+ + +
+
+ +
+
+
+ +
+ 33X_BLE_62200024 +
电量: 未知 · 固件: 未知 · 同步: 2026-08-12 14:32:25
+
+
+ 未绑定 +
+
+
+ +
+ 33X_BLE_2200002 +
电量: 未知 · 固件: 未知 · 同步: 2026-08-12 14:32:25
+
+
+ 未绑定 +
+
+
+ + diff --git a/.preview/device_database/option_5_cyber_dock_hud.html b/.preview/device_database/option_5_cyber_dock_hud.html new file mode 100644 index 0000000..e6c1c54 --- /dev/null +++ b/.preview/device_database/option_5_cyber_dock_hud.html @@ -0,0 +1,100 @@ + + + + + +方案 5:Cyber Precision 暗晶遥测中枢 (HUD 极客风格) + + + +
+
+
+ +

设备数据库管理

+
+ +
+ +
+
+ 📡 遥测时间: + +
+
+ + +
+
+ +
+
+
+ +
+ 33X_BLE_62200024 +
电量: 未知 · 固件: 未知 · 同步: 2026-08-12 14:32:25
+
+
+ 未绑定 +
+ +
+
+ +
+ 33X_BLE_2200002 +
电量: 未知 · 固件: 未知 · 同步: 2026-08-12 14:32:25
+
+
+ 未绑定 +
+
+
+ + diff --git a/.preview/device_database/preview_bakeoff.html b/.preview/device_database/preview_bakeoff.html new file mode 100644 index 0000000..55ebcab --- /dev/null +++ b/.preview/device_database/preview_bakeoff.html @@ -0,0 +1,102 @@ + + + + + +设备数据库管理 - 5套重构方案决策中心 + + + +
+
+ 📡 设备数据库管理 5套候选方案决策中心 + 统一充电与状态遥测 +
+
+ + + + + +
+
+ +
+ +
+ + + + diff --git a/.preview/device_database/shot_opt1.png b/.preview/device_database/shot_opt1.png new file mode 100644 index 0000000..5b3c0f6 Binary files /dev/null and b/.preview/device_database/shot_opt1.png differ diff --git a/.preview/device_database/shot_opt1_subview_batch_sync.png b/.preview/device_database/shot_opt1_subview_batch_sync.png new file mode 100644 index 0000000..55e59d6 Binary files /dev/null and b/.preview/device_database/shot_opt1_subview_batch_sync.png differ diff --git a/.preview/device_database/shot_opt1_subview_empty_state.png b/.preview/device_database/shot_opt1_subview_empty_state.png new file mode 100644 index 0000000..f9299ee Binary files /dev/null and b/.preview/device_database/shot_opt1_subview_empty_state.png differ diff --git a/.preview/device_database/shot_opt2.png b/.preview/device_database/shot_opt2.png new file mode 100644 index 0000000..2905c16 Binary files /dev/null and b/.preview/device_database/shot_opt2.png differ diff --git a/.preview/device_database/shot_opt3.png b/.preview/device_database/shot_opt3.png new file mode 100644 index 0000000..624c342 Binary files /dev/null and b/.preview/device_database/shot_opt3.png differ diff --git a/.preview/device_database/shot_opt4.png b/.preview/device_database/shot_opt4.png new file mode 100644 index 0000000..6f69964 Binary files /dev/null and b/.preview/device_database/shot_opt4.png differ diff --git a/.preview/device_database/shot_opt5.png b/.preview/device_database/shot_opt5.png new file mode 100644 index 0000000..5dae3f4 Binary files /dev/null and b/.preview/device_database/shot_opt5.png differ diff --git a/README.md b/README.md index df762f0..1aeb826 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,7 @@ | 5 | `手环配置/` | `Screenshot_20260812_143405.png` | ✅ | **已完工**(6 件齐) | | 6 | `DFU固件升级/` | `Screenshot_20260812_143413.png` | ✅ | **已完工**(6 件齐) | | 7 | `用户管理/` | `Screenshot_20260812_143424.png` | ✅ | **已完工**(6 件齐) | -| 8 | `设备数据库管理/` | `Screenshot_20260812_143432.png` | ❌ | 待办 | +| 8 | `设备数据库管理/` | `Screenshot_20260812_143432.png` | ✅ | **已完工**(6 件齐) | | 9 | `数据上传/` | `Screenshot_20260812_143450.png` | ❌ | 待办 · 有旧基准¹ | | 10 | `版本信息/` | `Screenshot_20260812_143456.png` | ❌ | 待办 · 有旧基准¹ | | 11 | `Logo授权管理/` | `Screenshot_20260812_143502.png` | ❌ | 待办 · 有旧基准¹ | diff --git a/设置页面UI优化/设备数据库管理/CARD-20260817-UITask-设备数据库管理.md b/设置页面UI优化/设备数据库管理/CARD-20260817-UITask-设备数据库管理.md new file mode 100644 index 0000000..c55047e --- /dev/null +++ b/设置页面UI优化/设备数据库管理/CARD-20260817-UITask-设备数据库管理.md @@ -0,0 +1,28 @@ +# JIRA 任务卡:CARD-20260817-UITask-设备数据库管理 + +- **任务 ID**: `CARD-20260817-UITask-设备数据库管理` +- **模块名称**: 设置 / 设备数据库管理 +- **设计风格**: 方案 2 · Master-Detail Inset Station 经典双栏 (360px 1fr) +- **状态**: `READY_FOR_RELEASE` +- **创建时间**: 2026-08-17 + +--- + +## 1. 业务目标与需求 + +1. **统一色彩规范**:严格对齐项目主色调 `#2563EB`(Royal Blue)体系,消除刺眼杂绿/杂红,状态胶囊使用柔和调和色(未绑定 `--color-warning: #D97706`)。 +2. **黄金栅格比例**:采用 `360px : 1fr` 经典双栏比例,左侧为充电机柜遥测大盘,右侧为手环多选卡片清单。 +3. **任意手环勾选同步**:右侧列表支持单选、多选、全选与清除;左侧主按钮文案动态联动 `开始同步已选手环 (N 台)`。 +4. **自由配置时间范围**:左侧下拉框支持 1天/3天/7天/14天/30天 同步时间范围自由切换。 +5. **解绑二次确认与空状态流转**:点击【批量解绑全部】弹出确认弹窗,确认后列表清空并优雅转入【没有发现已注册的设备】空状态。 + +--- + +## 2. 验收清单 (Acceptance Criteria) + +- [x] AppBar 标题为 `← 设备数据库管理`,带标准返回与更多功能操作。 +- [x] 左侧 360px 控制面板包含机柜遥测标题、已登记总数、未绑定数、同步时间下拉与贯穿式全宽操作按钮。 +- [x] 右侧 1fr 清单完整展现 7 台设备(`33X_BLE_62200024`, `33X_BLE_2200002`, `33X_BLE_62200025`, `33X_BLE_22000005`, `33X_BLE_62200014`, `33X_BLE_22000024`, `33X_BLE_22000009`)。 +- [x] 支持任意勾选,勾选 0 台时主按钮自动禁用置灰并提示。 +- [x] 解绑全部后可触发空状态并支持重新扫描恢复。 +- [x] 无头渲染输出 1200x800 高清效果图 `image.png`。 diff --git a/设置页面UI优化/设备数据库管理/DESIGN_SPEC.md b/设置页面UI优化/设备数据库管理/DESIGN_SPEC.md new file mode 100644 index 0000000..39b7e2a --- /dev/null +++ b/设置页面UI优化/设备数据库管理/DESIGN_SPEC.md @@ -0,0 +1,50 @@ +# 设备数据库管理 - 工业级 UI 重构设计规范 (Design Spec) + +## 1. 架构与定位 (Architecture & Positioning) + +本模块作为智能充电机柜与手环硬件群控系统的核心遥测与数据库中枢,主要承担全量已登记 BLE 蓝牙智能手环的状态监控、实时电量/固件遥测、任意设备勾选批量历史健康数据同步、时间范围筛选与群组解绑等高可用功能。 + +--- + +## 2. 设计规范与色彩系统 (Design Tokens & Color Palette) + +严格对齐项目主色调 `#2563EB` 与调和语义色规范: + +| Token 变量名 | 色值 / 规范 | 应用场景 | +| :--- | :--- | :--- | +| `--color-primary` | `#2563EB` (Royal Blue) | 主品牌色、选中态边框、勾选框高亮、主按钮背景 | +| `--color-primary-dark` | `#1D4ED8` | 主按钮悬停与渐变深色端 | +| `--color-primary-light` | `#EFF6FF` | 选中卡片底色、聚焦外发光底色 | +| `--color-primary-border` | `#DBEAFE` | 聚焦与选中态外边框 | +| `--color-primary-gradient` | `linear-gradient(135deg, #2563EB 0%, #1D4ED8 100%)` | 贯穿式批量同步主按钮背景 | +| `--color-warning` | `#D97706` (Amber) | 未绑定状态指示文字与标签 | +| `--color-warning-bg` | `#FFFBEB` | 未绑定状态胶囊浅色底 | +| `--color-warning-border` | `#FDE68A` | 未绑定状态胶囊边框 | +| `--color-danger` | `#E11D48` (Rose) | 批量解绑全部高风险危险操作按钮 | +| `--color-danger-bg` | `#FFF1F2` | 危险按钮次级浅底 | +| `--color-danger-border` | `#FFE4E6` | 危险按钮次级边框 | + +--- + +## 3. 布局与比例规范 (Layout & Ratio) + +采用与语言设置、版型切换深度对齐的 **360px : 1fr** 经典双栏比例: +- **左侧 360px 充电机柜遥测大盘**: + - 机柜遥测标题与副标题描述; + - 核心指标卡:已登记手环总数(`7 台`)、未绑定待分配总数(`7 台`); + - 默认历史同步时间选择器(支持 1天/3天/7天/14天/30天 下拉自由切换); + - 贯穿式全宽动态主按钮 `开始同步已选手环 (N 台)`(联动右侧勾选计数,0 台时自动置灰禁用); + - 次级贯穿式操作按钮 `批量解绑全部`(二次确认后清空并切换空状态)。 +- **右侧 1fr 手环设备清单**: + - 顶部工具栏:标题 + `全选` / `清除` 快捷操作; + - 7 台 BLE 手环卡片流,每张卡片支持任意点击或勾选复选框,显示设备广播名、电量、固件、最后同步时间及未绑定标签。 + +--- + +## 4. 交付文件清单 (Deliverables) + +1. `baseline_ui.html`:生产级无头渲染 HTML 源代码。 +2. `image.png`:1200x800 高清定稿预览效果截图。 +3. `DESIGN_SPEC.md`:本设计规范。 +4. `implementation_plan.md`:原生与前端工程实施方案。 +5. `CARD-20260817-UITask-设备数据库管理.md`:JIRA 重构研发任务卡。 diff --git a/设置页面UI优化/设备数据库管理/Screenshot_20260817_批量历史数据同步.png b/设置页面UI优化/设备数据库管理/Screenshot_20260817_批量历史数据同步.png new file mode 100644 index 0000000..2f55798 Binary files /dev/null and b/设置页面UI优化/设备数据库管理/Screenshot_20260817_批量历史数据同步.png differ diff --git a/设置页面UI优化/设备数据库管理/Screenshot_20260817_设备数据库管理_空状态.png b/设置页面UI优化/设备数据库管理/Screenshot_20260817_设备数据库管理_空状态.png new file mode 100644 index 0000000..dd0f952 Binary files /dev/null and b/设置页面UI优化/设备数据库管理/Screenshot_20260817_设备数据库管理_空状态.png differ diff --git a/设置页面UI优化/设备数据库管理/baseline_ui.html b/设置页面UI优化/设备数据库管理/baseline_ui.html new file mode 100644 index 0000000..5c6f001 --- /dev/null +++ b/设置页面UI优化/设备数据库管理/baseline_ui.html @@ -0,0 +1,454 @@ + + + + + +设备数据库管理 - Master-Detail Inset Station (360px 1fr) + + + +
+
+
+ +

设备数据库管理

+
+ +
+ +
+ +
+
+
+

📡 设备数据库

+

统一充电与状态管理

+
+ +
+ 已登记手环总数 + 7 台 +
+ +
+ 未绑定待分配 + 7 台 +
+ +
+
默认同步天数
+ +
+
+ +
+ + +
+
+ + +
+
+ 设备列表 +
+ + +
+
+ +
+ +
+
+ +
+
33X_BLE_62200024
+
+ 电量: 未知 + 固件: 未知 + 最后同步: 2026-08-12 14:32:25 +
+
+
+
+ 未绑定 +
+
+ + +
+
+ +
+
33X_BLE_2200002
+
+ 电量: 未知 + 固件: 未知 + 最后同步: 2026-08-12 14:32:25 +
+
+
+
+ 未绑定 +
+
+ + +
+
+ +
+
33X_BLE_62200025
+
+ 电量: 未知 + 固件: 未知 + 最后同步: 2026-08-12 14:32:25 +
+
+
+
+ 未绑定 +
+
+ + +
+
+ +
+
33X_BLE_22000005
+
+ 电量: 未知 + 固件: 未知 + 最后同步: 2026-08-12 14:32:25 +
+
+
+
+ 未绑定 +
+
+ + +
+
+ +
+
33X_BLE_62200014
+
+ 电量: 未知 + 固件: 未知 + 最后同步: 2026-08-12 14:32:25 +
+
+
+
+ 未绑定 +
+
+ + +
+
+ +
+
33X_BLE_22000024
+
+ 电量: 未知 + 固件: 未知 + 最后同步: 2026-08-12 14:32:25 +
+
+
+
+ 未绑定 +
+
+ + +
+
+ +
+
33X_BLE_22000009
+
+ 电量: 未知 + 固件: 未知 + 最后同步: 2026-08-12 14:32:25 +
+
+
+
+ 未绑定 +
+
+
+ + +
+
+ +
+
没有发现已注册的设备
+ +
+
+
+
+ + + + diff --git a/设置页面UI优化/设备数据库管理/image.png b/设置页面UI优化/设备数据库管理/image.png new file mode 100644 index 0000000..55ad9b6 Binary files /dev/null and b/设置页面UI优化/设备数据库管理/image.png differ diff --git a/设置页面UI优化/设备数据库管理/implementation_plan.md b/设置页面UI优化/设备数据库管理/implementation_plan.md new file mode 100644 index 0000000..b1a8986 --- /dev/null +++ b/设置页面UI优化/设备数据库管理/implementation_plan.md @@ -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`。