From b9c38b0b7b0003ced85a4fbf95be1d57824289c8 Mon Sep 17 00:00:00 2001 From: que01 Date: Thu, 17 Sep 2026 10:07:40 +0800 Subject: [PATCH] docs: scope junction exclusion routing follow-up --- .../check.jsonl | 1 + .../implement.jsonl | 1 + .../09-17-junction-exclusion-routing/prd.md | 21 +++++++++++++++ .../research.md | 14 ++++++++++ .../task.json | 26 +++++++++++++++++++ 5 files changed, 63 insertions(+) create mode 100644 .trellis/tasks/09-17-junction-exclusion-routing/check.jsonl create mode 100644 .trellis/tasks/09-17-junction-exclusion-routing/implement.jsonl create mode 100644 .trellis/tasks/09-17-junction-exclusion-routing/prd.md create mode 100644 .trellis/tasks/09-17-junction-exclusion-routing/research.md create mode 100644 .trellis/tasks/09-17-junction-exclusion-routing/task.json diff --git a/.trellis/tasks/09-17-junction-exclusion-routing/check.jsonl b/.trellis/tasks/09-17-junction-exclusion-routing/check.jsonl new file mode 100644 index 0000000..9dd3234 --- /dev/null +++ b/.trellis/tasks/09-17-junction-exclusion-routing/check.jsonl @@ -0,0 +1 @@ +{"_example": "Fill with {\"file\": \"\", \"reason\": \"\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."} diff --git a/.trellis/tasks/09-17-junction-exclusion-routing/implement.jsonl b/.trellis/tasks/09-17-junction-exclusion-routing/implement.jsonl new file mode 100644 index 0000000..9dd3234 --- /dev/null +++ b/.trellis/tasks/09-17-junction-exclusion-routing/implement.jsonl @@ -0,0 +1 @@ +{"_example": "Fill with {\"file\": \"\", \"reason\": \"\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."} diff --git a/.trellis/tasks/09-17-junction-exclusion-routing/prd.md b/.trellis/tasks/09-17-junction-exclusion-routing/prd.md new file mode 100644 index 0000000..fffb99c --- /dev/null +++ b/.trellis/tasks/09-17-junction-exclusion-routing/prd.md @@ -0,0 +1,21 @@ +# 复杂排除区绕行与多通行区求解范围研究 + +## Goal + +承接已归档父任务的区域求解遗留;先确定来源通行关系和安全可行域,不将多边形裁切等同于路径规划。 + +## Requirements + +- 审计来源通行关系、排除区与必要入口连接,区分面裁切、连通区域和车辆绕障路径。 +- 比较支持边界、失败诊断与可行方案,明确是否需要车辆尺寸及转弯半径等输入。 +- 优先完成 junction-layer-seams;本任务当前仅规划,不恢复已归档父任务。 + +## Acceptance Criteria + +- [ ] 为接缝被阻断、核心内部障碍和多个隔离通行区提供可重复反例。 +- [ ] 给出当前求解器的支持/拒绝矩阵和下一实现单元的可观察验收条件。 +- [ ] 明确需要用户决定的通行语义与安全约束,实施前完成设计和实施计划。 + +## Notes + +src/compile/junction-region-solver.js 当前是多边形 difference,不提供绕障路径规划。不能仅凭区域相连推断合法机动车转向。此前“可以直接完成”的估计过于宽泛,本专项先研究边界,不承诺任意障碍布局或车辆扫掠规划。 diff --git a/.trellis/tasks/09-17-junction-exclusion-routing/research.md b/.trellis/tasks/09-17-junction-exclusion-routing/research.md new file mode 100644 index 0000000..24b6135 --- /dev/null +++ b/.trellis/tasks/09-17-junction-exclusion-routing/research.md @@ -0,0 +1,14 @@ +# 区域求解边界初审 + +2026-09-17,只读审计;本专项仍为 planning,不在接缝专项内更换区域算法。 + +| 场景 | 当前路径 | 限制 | +| --- | --- | --- | +| 入口与排除区域相交 | junction-boundary-graph.js:99 检测相交并标记 overlaps-known-region,设施生成省略入口 | 没有重新布置入口绕障 | +| 核心内部已知安全孔洞 | buildCoreClosure 按 isHole、包含关系、入口避让发布 holes | 只能保证该结构核心面保留孔洞 | +| 障碍穿过核心边界或切断必需接口 | buildCoreClosure 返回 known-exclusion-region | 不重求连通区域 | +| 多个断开的铺装区域 | solveComplexPavementRegion 返回 disconnected | 不生成跨区连接,不等同于多通行区规划 | + +需要优先澄清的实现风险:complex-junction-surfaces.js 的 appendPavementRegion 只取各面 coordinates[0];junction-pavement-region.js 又以 polygon[0] 填掉所有合并结果孔洞。因而不能由 buildCoreClosure 的孔洞单测推断最终权威铺装保留已知排除区域。后续应先添加最终发布面的排除区反例,区分构建缝隙与已知孔洞,再考虑绕障。当前未声称运行了该最终反例,也未改产品行为。 + +建议的实施顺序:最终铺装保留排除区 → 对象级连接/拒绝契约 → 有限障碍布局的区域求解 → 需要来源与车辆约束的路径规划。不能只对凹多边形做裁切后宣称已提供合法车辆绕行。 diff --git a/.trellis/tasks/09-17-junction-exclusion-routing/task.json b/.trellis/tasks/09-17-junction-exclusion-routing/task.json new file mode 100644 index 0000000..aedddc7 --- /dev/null +++ b/.trellis/tasks/09-17-junction-exclusion-routing/task.json @@ -0,0 +1,26 @@ +{ + "id": "junction-exclusion-routing", + "name": "junction-exclusion-routing", + "title": "复杂排除区绕行与多通行区求解范围研究", + "description": "承接已归档父任务的区域求解遗留;先确定来源通行关系和安全可行域,不将多边形裁切等同于路径规划。", + "status": "planning", + "dev_type": null, + "scope": null, + "package": null, + "priority": "P2", + "creator": "dingkang", + "assignee": "dingkang", + "createdAt": "2026-09-17", + "completedAt": null, + "branch": null, + "base_branch": "main", + "worktree_path": null, + "commit": null, + "pr_url": null, + "subtasks": [], + "children": [], + "parent": null, + "relatedFiles": [], + "notes": "", + "meta": {} +} \ No newline at end of file