Files
eip4-platform/docs/归档/转换器覆盖度审计-2026-06-13.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:53:29 +08:00

11 KiB
Raw Permalink Blame History

转换器覆盖度审计(view_template / view_page × amis 转换器)

日期:2026-06-13 方法:数据驱动主动盘点——按模板 type、编辑表单 uitype、编辑表单结构、运行时端点四维,把源数据存量对照转换器实际分支与运行时可达性,找出尚未被动撞到的缺口。 触发:TreeGrid 三轮修复中暴露「编辑表单未迁移/juel 引擎缺口」后,主动系统盘点(4 个并行审计 agent + 浏览器/curl 抽验 + 代码核对)。 数据库:localhost:5433/eip4dev(schema eip3);转换器:platform-converter;产物:platform-converter/转换产物/schema/*.json(1489)。 ⚠️ 本文是缺口清单,不替代 EIP4-架构与缺口现状-2026-06-13.md(权威状态视图);本文结论按影响面/优先级排序于 §五。


一、模板类型覆盖(view_template 1516,dispatch 全有分支)

type root 量 转换器分支 判定 缺口(SQL 计数证据)
1 crud 858 convertCrud ⚠️ 835 入库;列表主链路 OK。隐性缺口=script/onload/filter 事件静态跳过(见 §三 3.2、§四)
3 tree 50 convertTree ⚠️ 声明式多级树仍走 selectservice 占位、未接 /api/template/{ref}/tree(53 页,§已知)
4 treegrid 45 convertTree→convertTreeGrid ✅ 本项三轮已修(树高度/子树聚合/按钮/删除);添加改待 juel
5 crud 2 convertCrud 🔴 语义错误 两条都是日历视图被转成普通 crud 表格:单个员工排班(HR_SCHUSERSCHEDULE,DoublePopupDateField+班次颜色+日历网格)、查看会议室调度(服务名含 _Calendar_)。应映射 amis calendar/fullcalendar,当前不可用
6 group 20 convertGroup ⚠️ 占位 20/20 产物是 tabs,每 tab body=tpl"子模板待跨模板联动加载",100% 占位。但引用的 62 个子模板 62/62 已各有独立产物——只需前端 tabs 切换时按 tempid 拉 /api/page/schema/{tempid} 即可激活,非转换器缺口、属前端路由活
7 form 70 convertForm ⚠️ 有 type=7 包壳的编辑表单可渲染;script 联动死逻辑、复杂子表后端联动待接
100/101 crud/tree 132 convertCrud/Tree ⚠️ 冗余死页 130 入库但菜单关联=0(不可直达);运行时选择由 /api/picker/{dialogid}/list 承接、不读这些 schema。转换它们目前无消费方——待决策:停转 or 留给 F4 低代码弹窗预览
200 report 339 convertReport ⚠️ A 类表格 ~324 可渲染(合计列已登记,聚合靠后端);B 类图表 ischart=true 4 条降级纯表格(ECharts 未平移);C 类 JOR 套打版式丢失(另案 univer/Web 打印,§已知)

FAILED:27 个 null-xml(空 XML 孤儿,无法转,§已知)。


二、编辑表单字段控件覆盖(view_page 1241,UiTypeMapper)

编辑表单整体尚未迁移入库(已知遗留②);本节审「一旦迁移,控件够不够用」。

uitype 量 分支 判定 缺口
TextField 6929 input-text ✅ —
SelectDialog 3663 picker / 降级 select ⚠️ 顶层 96.7% 无 dialogid(2811/2906)→ 落空源 select;仅 95 条走 picker
NumberField 3124 input-number ✅ —
ComboBox 2665 select+dict / 降级 ⚠️ 339 条无 comboboxid 且非枚举(查询服务型)→ SOURCE_EMPTY 空 select
PopupDateField 2219 input-date/datetime ✅ 有无时分秒自动区分
TextArea 1310 textarea ✅ —
MultiFileUploadField 608 input-file(multiple) ✅ —
EditGrid 508 input-table + buildEditGridColumns ⚠️ 子表退化 子表列硬写 input-text,不递归 UiTypeMapper:子表内 SelectDialog(431/508)/ComboBox(288)/NumberField(350)/PopupDate(159)/CheckBox(40) 全变文本框;178/508 子表联动脚本完全丢失;showaddbutton/showdeletebutton 空值默认全开放(过度开放风险)
MultiSelectDialog 319 picker(multiple) / 降级 ⚠️ 97.7% 无 dialogid → 降级 select
CheckBox 194 checkbox ✅ —
FormEditGrid 129 同 EditGrid ⚠️ 同 EditGrid 子表退化
SingleFileUploadField 41 default→input-text 🔴 丢失文件上传;含 isshowpic=true(图片预览,如证件照)彻底失语。修复=复用 FileUploadField case(multiple=false)
RichTextArea 16 input-rich-text ✅ —
DateField 1 default→input-text 🔴 丢日期选择器。修复=复用 PopupDateField
PasswordField 1 default→input-text 🔴 密码明文显示。修复=映射 input-password(1 行)

default 分支(line 199)= input-text + degrade。落 default 的 = SingleFileUploadField(41)/DateField(1)/PasswordField(1)。


三、编辑表单结构与脚本(view_page,convertForm)

审查点 影响面 状态 说明
多页签 <tab> 布局 72 页(59×2签/10×3/2×4/1×9) 🔴 完全丢失 convertForm 只读 <fields>、跳过 <layout>,多 tab 折叠成单一平铺表单
字段显示顺序 全量 ⚠️ 部分丢失 以 <fields> 声明序为准,<layout><div location> 的版面顺序放弃
<table> 二列布局 1232 ✅ 有替代 buildFormRows 两栏 group(宽控件独占行)
width/colspan 精确布局 colspan 875 / width 1241 🔴 完全丢失 mapField 不读 width/colspan/height,统一等宽两列
required/readonly/hidden 全量 ✅ → required/disabled/hidden
initvalue/maxlength 全量 ✅ initvalue token 求值已做(§7-3)
requirederror(自定义必填提示) 1237 🔴 完全丢失 未读取
minlength 1219 🔴 完全丢失 applyLength 只处理 maxlength
页面级 <scripts> 联动 601 页 ⚠️ 部分处理 convertForm 只记 note 不生成 onEvent;需脚本改写器(FULL_AUTO)后处理才生效。与 §4.2 onselected/filter 是不同管线、不同阻塞点
EditGrid 子表(作字段) 412 字段 ⚠️ 前端结构已转 input-table;后端 updateSubTable 保存联动待接(F 阶段)

四、运行时数据源覆盖(1489 产物,端点可达性)

注:并行 agent 初判 picker/dict「零引用」有误(grep 漏了嵌套 source 字段);实测如下。

端点 引用页数 引用次数 抽样可达性
/api/flow/*_SEARCH 1345 — N=300:有数据 55.3% / 空(dev缺口) 41.7% / status:1 降级 2.3%(7) / 错 0.7%
/api/picker/* 911 1948 核心依赖(选择窗);多列+分页+回填已验(轮次1)
/api/poc/dict/* 728 1683 字典源;部分 ComboBox 误路由致空(§二 339 条)
`/api/template/treegrid tree` 45 —
/api/page/schema/{id} 109 — 编辑表单弹窗(多数指向未迁移 view_page → 「未配」,遗留②)

真缺口 vs dev 数据缺口分离:

  • 🔴 VIEW_/VM_ 报表端点 ~46 个 → 影响约 277 页(18.6%):dev 库无聚合视图。需 DBA 确认生产是否有这些视图——生产有=dev 数据缺口(非产品缺陷);生产也无=真需建视图+注册服务流。集中在 PM/OA 报表模块。
  • 🔴 真代码/转换缺口 ~7 个端点:服务不存在(含一个转换侧拼写 PM_MACHINECONTRACTREGEIDTER)/服务流未注册。
  • 🟢 dev 数据缺口 ~500 表:服务链路完整、仅 dev 无业务数据,上线自动有,不计产品缺陷。

五、缺口总清单(按优先级,新发现优先)

P1 — 正确性错误 / 安全(小量但必须修)

  1. 🔴 type=5 日历视图(2) 转成 crud 表格 → 应映射 calendar/fullcalendar。功能性错误。
  2. 🔴 编辑表单 default 控件:PasswordField→明文(安全)、SingleFileUploadField(41)→丢上传、DateField(1)→丢日期。各 1 行/复用即可修(迁移编辑表单前先补 UiTypeMapper)。
  3. 🔴 VIEW_/VM_ 报表数据源(~46 端点/~277 页):先由 DBA 确认生产视图存在性,再定 dev 数据缺口 or 真建视图。

P2 — 编辑表单迁移(遗留②)必须连带解决的质量项

  1. ⚠️ EditGrid/FormEditGrid 子表列硬写 input-text 不递归 UiTypeMapper(637 子表、子表内选择/枚举/数值/日期全退化)+ 178 子表联动丢失 → buildEditGridColumns 改为对子表字段递归 mapField(quickEdit)。
  2. ⚠️ 多页签布局(72) + width/colspan 精确布局(875+):convertForm 解析 <layout><tab> 生成 amis tabs + 还原列宽/跨列。
  3. ⚠️ requirederror(1237)/minlength(1219):补读两属性。
  4. ⚠️ 编辑表单 SelectDialog/MultiSelectDialog ~97% 无 dialogid + ComboBox 339 查询服务源:需运行时按字段/实体元数据补全数据源路由(与列表页 picker 同源机制延伸)。
  5. ⚠️ 页面级 <scripts> 联动(601):依赖脚本改写器管线(与 §4.2 onselected/filter 不同管线)。

P3 — 决策 / 低成本 / 已知后置

  1. type=6 group(20):子模板 62/62 已转,前端 tabs 按 tempid 加载即可激活(前端路由活,非转换器缺口)。
  2. type=100/101(130) 选择窗死页:无菜单、/api/picker 已覆盖 → 决策停转或留 F4。
  3. report B 图表(4)/C JOR 套打:另案(amis chart / univer)。
  4. type=3 声明式多级树(53):接 /api/template/{ref}/tree 端点。

跨切(已知遗留,本审计佐证影响面)

  • 遗留① JUEL 引擎:阻断所有 EL 表达式写流(含编辑表单添加/修改提交、子表保存)。
  • 遗留② 编辑表单迁移:1241 个 view_page 未转入库 → 添加/修改/查看弹窗「未配」。本审计揭示:迁移时必须连带做 P2 全部项(否则迁移出来的表单子表退化、页签丢失、布局乱、联动失效)。

六、给排期的一句话

写功能真实可用的依赖链:遗留②编辑表单迁移(带 P2 质量项 #4–#8)+ 遗留① JUEL 引擎 → 才有完整「添加/修改」;「查看」只需遗留②(+ P2 部分);P1 是与之并行的小修+报表数据源确认。被动 dogfooding 撞到的(树/按钮/juel/编辑表单)与本主动盘点新增的(日历视图、子表退化、页签/布局/校验丢失、选择窗死页)合并,构成 F2/F3 收尾的完整缺口地图。