docs: record preview computation contracts

This commit is contained in:
que01 committed 2026-09-14 13:52:42 +08:00
1 parent 82846cdebc
commit 3d5cc2de6b
2 files changed
+20 -1

No files matched your search

+19
View File
@@ -497,3 +497,22 @@ published pavement region and avoid island edges/interiors. Failed candidate
paths remain diagnostic/deferred movements, never fake safe curves. Current
implementation explores a bounded set of cubic control lengths; it is not a
complete motion planner and does not prove vehicle swept-envelope clearance.
## Preview computation and bundled assets
When `resolveDirectEditConstraints()` receives `selection.type === 'cluster'`,
it may omit road, node-junction, and lane-maneuver handles that the selector
would discard. It must still solve the complete document before filtering the
manifest: saved constraints outside the selected handle family can affect the
compiled geometry. The scoped result must equal the unscoped resolution with
only the published handle array filtered.
The bundled `assets/lane-icons/manifest.json` may be cached in-process using its
file modification time and size as the invalidation key. Custom manifest paths
remain uncached because they are valid live test/config inputs. Caching must not
change compiled features or manifest validation errors.
Regression requirements: compare scoped and unscoped resolution plus compiled
layers for an empty document and a document containing mixed constraint kinds;
load the bundled manifest twice and verify the cached result; run the existing
preview/API and geometry suites after changes.
@@ -60,7 +60,7 @@
- [x] 保留未参与调参的真实 OSM 用作外部验证;若仓库不具备则记录数据需求,不冒称真实泛化通过。
- [x] 生成纯效果/调试效果、几何指标、支持/拒绝情况、耗时及兼容报告;三组截图仅复核暴露的问题是否被通用机制处理。
- [ ] 用户视觉验收合理初稿与局部校正结果;技术指标通过不能替代该验收。
- [ ] 更新 spec,记录迁移和剩余能力;按当前用户提交授权执行提交,不假定授权发布或合并。
- [x] 更新 spec,记录迁移和剩余能力;按当前用户提交授权执行提交,不假定授权发布或合并。
## 验证命令