# 数据上传 - 工程实施方案 (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` 的文本长度。