refactor: 明确多品牌后台工作区语义

This commit is contained in:
que01 committed 2026-09-23 11:07:57 +08:00
1 parent a8a37c179e
commit 1ea757555d
7 files changed
+87 -4

No files matched your search

@@ -0,0 +1,20 @@
# 多品牌后台与 API 架构收口
## 目标
让后台明确运行在“当前品牌工作区”上下文中,让品牌内容、模板、业务提供项、信任内容和咨询数据都属于当前品牌;同时拆分 API Controller,避免 `main.ts` 继续成为业务代码集中点。
## 原则
- `brandId` 来自认证后的 membership,不信任客户端传入。
- 后台页面表达“当前品牌工作区”,而不是假设系统只有一个品牌。
- Controller 只做 transport,业务查询和状态逻辑进入 feature service。
- `main.ts` 只保留应用装配和模块注册。
- 每次拆分保持现有 API 路径和响应契约不变。
## 验收
- 后台导航和页面显示当前品牌上下文。
- 多品牌授权测试继续通过。
- API Controller 按 public、customer、admin feature 拆分。
- API、Admin build、miniapp fixture 全量通过。
@@ -0,0 +1,13 @@
# 进度
- 任务:多品牌后台与 API 架构收口
- 形态:epic
- 进度:1/3
- 当前:API Controller 拆分
- 真相文件:`SUBTASKS.csv`
## 已完成
- 后台导航改为当前品牌工作区语义。
- Header 显示当前认证品牌名称。
- 保持 membership 授权和现有 API 契约不变。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,当前品牌工作区语义,single-full,,DONE,tasks/admin-context,后台明确当前品牌并保持 membership 隔离,pnpm --filter @personal-brand/admin build && pnpm --filter @personal-brand/api test:integration,已完成
2,API Controller 拆分,single-full,1,TODO,tasks/api-split,main.ts 仅保留装配和跨模块基础代码,pnpm --filter @personal-brand/api typecheck && pnpm --filter @personal-brand/api test:integration,
3,架构回归收口,single-full,2,TODO,tasks/regression,Admin 和 miniapp 回归全部通过,pnpm --filter @personal-brand/admin build && pnpm --filter @personal-brand/miniapp test:fixture,
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 当前品牌工作区语义 single-full DONE tasks/admin-context 后台明确当前品牌并保持 membership 隔离 pnpm --filter @personal-brand/admin build && pnpm --filter @personal-brand/api test:integration 已完成
3 2 API Controller 拆分 single-full 1 TODO tasks/api-split main.ts 仅保留装配和跨模块基础代码 pnpm --filter @personal-brand/api typecheck && pnpm --filter @personal-brand/api test:integration
4 3 架构回归收口 single-full 2 TODO tasks/regression Admin 和 miniapp 回归全部通过 pnpm --filter @personal-brand/admin build && pnpm --filter @personal-brand/miniapp test:fixture
@@ -0,0 +1,7 @@
# 当前品牌工作区语义
状态:DONE
- 后台导航使用“当前品牌概览 / 当前品牌表达”。
- 顶部显示认证会话对应的当前品牌名称。
- Admin build 和 API 集成测试通过。