diff --git a/.preview/data_upload/option_1_master_detail_split.html b/.preview/data_upload/option_1_master_detail_split.html new file mode 100644 index 0000000..4efb9c0 --- /dev/null +++ b/.preview/data_upload/option_1_master_detail_split.html @@ -0,0 +1,405 @@ + + + + + +数据上传 - Master-Detail Inset Station (测试贯穿与表单校验联动版) + + + +
+
+
+ +

数据上传

+
+ +
+ +
+ +
+
+
+

☁️ 数据上传

+

健康指标与传感器原始遥测实时上报

+
+ + +
+
+ 自动上传数据 + 测量完成后后台静默上报 +
+ +
+ + +
+
+ 上传通道监控 + + + 未测试 + +
+
+
+ 响应时延 + -- ms +
+
+ 传输协议 + RESTful +
+
+ 最近测试时间 + 从未测试 +
+
+
+
+ + +
+ + +
+
+ + +
+
+
+ 服务器端点配置 + 完整填写所有地址后可触发测试 +
+ +
+ +
+ + + 用于同步学员体检报告与评估表单数据 +
+ + +
+ + + 用于回传 PPG / 心率变异性原始时域数据包 +
+ + +
+ + + 默认 TCP/HTTP 通讯端口(范围 1 ~ 65535) +
+
+
+ + +
+ +
+
+
+
+ + + + diff --git a/.preview/data_upload/option_2_fluid_endpoint_studio.html b/.preview/data_upload/option_2_fluid_endpoint_studio.html new file mode 100644 index 0000000..befad95 --- /dev/null +++ b/.preview/data_upload/option_2_fluid_endpoint_studio.html @@ -0,0 +1,113 @@ + + + + + +方案 2:Fluid Form Studio 通栏工控表单流 + + + +
+
+
+ +

数据上传

+
+ +
+ +
+
+
+
+ 自动上传数据 +
完成采集后自动将数据推送到指定云端
+
+ +
+ +
+ + +
+ +
+ + +
+ +
+ + +
+ +
+ + + +
+
+
+
+ + diff --git a/.preview/data_upload/option_3_bento_telemetry_dock.html b/.preview/data_upload/option_3_bento_telemetry_dock.html new file mode 100644 index 0000000..64cab67 --- /dev/null +++ b/.preview/data_upload/option_3_bento_telemetry_dock.html @@ -0,0 +1,93 @@ + + + + + +方案 3:Neo-Bento 数据分发矩阵 + + + +
+
+
+ +

数据上传

+
+ +
+ +
+
+
+ 自动上传数据 +
开启后实时同步健康体检与传感器流
+
+ +
+ +
+ + +
+ +
+ + +
+ +
+
+ + +
+
+ + + +
+
+
+
+ + diff --git a/.preview/data_upload/option_4_nordic_slate_sheet.html b/.preview/data_upload/option_4_nordic_slate_sheet.html new file mode 100644 index 0000000..0e89925 --- /dev/null +++ b/.preview/data_upload/option_4_nordic_slate_sheet.html @@ -0,0 +1,95 @@ + + + + + +方案 4:Nordic Slate 极净工控表单 + + + +
+
+
+ +

数据上传

+
+ +
+ +
+
+ 自动上传数据 + +
+ +
+ 表单上传地址 + +
+ +
+ 原始数据上传地址 + +
+ +
+ 数据传输端口 + +
+ +
+ + + +
+
+
+ + diff --git a/.preview/data_upload/option_5_cyber_dock_hud.html b/.preview/data_upload/option_5_cyber_dock_hud.html new file mode 100644 index 0000000..11a6611 --- /dev/null +++ b/.preview/data_upload/option_5_cyber_dock_hud.html @@ -0,0 +1,104 @@ + + + + + +方案 5:Cyber Precision 暗晶传输中枢 + + + +
+
+
+ +

数据上传

+
+ +
+ +
+
+
+

📡 数据遥测网关

+
+ 自动上传数据 + +
+
+ +
+ + + +
+
+ +
+
+ + +
+
+ + +
+
+ + +
+
+
+
+ + diff --git a/.preview/data_upload/preview_bakeoff.html b/.preview/data_upload/preview_bakeoff.html new file mode 100644 index 0000000..6b392f3 --- /dev/null +++ b/.preview/data_upload/preview_bakeoff.html @@ -0,0 +1,102 @@ + + + + + +数据上传 - 5套重构方案决策中心 + + + +
+
+ ☁️ 数据上传 5套候选方案决策中心 + HTTP/HTTPS REST API +
+
+ + + + + +
+
+ +
+ +
+ + + + diff --git a/.preview/data_upload/shot_opt1.png b/.preview/data_upload/shot_opt1.png new file mode 100644 index 0000000..3c2e94e Binary files /dev/null and b/.preview/data_upload/shot_opt1.png differ diff --git a/.preview/data_upload/shot_opt2.png b/.preview/data_upload/shot_opt2.png new file mode 100644 index 0000000..112a891 Binary files /dev/null and b/.preview/data_upload/shot_opt2.png differ diff --git a/.preview/data_upload/shot_opt3.png b/.preview/data_upload/shot_opt3.png new file mode 100644 index 0000000..231ae6d Binary files /dev/null and b/.preview/data_upload/shot_opt3.png differ diff --git a/.preview/data_upload/shot_opt4.png b/.preview/data_upload/shot_opt4.png new file mode 100644 index 0000000..8832e02 Binary files /dev/null and b/.preview/data_upload/shot_opt4.png differ diff --git a/.preview/data_upload/shot_opt5.png b/.preview/data_upload/shot_opt5.png new file mode 100644 index 0000000..e1f97c3 Binary files /dev/null and b/.preview/data_upload/shot_opt5.png differ diff --git a/README.md b/README.md index 1aeb826..169f2bf 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,7 @@ | 6 | `DFU固件升级/` | `Screenshot_20260812_143413.png` | ✅ | **已完工**(6 件齐) | | 7 | `用户管理/` | `Screenshot_20260812_143424.png` | ✅ | **已完工**(6 件齐) | | 8 | `设备数据库管理/` | `Screenshot_20260812_143432.png` | ✅ | **已完工**(6 件齐) | -| 9 | `数据上传/` | `Screenshot_20260812_143450.png` | ❌ | 待办 · 有旧基准¹ | +| 9 | `数据上传/` | `Screenshot_20260812_143450.png` | ✅ | **已完工**(6 件齐) | | 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..b9c9279 --- /dev/null +++ b/设置页面UI优化/数据上传/CARD-20260817-UITask-数据上传.md @@ -0,0 +1,28 @@ +# JIRA 任务卡:CARD-20260817-UITask-数据上传 + +- **任务 ID**: `CARD-20260817-UITask-数据上传` +- **模块名称**: 设置 / 数据上传 +- **设计风格**: 方案 1 · Master-Detail Inset Station 经典双栏 (360px 1fr) +- **状态**: `READY_FOR_RELEASE` +- **创建时间**: 2026-08-17 + +--- + +## 1. 业务目标与需求 + +1. **统一色彩规范**:严格对齐项目主色调 `#2563EB`(Royal Blue)体系,输入框聚焦时使用 `--color-primary` 高亮与浅蓝微底。 +2. **黄金栅格比例**:采用 `360px : 1fr` 经典双栏比例,左侧为上传监控与操作大盘,右侧为服务器端点配置表单。 +3. **测试按钮右侧贯穿与表单校验联动**:将【测试数据上传】置于右侧表单底部,实现 100% 贯穿排版;当表单未填满时置灰禁用,填写完整后自动点亮为科技蓝。 +4. **实时连通性测试联动**:点击【测试数据上传】后向左侧【上传通道监控】发送连通性状态,动态刷新 200 OK 连通状态、响应时延(28ms)及最近测试时间。 +5. **重置与保存逻辑**:保存弹出成功提示,重置清空表单并使测试按钮自动回退为禁用态。 + +--- + +## 2. 验收清单 (Acceptance Criteria) + +- [x] AppBar 标题为 `← 数据上传`,带标准返回与更多功能操作。 +- [x] 左侧 360px 控制面板包含模块标题、自动上传数据开关、上传通道监控大盘与全宽保存/重置按钮。 +- [x] 右侧 1fr 面板完整包含【表单上传地址】、【原始数据上传地址】与【数据传输端口】3 个输入字段。 +- [x] 右侧底部贯穿式【测试数据上传】按钮在表单完整时点亮,未填满时置灰禁用。 +- [x] 点击测试后左侧监控大盘实时更新连通状态与时延。 +- [x] 无头渲染输出 1200x800 高清效果图 `image.png`。 diff --git a/设置页面UI优化/数据上传/DESIGN_SPEC.md b/设置页面UI优化/数据上传/DESIGN_SPEC.md new file mode 100644 index 0000000..5d04a3f --- /dev/null +++ b/设置页面UI优化/数据上传/DESIGN_SPEC.md @@ -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 重构研发任务卡。 diff --git a/设置页面UI优化/数据上传/baseline_ui.html b/设置页面UI优化/数据上传/baseline_ui.html new file mode 100644 index 0000000..b4642a6 --- /dev/null +++ b/设置页面UI优化/数据上传/baseline_ui.html @@ -0,0 +1,405 @@ + + + + + +数据上传 - Master-Detail Inset Station (360px 1fr) + + + +
+
+
+ +

数据上传

+
+ +
+ +
+ +
+
+
+

☁️ 数据上传

+

健康指标与传感器原始遥测实时上报

+
+ + +
+
+ 自动上传数据 + 测量完成后后台静默上报 +
+ +
+ + +
+
+ 上传通道监控 + + + 未测试 + +
+
+
+ 响应时延 + -- ms +
+
+ 传输协议 + RESTful +
+
+ 最近测试时间 + 从未测试 +
+
+
+
+ + +
+ + +
+
+ + +
+
+
+ 服务器端点配置 + 完整填写所有地址后可触发测试 +
+ +
+ +
+ + + 用于同步学员体检报告与评估表单数据 +
+ + +
+ + + 用于回传 PPG / 心率变异性原始时域数据包 +
+ + +
+ + + 默认 TCP/HTTP 通讯端口(范围 1 ~ 65535) +
+
+
+ + +
+ +
+
+
+
+ + + + diff --git a/设置页面UI优化/数据上传/image.png b/设置页面UI优化/数据上传/image.png new file mode 100644 index 0000000..3c2e94e 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..de42f7d --- /dev/null +++ b/设置页面UI优化/数据上传/implementation_plan.md @@ -0,0 +1,50 @@ +# 数据上传 - 工程实施方案 (Implementation Plan) + +## 1. 数据模型与接口规范 (Data Model & Schema) + +```typescript +export interface DataUploadConfig { + autoUploadEnabled: boolean; // 是否开启自动上传数据 + formUploadUrl: string; // 表单上传完整 URL + rawTelemetryUrl: string; // 原始数据上传完整 URL + transferPort: number; // 通信传输端口 (1~65535) +} + +export interface NetworkPingResult { + status: 'IDLE' | 'TESTING' | 'SUCCESS' | 'ERROR'; + statusCode?: number; // HTTP 状态码 (如 200) + latencyMs?: number; // 响应时延 (毫秒) + testedAt?: string; // 测试完成时间 ISO 字符串 + errorMessage?: string; // 错误描述 +} +``` + +--- + +## 2. 状态机与联动流程 (State Machine & Workflow) + +```mermaid +stateDiagram-v2 + [*] --> FormLoaded: 载入当前网络配置 + FormLoaded --> FormValid: 检查 3 项输入框均非空 + FormLoaded --> FormInvalid: 任一输入框为空 + FormInvalid --> TestDisabled: 右侧【测试数据上传】置灰禁用 + FormValid --> TestEnabled: 右侧【测试数据上传】点亮就绪 + TestEnabled --> TestingPing: 点击【测试数据上传】 + TestingPing --> PingSuccess: 服务器返回 200 OK + TestingPing --> PingFail: 网络超时或 4xx/5xx + PingSuccess --> UpdateMonitor: 左侧通道监控更新时延与状态 + UpdateMonitor --> FormLoaded: 恢复就绪 +``` + +--- + +## 3. 原生实施映射 (Native Implementation Mapping) + +- **Android (Kotlin / Jetpack Compose)**: + - 左侧采用 `Card(modifier = Modifier.width(360.dp))` 包含 `Switch` 与 `MonitorBox`; + - 右侧采用 `OutlinedTextField` 结合 `derivedStateOf { formUrl.isNotBlank() && rawUrl.isNotBlank() && port.isNotBlank() }` 实现测试按钮动态点亮; + - 网络测试基于 `OkHttpClient` 执行轻量 `HEAD` 或 `OPTIONS` Ping 请求。 +- **Flutter**: + - `Row(children: [SizedBox(width: 360, child: UploadControlPanel()), Expanded(child: ServerEndpointsForm())])`; + - 动态点亮使用 `ValueListenableBuilder` 监听 3 个 `TextEditingController` 的文本长度。