feat: establish junction region geometry baseline

This commit is contained in:
que01 committed 2026-09-11 15:27:53 +08:00
1 parent de97600fe8
commit 76f81d024a
14 files changed
+287 -11

No files matched your search

@@ -36,6 +36,16 @@ junction-structure/v1 保持前端投影,按需扩展展示字段;不在客
仅根据夹角不能证明存在导流岛或独立右转道路。已知设施使用显式来源/区域;推断对象标明推断原因,缺少通行区域或步行端点证据时不输出伪造有效设施。未知与不存在分开表达。本期不提供岛体自由编辑器,但 BoundaryGraph 可表达其排除区域与相邻通道,避免下一期推翻基础模型。
## 设施语义契约
复杂路口中的行人安全岛不是独立的固定角部多边形。它是三组过街连接之间的不可通行区域:一条进口斑马线和相邻两个角部斑马线共同限定其边界。`CrosswalkConnection` 必须连接两个有效步行边界;其内侧端点吸附到 `PedestrianIsland` 或路缘边界,不能悬空或穿过岛体。
- `PedestrianIsland`:独立的不可通行区域,有连续路缘边界,可作为分阶段过街等待空间。
- `CrosswalkConnection`:连接人行道、路缘或安全岛的过街区域;斑马线不是道路装饰层。
- `CurbBoundary`:机动车通行区与步行区域的共享边界,安全岛和斑马线都消费同一边界。
- `CurbExtension` 与 `PedestrianIsland` 分开建模;前者是人行道向车行道的扩展,后者位于机动车流之间。
- 复杂路口设施的求解顺序为:机动车区域 → 步行边界 → 三组过街连接 → 安全岛可行区域 → 端点吸附和冲突验证。
## 兼容、性能与风险
- 新管线先在显式 geometry version 下验证;旧复杂文档不能直接换默认值或静默裁剪。缺省构建应确定性;迁移报告逐约束列出可重放、需重检、失效及原因。普通路口输出回归保持不变。
@@ -1,6 +1,6 @@
# 实施计划与阶段出口
当前为 in_progress;用户已批准实施。单一任务按串行里程碑交付;每阶段必须提交证据,不能以接口有返回代替效果验收。
当前为 in_progress;任务已收敛为分阶段推进。第一个新阶段是“复杂路口区域模型”:先统一中心通行区、角部可行域和安全岛边界,再恢复设施与视觉验收。实验性固定安全岛修改已保存至 `/private/tmp/junction-island-experiment.patch`,不作为正式方案。
## 0. 契约与最小反例
@@ -0,0 +1,38 @@
# Geometry Library Evaluation
日期:2026-09-11
## 结论
首选 `polygon-clipping`(MIT)作为局部米制平面区域布尔运算库,配合项目已有的 `rbush` 空间索引。保留现有 `JunctionBuildPlan` 和 `BoundaryGraph` 作为来源拓扑与共享边界权威,不引入通用图框架替代道路来源身份。
## 候选比较
| 库 | 适合能力 | 主要问题 | 决策 |
| --- | --- | --- | --- |
| `polygon-clipping` | union/intersection/difference/xor;Polygon/MultiPolygon;适合中心区域、排除区、安全岛可行域 | 不负责道路语义、单位和拓扑来源 | 首选补充 |
| `@turf/*` | buffer、lineOffset、空间关系和地理验证;可按模块引入 | 完整包较重;经纬度计算不应成为内部几何权威 | 作为可选验证/偏移工具 |
| `JSTS` | 较完整的 GEOS/JTS 类几何算法 | 包体、API 和维护复杂度偏高 | 后备方案 |
| `clipper2-js` | 高精度平面裁切和偏移 | 当前运行时与维护兼容性需额外验证 | 暂不采用 |
| `graphlib/graphology` | 通用图遍历 | 不解决几何边界,不能替代 OSM 来源拓扑 | 不采用 |
## 目标数据流
```text
JunctionBuildPlan
-> BoundaryGraph(来源边、共享边、排除区)
-> polygon-clipping(区域 union/intersection/difference)
-> CornerFeasibleRegion
-> IslandRegion
-> CrossingRegion
-> 统一连通/自交/重叠/接缝验证
```
局部米制投影、稳定来源键、编辑约束和 GeoJSON 输出仍由项目代码负责。第三方库只接受已经投影到局部平面坐标的环,并返回经过规范化的区域结果;不得让布尔运算输出顺序决定来源身份。
## 引入前验证
- 在独立纯函数测试中验证凹形、孔洞、相切、重叠和多区域结果。
- 验证许可证、Node CommonJS、Vite 浏览器构建和包体影响。
- 先替换 `ringsOverlap` 等局部几何判断,再接入中心区域求解;不先改编辑协议或 UI。
- 如果库无法稳定保留共享边引用,则只用于可行域裁切,BoundaryGraph 仍保留边界所有权和接缝计算。