Files
persionalBrand/docs/adr/0009-visual-template-compatibility.md
que01 0d9f4a7d6f
CI / Static checks (push) Has been cancelled
CI / Production build (push) Has been cancelled
CI / API integration (push) Has been cancelled
CI / Taro builds (acheng-campus-food) (push) Has been cancelled
CI / Taro builds (atelier-solopreneur) (push) Has been cancelled
CI / Taro builds (linjing-editorial) (push) Has been cancelled
CI / Browser regression (push) Has been cancelled
refactor: 拆分品牌业务类型与页面方案
2026-10-20 17:04:30 +08:00

1.5 KiB

ADR 0009:视觉模板兼容性由 manifest 声明

Context

行业模板负责业务表达,视觉模板负责页面结构与视觉呈现。同一行业会拥有多套视觉模板,但并非每套模板都具备对应的页面变体、资源槽位和能力依赖。此前后台无条件展示全部视觉模板,API 也允许任意行业与视觉组合,无法渲染的组合只能依赖运行时兜底。

Decision

在视觉模板 definition 与 manifest 中增加 supportedIndustryTemplates。目录、组合预览和实际切换均通过共享 isVisualTemplateCompatible 校验。当前林境模板只支持 doors;极简模板支持 personal、food、doors。

Alternatives

  • 在 Admin 前端写行业判断:拒绝,无法约束其他客户端和 API 调用。
  • 在 Controller 中写 if (templateKey === ...):拒绝,新增模板仍需修改业务代码。
  • 所有组合都允许并在 Miniapp 运行时降级:拒绝,会把模板设计缺口推迟到用户验收阶段。

Consequences

  • 新增视觉模板时必须声明支持的行业模板,后台会自动过滤,API 会自动校验。
  • 兼容关系是模板包元数据的一部分,可随版本快照记录。
  • 后续若出现更细粒度的能力差异,可在 manifest 增加槽位或 capability 约束,而无需回到行业分支。

Migration

  • 现有两个视觉模板已补齐兼容声明。
  • 现有品牌配置无需迁移;当前不兼容配置会在下一次保存时被拒绝。