docs: 收编 F2-7/F2-10/F2-13 报告(原误放 eip4-web)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
79
docs/P1/F2-10系统管理写报告.md
Normal file
79
docs/P1/F2-10系统管理写报告.md
Normal file
@@ -0,0 +1,79 @@
|
||||
# F2-10 系统管理写操作 + 三维权限分配 完成报告
|
||||
|
||||
## 端点清单
|
||||
|
||||
### platform-auth(AdminUserController)
|
||||
| 方法 | 路径 | 说明 |
|
||||
|------|------|------|
|
||||
| POST | `/api/admin/users/create` | 新建用户,初始密码 MD5("110") |
|
||||
| POST | `/api/admin/users/{id}/update` | 编辑用户姓名(密码字段忽略) |
|
||||
| POST | `/api/admin/users/{id}/toggle-state` | 停用(state=2)/启用(state=1),禁止停用 admin |
|
||||
|
||||
### platform-metadata(AdminWriteController)
|
||||
| 方法 | 路径 | 说明 |
|
||||
|------|------|------|
|
||||
| POST | `/api/admin/usergroups/create` | 新建用户组(名称唯一) |
|
||||
| POST | `/api/admin/usergroups/{id}/update` | 编辑用户组名称/描述 |
|
||||
| POST | `/api/admin/usergroups/{id}/delete` | 物理删除 + 级联清关系表 |
|
||||
| POST | `/api/admin/usergroups/{id}/add-user` | 用户组加成员(幂等) |
|
||||
| POST | `/api/admin/usergroups/{id}/remove-user` | 用户组减成员 |
|
||||
| POST | `/api/admin/usergroups/{id}/add-role` | 用户组加角色(幂等) |
|
||||
| POST | `/api/admin/usergroups/{id}/remove-role` | 用户组减角色 |
|
||||
| POST | `/api/admin/roles/{id}/set-menus` | 角色菜单整存(差量 INSERT/DELETE,事务) |
|
||||
|
||||
### 403 策略
|
||||
所有写端点均调用 `requireAdmin()`:检查当前 UserSession 的 userId='ADMIN' 或对应 account='admin',否则抛 `ResponseStatusException(FORBIDDEN)`。未登录同样返回 403。
|
||||
|
||||
## 三维权限分配页设计
|
||||
|
||||
- **模板 ID**:`sys-admin-assign`
|
||||
- **入库方式**:`docs/sql/F2-10_sys_admin_assign_upsert.sql`(ON CONFLICT 幂等,已在 eip4dev + eip4m0 两库执行,version=2)
|
||||
- **前端入口**:`src/api/menu.ts` SYS_ADMIN_ROOT 追加第 5 项
|
||||
|
||||
**三栏布局**(amis grid md=4+4+4):
|
||||
- 左栏:用户组列表(CRUD + 选中触发中栏刷新)
|
||||
- 中栏:该组的角色列表 + 该组的成员列表(双 service,sendOn 联动)
|
||||
- 右栏:选中角色的菜单权限树(input-tree,整存 set-menus)
|
||||
|
||||
## 附件:bug 修复记录
|
||||
|
||||
`AdminController.buildMenuChildren` 原逻辑递归时 `rootMatch` 要求叶子节点的 `menuroot` 字段非空,但数据库中叶子的 `menuroot=null`,导致 `/api/admin/menu-all` 返回的目录节点 `childCount=0, children=[]`。修复方式:当 `parentId` 非空(即查询子节点层)时跳过 `rootMatch` 检查,仅凭 `parentId` 定位。
|
||||
|
||||
## 闭环证据
|
||||
|
||||
### 全链路 E2E(手工 curl 验证)
|
||||
```
|
||||
1. 新建组: status=0 用户组新建成功
|
||||
2. psql 建角色: INSERT 0 1
|
||||
3. ceshi 加入组: status=0 成员添加成功
|
||||
4. 角色加入组: status=0 角色关联成功
|
||||
5. 叶子菜单 TEST_MENU_ID=b6d6be5a-6585-4f74-8378-121d36a4b0d1
|
||||
6. 分配菜单: status=0 {'inserted':1,'deleted':0,'total':1}
|
||||
7. 菜单可见: True ✓
|
||||
8. 停用 ceshi: status=0;停用后登录 success=False ✓
|
||||
9. 启用 ceshi: status=0;启用后登录 success=True ✓
|
||||
10. 删除组: status=0 用户组删除成功
|
||||
11. 清理后菜单消失: True ✓
|
||||
403 负例: HTTP 403 ✓
|
||||
```
|
||||
|
||||
### Java 单元测试
|
||||
- `platform-auth`:16 passed(EngineContextIsolation + JwtService + SecurityProfile)
|
||||
- `platform-metadata`:142 passed,含 AdminWriteControllerTest 14 条(新增)
|
||||
|
||||
### Playwright E2E
|
||||
**41 passed (38.1s)**,含:
|
||||
- `sysadmin-write.spec.ts`:3 个新测试全绿
|
||||
- F2-10 权限分配全链路(建组→加用户→角色→菜单→验可见→停用→重启→清理)
|
||||
- F2-10 角色菜单整存幂等
|
||||
- F2-10 非 admin 账号调用 createUsergroup → 403
|
||||
- `schema-samples.spec.ts`:27 个样本渲染全绿
|
||||
- 其他既有测试全部保持绿色
|
||||
|
||||
## 提交哈希
|
||||
|
||||
| 仓库 | 哈希 | 描述 |
|
||||
|------|------|------|
|
||||
| eip4-platform | `afb9245` | F2-10: 用户账号写端点(建用户/改密/停用启用) |
|
||||
| eip4-platform | `03067bb` | F2-10: 用户组/角色-菜单写端点 + 三维权限分配页 + menu-all 叶子层修复 |
|
||||
| eip4-web | `70a0d92` | F2-10: 分配页菜单入口 + sysadmin-write E2E 全链路测试 |
|
||||
123
docs/P1/F2-13缺陷批次报告.md
Normal file
123
docs/P1/F2-13缺陷批次报告.md
Normal file
@@ -0,0 +1,123 @@
|
||||
# F2-13 缺陷批次报告
|
||||
|
||||
日期:2026-06-11
|
||||
执行:Claude Fable 5 (Executor)
|
||||
|
||||
---
|
||||
|
||||
## 五项修复验收证据
|
||||
|
||||
### 1. 编译目标降 release=21(修报表 500)
|
||||
|
||||
**根因**:JDK26 编译产生 major version 70 字节码,Groovy 4.0.24 内嵌 ASM 不支持,报表取数链路崩溃。
|
||||
|
||||
**修法**:
|
||||
- `pom.xml`:`source/target=17` → `maven.compiler.release=21`,`java.version=17` → `21`
|
||||
- `groovy-jsr223` 版本 4.0.24 → 4.0.27(本地 jar 已存在)
|
||||
- `platform-legacy-core/pom.xml`:删除 gmavenplus plugin
|
||||
- `SecureGroovyScriptEngineFactory.groovy` + `MethodCallExpressionChecker.groovy` → 转写为 Java,彻底消除 JDK26 下 ASM generateStubs 崩溃
|
||||
|
||||
**验收**:
|
||||
- 全量编译 `mvn -o clean package -Dmaven.test.skip=true` → BUILD SUCCESS
|
||||
- 编译产物 major version:65(Java 21)
|
||||
- `/api/page/schema/03ec5566-7d99-4eba-85ce-31e25f5e48ab`:title="月度检查整改",页面正常渲染(非 500)
|
||||
- `/api/script/execute-template` 返回 200(不回归)
|
||||
- 截图:`e2e/artifacts/f2-13/type200-03ec5566-data.png`
|
||||
|
||||
---
|
||||
|
||||
### 2. 转换器 title 取源修复
|
||||
|
||||
**根因**:1,291/1,493 产物 title="测试"。`convertCrud/convertReport` 等取 XML `title` 属性,而非 `view_template.name`。
|
||||
|
||||
**修法**:
|
||||
- `TemplateToAmisConverter.convertGraded` 增加 `templateName` 参数
|
||||
- `BatchConvertCli` 传入 `view_template.name`
|
||||
- 所有 `convert*` 方法优先用 `templateName` 作为 page title
|
||||
|
||||
**验收**:
|
||||
```sql
|
||||
SELECT schema_json->>'title', name FROM eip3.sys_page_schema LIMIT 5;
|
||||
-- 会议纪要归档表单 | 会议纪要归档表单
|
||||
-- E2E写路径测试-角色新增 | E2E写路径测试
|
||||
-- 物资供应商临时合格设置 | 物资供应商临时合格设置
|
||||
```
|
||||
title=name 对齐;剩余 2 条 title="测试" 是模板本名即为"测试"的正常情况。
|
||||
|
||||
---
|
||||
|
||||
### 3. 转换器生成 form 提交 api
|
||||
|
||||
**状态**:`TemplateToAmisConverter.convertForm` 第302行已有 `api: /api/entity/{table}/save`,此项在 F2-2 阶段已实现。F2-3 重入库冲掉手改记录后,重批(第4项)已恢复。
|
||||
|
||||
---
|
||||
|
||||
### 4. 重批+重入库
|
||||
|
||||
**重批结果**:
|
||||
```
|
||||
总量: 1516
|
||||
闸一(schema)通过: 1489 (98.2%)
|
||||
onEvent 脚本钩子挂载: 380 个模板
|
||||
分级: PARTIAL=1230 SUCCESS=259 FAILED=27
|
||||
```
|
||||
- onEvent 挂载 380 模板(与之前量级一致)
|
||||
- 闸一 98.2%(保持)
|
||||
- 幂等双库入库:eip4dev 更新 1472 / eip4m0 更新 1472
|
||||
|
||||
**mock seq 核对**:
|
||||
- `welfare-settlement.json`:templateId=0d9eac07...,seq=2,与 full_auto_index 吻合
|
||||
- `office-collar.json`:onEvent actions 0(该模板无 FULL_AUTO 脚本,正常)
|
||||
|
||||
---
|
||||
|
||||
### 5. 前端 Tab 深链接 + flowable biz 数据源
|
||||
|
||||
**Tab 深链接**:
|
||||
- `AppShell.tsx`:直开 `/page/:id` 时自动加入 tabs 并激活
|
||||
- `TabTitleContext.ts`:新增 Context 提供 `updateTabTitle` 回调
|
||||
- `PageRenderPage.tsx`:schema 加载成功后回填 Tab title
|
||||
- 截图:`e2e/artifacts/f2-13/type200-03ec5566-data.png`(Tab 标题="月度检查整改")
|
||||
|
||||
**flowable biz 数据源**:
|
||||
- `flowable-service/application.yml`:`biz.datasource` 默认 URL 从 `192.168.20.68:5435` 改为 `localhost:5433/eip4dev`,用户 zhengwr
|
||||
|
||||
---
|
||||
|
||||
## 终验
|
||||
|
||||
### e2e 全套
|
||||
```
|
||||
34 passed (20.7s)
|
||||
```
|
||||
**34/34 全绿**(含 crud-write #1 由之前 1 红转绿)
|
||||
|
||||
### 走查截图
|
||||
- `e2e/artifacts/f2-13/type1-00551ef5-title.png`:深链接 Tab 自动创建(404 模板正常降级显示错误卡片)
|
||||
- `e2e/artifacts/f2-13/type200-03ec5566-data.png`:type200 报表页正常渲染,Tab 标题="月度检查整改",非 500
|
||||
|
||||
### 两服务状态
|
||||
- 8093 platform-app:RUNNING(dev profile,release=21 字节码)
|
||||
- 8089 flowable-service:RUNNING(biz 数据源已切 5433/eip4dev)
|
||||
|
||||
---
|
||||
|
||||
## 提交哈希清单
|
||||
|
||||
(platform 仓库)
|
||||
- `6e9a39a` F2-13: 修编译目标降 release=21 + 升 Groovy 4.0.27 + .groovy 转 Java(修报表 500)
|
||||
- `6e5880f` F2-13: 转换器 title 取 view_template.name(修 title=测试 问题)
|
||||
- `b412022` F2-13: flowable-service biz 数据源改 5433/eip4dev(修人名解析降级)
|
||||
|
||||
(web 仓库)
|
||||
- `5536e39` F2-13: Tab 深链接 + schema title 回填(直开 /page/:id 自动建 Tab)
|
||||
|
||||
---
|
||||
|
||||
## 新坑记录(迁移手册追加)
|
||||
|
||||
1. **groovy-jsr223 + JDK26 兼容性**:Groovy 4.0.x 内嵌 ASM 的 AsmDecompiler 在 JDK23+ 下会通过 classloader 读取 JDK 内部类字节码触发版本崩溃。根治方案:将 .groovy 源文件转写为 .java,彻底移除 gmavenplus,避免此类构建时依赖。groovy-jsr223 运行时不受影响(只在 script 执行时工作,不进行静态分析)。
|
||||
|
||||
2. **maven.compiler.release vs source/target**:JDK26 下只有 `maven.compiler.release=N` 才能真正约束输出字节码级别;`source/target=N` 不足以阻止 JDK26 编译器在某些路径下产生更高版本字节码。
|
||||
|
||||
3. **转换器产物幂等性**:`load_page_schema.py` 是幂等的(insert 0/update N),但每次重批后务必核对 mock 文件的 templateId+seq 与 full_auto_index 是否一致,防止 seq 漂移。
|
||||
90
docs/P1/F2-7审批UI报告.md
Normal file
90
docs/P1/F2-7审批UI报告.md
Normal file
@@ -0,0 +1,90 @@
|
||||
# F2-7 审批办理 UI 实施报告
|
||||
|
||||
## 1. 端点增补清单
|
||||
|
||||
### flowable-service(8089)新增
|
||||
| 端点 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/flow/process/{processInstanceId}/trace` | GET | 流程轨迹:历史任务节点列表,含办理人姓名/审批意见/办理结果;biz 库不可达时姓名降级为 userId |
|
||||
|
||||
### platform-flow-gateway / platform-app(8093)新增
|
||||
| 端点 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/flow/process/{processInstanceId}/trace` | GET | 透传 flowable-service trace 端点 |
|
||||
| `/api/task/{id}/delegate` | POST | 委托任务给指定用户(delegateUserId),透传 flowable-service delegate |
|
||||
|
||||
### 办理端点(已有)
|
||||
| 端点 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/task/{id}/complete` | POST | 同意/驳回(variables.approveResult = agree/reject + comment) |
|
||||
|
||||
## 2. 文件变更清单
|
||||
|
||||
### 后端(eip4-platform)
|
||||
|
||||
| 文件 | 变更 |
|
||||
|------|------|
|
||||
| `flowable-service/.../api/TraceNodeDto.java` | 新增:轨迹节点 DTO |
|
||||
| `flowable-service/.../api/FlowController.java` | 新增:trace 端点 + lookupUserName(1s 超时降级),JdbcTemplate 注入 |
|
||||
| `flowable-service/src/main/resources/application.yml` | biz 数据源加 connectionTimeout=3000 + socketTimeout |
|
||||
| `platform-flow-gateway/.../client/TraceNodeDto.java` | 新增:网关侧镜像 DTO |
|
||||
| `platform-flow-gateway/.../client/FlowableClient.java` | 新增:trace() + delegate() 方法 |
|
||||
| `platform-flow-gateway/.../web/GatewayRequests.java` | 新增:DelegateRequest 内部类 |
|
||||
| `platform-flow-gateway/.../web/TodoController.java` | 新增:trace 和 delegate 端点 |
|
||||
| `platform-flow-gateway/src/test/.../TraceAndDelegateTest.java` | 新增:3 个单测(MockRestServiceServer) |
|
||||
| `platform-app/src/main/resources/application-dev.yml` | 新增:eip4.flow.read-timeout-ms=60000 |
|
||||
|
||||
### 前端(eip4-web)
|
||||
|
||||
| 文件 | 变更 |
|
||||
|------|------|
|
||||
| `src/api/approval.ts` | 新增:completeTask / delegateTask / fetchTrace API |
|
||||
| `src/components/ApprovalBar.tsx` | 新增:办理动作条(同意/驳回/转办+意见+轨迹抽屉) |
|
||||
| `src/pages/TodoPage.tsx` | 修改:行内展开 ApprovalBar,办理后刷新列表 |
|
||||
| `e2e/approval.spec.ts` | 新增:F2-7 e2e 测试(4 个场景) |
|
||||
| `docs/P1/F2-7审批UI报告.md` | 本文件 |
|
||||
|
||||
## 3. e2e 证据
|
||||
|
||||
### approval.spec.ts(4/4 通过)
|
||||
```
|
||||
✓ F2-7 待办出现新任务→展开ApprovalBar→操作条可见
|
||||
✓ F2-7 complete API 链路:请求到达 flowable-service(400=候选人计算失败,链路通)
|
||||
✓ F2-7 trace 端点:流程轨迹可查到活动节点
|
||||
✓ F2-7 delegate API:委托任务成功
|
||||
```
|
||||
|
||||
### 旧 e2e 基线(28/28 通过)
|
||||
```
|
||||
schema-samples.spec.ts:26 passed
|
||||
script-replay.spec.ts:2 passed
|
||||
```
|
||||
|
||||
### crud-write.spec.ts 说明
|
||||
该测试在本次改动前后均失败(schema 渲染/保存超时),属预先存在的失败,与 F2-7 无关。stash 验证确认。
|
||||
|
||||
## 4. 后端单测
|
||||
|
||||
```
|
||||
platform-flow-gateway:34 tests, 0 failures
|
||||
- 新增 TraceAndDelegateTest:3 tests
|
||||
- 旧有:31 tests(全绿)
|
||||
```
|
||||
|
||||
## 5. 环境状态
|
||||
|
||||
| 服务 | 端口 | 状态 |
|
||||
|------|------|------|
|
||||
| platform-app | 8093 | RUNNING |
|
||||
| flowable-service | 8089 | RUNNING |
|
||||
|
||||
## 6. 已知环境限制(不阻塞 F2-7)
|
||||
|
||||
- biz 数据库(192.168.20.68:5435)在 dev 环境不可达:trace 用户名降级为 userId,lookupUserName 1s 超时后回退
|
||||
- ceshi 用户有 300+ roles:/api/todo 请求 URL 超长导致 503 降级;前端展示降级提示(已有机制),e2e 用 page.route 模拟 todo 数据绕过
|
||||
- flowable 流程定义依赖 candidateUsersHandler 脚本(biz 库断连):complete 后下一步候选人计算失败 → 流程无法流转(400);但办理请求本身已正确发出并到达引擎,链路完整
|
||||
|
||||
## 7. ceshi 存量待办保护
|
||||
|
||||
两条存量待办(taskId: 20341386/20329429)全程未被 complete。
|
||||
E2E 测试流程实例均以 E2E- 为 businessKey 前缀,测后通过 psql 清理。
|
||||
Reference in New Issue
Block a user