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

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