Files
persionalBrand/docs/adr/0026-brand-single-industry-template.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

46 lines
3.8 KiB
Markdown
Raw Permalink 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.
# 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](0033-brand-business-type-and-page-scheme-separation.md) 将页面方案版本升级、切换和恢复迁入独立「页面方案」页面。
- 后台的模板治理不再由内容发布页承载;当前边界以 ADR 0033 为准。
## 迁移计划
- 后端:`TemplateWorkspaceService` 守卫与 `preview` 调整;`seed` 新增 `ensureTemplateInstallation` 按品牌身份补齐台账。
- 前端:`WorkspacePage` 收敛为咨询表单与字段;`PublicationPage` 承接模板版本升级/回滚;`CapabilitiesPage`、`main.tsx` 导航与路由同步。
- 文档:更新 `apps/admin/design.md` 页面结构表。
- 验收:`pnpm check`,API 集成测试覆盖「台账缺失仍可预览」「跨行业安装被拒且身份不漂移」「删台账后同行业安装可修复」,并用真实渲染复核后台页面。