refactor: 拆分品牌业务类型与页面方案
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
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
This commit is contained in:
1 parent
f02e2cafbb
commit
0d9f4a7d6f
86 files changed
+4111
-1543
No files matched your search
@@ -6,7 +6,7 @@
|
||||
|
||||
## Decision
|
||||
|
||||
在视觉模板 definition 与 manifest 中增加 `supportedIndustryTemplates`。目录、组合预览和实际切换均通过共享 `isVisualTemplateCompatible` 校验。当前林境模板支持 `personal`、`doors`;极简模板支持 `personal`、`food`、`doors`。
|
||||
在视觉模板 definition 与 manifest 中增加 `supportedIndustryTemplates`。目录、组合预览和实际切换均通过共享 `isVisualTemplateCompatible` 校验。当前林境模板只支持 `doors`;极简模板支持 `personal`、`food`、`doors`。
|
||||
|
||||
## Alternatives
|
||||
|
||||
|
||||
@@ -21,7 +21,8 @@
|
||||
### 2. 后台页面按「日常经营」与「模板治理」拆开
|
||||
|
||||
- `咨询表单与字段`(`/admin/workspace`)只负责咨询入口表单与高级自定义字段,归入「日常经营」,不再承载任何模板、视觉或组合预览。
|
||||
- 模板治理归入「配置与发布 → 内容发布」的「选择表达方式」:行业模板只读展示、视觉模板选择、模板版本升级与回滚。视觉模板是行业模板的排版变体,不是新的行业身份。
|
||||
- 页面方案治理归入独立的「页面方案」页面:业务类型只读展示,页面方案版本可升级、切换和恢复。页面方案是业务类型的排版变体,不是新的行业身份。
|
||||
- 「内容与发布」只处理内容检查、发布、撤回、小程序发布和配置,不再承载业务类型或页面方案选择。
|
||||
|
||||
## 替代方案
|
||||
|
||||
@@ -33,8 +34,8 @@
|
||||
|
||||
- 品牌身份、模板台账、发布快照三者不会再互相漂移;公开运行时始终跑品牌当前的行业模板。
|
||||
- 行业模板不可在后台切换,切换到另一行业需要显式的产品与迁移方案。
|
||||
- 视觉模板切换历史/回滚、模板组合预览从 UI 中移除。当前每个行业实际只适配一个视觉模板,这两块属于不可达的死 UI。
|
||||
- 后台的模板治理不再是 owner 专属的高深设置,而是和发布放在同一处。
|
||||
- 本 ADR 采纳时移除了视觉模板切换历史/回滚和组合预览;后续由 [ADR 0033](0033-brand-business-type-and-page-scheme-separation.md) 将页面方案版本升级、切换和恢复迁入独立「页面方案」页面。
|
||||
- 后台的模板治理不再由内容发布页承载;当前边界以 ADR 0033 为准。
|
||||
|
||||
## 迁移计划
|
||||
|
||||
|
||||
@@ -0,0 +1,54 @@
|
||||
# 0033 品牌业务类型与页面方案分离
|
||||
|
||||
- 状态:已采纳
|
||||
- 日期:2026-10-20
|
||||
|
||||
## Context
|
||||
|
||||
品牌创建、页面方案选择和内容发布此前共用「行业模板」「视觉模板」「选择表达方式」等内部概念。运营者无法判断哪个选择决定字段与能力,哪个选择只影响页面结构和视觉,也容易把页面方案切换误解为业务类型切换。林境画册还同时出现在 `personal` 与 `doors` 兼容矩阵中,导致个人品牌模板与门窗模板的身份边界失效。
|
||||
|
||||
## Decision
|
||||
|
||||
1. **业务类型是品牌身份**
|
||||
- 业务类型决定字段、能力、业务提供项 schema 和咨询表单语义。
|
||||
- 业务类型在创建品牌时确定,创建后不可修改。
|
||||
- 创建品牌必须显式选择业务类型和一个与它兼容的已发布页面方案。
|
||||
|
||||
2. **页面方案是结构和视觉版本**
|
||||
- 页面方案决定页面清单、模块结构、视觉资源槽位和版本。
|
||||
- 页面方案可以升级、切换到同一业务类型的其他已发布版本,并恢复上一版配置基线。
|
||||
- 页面方案切换不改变品牌业务类型,不删除品牌内容、业务提供项或咨询记录。
|
||||
|
||||
3. **创建流程不导入示例内容**
|
||||
- 创建品牌只建立品牌身份、成员关系、字段定义和页面方案安装记录。
|
||||
- 示例内容只能由管理员在「页面方案 → 高级」中显式预览并确认导入,且只补齐缺失内容。
|
||||
|
||||
4. **兼容矩阵由模板包声明**
|
||||
- `linjing-editorial` 只支持 `doors`,不得在页面方案目录、创建品牌页、预览或 API 中把它与 `personal` 组合。
|
||||
- `personal` 只展示 `atelier-solopreneur`;`food` 只展示 `acheng-campus-food`。
|
||||
|
||||
5. **内部模板键不对运营用户暴露**
|
||||
- Admin 页面不展示 `packageKey`、`visualTemplateKey`、`renderer` 等内部名称。
|
||||
- 页面使用「业务类型」「页面方案」「版本」等用户语义;API 仍以稳定 key 作为边界校验值。
|
||||
|
||||
## Alternatives
|
||||
|
||||
- 继续用一个「表达方式」控件同时选择业务类型和页面方案:运营者无法理解不可变与可升级的差异,拒绝。
|
||||
- 允许创建后修改业务类型:会造成字段、内容、能力与发布快照漂移,需要跨行业迁移方案,当前不支持。
|
||||
- 创建品牌时自动导入示例内容:会把演示文案误认为真实品牌资料,并让空品牌与演示品牌无法区分,拒绝。
|
||||
- 继续让林境兼容 `personal`:与专属个人品牌模板职责重叠,且林境页面和 sample 内容面向门窗业务,拒绝。
|
||||
|
||||
## Consequences
|
||||
|
||||
- 创建品牌多了一步「选择页面方案」,但业务类型的不可变边界变得明确。
|
||||
- 页面方案升级与业务类型稳定解耦,发布流程不再承载模板治理。
|
||||
- 林境不再出现在 `personal` 组合中;旧的不兼容数据必须通过显式迁移或人工修复,不做运行时兜底。
|
||||
- 页面方案的版本切换和配置恢复需要保持幂等、授权校验和内容冲突提示。
|
||||
|
||||
## Migration
|
||||
|
||||
- 新增 owner-only 的 `GET /admin/brands/creation-options` 与 `POST /admin/brands`,创建时校验业务类型、页面方案兼容性和版本发布状态。
|
||||
- 新增 `GET /admin/workspace/template/options`,供 owner/admin/platform-admin 读取当前品牌的业务类型和兼容页面方案。
|
||||
- Admin 新增「创建品牌」与「页面方案」页面;「内容与发布」移除业务类型和页面方案选择。
|
||||
- `linjing-editorial` 升至 `1.0.7`,兼容矩阵收窄为仅 `doors`;同步更新 package、manifest、registry 和测试 fixture。
|
||||
- 已有品牌保留当前业务类型和页面方案版本;不兼容组合不做静默改写,升级或迁移必须显式执行。
|
||||
Reference in new issue
Block a user