Files
eip4-platform/platform-auth/P2多维数据权限实测报告.md
zhengwr b6de637905 P2-4: 多维数据权限全形态实测——R1 风险判定(引擎多维隔离语义成立)
普查(客户库只读):1079 条活跃规则归型——多规则同实体 303/345(角色 OR 88%)、
多条件 op 串联 117、type 分布 CURRENTUSERORGID 323/OWNNERPROJECT 165/CURRENTUSERDEPARTID 27、
SPECIALDEPART/ORG 客户零用;OwnProjectWhere SysConfig 实际值取证。

实测(本地 eip4m0,可写):bootstrap-multidim.sql 构造 7 受控实体 + 规则矩阵,
MultiDimPrivilegeRunner + ParityCli --multidim 多维 ctx 驱动引擎过滤 vs JDBC 等价 WHERE
逐行对拍——14 形态 100% 一致(39 行)+ 7/7 负例被拒。覆盖部门/组织/SPECIALDEPART/
OWNNERPROJECT 单维、op=AND 串联、多规则角色 OR 三态、建筑三维 OWNER×部门×项目。

客户库抽测(只读,P2-1 口径):DM_FILE(299)/SYS_USER(806)组织维 count+行级 MATCH + 负例被拒。

测试通道:EntityController 加 asDepart/asOrg(与 asUser 同性质,不传零回归),
使引擎可解析 CURRENTUSERDEPARTID/CURRENTUSERORGID 维度。

单测:MultiDimDataPrivilegeTest 9 测(getWhereClause 拼接矩阵,FakePOInfo 模式)。
全模块 test + ArchUnit 绿。手册新增 §5.34/§5.35。

R1 判定:引擎多维隔离语义成立,不构成 P2 阻塞;缺口(OWNNERPROJECT 客户库直拍/
生产 ctx 注入/SPECIALDEPART 无真实样本)如实登记跟踪。未触发决策会 S1。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 14:05:09 +08:00

224 lines
15 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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.
# EIP4 P2-4 多维数据权限「建筑行业多维隔离」语义 实测报告
> 工程:eip4-platform · 时间:2026-06-11 · 性质:P2 成败手 / CTO 风险 **R1**(数据行级权限多维隔离语义是否成立)实质判定
> 环境:客户库 `192.168.20.68:5435/postgres?currentSchema=eip3`(ceshi/ceshi,**只读**)做规则普查 + 抽测;
> 本地 `localhost:5433/eip4m0`(zhengwr 无密码,可写)做全形态矩阵实测;服务端口 **8088**(8084/8087 未动)。
> 引擎语义权威来源:`platform-legacy-core` `DataPrivilegeServiceImpl.getFilterSql`(已逐行核对)。
---
## 一、结论速览(R1 判定)
| 项 | 结果 |
|----|------|
| 客户库规则形态普查(只读,1079 条活跃规则) | ✅ 已归型,见 §二 |
| **本地全形态矩阵实测(≥12 形态目标)** | ✅ **14 形态 100% 逐行一致(39 行)+ 7/7 负例被拒** |
| 客户库多维规则只读抽测(≥2 条) | ✅ **DM_FILE(299 行)/ SYS_USER(806 行)组织维 count+行级 MATCH + 负例被拒** |
| getWhereClause 拼接矩阵单测(≥6) | ✅ **MultiDimDataPrivilegeTest 9 测全绿**(沿用 FakePOInfo 模式) |
| 全模块 test + ArchUnit | ✅ **BUILD SUCCESS**,ArchUnit 1/1,全单测 0 失败(legacy-core 45 / metadata 34 / parity 30 / auth 16) |
| **R1 风险判定** | ✅ **引擎多维隔离语义成立**(部门×组织×部门集×项目×分包商,单维/多条件 op 串联/多规则角色 OR 全闭合);缺口见 §五.3 |
| 与决策会「P2 进度偏差>50% 触发 S1」对照 | ✅ **未触发 S1**(P2-4 全目标达成,无进度偏差) |
产物:
- 本报告;对拍报告 `parity-reports/multidim-parity-20260611-135917.{json,md}`
- 自举:`platform-parity/src/main/resources/bootstrap/bootstrap-multidim.sql`
- 对拍执行器:`platform-parity/.../selfcheck/MultiDimPrivilegeRunner.java` + `ParityCli`(`--multidim`)
- 测试通道扩展:`platform-metadata/.../web/EntityController.java`(加 `asDepart`/`asOrg`)
- 单测:`platform-legacy-core/.../privilege/MultiDimDataPrivilegeTest.java`
---
## 二、客户库规则形态普查(只读,第一手数据)
> 数据源:客户库 `eip3` schema,`SET search_path TO eip3` 后纯 SELECT,**未写任何规则**。脚本见 `/tmp/p2-4-survey.sql` 思路(归型用 `jsonb_array_elements` 精确解析 + 关键字命中双口径)。
### 2.1 规模与多规则分布
| 指标 | 值 |
|------|-----|
| 活跃规则总数(`isactive=1`) | **1079** |
| 去重实体数 | **345** |
| 单规则实体 / 多规则实体 | **42 / 303**(多规则同实体占比 **87.8%**) |
| 多规则实体涉及规则数 | 1037 |
| 同实体规则数 Top | PM_PAYMENTAPPLY 31、VIEW_PM_CONTRACT 23、PM_CONTRACTACCOUNTS 22、VIEW_HR_USERWITHALLCARDS/PM_CONTRACTBALANCE 18、HR_SAFETYCARD/PM_SUBCONTRACTCLAIM/PM_SUBCONTRACTCHANGE 13 |
> **判读**:88% 的实体配多条规则 → 引擎「多规则按角色 OR 合并」是客户库**绝对主流**用法,本期重点验证对象。
### 2.2 FILTERRULE JSON 形态
| 形态 | 计数 |
|------|------|
| 空条件(`[]`/null,查看全部) | **376** |
| 非空 JSON 数组 | **703** |
| 非数组形态 | 0 |
| 单条件规则(1 conditional) | **586** |
| 多条件规则(≥2 conditional,op 串联) | **117**(单规则内最多 **3** 条件) |
| 规则含 `op:"AND"` | **91** |
| 规则含 `op:"OR"` | **27** |
### 2.3 条件类型分布(`jsonb_array_elements` 精确解析,跨全部 conditional)
| type | 计数 | sign | 计数 |
|------|------|------|------|
| CURRENTUSERORGID(组织维) | **323** | `=` | 628 |
| NUMBER(静态数值) | 167 | `in` | 196 |
| OWNNERPROJECT(项目负责人维) | **165** | | |
| TEXT(静态/子查询) | 71 | | |
| CURRENTUSERID(用户维) | 71 | | |
| CURRENTUSERDEPARTID(部门维) | **27** | | |
| **SPECIALDEPART / SPECIALORG(指定集)** | **0 / 0**(客户**未用**,引擎支持) | | |
> **判读**:组织维(CURRENTUSERORGID 323)+ 项目负责人维(OWNNERPROJECT 165)是建筑行业多维隔离的**两大主力**,部门维(27)次之;SPECIALDEPART/ORG 客户零使用(本期仍补构造全覆盖引擎能力)。
### 2.4 OwnProjectWhere SysConfig 实际配置值(项目负责人维的核心)
```
SYS_APPLICATION_CONFIG[sys_application_config_id = 'com.dsasp.server.privilege.OwnProjectWhere'].value =
SELECT PM_PROJECTID FROM PM_PROJECT_USER WHERE USERID={CURRENTUSERID}
```
引擎 OWNNERPROJECT 形态据此拼:`P.<col> in ( SELECT PM_PROJECTID FROM PM_PROJECT_USER WHERE USERID='<当前用户>' )`(`{CURRENTUSERID}` 拼接前替换为带引号的当前用户;`SysConfig.getConfigValue` 读 `VALUE` 列,见 `DataDicServiceImpl.getConfigValue`)。
### 2.5 真实多维(多条件)规则样例(供形态构造与抽测)
| 实体 | 规则(节选) | 形态 |
|------|------|------|
| HR_SAFETYCARD | `KIND=N AND USERID in (select sys_user_id from sys_user where userorgid={CURRENTUSERORGID})` | 静态 AND 组织维子查询 |
| PM_CONTRACTACCOUNTS | `CONTRACTTYPE=N AND ORGID={CURRENTUSERORGID}` | 合同类型 AND 组织维 |
| OA_MEETINGMINUTES | `MEETING_COMPERE={CURRENTUSERID} OR MEETING_CLERK={CURRENTUSERID}` | 用户维 OR 串联 |
---
## 三、引擎多维过滤语义(逐行核对 `getFilterSql`)
| 条件 type | 引擎拼接 | ctx 来源 |
|-----------|----------|----------|
| `CURRENTUSERID` | `P.<col> <sign>'<user>'`(`TO_STRING` 自动加单引号) | `ctx.CURRENTUSER` |
| `CURRENTUSERDEPARTID` | `P.<col> <sign>'<depart>'` | `ctx.CURRENTDEPART` |
| `CURRENTUSERORGID` | `P.<col> <sign>'<org>'` | `ctx.CURRENTORG` |
| `SPECIALDEPART`/`SPECIALORG` | `P.<col> in ('v1','v2',…)`(`convertSplitStrToSql`,**sign 被强制为 in**) | 规则静态值 |
| `OWNNERPROJECT` | `P.<col> in ( <OwnProjectWhere,{CURRENTUSERID}已替换> )` | SysConfig + ctx.CURRENTUSER |
| 自定义(else) | `P.<col> <sign><backConditional,占位符已替换>` | 规则 + ctx |
| **op 串联** | 同规则内多 conditional 以 `op`(AND/OR)连接 | — |
| **多规则角色 OR** | 同实体多 `sys_filterrule` 行按命中角色以 ` OR ` 合并,外层 ` AND ( … )` 包裹 | `ctx.ROLES` ∩ 规则角色 |
| **first 分支** | 无任何命中角色 → 抛 `PrivilegeException`(HTTP 非 200) | — |
> 关键发现(坑 §5.34):测试通道 `EntityController.buildCtx` 原仅注入 `CURRENTUSER`+`ROLES`,部门/机构维 ctx 空 → 多维过滤恒空。本期加 `asDepart`/`asOrg` 测试通道(与 `asUser` 同性质,`RESERVED_KEYS` 放行),不传则单维行为零回归。
---
## 四、本地全形态矩阵实测(localhost:5433/eip4m0,可写)
> 自举:`bootstrap-sys.sql`(SYS 自描述元数据)+ `bootstrap-multidim.sql`(7 受控实体 + 规则矩阵 + OwnProjectWhere SysConfig + PM_PROJECT_USER 支撑表 + 种子数据)。
> 方法:`ParityCli --multidim`——多维 ctx(`asUser+asDepart+asOrg+roles`)驱动引擎行级过滤路径 vs JDBC **等价 WHERE** 逐行 diff(复用 C1/C2 的 RowDiff + 自对拍豁免内核 `SelfCheckRunner.checkRows`)。
### 4.1 形态矩阵结果(14 形态,全过)
| # | 形态 | 实体 | 等价 WHERE | 行数 | 一致率 | 结果 |
|---|------|------|-----------|------|--------|------|
| 1 | 单维-部门 CURRENTUSERDEPARTID(DEP_1) | EIP4PT_MDDEPT | `departid='DEP_1'` | 3 | 1.0000 | ✅ |
| 2 | 单维-部门 CURRENTUSERDEPARTID(DEP_2) | EIP4PT_MDDEPT | `departid='DEP_2'` | 3 | 1.0000 | ✅ |
| 3 | 单维-组织 CURRENTUSERORGID(ORG_1) | EIP4PT_MDORG | `orgid='ORG_1'` | 4 | 1.0000 | ✅ |
| 4 | 单维-组织 CURRENTUSERORGID(ORG_2) | EIP4PT_MDORG | `orgid='ORG_2'` | 2 | 1.0000 | ✅ |
| 5 | 单维-指定部门集 SPECIALDEPART | EIP4PT_MDSPECDEPT | `departid in ('DEP_1','DEP_2')` | 4 | 1.0000 | ✅ |
| 6 | 单维-项目负责人 OWNNERPROJECT(USER_PM) | EIP4PT_MDPROJECT | `projectid in (我负责的项目)` | 4 | 1.0000 | ✅ |
| 7 | 单维-项目负责人 OWNNERPROJECT(USER_BOB) | EIP4PT_MDPROJECT | `projectid in (我负责的项目)` | 2 | 1.0000 | ✅ |
| 8 | 多条件 op=AND 部门 AND 项目(USER_PM/DEP_1) | EIP4PT_MDCOMBO | `departid='DEP_1' AND projectid in(我负责)` | 3 | 1.0000 | ✅ |
| 9 | 多条件 op=AND 部门 AND 项目(USER_BOB/DEP_2) | EIP4PT_MDCOMBO | `departid='DEP_2' AND projectid in(我负责)` | 2 | 1.0000 | ✅ |
| 10 | 多规则角色 OR(命中 A+B:OWNER OR 部门) | EIP4PT_MDOR | `(owner='USER_PM') OR (departid='DEP_1')` | 4 | 1.0000 | ✅ |
| 11 | 多规则角色 OR(只命中 A:OWNER) | EIP4PT_MDOR | `owner='USER_PM'` | 2 | 1.0000 | ✅ |
| 12 | 多规则角色 OR(只命中 B:部门) | EIP4PT_MDOR | `departid='DEP_1'` | 2 | 1.0000 | ✅ |
| 13 | **建筑三维** OWNER AND 部门 AND 项目(USER_PM/DEP_1) | EIP4PT_SUBCONTRACT | `owner='USER_PM' AND departid='DEP_1' AND projectid in(我负责)` | 3 | 1.0000 | ✅ |
| 14 | **建筑三维** OWNER AND 部门 AND 项目(USER_BOB/DEP_1) | EIP4PT_SUBCONTRACT | `owner='USER_BOB' AND departid='DEP_1' AND projectid in(我负责)` | 1 | 1.0000 | ✅ |
**汇总**:形态正例 **14/14 全一致**,总比对 **39 行 100% 逐行一致**;形态通过率 **1.0000**。覆盖:单维(部门/组织/指定部门集/项目负责人)、多条件 op=AND 串联、多规则角色 OR(命中其一/其二/全命中三态)、建筑三维(项目×组织×部门×分包商表 OWNER×部门×项目)。**目标 ≥12 形态达成(实测 14)。**
### 4.2 负例(无命中角色 → PrivilegeException)
| 实体 | HTTP 状态 | 期望 | 结果 |
|------|----------|------|------|
| EIP4PT_MDDEPT / MDORG / MDSPECDEPT / MDPROJECT / MDCOMBO / MDOR / SUBCONTRACT | **500** | 非 200(PrivilegeException) | ✅ 全部被拒(7/7) |
> 印证「规则存在但无命中角色 → 拒绝」语义(`getWhereClause` first 分支抛 `PrivilegeException`)。
---
## 五、客户库多维规则只读抽测 + R1 风险判定
### 5.1 客户库抽测(只读,P2-1 安全口径)
> 服务以 `hikari.read-only=true` 连客户库(8088)。挑**单条件纯组织维**(`<col>={CURRENTUSERORGID}`)规则——等价 WHERE 可确定性复现为 `<col>='<org>'`,且对实体只供该规则角色(不 OR-in view-all 角色)。**全程只读,未写任何规则**。
| # | 实体 | 规则形态 | 真实 org | 引擎过滤 total | JDBC 等价 WHERE count | count | 行级(前10主键) | 负例 |
|---|------|---------|---------|---------------|----------------------|-------|----------------|------|
| 1 | DM_FILE | `ORGID={CURRENTUSERORGID}` | 402881343826dc6f0138275606b50001 | **299** | `orgid='…'`=299 | ✅ MATCH | ✅ MATCH | 500 ✅ |
| 2 | SYS_USER | `USERORGID={CURRENTUSERORGID}` | (同上) | **806** | `userorgid='…'`=806 | ✅ MATCH | — | — |
- 两实体均为 2 条规则(1 条组织维 + 1 条 `[]` view-all,角色不同);抽测只供组织维规则角色,引擎仅 OR 该单条 → 等价 WHERE 确定。**count + 行级主键集逐一 MATCH**,负例(占位角色)HTTP 500 被拒。
- **不可复现形态如实登记**:`{CURRENTUSERORGID}` 子查询型(如 HR_SAFETYCARD `KIND=N AND USERID in (…userorgid={CURRENTUSERORGID})`)、OWNNERPROJECT、多角色 OR-合并用户——等价 WHERE 依赖运行期真实 org/depart/project ctx 且含嵌套子查询,只读侧精确重建脆弱(易假阳性),按 P2-1 口径不纳入正例(待 P2 管理 UI 落地后用「写规则→读回 ctx 一致性」闭环验)。
### 5.2 R1 风险判定结论:**引擎多维隔离语义成立**
1. **维度闭合**:部门(CURRENTUSERDEPARTID)、组织(CURRENTUSERORGID)、指定集(SPECIALDEPART/ORG)、项目负责人(OWNNERPROJECT)四类维度,引擎拼接语义与 JDBC 等价 WHERE **逐行一致**(本地 14 形态)。
2. **组合闭合**:多条件 op=AND/OR 串联(单规则内)+ 多规则按角色 OR 合并(跨规则)——客户库 88% 实体的主流用法——引擎合并语义**逐行一致**,命中其一/其二/全命中三态正确,无命中抛 `PrivilegeException`。
3. **建筑三维闭合**:项目×组织×部门×分包商场景(EIP4PT_SUBCONTRACT,OWNER×部门×项目三条件 AND),多用户多角色交叉**逐行一致**。
4. **真实规则印证**:客户库真实组织维规则(DM_FILE 299 行 / SYS_USER 806 行)只读抽测 count+行级 MATCH,印证引擎对真实配置的隔离正确。
> **R1 不构成阻塞**:引擎多维数据隔离语义经本地全形态 + 客户库真实抽测双向验证成立,可作为 P2 数据权限的承载底座。
### 5.3 缺口清单(非阻塞,登记跟踪)
| # | 缺口 | 现状 | 后续 |
|---|------|------|------|
| G1 | OWNNERPROJECT/子查询型动态规则的**客户库**直接对拍 | 本地已全形态验;客户库等价 WHERE 重建脆弱,未做正例 | P2 管理 UI 落地后写规则→读回 ctx 闭环验(届时有真实 org/project ctx 来源) |
| G2 | 多维 ctx 的**生产注入**(部门/机构)由 JWT/UserSession 提供 | 本期用 `asDepart`/`asOrg` 测试通道驱动;生产路径未在本期验 | P2 登录/会话集成时验 JWT claims→UserSession→ctx 的部门/机构透传 |
| G3 | SPECIALDEPART/ORG 客户零使用 | 引擎支持已验(本地形态 5);无真实样本 | 仅登记,客户启用时即覆盖 |
---
## 六、单测(getWhereClause 拼接矩阵,FakePOInfo 模式)
`platform-legacy-core/.../privilege/MultiDimDataPrivilegeTest.java`(9 测,**沿用既有 DataPrivilegeTest 的 FakePOInfo 反射注入 + 纯 ctx 模式**,绕开 DB/Spring):
| 测试 | 覆盖 |
|------|------|
| `whereClause_currentUserDepart_singleDim` | 部门维 `P.DEPARTID='DEP_1'` |
| `whereClause_currentUserOrg_singleDim` | 组织维 `P.ORGID='ORG_2'` |
| `whereClause_specialDepart_forcedInClause` | SPECIALDEPART 强制 `in('DEP_1','DEP_2')`(非等值) |
| `whereClause_multiConditional_opAnd` | 单规则内 op=AND 串联(部门 AND 组织) |
| `whereClause_multiConditional_opOr` | 单规则内 op=OR 串联(会议主持 OR 记录) |
| `whereClause_multiRule_roleOr_bothMatched` | 多规则角色 OR(两条规则 OR 合并) |
| `whereClause_multiRule_roleOr_onlyOneMatched` | 多规则只命中一条(只拼该子句) |
| `whereClause_multiRule_roleOr_noneMatched_throws` | 无命中角色 → PrivilegeException |
| `whereClause_threeDim_andChain` | 建筑三维 3 条件 AND 链(OWNER AND 部门 AND 组织) |
> **≥6 目标达成(9 测)**;`DataPrivilegeTest`(既有 9 测)同步全绿,无回归。
全模块 `mvn clean install`:**BUILD SUCCESS**;ArchUnit `ArchitectureRulesTest` 1/1 绿;legacy-core 45 / metadata 34 / parity 30 / auth 16 单测 0 失败。
---
## 七、与决策会「P2 进度偏差>50% 触发 S1」对照
| 决策会条款 | 本期对照 |
|-----------|---------|
| P2 进度偏差 >50% 触发 S1 应急 | **未触发**:P2-4 全部任务目标达成——普查(1079 条归型)/ 全形态实测(14 形态 100%,超 ≥12 目标)/ 客户库抽测(2 实体 MATCH,超 ≥2 目标)/ 单测(9,超 ≥6 目标)/ 全模块绿。无进度偏差。 |
| R1(多维隔离语义)实质判定 | **成立**(§五.2),不构成 P2 阻塞,可作数据权限底座。 |
---
## 八、纪律与产物对照
| 任务要求 | 交付 |
|---------|------|
| 客户库规则形态普查(只读) | ✅ §二(1079 条归型 + OwnProjectWhere 值) |
| 多维形态全覆盖实测(≥12 形态全过) | ✅ §四(14 形态 100% + 7/7 负例) |
| 客户库多维规则抽测(≥2 条只读) | ✅ §五.1(DM_FILE/SYS_USER MATCH) |
| 单测 ≥6(getWhereClause 拼接矩阵) | ✅ §六(9 测) |
| 全模块 test + ArchUnit 绿 | ✅ BUILD SUCCESS |
| R1 风险判定结论 | ✅ §五.2(成立)+ §五.3 缺口清单 |
| 新坑进迁移手册 | ✅ §5.34(asDepart/asOrg 测试通道)/ §5.35(bootstrap 宽前缀 DELETE 误删 SYS 元数据) |
| 端口 8088,8084/8087 未动;客户库只读未写规则 | ✅ |
| git 只 add 自己文件,commit 前核对并行代理 | ✅ 见提交记录 |
| 结束 kill 8088 | ✅ 见末节 |