refactor: 明确多品牌后台工作区语义
This commit is contained in:
1 parent
a8a37c179e
commit
1ea757555d
7 files changed
+87
-4
No files matched your search
@@ -0,0 +1,30 @@
|
||||
# 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。
|
||||
Reference in new issue
Block a user