Files
persionalBrand/docs/template-registry.md
T

3.0 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.2:餐饮场景,使用 food 行业能力。
  • linjing-editorial@1.0.4:林境建筑画册,可用于 doors 和 personal 组合。
  • atelier-solopreneur@1.3.1:独立工坊方向,适配 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 幂等、目录发布/撤回与审计已由 template pack 和管理 API 实现;
  • /admin/templates 覆盖导入、校验、预览、发布、撤回和审计;
  • 行业安装与视觉包精确版本通过兼容读取和不可变版本台账关联;新安装保存 package version/checksum;
  • 预览 fixture 与显式 bootstrap 内容分离,预览不写入品牌;
  • pnpm template:compatibility 自动检查 package、行业、平台视觉 manifest、Taro renderer 和 Admin renderer discovery;Runtime contract 及 package schema 由 pnpm validate:templates 校验;toolchain 产物由 pnpm template:conformance 验证;
  • atelier-solopreneur 的 manifest/package metadata 版本已统一,并由 validate:templates 阻断后续漂移;
  • 每个模板仍需完成真实品牌编辑、保存重载、发布和视觉证据;双端生产构建按交付变更执行,真实微信外部上传/审核尚未证明。

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