From 8b84166e6f07d604eb90f0f218c755e84ef06b06 Mon Sep 17 00:00:00 2001 From: que01 Date: Mon, 31 Aug 2026 18:02:27 +0800 Subject: [PATCH] chore(task): record lane-maneuver delivery and the UI prerequisite MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit All seven criteria pass against a live area. Notes what a UI would need first: turn arrows group by lane plus maneuver, a two-field key, where crosswalks and stop lines group by a single property — so the element registry's groupProperty has to become composable before arrows can join it. Co-Authored-By: Claude Opus 5 (1M context) --- .../tasks/08-31-lane-maneuver-override/prd.md | 31 ++++++++++++++----- 1 file changed, 24 insertions(+), 7 deletions(-) diff --git a/.trellis/tasks/08-31-lane-maneuver-override/prd.md b/.trellis/tasks/08-31-lane-maneuver-override/prd.md index 2d90311..d019301 100644 --- a/.trellis/tasks/08-31-lane-maneuver-override/prd.md +++ b/.trellis/tasks/08-31-lane-maneuver-override/prd.md @@ -51,13 +51,13 @@ v1 override 里已有覆盖 OSM 派生值的先例:`road` kind 覆盖 `laneCou ## 验收标准 -- [ ] 对一条 OSM 已标 `turn:lanes` 的车道施加覆盖,编译输出的 `maneuver` 变为覆盖值。 -- [ ] 对一条 OSM **未标**的车道施加覆盖,输出**新增**该车道的箭头。 -- [ ] `maneuver: ''` 使该车道不再输出箭头。 -- [ ] 非法 `maneuver`(如 `'u-turn'`)被拒绝并报错,不静默降级。 -- [ ] 未知 `laneId` 按既有 stale 机制处理,与 `lane-connection` 行为一致。 -- [ ] 空覆盖集的编译输出与改动前字节一致(fixture 不变)。 -- [ ] `npm run format:check`、`npm run test`、`npm run test:client`、`npm run test:client:unit`、`npm run build` 通过。 +- [x] 对一条 OSM 已标 `turn:lanes` 的车道施加覆盖,编译输出的 `maneuver` 变为覆盖值。 +- [x] 对一条 OSM **未标**的车道施加覆盖,输出**新增**该车道的箭头。 +- [x] `maneuver: ''` 使该车道不再输出箭头。 +- [x] 非法 `maneuver`(如 `'u-turn'`)被拒绝并报错,不静默降级。 +- [x] 未知 `laneId` 按既有 stale 机制处理,与 `lane-connection` 行为一致。 +- [x] 空覆盖集的编译输出与改动前字节一致(fixture 不变)。 +- [x] `npm run format:check`、`npm run test`、`npm run test:client`、`npm run test:client:unit`、`npm run build` 通过。 ## 风险与门槛 @@ -67,3 +67,20 @@ v1 override 里已有覆盖 OSM 派生值的先例:`road` kind 覆盖 `laneCou 由既有 stale 机制兜底,本任务不新增重定位逻辑。 - `normalizeManeuver` 对未知取值会原样返回拼接串(`supported.get(...) || parts.join(';')`), 所以校验必须在 override 层做,不能指望它兜底。 + +## 交付状态(2026-08-31) + +编译器与 override 合同**已完成**,7 条验收标准全部通过,实测于 +`nantaizihu-9PTsZg`(108 个导向箭头 / 28 条车道有箭头)。 + +| 场景 | 结果 | +| --- | --- | +| 覆盖已标注车道 | `through;left;right` → `left` | +| 给未标注车道新增 | 新增 3 个 part | +| `maneuver: ''` 移除 | 0 个 | +| 空覆盖集 | 与基线字节一致,fixture 未变 | + +**客户端 UI 按 PRD 明确不做。** 现在只能通过 override 文件或 API 施加。 +接 UI 时需要的前置:导向箭头的分组键是 `lane_id + maneuver`(实测 108 个 → 28 组, +每组 3 或 5 个 part),与斑马线的 `crossing_node_id` 不同形态, +`element.ts` 的注册表需要扩展 `groupProperty` 为可组合的形式。