lingniu-vehicle-ingest/vehicle-data-platform/docs/design/vehicle-workflow-continuity-20260723

车辆工作链连续性优化

目标与结果

本轮将全局监控、车辆目录、车辆档案、轨迹回放、历史数据、里程查询与告警事件串成可恢复的工作链。用户不再依赖浏览器后退猜测来源：每个子页面优先返回最近的车辆档案，车辆档案再精确返回目录或全局监控位置。

核心链路：

全局监控 → 车辆目录（搜索 / 视图 / 页码）→ 车辆档案 → 轨迹 / 历史 / 里程 / 事件

返回顺序：

子页面 → 同一车辆档案 → 原车辆目录位置 → 原全局监控位置

URL 状态契约

• vehicleSearch：车辆目录已应用搜索词。
• vehicleView：all / online / offline / multi 目录视图。
• vehiclePage：车辆目录页码。
• vehicleDirectoryReturn：车辆档案返回目录时使用的内部路径。
• vehicleReturn：轨迹、历史、里程和事件返回车辆档案时使用的内部路径。
• monitorReturn：保留在目录或档案之后的全局监控来源。

所有返回参数都会重新解析、规范化并限制为平台内部受支持路由；外部 URL 和不相关平台路径会被拒绝。

页面行为

1. 车辆目录筛选、视图和分页全部由 URL 驱动，刷新、分享、前进/后退可恢复。
2. 从目录打开车辆时，档案顶部显示“返回车辆目录”，并说明已保留的搜索、视图和页码。
3. 从档案进入轨迹、历史、里程或告警时，子页面顶部显示“返回车辆档案”。
4. 子页面修改筛选或时间范围后仍保留车辆返回目标。
5. 手机端返回条隐藏辅助说明，仅保留主要返回动作和车辆/搜索标识，避免挤压内容。
6. 已选车辆但时间窗没有轨迹时，改为“当前时间窗没有可回放轨迹”，不再错误要求重新选择车辆。

视觉一致性记录

本轮没有生成新的视觉概念图。改动沿用现有 Semi UI、平台工作区命令栏和共享返回条，是一项跨模块状态与页面逻辑连续性优化。

实现与现有设计系统对照：

1. 返回条继续使用共享蓝色主操作，不增加新的浮层或导航层级。
2. 档案首屏仍保持“身份 → 快捷操作 → 最新上报 → 车辆视图”的既有层级。
3. 手机端继续使用两项主操作加“更多”的收敛模式，新增返回信息没有挤占动作区。
4. 轨迹页仍以地图为主画布，返回条位于页面任务区最上方。
5. 目录页仍使用相同的视图切换、指标栏、车辆列表与分页，只把工作位置写入 URL。
6. 空轨迹状态只调整语义文案和操作目标，没有改变既有空状态组件与视觉样式。

首屏文案差异是有意的：原“先选择车辆，再开始轨迹回放”在已选车辆、空时间窗场景中改为“当前时间窗没有可回放轨迹”，用于准确解释当前状态。其余关键首屏结构与现有设计保持一致，未发现实质视觉偏差。

浏览器验收

通过 Codex 内置浏览器以真实 Vite 页面和本地 API 验收数据完成交互验证：

• 桌面原生视口：1440 × 900
• 手机原生视口：390 × 844
• 桌面和手机的 documentElement.scrollWidth - clientWidth 均为 0
• 手机返回条宽度 376px，位于 390px 视口内；辅助说明的计算样式为 display: none
• 实际走通：目录第 2 页 → 车辆档案 → 轨迹 → 车辆档案 → 原目录第 2 页
• 恢复结果：搜索 粤A、视图“当前在线”、页码 2/2
• 页面日志没有应用异常；保留 Semi UI 依赖产生的既有 findDOMNode 开发警告

截图证据：

• vehicle-directory-desktop.png
• vehicle-detail-return-desktop.png
• track-vehicle-return-desktop.png
• vehicle-directory-mobile.png
• vehicle-detail-return-mobile.png
• track-vehicle-return-mobile.png

截图已通过本地图像工具按原始分辨率复核；返回层级、裁切、操作密度和移动端底部导航均符合预期。

自动化与构建证据

• 车辆上下文、共享返回条、全局监控、车辆、轨迹、历史、里程和事件：127 / 127 测试通过。
• tsc -b、Vite 生产构建、发布产物验证全部通过。
• 车辆详情关键入口产物：29,777 B，低于既有 30,000 B 门槛。
• 返回动作的 URL 组装下沉到延迟加载的 VehicleActions，没有通过提高构建阈值掩盖体积回退。