ed877e14ef
- 页面交付清单 (已累计完成 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 更新)。
51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
# 数据上传 - 工程实施方案 (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` 的文本长度。
|