Files
road-compiler/.trellis/tasks/09-08-junction-reference-fidelity/prd.md
T

57 lines
6.0 KiB
Markdown

# 复杂路口通用构建:结构约束与连续边界
## 目标与价值
让复杂路口由可解释、可组合、可局部校正的结构生成连续道路几何。不同进口数量、方向、宽度和分隔方式应自然得到不同形态,而不是依靠针对具体路口的模板补丁。用户可从 OSM 得到合理初稿,在数据不足时用有限的结构/边界编辑修正,并可靠地预览、撤销、保存和重建。
“相对理想”的交付定义:支持范围内结构正确、必要接缝连续、编辑真实有效、无依据设施不被伪造、失败可定位;不是从不完整 OSM 自动还原卫星图的全部细节。
## 已确认背景
- 用户提供三组真实/生成截图以暴露问题,明确反对专门适配这三个样本。图片保存在 references/,仅作定性观察;尚未配准,遮挡处和尺寸不是事实输入。
- 现有编辑已覆盖复杂车行道宽度、收口、角部圆角、过街退让、停止线偏移;继续复用编辑与存储闭环。
- 当前构建仍分别生成中心包络、车行道矩形、圆角和角部设施。问题证据与代码入口见 research/current-state.md。
- 用户已要求暂缓导流岛编辑;本阶段不以实现岛体编辑为完成条件,但通用结构不能把岛体误当作普通角部填充。
## 范围与要求
R1 通用结构:显式表达外部车行道、进出方向、接入断面、相邻边界、通行区域、已知排除区域及必要连接。道路臂是组合视图,不因方向近似便抹掉分隔车行道、辅路或独立通道的差异。分类标签用于说明,不控制是否采用同一矩形模板。
R2 连续构建:进口、中心、路缘和过渡以同一有效几何计划为依据。外部道路与进口共享接缝;进口与核心的必要连接可验证。支持不等宽、非正交、非对称和错位接入,调整局部参数不得制造断面或侵占已知排除区域。
R3 有限校正:支持选定车行道的接入位置、方向、左右边界及过渡长度校正;保留角部控制。道路远端锚定,改动通过过渡传播;控件明确展示作用对象。源拓扑有歧义时允许显式纠正道路臂归组,不能靠改几何角度隐式改变身份。每种控件必须贯通求解、图形、保存再编译后才开放。
R4 数据诚实:每个推断保留来源和原因;缺失的岛体、独立右转或过街连接不能被假定存在。已知但暂不支持的复杂结构应给对象级诊断,不能悄悄简化成正确外观。现有设施必须消费有效道路边界;无支撑的自动角部岛体/小斑马线应可识别并停止伪生成,同时报告原因。
R5 兼容与交互:保留稳定来源身份、普通路口行为及编辑文档的可读性。输入与拖拽共用会话、预览、撤销、保存协议;慢请求持续显示 pending,旧响应不能覆盖新编辑;无效参数保留最后有效几何并显示原因。
## 首期支持边界
- 同层平面交叉:3~6 个外部道路臂,含单向/双向及分隔车行道组合、T/斜交/十字/偏置/不等宽进口。
- 已知分隔空间作为区域约束保留;已识别独立通道不被错误吞并。复杂渠化结构若不能安全构建,明确标记局部不支持。
- 不承诺任意路网完全自动建模,不涉及立交、环岛专用设计、交通配时优化、卫星图自动识别、完整车道级交通仿真。
- 导流岛自由编辑、独立右转通道创建、全套过街设施新编辑器作为后续阶段;本期仅完成结构预留、现有设施联动与错误自动生成治理。
## 验收标准
| ID | 可观察结果与验证 | 对应需求 |
| --- | --- | --- |
| A1 | 单一构建路径覆盖上述 3~6 臂组合;不得以图片编号、OSM ID、地名或固定坐标选分支 | R1、R2 |
| A2 | 同一输入反复编译确定性一致;输入顺序重排不改变来源身份;平移/旋转后的拓扑和相对几何等价;调整一侧方向/宽度能连续响应 | R1、R2 |
| A3 | 局部米制坐标下共享接缝端点偏差 ≤1 cm;环闭合、面积为正且无自交;必要铺装区域连通;已知排除区域不被侵入。逐项报告,不能仅靠截图或 GeoJSON 有变化通过 | R2 |
| A4 | 至少两类不同结构验证接入位置、方向、左右边界、过渡长度的输入/拖拽、撤销/重做、重置、保存/重编译/刷新;目标区域变化且远端锚点保持;真实拓扑改变时旧约束明确重检/失效 | R3、R5 |
| A5 | 每项参数边界可接受且有几何效果;超过边界返回明确诊断。旧文档超出新可行域时不静默截断;歧义归组可解释并可纠正 | R3、R5 |
| A6 | 现有斑马线位于实际车行道范围;已知步行连接可追溯;未知连接标记不确定。无依据的孤立角部设施不作为有效结果输出 | R4 |
| A7 | 预览与正式编译对同文档输出一致;预览不写盘;保存失败/409 不覆盖文档;跨路口、连续编辑和慢响应不串状态 | R5 |
| A8 | 合成组合测试之外,用未参与调参的真实 OSM 验证;三张图仅为定性复核之一。纯效果与调试效果并列提供,用户确认整体达到合理初稿且可局部修正 | 全部 |
A3 的 1 cm 是内部拼接精度,不代表影像测绘精度。视觉相似度不设置虚假的百分比分数。真实图与源数据无法对应时,记录缺失信息,不猜测完成 A8。
## 交付物
通用结构/几何契约、构建实现、可用校正界面、兼容策略、结构组合与几何不变量测试、真实数据验证报告、前后纯效果/调试效果对照、遗留问题列表。
## 待验证技术问题
这些问题由实施阶段证据解决,不要求用户猜实现:现有 polygon 运算是否足以完成区域验证;车道线/步行带全部裁切调用是否统一;现有 OSM 数据能支持哪些歧义归组纠正;校正与旧半径/收口约束的兼容边界。若答案导致缩减上述支持范围,须修订规划后再实施该缩减。