普查(客户库只读):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>
15 KiB
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-coreDataPrivilegeServiceImpl.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
二、客户库规则形态普查(只读,第一手数据)
数据源:客户库
eip3schema,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) |
印证「规则存在但无命中角色 → 拒绝」语义(
getWhereClausefirst 分支抛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_SAFETYCARDKIND=N AND USERID in (…userorgid={CURRENTUSERORGID}))、OWNNERPROJECT、多角色 OR-合并用户——等价 WHERE 依赖运行期真实 org/depart/project ctx 且含嵌套子查询,只读侧精确重建脆弱(易假阳性),按 P2-1 口径不纳入正例(待 P2 管理 UI 落地后用「写规则→读回 ctx 一致性」闭环验)。
5.2 R1 风险判定结论:引擎多维隔离语义成立
- 维度闭合:部门(CURRENTUSERDEPARTID)、组织(CURRENTUSERORGID)、指定集(SPECIALDEPART/ORG)、项目负责人(OWNNERPROJECT)四类维度,引擎拼接语义与 JDBC 等价 WHERE 逐行一致(本地 14 形态)。
- 组合闭合:多条件 op=AND/OR 串联(单规则内)+ 多规则按角色 OR 合并(跨规则)——客户库 88% 实体的主流用法——引擎合并语义逐行一致,命中其一/其二/全命中三态正确,无命中抛
PrivilegeException。 - 建筑三维闭合:项目×组织×部门×分包商场景(EIP4PT_SUBCONTRACT,OWNER×部门×项目三条件 AND),多用户多角色交叉逐行一致。
- 真实规则印证:客户库真实组织维规则(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 | ✅ 见末节 |