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>
16 KiB
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 → 引擎
getWhereClausefirst 分支抛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》)
- OTP 库无公网坐标(§九.OTP):
jotpverify.jar经模块内local-libs私有仓库解析,父 pom 不动。 - organize bean 是 XML setter 注入(§4.1 复用):4 impl 依赖经 LegacyXmlWiring 补,旧类零改。
sys_usergroupuser.userid列长度不一致(36 padding vs 32)(新增 §5.29):varchar=不忽略尾空格,引擎findRolesByUserId只匹配同表示行;客户库历史数据质量不一致,非移植缺陷;对账须用引擎精确 SQL 复现。- 真实数据权限规则形态多样(新增 §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 | ✅ 见末节 |