From cded6787f4a442a48d4eec1ea2bd287210640cf3 Mon Sep 17 00:00:00 2001 From: zhoulei Date: Thu, 20 Aug 2026 10:41:10 +0800 Subject: [PATCH] =?UTF-8?q?chore(backend):=20=E6=B2=BB=E7=90=86=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E8=A1=A5=E5=85=85=20SaaS=20=E5=A4=9A=E7=A7=9F?= =?UTF-8?q?=E6=88=B7=E6=8C=87=E9=92=88=E4=B8=8E=E7=A1=AC=E7=BA=A6=E6=9D=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../.project.agents/SELF_CONSTRAINTS.md | 6 ++++++ .../.project.agents/docs/context/ARCHITECTURE.md | 10 ++++++++++ .../.project.agents/docs/context/CONVENTIONS.md | 1 + 3 files changed, 17 insertions(+) diff --git a/abacus.springboot.example/.project.agents/SELF_CONSTRAINTS.md b/abacus.springboot.example/.project.agents/SELF_CONSTRAINTS.md index 31180a5..26f7d1e 100644 --- a/abacus.springboot.example/.project.agents/SELF_CONSTRAINTS.md +++ b/abacus.springboot.example/.project.agents/SELF_CONSTRAINTS.md @@ -52,6 +52,12 @@ - 不为不可能发生的情况加 fallback。 - 不引入向后兼容 shim，除非用户明确要求。 +### B7. 多租户隔离（SaaS 硬约束） +- 任何数据访问（JPA / 原生 SQL / 编排）必须带 `tenant_id` 过滤；缓存 key 必须前缀 `tenant:{tenantId}:`。 +- 租户标识以 token 为准，禁止在业务参数 / URL 中传递 tenantId；跨租户操作须 `@CrossTenant` + 审批。 +- 前端：品牌/主题/菜单须按 `tenantConfig` 动态加载，禁止硬编码；`X-Tenant-Id` 头由 `request.ts` 自动附加，业务代码不得手写。 +- 详细设计与落地映射见 `docs/architecture.md §7`、`coding-standards.md §9`；本仓库 `ARCHITECTURE.md §10`。 + ### B6. 实施日志（execution log） - **每完成一个可独立验收的部分（milestone 或子任务），必须在 `.project.agents/log` 写日志**。格式与时机见 `VIBECODING_GUIDE`。 - 日志内必须包含本段的版本控制提交列表；若本段未提交，明确写出"未提交"及原因。 diff --git a/abacus.springboot.example/.project.agents/docs/context/ARCHITECTURE.md b/abacus.springboot.example/.project.agents/docs/context/ARCHITECTURE.md index 1720e4a..beae577 100644 --- a/abacus.springboot.example/.project.agents/docs/context/ARCHITECTURE.md +++ b/abacus.springboot.example/.project.agents/docs/context/ARCHITECTURE.md @@ -31,6 +31,7 @@ - I2. 原生 SQL 全量 `?` 参数化，禁止字符串拼接。 - I3. 分层依赖单向：api/controller → esb/wsi → {pi/impl, repository} → dao；禁止反向依赖。 - I4. Controller 直接 return 业务对象，禁止手拼统一响应体。 +- I5. 多租户隔离：所有数据访问必须带 `tenant_id` 过滤（JPA @Filter / Repository 基类 / 原生 SQL `?`），缓存 key 前缀 `tenant:{tenantId}:`；跨租户操作须 `@CrossTenant` + 审批。详见 `../../../../docs/architecture.md §7` 与 `coding-standards.md §9`。 ## 2. 模块清单 @@ -176,3 +177,12 @@ src/main/resources/ - 加/删模块或改依赖方向 → 改本文 §2 + §3，同一 commit。 - 改对外签名 → 先改 §3.2，再改代码。 - 与 `PRD.md` 冲突 → 以 `PRD.md` 为准，回改本文；与共享 `docs/coding-standards.md` 冲突 → 以 docs/ 为准并回改本文。 + +## 10. SaaS 多租户架构（指针） + +> 完整设计（隔离策略、租户识别、缓存/异步隔离、前后端协作、扩展性、落地映射）见工作区 `../../../../docs/architecture.md §7`；编码强制约束见 `../../../../docs/coding-standards.md §9`。本文仅记录后端特有约束： + +- 租户识别以 JWT `tenantId` 为唯一真相源；`X-Tenant-Id` 头仅透传/审计。 +- `TenantContextHolder`（ThreadLocal）由 `TenantInterceptor` 写入、`afterCompletion` 清除。 +- 数据访问（JPA / `pi` 原生 SQL / `esb` 编排）一律带 `tenant_id`；缓存 key 前缀 `tenant:{tenantId}:`；`@Async` 经 `TenantTaskDecorator` 传播、Kafka/XXL-JOB 携带 `tenantId`。 +- 后端新增 `tenant/` 相关类（`config/TenantConfig`、`dao/Tenant*`、`api/TenantController`、`esb/TenantBizService`/`TenantProvisioningService`、`pi/TenantAccess`），包归属见 §2 / §6，纳入统一扫描。 diff --git a/abacus.springboot.example/.project.agents/docs/context/CONVENTIONS.md b/abacus.springboot.example/.project.agents/docs/context/CONVENTIONS.md index 578fb0b..5309aef 100644 --- a/abacus.springboot.example/.project.agents/docs/context/CONVENTIONS.md +++ b/abacus.springboot.example/.project.agents/docs/context/CONVENTIONS.md @@ -92,3 +92,4 @@ Conventional Commits：`type(scope): subject`。允许 type：`feat` / `fix` / ` ## 6. 不在本文范围（明确划清） - 模块拆分归 `ARCHITECTURE.md`；行为/范围归 `PRD.md`；前后端共享约束（响应体/异常码/分页/APP_NAME/打包）归 `docs/coding-standards.md`。 +- 多租户 SaaS 隔离与前后端协作归 `docs/architecture.md §7`；编码强制约束归 `docs/coding-standards.md §9`（后端落地见本仓库 `ARCHITECTURE.md §10`）。