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

15 KiB
Raw Permalink Blame History

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 ✅ 见末节