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

211 lines
16 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 | ✅ 见末节 |