feat: expand vehicle data platform capabilities

2026-07-27 16:46:15 +08:00
parent e3a1f80f86
commit 3c4bece72c
650 changed files with 62155 additions and 2552 deletions
--- a/vehicle-data-platform/docs/design/track-scale-degradation-continuity-20260723/README.md
+++ b/vehicle-data-platform/docs/design/track-scale-degradation-continuity-20260723/README.md
@@ -0,0 +1,66 @@
+# 轨迹回放规模与降级连续性审计
+
+## 本轮结果
+
+本轮把轨迹回放中容易混淆的“源点、处理点、地图点、导出点”收敛为两层口径：源点代表完整查询证据，回放点代表当前地图与播放控制使用的点集。千点级抽稀、服务端截断、地图 SDK 不可用、地址解析失败和多来源融合均提供明确状态与恢复入口。
+
+| 检查项 | 调整前 | 调整后 |
+| --- | --- | --- |
+| 点数口径 | 摘要、播放坞和导出统一称“数据点” | 摘要与播放坞称“回放点”，证据条明确“源点 → 回放点” |
+| 千点抽稀 | 仅在概览角标显示“地图已抽稀” | 查询完整时说明全部源点参与计算、地图回放点数；不暗示数据丢失 |
+| 服务端截断 | 只显示“最新切片” | 显示可用点 / 总源点，并提供“修改范围”直达恢复 |
+| 地图降级 | SDK 未配置显示点数；加载失败仅能重试 | 明确轨迹证据仍可使用，可重试地图或直达来源/事件证据 |
+| 地址失败 | 静默退回经纬度 | 显示“地址暂不可用”、保留坐标并原位重试 |
+| 多来源融合 | 只列出协议和点数 | 标明主来源、备选来源、来源总数与轨迹内切换次数 |
+| 查询草稿 | 未提交的来源可能提前出现在折叠标题 | 标题、移动入口和侧栏摘要始终使用已应用条件 |
+
+## 关键旅程健康度
+
+1. **查询并应用条件 — 健康**：车辆、时间、来源提交后写入 URL；未提交草稿不会污染已应用标题。
+2. **查看千点轨迹 — 健康**：1,600 个回放点 / 12,480 个源点的自动化样本可稳定渲染，并清楚说明完整抽稀口径。
+3. **恢复部分结果 — 健康**：服务端仅返回部分轨迹时，状态区显示比例并直接展开时间范围编辑。
+4. **地图不可用时继续调查 — 健康**：SDK 未配置与临时失败均保留“查看轨迹证据”；临时失败同时保留地图重试。
+5. **地址失败时核验位置 — 健康**：真实浏览器运行中地址解析失败，坐标、错误状态和重试入口同时可见。
+6. **核对多来源 — 健康**：真实样本明确显示 2 个来源、JT/T 808 主来源、GB/T 32960 备选来源和 0 次切换。
+
+## 实页证据
+
+桌面端前后对比（左：调整前；右：调整后来源与恢复证据）：
+
+![桌面端前后对比](./comparison-desktop.png)
+
+桌面端最终轨迹：
+
+![桌面端最终轨迹](./after-desktop.png)
+
+桌面端来源概览：
+
+![桌面端来源概览](./after-desktop-overview.png)
+
+移动端前后状态：
+
+![移动端调整前](./before-mobile.png)
+
+![移动端调整后](./after-mobile.png)
+
+## 验证记录
+
+- 真实接口轨迹：粤AG18312，18 个回放点，22.9 km，11 个事件，2 个来源。
+- 桌面视口：1440 × 980；移动视口：390 × 844。
+- 千点样本：1,600 个回放点 / 12,480 个源点；覆盖完整与服务端截断两条分支。
+- 定向回归：3 个文件、29 个测试全部通过。
+- 全量前端回归：78 个文件、494 个测试全部通过；API `go test ./...` 全部通过。
+- 生产构建：通过，构建门禁 `web_build_gate=ok`；轨迹页面产物 61.73 kB（gzip 19.66 kB）。
+
+## 无障碍边界
+
+- 播放滑块和状态播报现使用“回放点”一致口径；抽稀/截断提示为 `role="status"`，地图证据与地址重试均为可聚焦按钮。
+- 高德底图 iframe 内部标注和缩放控件的完整读屏语义不由当前应用控制；轨迹时间、来源、事件和质量仍通过应用侧列表提供等价入口。
+- 本轮验证了 DOM 语义、键盘可达控件、响应式布局和自动化焦点行为，但未替代 VoiceOver/TalkBack 真机走查。
+- 地图 SDK 失败由自动化模拟验证，真实浏览器本轮实际命中了地址解析失败；生产网络限流和恢复后的地图缩放保持仍需生产环境持续观测。
+
+## 已知非阻断差异
+
+- 正常小轨迹不会额外显示抽稀提示，以避免重复信息；源点/回放点口径仍在当前点证据条和概览中可见。
+- 当前 CSV 明确导出“当前回放点”，尚未提供后台生成全部原始源点文件的独立任务。
+- Semi UI 仍在测试环境输出 React `findDOMNode` 弃用警告；Sass 构建仍提示第三方 Semi 主题使用已弃用的 `@import`。