42 lines
4.2 KiB
Markdown
42 lines
4.2 KiB
Markdown
# 全局监控万辆车与降级连续性审计
|
||
|
||
审计日期：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 辆有定位` 口径同时可见。[截图](after/01-desktop-map-coverage.jpg)
|
||
2. **桌面分页列表 — 健康**：四辆授权车辆完整保留；地址服务失败时单元格显示“解析失败，重试”，无坐标车辆不触发地理解析。[截图](after/02-desktop-list-address-recovery.jpg)
|
||
3. **移动分页列表 — 健康**：卡片保留车牌、VIN、速度、里程、协议、坐标和地址恢复操作；底部导航与分页操作保持可见。[截图](after/03-mobile-list-address-recovery.jpg)
|
||
4. **移动全国地图 — 健康**：省级聚合、状态图例和智能刷新在 390 × 844 下可用，地图没有横向页面滚动。[截图](after/04-mobile-map.jpg)
|
||
5. **移动单车详情 — 健康**：地址失败明确为 `alert`，坐标证据仍可复制/核对，重试按钮与跨模块调查入口保持在同一工作面板。[截图](after/05-mobile-detail-address-recovery.jpg)
|
||
|
||
## 前后对照
|
||
|
||
- 基线桌面：[全国地图](before/01-desktop-map.png) · [分页列表](before/02-desktop-list.png)
|
||
- 改进桌面：[地图覆盖口径](after/01-desktop-map-coverage.jpg) · [地址失败恢复](after/02-desktop-list-address-recovery.jpg)
|
||
- 同屏检查：[桌面地图前后对照](comparison-desktop-map-before-after.png)
|
||
|
||
## 验证
|
||
|
||
- 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% 缩放、强制色彩或完整对比度测量。
|