Files
EAP_Interface_html/设置页面UI优化/数据上传/implementation_plan.md
T
zhy200308 ed877e14ef 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 更新)。
2026-08-17 18:43:32 +08:00

51 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 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` 的文本长度。