From f563b472e6a4d661a87fc7fce0f8d0ebf22a1a5a Mon Sep 17 00:00:00 2001 From: zhengwr Date: Thu, 11 Jun 2026 16:27:49 +0800 Subject: [PATCH] =?UTF-8?q?P4-1=20=E8=BD=AC=E6=8D=A2=E5=99=A8=E7=BA=BF:?= =?UTF-8?q?=E6=89=A9=20EDITFORM/=E4=B8=BB=E5=AD=90=E8=A1=A8/=E6=A0=91/?= =?UTF-8?q?=E9=80=89=E6=8B=A9=E7=AA=97/=20=E6=AE=B5=20+=20?= =?UTF-8?q?=E5=85=A8=E9=87=8F=201516=20=E6=A8=A1=E6=9D=BF=E6=89=B9?= =?UTF-8?q?=E9=87=8F=E8=BD=AC=E6=8D=A2=E5=8F=8C=E9=97=B8=E5=88=86=E7=BA=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 转换器扩展(platform-converter,PoC crud 三段种子上): - 按 XML 根元素分派 crud/form/tree/report/group;ConversionResult+Grade 三级分级 - EDITFORM:form pageid 解析 view_page 取字段;主子表 EditGrid/FormEditGrid→input-table(子列取自 editgridtemplate) - 树:type=3 声明式→input-tree、type=4 引用式→flex(tree+crud) - 选择窗 SelectDialog/MultiSelectDialog→select+source(非 amis picker:picker 不在 6.13 schema 表单项 oneOf,闸一会拒) - A 类:crud+合计行(issummer→summaryFields)+金额列(ismoney→number);selectservice→/api/flow;JOR/图表降级标注 - UiTypeMapper 统一 uitype 映射;每决策登记映射台账(全量约 1.6 万条) - 孤儿模板(entityid 非法/空 xml)旁路标记不崩(手册 §7.4) 批量+双闸(BatchConvertCli,可独立 CLI 跑批,只读连库+5435 ceshi 库硬守门): - 闸一 SchemaGate(宽松语义预处理抽出,与 AmisSchemaController 共享):通过 98.2%(1489/1516) - 闸二 playwright+本地 amis SDK 渲染冒烟,每类型抽≥5:25/25 全过 - 产物 转换产物/(schema/*.json + 分级清单.csv + 闸二结果.json) - 失败 27 个全为空 xml 孤儿模板(库内数据问题,非转换器缺陷) 新坑进手册 §8.3(picker 不在表单项 oneOf,用 select+source) §8.4(闸二大 schema 经端点拉避 HTTP 431) 单测 24 个;全 reactor mvn test+ArchUnit 绿 报告 platform-converter/P4批量转换报告.md Co-Authored-By: Claude Fable 5 --- docs/迁移手册.md | 18 + platform-converter/P4批量转换报告.md | 173 + platform-converter/gate2-smoke/.gitignore | 2 + platform-converter/gate2-smoke/host.html | 43 + platform-converter/gate2-smoke/package.json | 7 + platform-converter/gate2-smoke/smoke.mjs | 142 + platform-converter/pom.xml | 4 + .../platform/converter/BatchConvertCli.java | 257 + .../platform/converter/ConversionGrade.java | 16 + .../platform/converter/ConversionResult.java | 76 + .../eip4/platform/converter/SchemaGate.java | 63 + .../converter/TemplateToAmisConverter.java | 617 +- .../eip4/platform/converter/UiTypeMapper.java | 196 + .../main/resources/amis-schema-6.13.0.json | 34161 ++++++++++++++++ .../converter/SchemaGateAndCliTest.java | 72 + .../TemplateToAmisConverterTest.java | 308 + platform-converter/转换产物/.gitignore | 3 + platform-converter/转换产物/分级清单.csv | 1517 + platform-converter/转换产物/闸二结果.json | 183 + .../metadata/web/AmisSchemaController.java | 56 +- 20 files changed, 37747 insertions(+), 167 deletions(-) create mode 100644 platform-converter/P4批量转换报告.md create mode 100644 platform-converter/gate2-smoke/.gitignore create mode 100644 platform-converter/gate2-smoke/host.html create mode 100644 platform-converter/gate2-smoke/package.json create mode 100644 platform-converter/gate2-smoke/smoke.mjs create mode 100644 platform-converter/src/main/java/com/eip4/platform/converter/BatchConvertCli.java create mode 100644 platform-converter/src/main/java/com/eip4/platform/converter/ConversionGrade.java create mode 100644 platform-converter/src/main/java/com/eip4/platform/converter/ConversionResult.java create mode 100644 platform-converter/src/main/java/com/eip4/platform/converter/SchemaGate.java create mode 100644 platform-converter/src/main/java/com/eip4/platform/converter/UiTypeMapper.java create mode 100644 platform-converter/src/main/resources/amis-schema-6.13.0.json create mode 100644 platform-converter/src/test/java/com/eip4/platform/converter/SchemaGateAndCliTest.java create mode 100644 platform-converter/src/test/java/com/eip4/platform/converter/TemplateToAmisConverterTest.java create mode 100644 platform-converter/转换产物/.gitignore create mode 100644 platform-converter/转换产物/分级清单.csv create mode 100644 platform-converter/转换产物/闸二结果.json diff --git a/docs/迁移手册.md b/docs/迁移手册.md index f6823c4..3bc9750 100644 --- a/docs/迁移手册.md +++ b/docs/迁移手册.md @@ -653,6 +653,24 @@ com.dsasp.* com.eip4.* | **对策** | **双闸缺一不可**:第一闸(schema 校验)抓结构问题;第二闸(headless 渲染冒烟,如 Puppeteer/Playwright 执行 `amis.embed`)抓渲染问题;P4 批量转换流水线必须两闸串联,两闸都过才入库 | | **影响范围** | P4 全量 1,516 模板转换流水线;AI 生成管线;MCP Server validate-schema(需升级为双闸);决策会已将「双闸」作为质量门禁第 2 条 | +### 8.3 amis `picker` 表单项不在 6.13 schema 的表单项 oneOf 中(弹窗选择器映射坑)[NEW 2026-06-11] + +| 栏目 | 内容 | +|------|------| +| **现象** | P4 批量转换把旧引擎 `uitype=SelectDialog` 弹窗选择器映射为 amis `picker` 控件后,**闸一 schema 校验大批失败**,错误为 `$.body.body: array found, object expected`(form 含 ≥3 表单项时爆发);但 picker 在浏览器实际能渲染 | +| **根因** | amis 6.13 官方 schema 中 `PickerControlSchema`(type const "picker")虽存在,但**未被纳入表单项的 oneOf 分支**;form.body 数组里出现 picker 时,校验器走不到 picker 分支、回落到把整个 form.body 当单对象(SchemaNode)的分支并报「array found, object expected」。这是 schema 枚举不全,非 schema 严格性问题 | +| **对策** | 弹窗选择器(SelectDialog/MultiSelectDialog)**映射为 `select` + 远程 `source`**(multiple 对应多选),而非 picker——select+source 双闸皆过且语义保真(弹窗本质是远程数据选择)。picker 需内嵌 pickerSchema(CRUD)、跨模板引用,本就无法在单模板转换内自洽。**实测此一项把闸一通过率从 94.7% → 98.2%** | +| **影响范围** | P4 转换器 uitype 映射表(已落 `UiTypeMapper`);任何把"弹窗选择"类旧控件转 amis 表单项的地方;AI 生成管线若生成 picker 表单项同样会被闸一拒,应优先用 select+source | + +### 8.4 闸二渲染冒烟宿主:大 schema 不可经 URL query 注入(HTTP 431 坑)[NEW 2026-06-11] + +| 栏目 | 内容 | +|------|------| +| **现象** | P4 闸二 playwright 渲染冒烟,个别大模板(字段多、schema 大)被误判「根组件未渲染出 DOM」;实为宿主 HTML 自身加载失败 | +| **根因** | 冒烟宿主把 schema JSON 经 `?schema=` 塞进 URL,大 schema 撑爆 HTTP 请求头,Node 静态服务器返回 **431 Request Header Fields Too Large**,host.html 根本没加载 | +| **对策** | schema 经**独立端点**(`/schema?id=<模板id>` 后端读文件返回)拉取,URL 只传短 id;宿主 `fetch('/schema?id=…')` 后再 `amis.embed`。改后该类模板渲染恢复正常(form 抽样 4/5 → 5/5) | +| **影响范围** | P4 闸二冒烟宿主(已修,见 `platform-converter/gate2-smoke/{host.html,smoke.mjs}`);任何用 query 串传 schema 给 headless 宿主的渲染验证脚本 | + --- ## 九、待补章节占位 diff --git a/platform-converter/P4批量转换报告.md b/platform-converter/P4批量转换报告.md new file mode 100644 index 0000000..47fa291 --- /dev/null +++ b/platform-converter/P4批量转换报告.md @@ -0,0 +1,173 @@ +# P4 批量转换报告(模板转换器扩展 + 全量批量转换 + 双闸分级) + +> 日期:2026-06-11 | 作者:platform-converter 工作线 +> 数据源:客户库 192.168.20.68:5435/postgres?currentSchema=eip3(ceshi/ceshi,**只读**) +> 工程:eip4-platform/platform-converter(JDK17) +> 前序:PoC 种子 `TemplateToAmisConverter`(display/search/button 三段,3 模板 0 错误已验证) +> 依据:docs/迁移手册.md §8(amis schema 宽松语义预处理、双闸必要性、dom4j getText)、 +> ../docs/决策与盘点/EIP3报表迁移方案.md(A 类报表=`` 段口径) + +--- + +## 一、一句话结论 + +全量 **1,516** 个 view_template 批量转换:**闸一(官方 schema 校验)通过率 98.2%(1489/1516)**; +闸二(headless 渲染冒烟,每类型抽 ≥5)**25/25 全通过**。 +未过闸一的 27 个全部是 **xml 为空的孤儿模板**(库内数据问题,非转换器缺陷),转换器对其旁路标记不崩。 +通过率数字 98.2% 即检查点②(首功能点切流)的输入。 + +--- + +## 二、总量与各类型分布 + +模板按 XML 根元素分派转换(根元素与 view_template.type 一一对应): + +| 根元素 | 类型语义 | 总量 | 闸一通过 | 通过率 | SUCCESS | PARTIAL | FAILED | +|--------|---------|-----:|--------:|------:|--------:|--------:|-------:| +| crud | GRID 列表页 | 956 | 956 | 100.0% | 259 | 697 | 0 | +| report | A 类表格式报表 | 337 | 337 | 100.0% | 0 | 337 | 0 | +| tree | 树 / 树+grid | 106 | 106 | 100.0% | 0 | 106 | 0 | +| form | EDITFORM 表单页 | 70 | 70 | 100.0% | 0 | 70 | 0 | +| group | 分组容器 | 20 | 20 | 100.0% | 0 | 20 | 0 | +| (空 xml) | 孤儿模板 | 27 | 0 | 0.0% | 0 | 0 | 27 | +| **合计** | | **1516** | **1489** | **98.2%** | **259** | **1230** | **27** | + +> 分级口径: +> - **SUCCESS**:全字段命中映射规则,无降级标注,闸一通过。 +> - **PARTIAL**:转出有效 amis schema 且闸一通过,但有字段/特性走降级旁路(标注在映射台账)。 +> - **FAILED**:无法转出(xml 为空 / 解析失败 / 根元素不支持),不入产物只入失败清单。 +> +> report/tree/form/group 全部落 PARTIAL 是设计内:report 普遍含 JOR 套打版式(C 类不迁移)、 +> tree 普遍含节点级按钮、form 普遍含 SelectDialog/自定义 HTML 版式、group 全为跨模板壳—— +> 这些都是「能渲染、待后端/人工补」的降级,不是错误。 + +--- + +## 三、双闸结果 + +### 闸一:官方 schema 校验(amis-schema-6.13.0.json,draft-07) + +- 通过 **1489/1516 = 98.2%**。 +- 复用迁移手册 §8.1 的**宽松语义预处理**(递归剥除 `$ref` 节点的兄弟 `additionalProperties:false`), + 实现抽到 `platform-converter/SchemaGate`,与 `AmisSchemaController` 共享同一份口径(消除 metadata 侧重复实现)。 +- 失败 27 个全部因 xml 为空,无 schema 可校验。 + +### 闸二:headless 渲染冒烟(playwright + 本地 amis SDK 6.13.0) + +口径:对每个模板类型从**闸一通过**的 schema 中抽 **≥5** 个,用本地 amis SDK(`../eip4-poc/.../sdk-local/`)+ +无头 chromium 逐个 `amis.embed` 渲染,判定 ① 无未捕获 JS 错误 ② 根组件渲染出 DOM(#root 有子节点)。 +数据接口全部桩成空响应(冒烟只验「能渲染根组件」,不验数据)。**全量渲染不要求——本闸是抽样冒烟。** + +| 类型 | 抽样 | 通过 | 失败 | +|------|----:|----:|----:| +| crud | 5 | 5 | 0 | +| report | 5 | 5 | 0 | +| tree | 5 | 5 | 0 | +| form | 5 | 5 | 0 | +| group | 5 | 5 | 0 | +| **合计** | **25** | **25** | **0** | + +> 闸二坑(已修,记入手册):大 schema 经 URL query 注入触发 **HTTP 431 (Request Header Fields Too Large)**, +> 误判为「根组件未渲染」。改为 schema 经独立 `/schema?id=` 端点拉取后,form 抽样从 4/5 → 5/5。 + +产物:`转换产物/闸二结果.json`(含逐样本判定)。 + +--- + +## 四、失败模式 Top10(按模板计,去重原因) + +| # | 模板数 | 归类 | 模式 | +|---|------:|------|------| +| 1 | 937 | 转换器缺陷(待补能力) | search 字段 uitype=SelectDialog → select+source 占位(弹窗数据源 /api/picker 待后端实现) | +| 2 | 329 | C 类设计内不迁移 | report 含 reportfile(JOR 套打版式)→ 仅转表格视图,套打另案 univer/Web 打印 | +| 3 | 138 | 转换器缺陷(待补能力) | search 字段 uitype=MultiSelectDialog → select(multiple)+source 占位 | +| 4 | 69 | 模板版式 | form 含 HTML `` 自定义表格版式 → amis 默认纵向布局替代,版式需人工核对 | +| 5 | 61 | 转换器缺陷(待补能力) | tree 节点含 buttons(增删改保存)→ input-tree 不原生支持节点级按钮,需自定义工具栏 | +| 6 | 50 | 转换器缺陷(待补能力) | editform 字段 uitype=SelectDialog → select+source 占位 | +| 7 | 41 | 转换器缺陷(待补能力) | editform 字段 uitype=MultiFileUploadField → 暂映射 input-text(映射表待补该控件) | +| 8 | 27 | **模板数据问题** | xml 为空(孤儿模板,FAILED) | +| 9 | 26 | 主子表已支持 | editform 字段 uitype=EditGrid → input-table 子表(保存联动 updateSubTable 待后端) | +| 10 | 20 | 跨模板引用 | group 分组容器仅转 tabs 壳,各 tab 子模板需跨模板联动加载 | + +**三桶归类(按模板计)**: + +| 桶 | 模板数 | 说明 | +|----|------:|------| +| 转换器缺陷(待补能力) | 1228 | 绝大多数是 SelectDialog→数据源未联动、JOR 套打、跨模板引用等「schema 有效、待后端/人工补」项,**非渲染缺陷** | +| 模板数据问题 | 28 | xml 为空(27)+ 个别解析问题,库内存量数据缺陷 | +| 孤儿模板(entityid 非法) | 5 | entityid 在 SYS_ENTITY 无对应实体(迁移手册 §7.4),转换器旁路标记不崩 | + +> 关键判读:「转换器缺陷」桶 1228 个里,**937+138+50=1125 个其实是同一件事**——SelectDialog/MultiSelectDialog +> 弹窗数据源 `/api/picker/{dialogid}/list` 尚未由后端实现。schema 本身有效且渲染通过,属「待联动」而非「转不出」。 +> 真正需要补转换器映射规则的只有 MultiFileUploadField(41)等少数控件。 + +--- + +## 五、转换器扩展明细(PoC 种子 → P4) + +在 PoC 已验证的 crud 三段(display/search/button)上扩出五类根元素分派: + +| 段 | 旧形态 | amis 映射 | 备注 | +|----|--------|----------|------| +| **crud** | `` | crud columns | 强化 null-safe、金额列(ismoney)→number+千分位、对齐、top-level+display 双挂 button | +| **EDITFORM** | `
` + view_page 的 `` | form + body items | 字段经 pageid 解析 view_page 取得;method→form actions | +| **主子表** | form 内 `uitype=EditGrid/FormEditGrid` | **input-table** + 子列 | 子列解析 `` CDATA 内 `` | +| **树** | `` / `` | input-tree / flex(tree+crud) | type=3 声明式 / type=4 引用式两路 | +| **picker(选择窗)** | `uitype=SelectDialog/MultiSelectDialog` | **select + 远程 source** | 不用 amis picker——picker 需内嵌 pickerSchema 且 6.13 schema 未纳入表单项 oneOf,闸一会拒(§8.2);select+source 双闸皆过,更保真 | +| **``(A 类)** | `` | crud + 合计行/金额列 | issummer=true→summaryFields、ismoney→number;selectservice→`/api/flow/{id}`;JOR reportfile/图表降级标注(B/C 类另案) | +| **group** | `