diff --git a/docs/P1/F2-13缺陷批次报告.md b/docs/P1/F2-13缺陷批次报告.md new file mode 100644 index 0000000..221e389 --- /dev/null +++ b/docs/P1/F2-13缺陷批次报告.md @@ -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 漂移。