# 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. 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. ''`(`TO_STRING` 自动加单引号) | `ctx.CURRENTUSER` | | `CURRENTUSERDEPARTID` | `P. ''` | `ctx.CURRENTDEPART` | | `CURRENTUSERORGID` | `P. ''` | `ctx.CURRENTORG` | | `SPECIALDEPART`/`SPECIALORG` | `P. in ('v1','v2',…)`(`convertSplitStrToSql`,**sign 被强制为 in**) | 规则静态值 | | `OWNNERPROJECT` | `P. in ( )` | SysConfig + ctx.CURRENTUSER | | 自定义(else) | `P. ` | 规则 + 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)。挑**单条件纯组织维**(`={CURRENTUSERORGID}`)规则——等价 WHERE 可确定性复现为 `=''`,且对实体只供该规则角色(不 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 | ✅ 见末节 |