Files
persionalBrand/docs/template-registry.md
T

2.7 KiB
Raw Blame History

模板注册表

本文只记录当前盘点和迁移状态,不是模板目录的第二份事实来源。模板管理、导入、校验、预览、安装、升级和验收统一由模板管理与分发交付计划统筹;可复用的架构边界见 ADR 0029。

模板采用“行业模板 + 视觉模板包 + Capability”组合,不为每个行业复制一套小程序代码。最终目录必须由可校验 package manifest 发现,手工修改本文不能让模板在线可用。

当前盘点

行业模板

  • personal@1.0.0:个人品牌基线。
  • food@1.0.0:餐饮业务表达示例。
  • doors@1.0.0:门窗业务表达示例。

仓库内视觉模板包

  • acheng-campus-food@1.0.1:餐饮场景,使用 food 行业能力。
  • linjing-editorial@1.0.3:林境建筑画册,可用于 doors 和 personal 组合。
  • atelier-solopreneur@1.3.0:独立工坊方向,适配 personal 行业。

以上是仓库盘点,不表示三个包都已经通过线上导入、预览、品牌安装和微信上传验收。生成目录当前位于 packages/config/src/generated-template-packages.ts,后续必须由导出和 conformance 流程生成并校验。

组合规则

行业模板决定字段、Offering schema、表单用途和能力依赖;视觉模板包决定页面模块、变体、theme token、资源槽位、数据槽位和 Admin binding;Capability 决定可复用业务能力。安装结果必须保存行业和视觉包的精确版本、checksum 与配置快照,升级只能显式执行并提供差异预览。

预览使用包内 previewFixture,不写入品牌。起始内容使用显式 bootstrap import,来源记录必须包含 package key、版本和 checksum。模板包的样例内容不能成为 Prisma seed 中的全局品牌内容。

当前缺口

  • 版本导出、线上导入、checksum 幂等和目录发布尚未形成统一闭环;
  • 独立模板管理页面尚未覆盖导入、校验、预览、发布和审计全流程;
  • 行业安装和视觉包安装的持久化边界需要迁移设计;
  • 预览 fixture 和可导入 bootstrap 内容需要明确分离;
  • Taro renderer、Runtime contract、package schema 和 toolchain 的兼容矩阵需要落库;
  • atelier-solopreneur 的 manifest/package metadata 版本已统一,并由 validate:templates 阻断后续漂移;
  • 每个模板仍需完成真实品牌编辑、保存重载、发布、双端构建和真实微信外部验收。

新增模板时先修改模板包和契约测试,再更新生成产物;不要直接在本文追加一条“已注册”来绕过门禁。