- 从工作区根 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>
11 KiB
转换器覆盖度审计(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 — 正确性错误 / 安全(小量但必须修)
- 🔴 type=5 日历视图(2) 转成 crud 表格 → 应映射 calendar/fullcalendar。功能性错误。
- 🔴 编辑表单 default 控件:PasswordField→明文(安全)、SingleFileUploadField(41)→丢上传、DateField(1)→丢日期。各 1 行/复用即可修(迁移编辑表单前先补 UiTypeMapper)。
- 🔴 VIEW_/VM_ 报表数据源(~46 端点/~277 页):先由 DBA 确认生产视图存在性,再定 dev 数据缺口 or 真建视图。
P2 — 编辑表单迁移(遗留②)必须连带解决的质量项
- ⚠️ EditGrid/FormEditGrid 子表列硬写 input-text 不递归 UiTypeMapper(637 子表、子表内选择/枚举/数值/日期全退化)+ 178 子表联动丢失 → buildEditGridColumns 改为对子表字段递归 mapField(quickEdit)。
- ⚠️ 多页签布局(72) + width/colspan 精确布局(875+):convertForm 解析
<layout><tab>生成 amis tabs + 还原列宽/跨列。 - ⚠️ requirederror(1237)/minlength(1219):补读两属性。
- ⚠️ 编辑表单 SelectDialog/MultiSelectDialog ~97% 无 dialogid + ComboBox 339 查询服务源:需运行时按字段/实体元数据补全数据源路由(与列表页 picker 同源机制延伸)。
- ⚠️ 页面级
<scripts>联动(601):依赖脚本改写器管线(与 §4.2 onselected/filter 不同管线)。
P3 — 决策 / 低成本 / 已知后置
- type=6 group(20):子模板 62/62 已转,前端 tabs 按 tempid 加载即可激活(前端路由活,非转换器缺口)。
- type=100/101(130) 选择窗死页:无菜单、/api/picker 已覆盖 → 决策停转或留 F4。
- report B 图表(4)/C JOR 套打:另案(amis chart / univer)。
- type=3 声明式多级树(53):接
/api/template/{ref}/tree端点。
跨切(已知遗留,本审计佐证影响面)
- 遗留① JUEL 引擎:阻断所有 EL 表达式写流(含编辑表单添加/修改提交、子表保存)。
- 遗留② 编辑表单迁移:1241 个 view_page 未转入库 → 添加/修改/查看弹窗「未配」。本审计揭示:迁移时必须连带做 P2 全部项(否则迁移出来的表单子表退化、页签丢失、布局乱、联动失效)。
六、给排期的一句话
写功能真实可用的依赖链:遗留②编辑表单迁移(带 P2 质量项 #4–#8)+ 遗留① JUEL 引擎 → 才有完整「添加/修改」;「查看」只需遗留②(+ P2 部分);P1 是与之并行的小修+报表数据源确认。被动 dogfooding 撞到的(树/按钮/juel/编辑表单)与本主动盘点新增的(日历视图、子表退化、页签/布局/校验丢失、选择窗死页)合并,构成 F2/F3 收尾的完整缺口地图。