Files
eip4-platform/docs/P1/F2-7审批UI报告.md
2026-06-12 01:31:11 +08:00

91 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 清理。