docs: Archive osmassets refactor plan
This commit is contained in:
@@ -85,7 +85,7 @@ def assemble(ring, [way_id,] scene_xmin, scene_xmax, scene_ymin, scene_ymax,
|
||||
|
||||
### 加一种新 OSM 要素
|
||||
|
||||
目标形态(`docs/refactor-plan.md`):**新增一个模块 + 注册一行,不改 `build()`**。
|
||||
目标形态:**新增一个模块 + 注册一行,不改 `build()`**。
|
||||
|
||||
1. 新建 `osmassets/<feature>.py`,写 `assemble(...)`,签名照抄上面
|
||||
2. 只 import 需要的:`from osmassets.geom import clip_polygon`、
|
||||
@@ -176,7 +176,7 @@ export_cesium.py # 优先读 material custom property
|
||||
否则新生成的 `.blend` 不会自带契约
|
||||
- `catalog.py` 仍属纯 Python 层,不能 import `bpy`;序列化发生在 `materials.py`
|
||||
- `"Office White Metal Facade"` 在四张表里都有,但 `catalog` 里**已无此材质**
|
||||
(`docs/refactor-plan.md` 记为缺陷 D1)。它只能作为旧 `.blend` 回退兼容存在,
|
||||
(历史上记为缺陷 D1)。它只能作为旧 `.blend` 回退兼容存在,
|
||||
不要迁回新契约源
|
||||
|
||||
**改材质名时**:`catalog.MATERIALS` + `catalog.ROAD_LAYERS` + 四张旧回退表全部
|
||||
|
||||
@@ -57,7 +57,7 @@ node scripts/parity.js compare control-1 control-2 # 必须全绿
|
||||
|
||||
没做这步就开始改代码,你会分不清一个差异是"重构引入的 bug"还是"本来就每次都不一样"。
|
||||
|
||||
已完成的 control 结论(`docs/refactor-plan.md`):
|
||||
已完成的 control 结论:
|
||||
|
||||
- `.blend` **结构摘要两次完全一致** ← 这是主校验信号,可信
|
||||
- `.blend` 文件 sha256 不一致
|
||||
@@ -147,7 +147,7 @@ capturedAt / durationMs / label
|
||||
|
||||
## 风险高的改动要分次提交
|
||||
|
||||
`docs/refactor-plan.md` 对风险最高的一期写着:
|
||||
要素注册表这类高风险重构必须按要素分次提交:
|
||||
|
||||
> 逐要素分次提交,每次单独跑 parity。
|
||||
|
||||
@@ -155,9 +155,9 @@ capturedAt / durationMs / label
|
||||
|
||||
---
|
||||
|
||||
## 当前重构进度(`docs/refactor-plan.md`)
|
||||
## 当前重构进度
|
||||
|
||||
那份计划是**临时工作文档**,P3 收尾后会并入 changelog 并删除。当前状态:
|
||||
临时施工计划已删除;长期状态以本指南和 `docs/changelog.md` 为准:
|
||||
|
||||
| 期 | 内容 | 状态 |
|
||||
|---|---|---|
|
||||
|
||||
Reference in New Issue
Block a user