feat: expand vehicle data platform capabilities
This commit is contained in:
@@ -0,0 +1,41 @@
|
||||
# 全局监控万辆车与降级连续性审计
|
||||
|
||||
审计日期: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% 缩放、强制色彩或完整对比度测量。
|
||||
Reference in New Issue
Block a user