Files
persionalBrand/docs/adr/0006-multibrand-admin-and-api-boundaries.md

31 lines
1.4 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.
# 0006 多品牌后台上下文与 API 边界
## 背景
系统已经使用 `BrandMembership` 和认证 identity 的 `brandId` 做数据隔离,但后台导航和页面文案仍然采用单品牌语义;同时 `apps/api/src/main.ts` 聚合了多个领域 Controller,导致新增行业能力时维护成本持续上升。
## 决策
- 后台所有品牌内容页面都明确属于“当前品牌工作区”。
- 品牌上下文由管理员 membership 和会话决定,客户端不能提交 `brandId` 覆盖它。
- API 按 `public`、`customer`、`admin` 领域拆分 Controller;Controller 保持 transport 职责,业务逻辑进入 service。
- 保持现有 URL 和响应契约,拆分只改变代码 ownership,不改变客户端行为。
## 备选方案
- 继续向 `main.ts` 添加 Controller:短期快,但会形成不可维护的领域耦合。
- 在每个页面自行传 `brandId`:容易越权,不采用。
- 为每个行业复制一套 Controller:破坏模板复用,不采用。
## 后果
- 会产生一次代码搬迁和测试调整成本。
- 后续增加品牌切换、品牌成员管理时有清晰入口。
- 行业模板只影响 Runtime 配置,不影响租户边界。
## 迁移计划
1. 先完成后台当前品牌上下文语义和回归测试。
2. 抽离公开、客户、管理员 Controller 文件。
3. 再把跨 Controller 的查询和状态规则下沉到 feature service。