fix: 统一模板包版本与校验
This commit is contained in:
1 parent
1918dae36b
commit
b6713ea34c
4 files changed
+40
-15
No files matched your search
@@ -67,16 +67,16 @@
|
||||
|
||||
## 3. 当前状态和目标状态
|
||||
|
||||
| 领域 | 当前状态 | 目标状态 | 进入目标状态的证据 |
|
||||
| ------------ | --------------------------------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------- |
|
||||
| 模板发现 | packages/config 有生成注册表,文档注册表仍是手工清单 | 所有可用版本由可校验包 manifest 发现,生成注册表只作为构建产物 | 包发现测试、目录接口测试、无手工重复定义 |
|
||||
| 版本 | 模板 key、manifest version、package metadata 可能漂移 | key + version + checksum 唯一且不可变 | 导出 checksum、重复导入、冲突导入测试 |
|
||||
| 行业与视觉 | 行业安装和视觉选择已有部分能力,但没有完整版本化目录 | 行业兼容性、视觉包版本、renderer contract 一起校验 | 组合矩阵、安装快照和跨行业测试 |
|
||||
| 示例内容 | 包内 sample 可用于部分预览和显式导入 | preview fixture、bootstrap 内容、品牌真实数据严格分离 | 预览无品牌写入、显式导入审计、缺失值规则测试 |
|
||||
| 模板管理页面 | 现有工作台可以选择部分已注册模板 | 独立 /admin/templates 管理导入、校验、预览、发布和版本 | 页面状态测试、API 权限测试、错误重试测试 |
|
||||
| 安装和升级 | BrandTemplateInstallation 主要承担行业安装 | 行业安装、视觉包安装、样例导入、升级计划和发布快照各有边界 | schema 迁移、旧数据回填、升级/回滚 integration test |
|
||||
| 构建发布 | 构建、上传和发布曾共用状态,容易死锁或误报 | build、upload、review、publish 分层,attempt/lease/产物隔离 | 并发、重启、超时、错误收敛、真实参数产物测试 |
|
||||
| 版本事实 | atelier-solopreneur 的 manifest 为 1.1.0,package metadata 仍为 1.0.0 | 包内版本字段和导出元数据在导出前强一致 | 第一阶段盘点修复并添加阻断测试 |
|
||||
| 领域 | 当前状态 | 目标状态 | 进入目标状态的证据 |
|
||||
| ------------ | ------------------------------------------------------------------ | -------------------------------------------------------------- | --------------------------------------------------- |
|
||||
| 模板发现 | packages/config 有生成注册表,文档注册表仍是手工清单 | 所有可用版本由可校验包 manifest 发现,生成注册表只作为构建产物 | 包发现测试、目录接口测试、无手工重复定义 |
|
||||
| 版本 | 当前模板包 metadata 已与 manifest 对齐,导入 checksum 闭环尚未实现 | key + version + checksum 唯一且不可变 | 导出 checksum、重复导入、冲突导入测试 |
|
||||
| 行业与视觉 | 行业安装和视觉选择已有部分能力,但没有完整版本化目录 | 行业兼容性、视觉包版本、renderer contract 一起校验 | 组合矩阵、安装快照和跨行业测试 |
|
||||
| 示例内容 | 包内 sample 可用于部分预览和显式导入 | preview fixture、bootstrap 内容、品牌真实数据严格分离 | 预览无品牌写入、显式导入审计、缺失值规则测试 |
|
||||
| 模板管理页面 | 现有工作台可以选择部分已注册模板 | 独立 /admin/templates 管理导入、校验、预览、发布和版本 | 页面状态测试、API 权限测试、错误重试测试 |
|
||||
| 安装和升级 | BrandTemplateInstallation 主要承担行业安装 | 行业安装、视觉包安装、样例导入、升级计划和发布快照各有边界 | schema 迁移、旧数据回填、升级/回滚 integration test |
|
||||
| 构建发布 | 构建、上传和发布曾共用状态,容易死锁或误报 | build、upload、review、publish 分层,attempt/lease/产物隔离 | 并发、重启、超时、错误收敛、真实参数产物测试 |
|
||||
| 版本事实 | atelier-solopreneur 的 manifest 和 package metadata 已统一为 1.1.0 | 包内版本字段和导出元数据在导出前强一致 | validate:templates 的版本一致性检查 |
|
||||
|
||||
当前存在的 Runtime Workspace、模板 manifest、样例导入和 Taro 构建能力是基础组件,不代表本任务已完成。实施进度必须引用本文的阶段和证据。
|
||||
|
||||
@@ -340,14 +340,22 @@ Taro 交付必须额外验证:
|
||||
### Phase 0:任务固化和现状盘点
|
||||
|
||||
- [x] 建立本文档和 ADR 0029,并将其设为唯一任务入口;
|
||||
- [ ] 盘点所有模板包的 manifest/package metadata、renderer、fixture、资源和版本差异;
|
||||
- [x] 盘点所有模板包的 manifest/package metadata、renderer、fixture、资源和版本差异;
|
||||
- [ ] 盘点现有行业安装、视觉选择、发布快照和 Admin 页面调用关系;
|
||||
- [ ] 为历史事故建立可执行回归清单;
|
||||
- [ ] 解决 atelier-solopreneur manifest/package metadata 版本漂移;
|
||||
- [x] 解决 atelier-solopreneur manifest/package metadata 版本漂移;
|
||||
- [ ] 明确平台模板管理员角色和线上隔离环境。
|
||||
|
||||
退出门禁:模板目录、版本事实、现有数据模型和已知失败路径有可审阅清单;没有“默认值能猜出来”的隐含项。
|
||||
|
||||
Phase 0 执行记录(2026-10-16):
|
||||
|
||||
- 已将三个仓库模板的 package metadata 与 manifest 对照,并修复 atelier-solopreneur 的 1.0.0/1.1.0 漂移;
|
||||
- validate:templates 新增 package name 和 version 一致性阻断;
|
||||
- template-doctor 生成 after 报告:三个模板 staticStatus 均为 pass,completionStatus 保持 unverified,112 个 review 均有登记;
|
||||
- template:check、template-doctor 测试和 typecheck 通过;完整证据保存在本次工作区的 Phase 0 运行记录中;
|
||||
- 平台模板管理员角色、线上隔离环境和行业安装调用盘点仍待完成。
|
||||
|
||||
### Phase 1:包契约和确定性导出
|
||||
|
||||
- [ ] 扩展 packages/template-contract,定义 package schema、rendererRef、preview/bootstrap、资源和兼容矩阵;
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
|
||||
- acheng-campus-food@1.0.0:餐饮场景,使用 food 行业能力。
|
||||
- linjing-editorial@1.0.0:林境建筑画册,可用于 doors 和 personal 组合。
|
||||
- atelier-solopreneur:template.json 声明为 1.1.0,但 package.json 仍为 1.0.0;在版本事实收敛前不得作为可导入线上版本。
|
||||
- atelier-solopreneur@1.1.0:独立工坊方向,适配 personal 行业。
|
||||
|
||||
以上是仓库盘点,不表示三个包都已经通过线上导入、预览、品牌安装和微信上传验收。生成目录当前位于 packages/config/src/generated-template-packages.ts,后续必须由导出和 conformance 流程生成并校验。
|
||||
|
||||
@@ -33,7 +33,7 @@
|
||||
- [ ] 行业安装和视觉包安装的持久化边界需要迁移设计;
|
||||
- [ ] 预览 fixture 和可导入 bootstrap 内容需要明确分离;
|
||||
- [ ] Taro renderer、Runtime contract、package schema 和 toolchain 的兼容矩阵需要落库;
|
||||
- [ ] atelier-solopreneur 的 manifest/package metadata 版本漂移需要先修复;
|
||||
- [x] atelier-solopreneur 的 manifest/package metadata 版本已统一,并由 validate:templates 阻断后续漂移;
|
||||
- [ ] 每个模板仍需完成真实品牌编辑、保存重载、发布、双端构建和真实微信外部验收。
|
||||
|
||||
新增模板时先修改模板包和契约测试,再更新生成产物;不要直接在本文追加一条“已注册”来绕过门禁。
|
||||
Reference in new issue
Block a user