Files
eip4-platform/platform-auth/P2组织权限实测报告.md
zhengwr 82f52c1114 P2-1: 权限对拍扩容(真实实体只读权限对拍)+ 报告 + 手册坑位
platform-parity 新增「真实实体只读权限对拍」模式:
- RealEntityPrivilegeRunner:从客户库真实 SYS_FILTERRULE(1079 条活跃规则)发现
  可确定性复现的 (实体,用户,角色) 案例(只挑 []→全表、USERID={CURRENTUSERID}→
  WHERE userid=<uid> 两类形态,且仅当用户全部交集规则均可复现才取正例),
  真实用户 ctx 驱动引擎行级过滤 vs JDBC 等价 WHERE 逐行 diff;负例无命中角色→
  PrivilegeException(HTTP 非 200)。全程只读,绝不向客户库写规则。
- ParityCli 增 --realprivilege 模式 + JSON/MD 报告;SelfCheckRunner 抽出 checkRows
  复用自对拍豁免内核(BOOLEAN 域外/计算列/物理孤儿/xml/JSON 空值),纯增量不改既有路径。

实测(8085 客户库只读):HR_SAFETYCARD/HR_OTHERCARD/HR_CONSTRUCTORCARD/HR_MEMBERCARD
共 4 实体 805 行 100% 逐行一致 + 5/5 负例被拒。

报告:platform-auth/P2组织权限实测报告.md(移植清单/REST 7 例证据/对拍扩容/
密码哈希=无盐小写 MD5 客户库实证)。

手册新坑:§5.32(userid 36/32 长度不一致 varchar 等值)、§5.33(真实规则形态多样
只纳入可复现形态对拍)、§5.OTP(私有 jar 模块内仓库)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 13:39:17 +08:00

16 KiB
Raw Permalink Blame History

EIP4 P2-1 组织/用户/角色/功能权限模块移植 + 权限对拍扩容 实测报告

工程:eip4-platform · 环境:服务端口 8085(默认 profile,连客户库 192.168.20.68:5435/postgres?currentSchema=eip3,ceshi/ceshi,只读 hikari.read-only=true) 时间:2026-06-11 · 性质:P2-1 一级交付(组织/用户/角色保真层移植 + 现代层只读 REST + 真实实体权限对拍扩容) 纪律:8084 共享端口未动;客户库全程只读未写任何规则;父 pom 未改,仅 platform-legacy-core 模块 pom 加 OTP 依赖

一、结论速览

项 结果
组织模块 5 impl + 5 common 接口 + 2 workflow 依赖移植(包名/签名原样) ✅ 全模块 mvn clean install 通过
privilege 模块剩余文件 diff 核查 ✅ 仅 OSGi Activator 未移植(手册 §5.17 纪律),其余已在仓库
OTP 库 jotpverify.jar(无公网坐标)经模块内私有仓库解析 ✅ 构建可复现,父 pom 未动
LegacyXmlWiring 补 setter 注入(等价原 service.xml <property>) ✅ 4 个 impl 依赖装配,旧类零修改
ArchUnit 架构纪律(保真层禁依赖现代层) ✅ 绿(1/1)
既有单测全绿(无回归) ✅ 105 run,0 Failures,0 Errors,0 Skipped
OrgController 只读 REST(7 端点 + OpenAPI 注解) ✅ 全部进 OpenAPI /v3/api-docs
REST 实测(客户库真实数据,7 例,逐一与 DB 直查一致) ✅ 7/7 MATCH
权限对拍扩容:真实实体只读权限对拍(--realprivilege) ✅ 4 实体逐行 100%(805 行)+ 5/5 负例被拒
老系统密码哈希方式侦察(P2-2 用) ✅ 已查明:无盐 MD5 十六进制小写(经客户库实证)

产物:

  • 报告:本文件;真实实体权限对拍:parity-reports/realprivilege-parity-20260611-133334.{json,md}
  • 移植:platform-legacy-core/.../organize/service/*.java(5)+ common/*(7)
  • 现代层:platform-metadata/.../web/OrgController.java
  • 装配:platform-app/.../config/LegacyXmlWiring.java(增 4 impl setter 注入)
  • 对拍扩容:platform-parity/.../selfcheck/RealEntityPrivilegeRunner.java + ParityCli(--realprivilege)+ SelfCheckRunner.checkRows

二、移植清单(保真层 platform-legacy-core,包名原样,一行未改)

2.1 组织模块 impl(framework/com.dsasp.server.organize/src → platform-legacy-core 同包)

文件 行数 @Service 名 依赖装配方式
organize/service/OrganizationServiceImpl.java 212 organizationService setter(LegacyXmlWiring 补 pojoCRUDService + jdbcTemplate)
organize/service/UserFindServiceImpl.java 516 userFindService setter(pojoCRUDService + jdbcTemplate + organizationService)
organize/service/RoleServiceImpl.java 61 roleService jdbcTemplate 为 @Autowired(无需手工补)
organize/service/UserOtpServiceImpl.java 128 userOtpService setter(pojoCRUDService + jdbcTemplate);依赖 ft.otp.verify.OTPVerify
organize/service/AssignmentHandlerImpl.java 114 assignmentHandler setter(organizationService + userFindService)

Activator.java(54 行)未移植——OSGi BundleActivator,JDK17 无 OSGi 容器;bean 改由 @Service 名 + 组件扫描注册(手册 §5.17 先例),依赖经 LegacyXmlWiring 补 setter(手册 §4.1)。

2.2 依赖的 common 接口 / workflow bean(legacy-core 原无,本次随移植补齐)

文件 说明
common/organization/service/OrganizationService.java OrganizationServiceImpl 实现的接口
common/user/service/UserFindService.java UserFindServiceImpl 实现的接口
common/user/service/RoleService.java RoleServiceImpl 实现的接口
common/user/service/UserOtpService.java UserOtpServiceImpl 实现的接口
common/user/service/AssignmentHandler.java AssignmentHandlerImpl 实现的接口
common/workflow/service/ProcessDefinitionService.java AssignmentHandlerImpl 引用的流程定义常量(USER/ROLES/DEPART…分配类型)
common/workflow/bean/WFMould.java ProcessDefinitionService 引用的 bean(纯接口,无下游依赖)

依赖闭包核查:5 impl 的全部 com.dsasp.* import 经逐一比对均已在 legacy-core(CustomSearchConditional / GeneralPOJO / POJOCRUDService / StringUtil(含 convertListStrToSql/convertSplitStrToSql)/ UserSession / LoggedInUser / Position / ValidationException 等)。唯一外部依赖是 OTP 库(见三)。

2.3 privilege 模块剩余文件 diff 核查结论

逐一 diff framework/com.dsasp.server.privilege/src vs 仓库:

文件 仓库状态
service/DataPrivilegeServiceImpl.java 已在(C2 移植,差异仅 CRLF/LF)
service/FlowPrivilegeServiceImpl.java 已在(逐字节相同)
service/ServicePrivilege.java 已在(逐字节相同)
bean/DataFilterHelper.java 已在(C2 移植,差异仅行尾)
service/Activator.java(282 行) 未移植——OSGi/Vaadin BundleActivator,手册 §5.17 纪律

结论:privilege 模块除 OSGi Activator 外已全部在仓库,P2-1 无需再搬。


三、OTP 库依赖处置(jotpverify.jar)

  • UserOtpServiceImpl 依赖 ft.otp.verify.OTPVerify(动态令牌校验:ET_CheckPwdz201 / ET_Syncz201 / OTP_SUCCESS),原版在 framework/com.dsasp.server.organize/lib/jotpverify.jar,无公网 Maven 坐标。
  • 处置:置 jar 于 platform-legacy-core/local-libs/(标准 Maven repo 布局 ft/otp/jotpverify/1.0.0/),在 platform-legacy-core 模块 pom 加 file://${project.basedir}/local-libs 私有仓库 + 该依赖坐标。
  • 父 pom 不动:依赖仅落在模块 pom,坐标 + 私有仓库均模块自包含,构建可复现(随工程进版本库)。UserOtpServiceImpl 代码原样保留,一行未改。

四、装配:LegacyXmlWiring 补 setter 注入

framework 原 com.dsasp.server.organize/META-INF/spring/service.xml 用 <property> setter 注入(非 @Autowired),Boot 3 注解容器不自动装配。在 platform-app 的 LegacyXmlWiring(SmartInitializingSingleton)集中补齐(与手册 §4.1 同法,旧类零修改):

organizationService ← pojoCRUDService, jdbcTemplate
userFindService     ← pojoCRUDService, jdbcTemplate, organizationService
userOtpService      ← pojoCRUDService, jdbcTemplate
assignmentHandler   ← organizationService, userFindService
roleService.jdbcTemplate 是 @Autowired,无需手工补

逐项与原 service.xml 的 <property ref> 一一对照,语义等价。


五、现代层只读 REST:OrgController

platform-metadata/.../web/OrgController.java(@Tag + 每端点 @Operation,7 端点全进 OpenAPI):

端点 口径 底座
GET /api/org/user/{id} 按 ID 查用户(密码脱敏) 引擎 pojoCRUDService.loadPOJO 读 SYS_USER
GET /api/org/user/by-account/{account} 按账号查用户(密码脱敏) 引擎 listSelect 按 ACCOUNT 过滤
GET /api/org/user/by-depart/{departId} 按部门查在岗用户 SYS_POSITION→SYS_POSITIONUSER→SYS_USER(与 UserFindService 同源)
GET /api/org/orgs 组织(公司)列表 SYS_ORG 活跃
GET /api/org/depart-tree/{orgId} 某公司部门树(层级) 保真层 organizationService.getDepartTreeByOrgId + VIEW_DEPART_TREE level/parentId
GET /api/org/roles 角色列表 SYS_ROLE 活跃
GET /api/org/user/{id}/roles 用户-角色关系 保真层 roleService.findRolesByUserId(含 SYS_ROLE_ROLE 数据角色派生)
  • 只读:全经 ADMIN 上下文(管理视角元数据查询;行级过滤对拍由 §七真实实体权限对拍覆盖)。
  • 密码脱敏:用户行 PASSWORD 列一律置 ***,门面不外泄哈希。
  • 响应统一 amis 约定 {status:0,msg,data},与既有 EntityController 一致。
  • 写路径(分配角色、维护规则)P2-4 一起验,本控制器不含。

六、REST 实测(8085,客户库真实数据,逐一与 DB 直查对照)

服务以默认 profile 连客户库,hikari.read-only=true;每例 REST 结果与 psql 直查 ground truth 比对。

# 端点 REST 结果 DB 直查 判定
T1 GET /api/org/roles total=1531 count(*) sys_role isactive=1=1531 ✅
T2 GET /api/org/orgs total=25 count(*) sys_org isactive=1=25 ✅
T3 GET /api/org/depart-tree/{org} departCount=31,levels=[0,1] view_depart_tree(orgid)=31,max level=1 ✅(层级正确)
T4 GET /api/org/user/{u}/roles roleCount=360 引擎 findRolesByUserId 精确语义=360 ✅(见 §6.1 坑)
T5 GET /api/org/user/by-account/xuyx NAME=徐宇翔,PASSWORD=*** account=xuyx → 徐宇翔 ✅(脱敏)
T6 GET /api/org/user/{id} NAME=徐宇翔,PASSWORD=*** 同上 ✅(脱敏)
T7 GET /api/org/user/by-depart/{dep} total=317 部门→岗位→在岗用户 distinct=317 ✅

测试用真实 fixture:org=402881343826dc6f0138275606b50001、user=402881343826dc6f01382770a419002b(360 角色)/0d1208db-...(徐宇翔)、depart=18b6f4b0-...(317 人)。

6.1 [坑] 用户角色数(360)对账——userid 列长度不一致(36 padding vs 32)

T4 一度对账困难:sys_usergroupuser.userid 是 character varying 但数据混存两种长度——36 字符(空格补足,5101 行)与 32 字符(无补足,198 行)。引擎 findRolesByUserId 的 WHERE ugu.userid='<32位id>' 走 varchar =(不忽略尾空格),只匹配 32 位的非补足行 → 215 条 direct 角色;再经 SYS_ROLE_ROLE(OPERATORROLE IN 215)派生 145 → 列表共 360(含重)。用 DB 完整复现引擎两步 SQL = 360,逐字节一致。这是客户库历史数据质量不一致(同列两种 ID 表示),非移植缺陷;已记入手册 §5.29。


七、权限对拍扩容:真实实体只读权限对拍(--realprivilege)

7.1 背景与设计

原 PrivilegeCheckRunner 仅测 3 个 EIP4PT_* 种子实体(C2 自造规则)。本次新增真实实体只读权限对拍模式 RealEntityPrivilegeRunner + ParityCli --realprivilege:

  • 数据源:客户库真实 SYS_FILTERRULE 配置(SQL 摸底:SELECT entityid,count(*) FROM sys_filterrule WHERE isactive=1 GROUP BY 1 → 1079 条活跃规则,反查 tablename 得 PM_PAYMENTAPPLY(31)/VIEW_PM_CONTRACT(23)/HR_SAFETYCARD(13)… 等真实配置)。客户库确有现成规则,故走真实规则对拍(非仅 PrivilegeException 兜底)。
  • 正例:从真实规则发现可确定性复现等价 WHERE 的 (实体,用户,角色) 案例,真实用户 ctx(asUser+roles)驱动引擎行级过滤 vs JDBC 同语义 WHERE 逐行 diff(复用 C1/C2 的 RowDiff + 自对拍豁免内核 SelfCheckRunner.checkRows)。只挑两类可复现规则形态:
    • 空条件 [](「查看全部」角色)→ 引擎 (1=1) → 等价 WHERE 为「全表」;
    • [{USERID={CURRENTUSERID}}](「查看自己」)→ 引擎 P.USERID='<uid>' → WHERE userid='<uid>'。
    • 其余真实形态(KIND=N、{CURRENTUSERORGID} 子查询、OWNNERPROJECT 等)语义虽真实但等价 WHERE 重建脆弱,不纳入正例避免假阳性,如实登记。
  • 用户挑选纪律:仅当真实用户对该实体的全部交集规则都属可复现形态才取为正例(否则引擎 OR 进不可复现规则,等价 WHERE 不成立)。
  • 负例:无命中角色 ctx → 引擎 getWhereClause first 分支抛 PrivilegeException(HTTP 非 200)。只读构造 ctx,绝不向客户库写规则(任务红线)。

7.2 结果(2026-06-11,客户库真实规则,服务 8085 只读)

实体 活跃规则 正例规则形态 等价 WHERE 行数 逐行一致率 负例 HTTP 结果
HR_SAFETYCARD 13 view-all (全表) 199 1.0000 500 ✅
HR_OTHERCARD 7 view-all (全表) 478 1.0000 500 ✅
HR_EMPLOYEE 3 (无可复现形态案例,如实登记) — — — 500 —
HR_CONSTRUCTORCARD 7 view-all (全表) 120 1.0000 500 ✅
HR_MEMBERCARD 7 view-all (全表) 8 1.0000 500 ✅

汇总:可复现正例 4/4 全一致,总比对 805 行 100% 逐行一致(引擎真实规则行级过滤 == JDBC 同语义基线);负例 5/5 全部被拒(PrivilegeException → 500),印证「规则存在但无命中角色 → 拒绝」。退出码 0,全程未写客户库。

产物:parity-reports/realprivilege-parity-20260611-133334.{json,md}。


八、老系统密码哈希方式侦察结论(P2-2 登录用)

来源:framework 登录/改密代码(AuthConstroller.login、ChangePasswordView、EncryptUtil)+ 客户库密码列实证

项 结论
字段 SYS_USER.PASSWORD(character varying)
算法 MD5 十六进制,小写,无盐;等价 EncryptUtil.encodeMD5String(明文),与 PG md5(明文) 完全一致
格式 32 字符 ^[0-9a-f]{32}$(客户库 1854 行密码全部 32 位 hex;3 行空密码)
实证 SELECT account FROM sys_user WHERE trim(password)=md5('123456') → 命中真实账号(如 060020),即明文 123456 的 MD5 即库内存值 → 无盐、纯明文 MD5
登录校验 AuthConstroller.login:param.put("PASSWORD", EncryptUtil.encodeMD5String(明文)) + STATE=1 经 SYS_USER_SEARCH 流匹配(即存的就是 md5(明文),登录把输入明文 md5 后等值比较)
令牌 tokenid = EncryptUtil.encodeMD5String(SYS_USER_ID + PASSWORD)(即 md5(用户id + 密码哈希))
扫码登录 scanlogin:`md5(md5(sys_user_id

P2-2 落地口径:新登录服务校验密码 = EncryptUtil.encodeMD5String(用户输入明文).equalsIgnoreCase(SYS_USER.PASSWORD.trim()),STATE=1 为有效用户;无需迁移密码、无需加盐兼容(存量即无盐 MD5)。若 P2 要增强(加盐/bcrypt),须设「首次登录后升级哈希」迁移策略——存量库不可逆,只能渐进。


九、遇到的坑(已同步《eip4-platform/docs/迁移手册.md》)

  1. OTP 库无公网坐标(§九.OTP):jotpverify.jar 经模块内 local-libs 私有仓库解析,父 pom 不动。
  2. organize bean 是 XML setter 注入(§4.1 复用):4 impl 依赖经 LegacyXmlWiring 补,旧类零改。
  3. sys_usergroupuser.userid 列长度不一致(36 padding vs 32)(新增 §5.29):varchar = 不忽略尾空格,引擎 findRolesByUserId 只匹配同表示行;客户库历史数据质量不一致,非移植缺陷;对账须用引擎精确 SQL 复现。
  4. 真实数据权限规则形态多样(新增 §5.30):客户库 1079 条活跃规则含 KIND=N/{CURRENTUSERORGID} 子查询/OWNNERPROJECT 等,等价 WHERE 重建脆弱;真实实体权限对拍只纳入可确定性复现的 []/USERID={CURRENTUSERID} 形态做正例,其余如实登记,避免假阳性。

十、返回交付对照

任务要求 交付
移植编译通过,ArchUnit 绿,既有单测全绿 ✅ clean install 通过;ArchUnit 1/1;105 单测 0 失败
OrgController 用户查询/组织树/角色列表/用户-角色关系(只读 REST + OpenAPI) ✅ 7 端点 + OpenAPI
≥5 条真实组织数据 REST 实测,证据进报告 ✅ 7 例全 MATCH(§六)
权限对拍扩容:真实实体只读权限对拍 ✅ 4 实体 805 行 100% + 5/5 负例(§七)
密码哈希结论(P2-2 用) ✅ 无盐 MD5 hex,客户库实证(§八)
新坑进迁移手册 ✅ §5.29 / §5.30 / §九.OTP
git 只 add 自己的文件,≥3 提交 见提交记录
结束 kill 8085 ✅ 见末节