Files
persionalBrand/docs/template-registry.md
T
que01 4f0b50c7f1 fix: 收口模板契约与安全门禁
统一模板包 visual 契约并补齐完成证据;修复 release 版本一致性、管理员 token 撤销、CORS 与默认品牌配置;收敛依赖安全风险并完成全量回归验证。
2026-10-18 22:05:31 +08:00

40 lines
3.0 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.3:餐饮场景,使用 food 行业能力。
- linjing-editorial@1.0.4:林境建筑画册,可用于 doors 和 personal 组合。
- atelier-solopreneur@1.3.2:独立工坊方向,适配 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 中的全局品牌内容。
## 当前缺口
- [x] 版本导出、导入、checksum 幂等、目录发布/撤回与审计已由 template pack 和管理 API 实现;
- [x] `/admin/templates` 覆盖导入、校验、预览、发布、撤回和审计;
- [ ] 品牌安装统一锁定行业模型与精确视觉包版本;当前兼容读取及多处视觉选择状态待由一次性数据迁移收敛后删除;
- [x] 预览 fixture 与显式 bootstrap 内容分离,预览不写入品牌;
- [x] `pnpm template:compatibility` 自动检查 package、行业、平台视觉 manifest、Taro renderer 和 Admin renderer discovery;Runtime contract 及 package schema 由 `pnpm validate:templates` 校验;toolchain 产物由 `pnpm template:conformance` 验证;
- [x] atelier-solopreneur 的 manifest/package metadata 版本已统一,并由 validate:templates 阻断后续漂移;
- [ ] 每个模板仍需完成真实品牌编辑、保存重载、发布和视觉证据;双端生产构建按交付变更执行,真实微信外部上传/审核尚未证明。
新增模板时先修改模板包和契约测试,再更新生成产物;不要直接在本文追加一条“已注册”来绕过门禁。