Files
eip4-platform/docs/P1/F2-13缺陷批次报告.md
2026-06-12 01:31:11 +08:00

124 lines
4.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-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 漂移。