fix: 收口模板契约迁移预检

This commit is contained in:
que01 committed 2026-10-18 17:45:15 +08:00
1 parent 50b87e48de
commit 456171aa85
8 files changed
+673 -48

No files matched your search

+8 -6
View File
@@ -35,9 +35,11 @@
## 迁移计划
1. 盘点品牌行业、config 视觉键、安装行、包版本和发布快照,输出只读不一致报告。
2. 对存在唯一明确来源的品牌,迁移为每品牌唯一安装行,并绑定已发布 package version、版本与 checksum;无法唯一映射的品牌保持不变并列为阻断项。
3. 在失败即停迁移中校验一品牌一安装、精确版本引用、package key/version/checksum/行业声明及旧视觉键一致;成功后删除 config JSON 键及安装/版本表重复 renderer 列,并约束一品牌唯一安装。
4. 将 API、Admin、Runtime、发布快照、bootstrap 和构建路径切换到安装记录;缺失/损坏状态显式失败。
5. 删除默认映射、包外 sample fallback、旧格式推断和聚合字段兼容读写,补授权、成功和失败集成测试。
6. 运行 template doctor、数据库迁移、API integration、Admin production build、Taro 双端构建及完整格式/类型门禁。
1. 使用 `pnpm template:migration:audit` 盘点品牌行业、旧视觉键、安装行和包版本;该命令只读,明确报告候选版本和阻断原因。
2. 仅可用品牌或安装记录中已有的明确 package key 作为一次性迁移来源。必须恰好匹配一个已发布版本,且 manifest 自身的 package key、version、visual renderer key、行业声明和 preview fixture 一致;不得按行业名推断 package key 或按版本号排序挑选。
3. 对唯一明确的映射回填 package version id、version、checksum 和 manifest snapshot。无映射、候选未发布、多候选、声明冲突或安装缺失均失败即停,由管理员先显式解决。
4. 未被品牌安装引用的历史无效快照保留原文供审计,不因缺少新契约字段而阻断迁移;其预览/安装仍由当前 manifest 契约校验拒绝。已安装版本必须通过完整迁移前置校验。
5. 成功后删除 config JSON 键及安装/版本表重复 renderer 列,并约束一品牌唯一安装。
6. 将 API、Admin、Runtime、发布快照、bootstrap 和构建路径切换到安装记录;缺失/损坏状态显式失败。
7. 删除默认映射、包外 sample fallback、旧格式推断和聚合字段兼容读写,补授权、成功和失败集成测试。
8. 运行 template doctor、数据库迁移、API integration、Admin production build、Taro 双端构建及完整格式/类型门禁。