From 002086c82faa7bf9915d93e7f8539eb8241b9aff Mon Sep 17 00:00:00 2001 From: zhengwr Date: Fri, 12 Jun 2026 01:31:11 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E9=98=B6=E6=AE=B5=E6=8A=A5=E5=91=8A?= =?UTF-8?q?=E5=BD=92=E4=BD=8D=20eip4-platform/docs/P1(=E6=B2=BB=E7=90=86?= =?UTF-8?q?=E6=A1=A3=E6=A1=88=E7=BB=9F=E4=B8=80=E4=BB=93=E5=BA=93)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- docs/P1/F2-13缺陷批次报告.md | 123 ----------------------------------- docs/P1/F2-7审批UI报告.md | 90 ------------------------- 2 files changed, 213 deletions(-) delete mode 100644 docs/P1/F2-13缺陷批次报告.md delete mode 100644 docs/P1/F2-7审批UI报告.md diff --git a/docs/P1/F2-13缺陷批次报告.md b/docs/P1/F2-13缺陷批次报告.md deleted file mode 100644 index 221e389..0000000 --- a/docs/P1/F2-13缺陷批次报告.md +++ /dev/null @@ -1,123 +0,0 @@ -# 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 漂移。 diff --git a/docs/P1/F2-7审批UI报告.md b/docs/P1/F2-7审批UI报告.md deleted file mode 100644 index 8ff4b06..0000000 --- a/docs/P1/F2-7审批UI报告.md +++ /dev/null @@ -1,90 +0,0 @@ -# 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 清理。