Files
lingniu-vehicle-ingest/vehicle-data-platform/docs/design/monitor-scale-degradation-continuity-20260723

全局监控万辆车与降级连续性审计

审计日期2026-07-23。范围覆盖全国聚合、授权车辆与地图定位口径、10,000 辆服务端载荷上限、地图 SDK 不可用、列表地址解析和单车详情地址解析。

结论

  1. 地图底部不再把省级聚合误写成“0 个车辆点”,现在统一显示“已定位 / 授权车辆”与当前聚合层级;本地样例明确为 2 / 4 辆有定位 · 省级聚合
  2. 当监控工作区达到 10,000 辆处理上限时,车辆总数继续采用服务端总量,状态统计与地图明确标记“部分口径”,并提供“查看完整车辆列表”进入 20/50/100 条服务端分页核对。
  3. 地图未配置或 SDK 加载失败时不再只停留在灰色地图:保留原位重试,并新增“使用车辆列表”作为可工作的降级路径。
  4. 列表地址保持按需解析;失败时显示原位重试。单车详情地址解析失败不再永久显示“位置解析中”,而是保留原始坐标、明确失败并提供重试。
  5. 只在截断时需要的口径提示与批量车辆编辑器均按需加载,监控关键入口产物从超预算状态收敛到 33,816 bytes,未放宽 35,000 bytes 门槛。

当前运行步骤与证据

  1. 桌面全国地图 — 健康:省级聚合、车辆列表、状态图例和 2 / 4 辆有定位 口径同时可见。截图
  2. 桌面分页列表 — 健康:四辆授权车辆完整保留;地址服务失败时单元格显示“解析失败,重试”,无坐标车辆不触发地理解析。截图
  3. 移动分页列表 — 健康卡片保留车牌、VIN、速度、里程、协议、坐标和地址恢复操作底部导航与分页操作保持可见。截图
  4. 移动全国地图 — 健康:省级聚合、状态图例和智能刷新在 390 × 844 下可用,地图没有横向页面滚动。截图
  5. 移动单车详情 — 健康:地址失败明确为 alert,坐标证据仍可复制/核对,重试按钮与跨模块调查入口保持在同一工作面板。截图

前后对照

验证

  • 1440 × 980全国地图、授权/定位口径、分页列表和地址失败恢复通过真实浏览器检查。
  • 390 × 844移动地图、卡片列表、单车详情、固定底部导航与地址失败恢复通过真实浏览器检查。
  • 10,000+ 载荷:自动化覆盖 10,000 / 12,480 部分口径、全量总数和切换分页列表;地图聚合保持服务端省级/网格/车辆点三层响应。
  • 地图 SDK自动化覆盖加载失败后的重试与切换列表也覆盖未配置地图时直接使用列表。
  • 无障碍语义:部分口径使用命名 status,地址失败使用 alert;恢复操作均为原生按钮,地图/列表使用命名页签;单车坐标在地址失败时仍可访问。
  • 回归Web 78 个测试文件、490 项测试全部通过(含 MonitorPage.test.tsx 25 项、FleetMap.test.tsx 22 项生产构建通过API go test ./... 通过。

已知边界

  • 本地数据仅有 4 辆10,000+ 状态由服务端与页面自动化构造验证,仍需生产级车辆分布、长时间运行和浏览器内存曲线复核。
  • 当前浏览器环境成功加载高德地图SDK 加载失败与未配置恢复路径由组件自动化验证,未用截图冒充真实浏览器故障证据。
  • 地址解析服务在当前运行中真实返回失败,因此验证了错误与重试;尚未验证限流、长超时、恢复后缓存刷新和不同地图供应商返回格式。
  • 截图与语义 DOM 不能证明 WCAG 全量合规;本轮未执行 VoiceOver/NVDA 人工听读、200% 缩放、强制色彩或完整对比度测量。