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

This commit is contained in:
que01 committed 2026-10-20 17:04:30 +08:00
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。
- 已有品牌保留当前业务类型和页面方案版本;不兼容组合不做静默改写,升级或迁移必须显式执行。
+2 -2
View File
@@ -444,7 +444,7 @@ Phase 3 现场验收纠偏(2026-10-16):
- atelier 独立 fixture 也没有头像。已升为 `atelier-solopreneur@1.3.0`,在 `previewFixture.personal.brand` 中加入包内头像,继续保持预览数据与 bootstrap sample 分离。
- 修复 Admin 导入包预览中 food renderer 的资源 key 前缀映射:包内 `/assets/service/*.png` 等图标现在可从 archive 校验后的 data URL 渲染,不回退到本地部署资源。
- 矩阵 API 回归新增断言:每个支持行业的主理人身份非空、头像指向包内资源、所有 asset slot 都是 `ready`、没有诊断。
- 新增 Playwright 媒体矩阵:覆盖 `acheng/food`、`atelier/personal`、`linjing/personal`、`linjing/doors`,使用真实 `template:pack` 产物和 API preview service;验证失败重试、founder 可见、所有 `data:` 图像 `naturalWidth > 0`、无“内容缺失”、无真实写入请求。四张截图已人工检查。
- 新增 Playwright 媒体矩阵:覆盖 `acheng/food`、`atelier/personal`、`linjing/doors`,使用真实 `template:pack` 产物和 API preview service;验证失败重试、founder 可见、所有 `data:` 图像 `naturalWidth > 0`、无“内容缺失”、无真实写入请求。四张截图已人工检查。
- 本轮本地目录以最新已发布版本为准:`acheng-campus-food@1.0.1`、`atelier-solopreneur@1.3.0`、`linjing-editorial@1.0.3`;被取代的旧演示版本进入 retired。
Phase 3 隔离、导航和矩阵收口(2026-10-16):
@@ -452,7 +452,7 @@ Phase 3 隔离、导航和矩阵收口(2026-10-16):
- Admin dev/preview 响应增加 CSP、`Referrer-Policy: no-referrer` 和 `X-Content-Type-Options: nosniff`。preview/生产 CSP 为 `default-src 'self'`、`script-src 'self'`、`object-src 'none'`、`base-uri 'none'`、`frame-ancestors 'self'`、`form-action 'self'`;图片和媒体允许 `self/data/blob` 以读取通过 checksum 校验的包内资源,样式保留 `unsafe-inline` 以支持现有 React UI。生产构建同时保留 CSP meta 作为静态托管防线。
- Vite dev 为 React refresh preamble 单独允许 inline script;这是开发服务器例外,不是 preview/生产契约。Playwright 校验响应中存在 CSP 的 `default-src 'self'`、包内资源所需的 `img-src data:` 和 `frame-ancestors 'self'`。
- Admin 画布监听 Taro web preview runtime 发出的导航事件,把 renderer 内真实 CTA 转成画布内切换;`detail` 路由同步选择对应 offering。Playwright 覆盖“首页案例 -> 详情 CTA -> 禁止提交的咨询表单”。
- 新增真实包矩阵回归:`acheng-campus-food/food`、`atelier-solopreneur/personal`、`linjing-editorial/{personal,doors}`,每个组合各 2 个版本,共 8 个模拟品牌。测试校验行业兼容、Runtime/renderer 声明、模拟品牌 ID、包内资源逐项 checksum、禁用提交和跨版本隔离。
- 新增真实包矩阵回归:`acheng-campus-food/food`、`atelier-solopreneur/personal`、`linjing-editorial/doors`,每个组合各 2 个版本,共 6 个模拟品牌。测试校验行业兼容、Runtime/renderer 声明、模拟品牌 ID、包内资源逐项 checksum、禁用提交和跨版本隔离。
- 矩阵回归发现 linjing doors 起始内容声明了未注册 capability `doors`。已将其修正为 `inquiry`,模板包升为 `linjing-editorial@1.0.1`,生成目录、release build 配置和模板注册表同步更新;旧 `1.0.0` 不在本轮改写。
- Playwright 支持通过 `TEMPLATE_PREVIEW_VISUAL_EVIDENCE` 输出 `home/detail/inquiry/profile` 截图。本轮已生成并人工检查:独立 fixture 身份、包内图片、详情 CTA、咨询禁用和我的页面正常。该证据覆盖本地 Admin/H5 预览,不替代微信真机视觉验收或审核上传。
- 本轮回归:API HTTP integration `52/52`、upload `2/2`、API unit `52/52`、Client `6/6`、Admin unit `6/6`、Playwright `1/1`;全仓 typecheck、变更范围 ESLint、format、Admin production build 和 `template:check` 通过。全仓 `pnpm lint` 仍有先前记录的 Admin 既有 error,非本轮阻塞。
+1 -1
View File
@@ -15,7 +15,7 @@
### 仓库内视觉模板包
- acheng-campus-food@1.0.3:餐饮场景,使用 food 行业能力。
- linjing-editorial@1.0.4:林境建筑画册,可用于 doors 和 personal 组合。
- linjing-editorial@1.0.7:林境建筑画册,仅适配 doors 业务类型。
- atelier-solopreneur@1.3.2:独立工坊方向,适配 personal 行业。
以上是仓库盘点,不表示三个包都已经通过线上导入、预览、品牌安装和微信上传验收。生成目录当前位于 packages/config/src/generated-template-packages.ts,后续必须由导出和 conformance 流程生成并校验。