39 lines
2.4 KiB
Markdown
39 lines
2.4 KiB
Markdown
# Vehicle incident and information preview
|
||
|
||
## Goal
|
||
|
||
在 Cesium 验证预览中，让使用者能够查看每辆巡航车辆的基础信息，并人为标记车辆事故/故障状态，直观看到该状态对车辆和路线展示的影响。
|
||
|
||
## Confirmed Facts
|
||
|
||
- 车辆是 `scripts/lib/cesium-preview.js` 创建的 Cesium Entity；当前已有车型、路线、巡航速度、
|
||
跟随、显隐与路线选择。
|
||
- 车辆模型和路线都属于 `_preview/` 验证资源，不是 area package 的下游资产契约。
|
||
- 当前不存在车辆业务资料、事故状态、碰撞检测或自动事件推演。
|
||
- 项目定位是资产生成与验证，不能将交通流/事故仿真作为本任务的范围。
|
||
|
||
## Requirements
|
||
|
||
- 每辆预览车辆必须有稳定的显示编号、车型、当前路线、设定速度和行驶状态。
|
||
- 点击场景中的车辆后，必须弹出该车辆的信息卡，展示基础信息与当前事件状态；信息卡内完成状态与说明编辑。
|
||
- 使用者必须能将选中车辆在正常、故障和事故状态之间切换，并能提供简短事件说明。
|
||
- 故障和事故是不同状态：二者均停止巡航；故障使用黄色标记，事故使用红色标记并提示路线中断。
|
||
- 故障使用车辆顶部黄色扳手标记；事故使用红色警示三角标记，并将该车辆当前路线改为红色。
|
||
- 非正常车辆必须有可见的场景标记；恢复正常后继续按既有路线巡航。
|
||
- 事故/故障仅在当前浏览器预览会话中存在；刷新或重建预览后不保留。
|
||
|
||
## Out of Scope
|
||
|
||
- 自动碰撞检测、车辆间物理碰撞、自动事故生成。
|
||
- 信号配时、交通流、调度策略或持久化事件记录。
|
||
- 向 `package/` 加入车辆、路线或事故数据。
|
||
|
||
## Acceptance Criteria
|
||
|
||
- [ ] 用户可点击任一可见车辆，弹出其基础信息、状态和事件说明；现有车辆选择控件仍可用于路线和跟随。
|
||
- [ ] 用户可标记故障或事故，并看到车辆停止、状态文本和明显的场景标记。
|
||
- [ ] 故障显示黄色扳手；事故显示红色警示三角且当前路线变红。
|
||
- [ ] 用户可恢复正常，车辆继续其现有路线；其他车辆不受影响。
|
||
- [ ] 无可用路线时，车辆信息和事故控件按既有禁用语义处理。
|
||
- [ ] 预览资产、路线与现有信号灯 runtime 继续可加载；不新增下游 package 内容。
|