diff --git a/docs/template-management-delivery-plan.md b/docs/template-management-delivery-plan.md index 28b4f04..c89ba4a 100644 --- a/docs/template-management-delivery-plan.md +++ b/docs/template-management-delivery-plan.md @@ -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、资源和兼容矩阵; diff --git a/docs/template-registry.md b/docs/template-registry.md index 13cfb57..eff1f34 100644 --- a/docs/template-registry.md +++ b/docs/template-registry.md @@ -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 阻断后续漂移; - [ ] 每个模板仍需完成真实品牌编辑、保存重载、发布、双端构建和真实微信外部验收。 新增模板时先修改模板包和契约测试,再更新生成产物;不要直接在本文追加一条“已注册”来绕过门禁。 diff --git a/packages/template-atelier-solopreneur/package.json b/packages/template-atelier-solopreneur/package.json index b4128d3..d3c12d3 100644 --- a/packages/template-atelier-solopreneur/package.json +++ b/packages/template-atelier-solopreneur/package.json @@ -1,6 +1,6 @@ { "name": "@personal-brand/template-atelier-solopreneur", - "version": "1.0.0", + "version": "1.1.0", "private": true, "type": "module", "files": [ diff --git a/scripts/validate-template-packages.cjs b/scripts/validate-template-packages.cjs index e3f2cbc..14766f0 100644 --- a/scripts/validate-template-packages.cjs +++ b/scripts/validate-template-packages.cjs @@ -28,10 +28,27 @@ async function main() { errors.push(`${entry.name}: invalid template.json (${error.message})`); continue; } + let packageJson; + try { + packageJson = JSON.parse(fs.readFileSync(path.join(packageDir, "package.json"), "utf8")); + } catch (error) { + errors.push(entry.name + ": invalid package.json (" + error.message + ")"); + continue; + } for (const error of validateTemplatePackageManifest(manifest)) errors.push(`${entry.name}: ${error}`); if (![entry.name, entry.name.replace(/^template-/, "")].includes(manifest.packageKey)) errors.push(`${entry.name}: packageKey must match directory name or template key`); + if (packageJson.name !== "@personal-brand/template-" + manifest.packageKey) + errors.push(entry.name + ": package name must match manifest packageKey"); + if (packageJson.version !== manifest.version) + errors.push( + entry.name + + ": package version " + + packageJson.version + + " != manifest " + + manifest.version, + ); for (const page of manifest.pages || []) { if (!fs.existsSync(path.join(packageDir, "miniapp", page + ".js"))) errors.push(`${entry.name}: declared page is missing: ${page}`);