40 lines
2.7 KiB
Markdown
40 lines
2.7 KiB
Markdown
# 模板注册表
|
||
|
||
本文只记录当前盘点和迁移状态,不是模板目录的第二份事实来源。模板管理、导入、校验、预览、安装、升级和验收统一由[模板管理与分发交付计划](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.0:餐饮场景,使用 food 行业能力。
|
||
- linjing-editorial@1.0.0:林境建筑画册,可用于 doors 和 personal 组合。
|
||
- atelier-solopreneur:template.json 声明为 1.1.0,但 package.json 仍为 1.0.0;在版本事实收敛前不得作为可导入线上版本。
|
||
|
||
以上是仓库盘点,不表示三个包都已经通过线上导入、预览、品牌安装和微信上传验收。生成目录当前位于 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 版本漂移需要先修复;
|
||
- [ ] 每个模板仍需完成真实品牌编辑、保存重载、发布、双端构建和真实微信外部验收。
|
||
|
||
新增模板时先修改模板包和契约测试,再更新生成产物;不要直接在本文追加一条“已注册”来绕过门禁。
|