chore(backend): 治理文件补充 SaaS 多租户指针与硬约束

2026-08-20 10:41:10 +08:00
parent 17912ea8a7
commit cded6787f4
3 changed files with 17 additions and 0 deletions
@@ -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，纳入统一扫描。
@@ -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`）。