feat(ui): 交付第9个子页面【数据上传】UI重构与连通性测试联动

- 页面交付清单 (已累计完成 9/11 个页面):
  1. 语言设置 (已完工)
  2. 版型切换 (已完工)
  3. 心率区间设置 (已完工)
  4. 自动连接配置 (已完工)
  5. 手环配置 (已完工)
  6. DFU固件升级 (已完工)
  7. 用户管理 (已完工)
  8. 设备数据库管理 (已完工)
  9. 数据上传 (本次交付·已完工)
- 核心重构亮点:
  1. 采纳 Master-Detail Inset Station 经典双栏比例 (360px 1fr);
  2. 彻底消除点击误导,左侧重构为【自动上传数据】标准开关行与只读【上传通道监控】大盘;
  3. 【测试数据上传】迁移至右侧表单底部实现 100% 贯穿式排版,且支持输入完整性动态校验点亮;
  4. 完善点击测试联动,实时回显 200 OK 连通状态、响应时延与最近测试时间戳;
  5. 集齐 6 件套交付物 (baseline_ui.html, image.png, DESIGN_SPEC.md, implementation_plan.md, CARD 任务卡, README 更新)。
This commit is contained in:
zhy200308
2026-08-17 18:43:32 +08:00
parent 75a642f4e9
commit ed877e14ef
17 changed files with 1447 additions and 1 deletions
@@ -0,0 +1,51 @@
# 数据上传 - 工业级 UI 重构设计规范 (Design Spec)
## 1. 架构与定位 (Architecture & Positioning)
本模块作为智能穿戴与生理指标监测系统向云端服务上报数据的通信中枢,负责配置表单数据上传接口、原始 PPG/HRV 时域数据包上传接口、通信端口以及自动上传开关,并提供实时网络连通性 Ping 测试与状态反馈。
---
## 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-success` | `#059669` (Emerald) | 测试成功连通状态 (200 OK) |
| `--color-success-bg` | `#ECFDF5` | 连通状态胶囊浅底 |
| `--color-success-border` | `#A7F3D0` | 连通状态胶囊边框 |
| `--color-warning` | `#D97706` (Amber) | 测试中动态转圈状态 |
| `--color-warning-bg` | `#FFFBEB` | 测试中胶囊浅底 |
---
## 3. 布局与比例规范 (Layout & Ratio)
采用与语言设置、版型切换、设备数据库管理深度对齐的 **360px : 1fr** 经典双栏比例:
- **左侧 360px 上传监控与控制面板**:
- 模块标题与副标题描述;
- 自动上传数据设置行(集成 iOS/M3 标准开关);
- 上传通道监控大盘(只读型,实时展现响应时延、传输协议与最近测试时间戳);
- 底部贯穿式全宽 `保存`(主色渐变)与 `重置`(次级幽灵白)按钮。
- **右侧 1fr 服务器端点配置面板**:
- 顶部表单区:表单上传地址、原始数据上传地址、数据传输端口;
- 底部贯穿式 `测试数据上传` 操作条:
- 当表单未填写完整时,按钮置灰禁用 (`disabled`);
- 当表单完整填写后,按钮自动点亮为科技蓝底色并支持点击;
- 点击后向左侧【上传通道监控】发送测试 Ping 并实时反馈连通状态与毫秒延迟。
---
## 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 重构研发任务卡。