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>
This commit is contained in:
2026-06-11 13:39:17 +08:00
parent 8d1d2ab0f7
commit 82f52c1114
5 changed files with 705 additions and 0 deletions

View File

@@ -0,0 +1,210 @@
# 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 || repeat(' ',36-char_length(sys_user_id)) || password)) = md5(tokenid)`——注意 **id 在拼接前补足到 36 位空格**(与本报告 §6.1 的 userid padding 同源约定) |
**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 | ✅ 见末节 |