67 lines
4.3 KiB
Markdown
67 lines
4.3 KiB
Markdown
# 轨迹回放规模与降级连续性审计
|
||
|
||
## 本轮结果
|
||
|
||
本轮把轨迹回放中容易混淆的“源点、处理点、地图点、导出点”收敛为两层口径：源点代表完整查询证据，回放点代表当前地图与播放控制使用的点集。千点级抽稀、服务端截断、地图 SDK 不可用、地址解析失败和多来源融合均提供明确状态与恢复入口。
|
||
|
||
| 检查项 | 调整前 | 调整后 |
|
||
| --- | --- | --- |
|
||
| 点数口径 | 摘要、播放坞和导出统一称“数据点” | 摘要与播放坞称“回放点”，证据条明确“源点 → 回放点” |
|
||
| 千点抽稀 | 仅在概览角标显示“地图已抽稀” | 查询完整时说明全部源点参与计算、地图回放点数；不暗示数据丢失 |
|
||
| 服务端截断 | 只显示“最新切片” | 显示可用点 / 总源点，并提供“修改范围”直达恢复 |
|
||
| 地图降级 | SDK 未配置显示点数；加载失败仅能重试 | 明确轨迹证据仍可使用，可重试地图或直达来源/事件证据 |
|
||
| 地址失败 | 静默退回经纬度 | 显示“地址暂不可用”、保留坐标并原位重试 |
|
||
| 多来源融合 | 只列出协议和点数 | 标明主来源、备选来源、来源总数与轨迹内切换次数 |
|
||
| 查询草稿 | 未提交的来源可能提前出现在折叠标题 | 标题、移动入口和侧栏摘要始终使用已应用条件 |
|
||
|
||
## 关键旅程健康度
|
||
|
||
1. **查询并应用条件 — 健康**：车辆、时间、来源提交后写入 URL；未提交草稿不会污染已应用标题。
|
||
2. **查看千点轨迹 — 健康**：1,600 个回放点 / 12,480 个源点的自动化样本可稳定渲染，并清楚说明完整抽稀口径。
|
||
3. **恢复部分结果 — 健康**：服务端仅返回部分轨迹时，状态区显示比例并直接展开时间范围编辑。
|
||
4. **地图不可用时继续调查 — 健康**：SDK 未配置与临时失败均保留“查看轨迹证据”；临时失败同时保留地图重试。
|
||
5. **地址失败时核验位置 — 健康**：真实浏览器运行中地址解析失败，坐标、错误状态和重试入口同时可见。
|
||
6. **核对多来源 — 健康**：真实样本明确显示 2 个来源、JT/T 808 主来源、GB/T 32960 备选来源和 0 次切换。
|
||
|
||
## 实页证据
|
||
|
||
桌面端前后对比（左：调整前；右：调整后来源与恢复证据）：
|
||
|
||
|
||
|
||
桌面端最终轨迹：
|
||
|
||
|
||
|
||
桌面端来源概览：
|
||
|
||
|
||
|
||
移动端前后状态：
|
||
|
||
|
||
|
||
|
||
|
||
## 验证记录
|
||
|
||
- 真实接口轨迹：粤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`。
|