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
27 lines
1.5 KiB
Markdown
27 lines
1.5 KiB
Markdown
# 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
|
|
|
|
- 现有两个视觉模板已补齐兼容声明。
|
|
- 现有品牌配置无需迁移;当前不兼容配置会在下一次保存时被拒绝。
|