45 lines
2.6 KiB
Markdown
45 lines
2.6 KiB
Markdown
# Cesium 路口信号灯可视化
|
||
|
||
## Goal
|
||
|
||
在 Cesium 预览中加入可直接观察的路口交通信号灯，使已完成的道路、停止线、斑马线、
|
||
转向箭头和车辆巡航有清晰的交通控制参照。车辆应在对应停止线前遵守同一套相位，并在
|
||
绿灯放行后继续巡航。
|
||
|
||
## Confirmed Facts
|
||
|
||
- `scripts/lib/cesium-preview.js` 目前只加载场景资产、巡航路线与车辆；没有信号灯图层、
|
||
模型或相位状态。
|
||
- 路线 JSON 包含连续的左、右、直转向曲线，但没有路口 ID 或信号相位字段。
|
||
- 现有停止线、斑马线和转向箭头已由区域构建确认，且用户要求暂不触及 QGIS 的人工修补
|
||
边界、道路生成与既有连续路线逻辑。
|
||
- Cesium 预览是验证层；改动它不应改变主 GLB、Blender 导出或 OSM/QGIS 产物。
|
||
|
||
## Requirements
|
||
|
||
- 在道路进口侧、停止线附近呈现简洁而可辨识的交通信号灯，并在不遮挡车道标线的前提下
|
||
面向来车方向。
|
||
- 红、黄、绿灯应有明确的点亮状态和周期性相位切换，使静态截图与实时预览都能看出其作用。
|
||
- 信号灯应能独立显示/隐藏，遵循现有 Cesium 控件的克制设计语言。
|
||
- 车辆接近已匹配的停止线时，红灯和黄灯必须停车，绿灯继续通行；相位切换后应自然恢复
|
||
移动，不得瞬移到路口另一侧。
|
||
- 等待逻辑只模拟单车对信号的响应，不做车辆间跟车距离、排队或碰撞避让。
|
||
- 首版以主要路口的程序化示意灯覆盖为准：从已生成的停止线和路口面推导进口，缺少可靠
|
||
几何锚点时跳过。它不宣称复刻 OSM 中逐节点标注的真实信号设施。
|
||
|
||
## Acceptance Criteria
|
||
|
||
- [ ] 重建目标区域的 preview 后，Cesium 中可见至少一组位于路口进口侧的信号灯，位置与停止线/
|
||
斑马线关系清楚，且不会漂浮在道路中央或遮挡车道箭头。
|
||
- [ ] 灯组以可见状态呈现红、黄、绿的相位切换；未点亮灯珠明显较暗。
|
||
- [ ] 页面提供独立的 Signals 显示开关，关闭后不影响场景、路线与车辆。
|
||
- [ ] 匹配到信号停止线的巡航车辆会在红/黄灯时停在线前，绿灯后连续通过；没有可靠匹配的
|
||
路线保持原有循环巡航，不因信号锚点缺失而卡住。
|
||
- [ ] 不修改 QGIS 工程、道路/标线生成或既有路线 JSON 的基本契约。
|
||
|
||
## Notes
|
||
|
||
- Keep `prd.md` focused on requirements, constraints, and acceptance criteria.
|
||
- Lightweight tasks can remain PRD-only.
|
||
- For complex tasks, add `design.md` for technical design and `implement.md` for execution planning before `task.py start`.
|