2.7 KiB
2.7 KiB
模板注册表
本文只记录当前盘点和迁移状态,不是模板目录的第二份事实来源。模板管理、导入、校验、预览、安装、升级和验收统一由模板管理与分发交付计划统筹;可复用的架构边界见 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.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 的兼容矩阵需要落库;
- atelier-solopreneur 的 manifest/package metadata 版本已统一,并由 validate:templates 阻断后续漂移;
- 每个模板仍需完成真实品牌编辑、保存重载、发布、双端构建和真实微信外部验收。
新增模板时先修改模板包和契约测试,再更新生成产物;不要直接在本文追加一条“已注册”来绕过门禁。