Files
persionalBrand/docs/template-registry.md
T

40 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 模板注册表
本文只记录当前盘点和迁移状态,不是模板目录的第二份事实来源。模板管理、导入、校验、预览、安装、升级和验收统一由[模板管理与分发交付计划](template-management-delivery-plan.md)统筹;可复用的架构边界见 [ADR 0029](adr/0029-template-management-and-distribution.md)。
模板采用“行业模板 + 视觉模板包 + 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.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 幂等和目录发布尚未形成统一闭环;
- [ ] 独立模板管理页面尚未覆盖导入、校验、预览、发布和审计全流程;
- [ ] 行业安装和视觉包安装的持久化边界需要迁移设计;
- [ ] 预览 fixture 和可导入 bootstrap 内容需要明确分离;
- [ ] Taro renderer、Runtime contract、package schema 和 toolchain 的兼容矩阵需要落库;
- [x] atelier-solopreneur 的 manifest/package metadata 版本已统一,并由 validate:templates 阻断后续漂移;
- [ ] 每个模板仍需完成真实品牌编辑、保存重载、发布、双端构建和真实微信外部验收。
新增模板时先修改模板包和契约测试,再更新生成产物;不要直接在本文追加一条“已注册”来绕过门禁。