1.5 KiB
1.5 KiB
ADR 0009:视觉模板兼容性由 manifest 声明
Context
行业模板负责业务表达,视觉模板负责页面结构与视觉呈现。同一行业会拥有多套视觉模板,但并非每套模板都具备对应的页面变体、资源槽位和能力依赖。此前后台无条件展示全部视觉模板,API 也允许任意行业与视觉组合,无法渲染的组合只能依赖运行时兜底。
Decision
在视觉模板 definition 与 manifest 中增加 supportedIndustryTemplates。目录、组合预览和实际切换均通过共享 isVisualTemplateCompatible 校验。当前林境模板支持 personal、doors;极简模板支持 personal、food、doors。
Alternatives
- 在 Admin 前端写行业判断:拒绝,无法约束其他客户端和 API 调用。
- 在 Controller 中写
if (templateKey === ...):拒绝,新增模板仍需修改业务代码。 - 所有组合都允许并在 Miniapp 运行时降级:拒绝,会把模板设计缺口推迟到用户验收阶段。
Consequences
- 新增视觉模板时必须声明支持的行业模板,后台会自动过滤,API 会自动校验。
- 兼容关系是模板包元数据的一部分,可随版本快照记录。
- 后续若出现更细粒度的能力差异,可在 manifest 增加槽位或 capability 约束,而无需回到行业分支。
Migration
- 现有两个视觉模板已补齐兼容声明。
- 现有品牌配置无需迁移;当前不兼容配置会在下一次保存时被拒绝。