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
3.8 KiB
3.8 KiB
0026 品牌单一行业模板与后台页面职责拆分
- 状态:已采纳
- 日期:2026-10-14
背景
后台的「模板与表单设置」页面把两类目标完全不同的事情放在了一起:日常经营(咨询入口表单、高级自定义字段)与半技术的模板治理(行业模板安装、模板版本升级/回滚、视觉模板切换、模板组合预览)。结果是运营者看到的页面既像内容配置页,又像技术设置页。
同时发现一个身份漂移问题:品牌的行业模板身份写在 BrandProfile.templateKey,但模板版本台账写在 BrandTemplateInstallation。旧实现里「品牌是否已使用某行业模板」以安装记录为准,seed 只写身份、不建台账,install 又允许换到另一个行业模板。于是可能出现「品牌在跑 A 模板、台账记的是 B」,并把发布快照接到不适配的视觉模板上。
决策
1. BrandProfile.templateKey 是唯一真相,一个品牌只使用一个行业模板
getEffectiveTemplateKey优先读BrandProfile.templateKey,BrandTemplateInstallation降级为同一模板的版本台账,缺失时不再反过来改写品牌身份。install只允许为当前模板补建/修复台账;请求的行业模板与品牌身份不一致时返回 400,并说明「更换行业模板不在本版本范围内」。- 安装写入时同时落
templateKey与台账,保证身份与台账一致;已自定义视觉模板的品牌在补建台账时保留原视觉选择。 preview不再要求台账存在:台账缺失时以模板目录版本为当前版本,不报错。
2. 后台页面按「日常经营」与「模板治理」拆开
咨询表单与字段(/admin/workspace)只负责咨询入口表单与高级自定义字段,归入「日常经营」,不再承载任何模板、视觉或组合预览。- 页面方案治理归入独立的「页面方案」页面:业务类型只读展示,页面方案版本可升级、切换和恢复。页面方案是业务类型的排版变体,不是新的行业身份。
- 「内容与发布」只处理内容检查、发布、撤回、小程序发布和配置,不再承载业务类型或页面方案选择。
替代方案
- 保留单一页面并把模板部分折叠收起:仍会让运营者看到技术设置,职责没有真正分开。
- 增加第二条「模板切换」流程支持换行业:属于产品范围扩张,且与「模板是可替换的行业表达、品牌身份跨行业稳定」的既有边界冲突。
- 只在
seed里补齐台账而不加后端守卫:换行业模板仍会漂移,属于治标不治本。
后果
- 品牌身份、模板台账、发布快照三者不会再互相漂移;公开运行时始终跑品牌当前的行业模板。
- 行业模板不可在后台切换,切换到另一行业需要显式的产品与迁移方案。
- 本 ADR 采纳时移除了视觉模板切换历史/回滚和组合预览;后续由 ADR 0033 将页面方案版本升级、切换和恢复迁入独立「页面方案」页面。
- 后台的模板治理不再由内容发布页承载;当前边界以 ADR 0033 为准。
迁移计划
- 后端:
TemplateWorkspaceService守卫与preview调整;seed新增ensureTemplateInstallation按品牌身份补齐台账。 - 前端:
WorkspacePage收敛为咨询表单与字段;PublicationPage承接模板版本升级/回滚;CapabilitiesPage、main.tsx导航与路由同步。 - 文档:更新
apps/admin/design.md页面结构表。 - 验收:
pnpm check,API 集成测试覆盖「台账缺失仍可预览」「跨行业安装被拒且身份不漂移」「删台账后同行业安装可修复」,并用真实渲染复核后台页面。