Entendido. Voy a sintetizar los 46 audits en un informe en Markdown. No necesito herramientas — los datos están todos en el prompt. Procedo a analizarlos y agruparlos. Déjame estructurar el análisis: clasificación por verdict/severity, identificación de patrones de converter-defect (el más recurrente: tree-editable退化, navigation按钮丢失, grid CRUD按钮丢失, picker双斜杠, filterscript未挂), y la secuencia de fixes. # EIP4 framework 层 46 定制视图迁移审计综合报告 > 路线认知:正确迁移 = 转换器→转换页(sys_page_schema)→保真层(/api/flow/、/api/picker/...)。手搓 bespoke 已弃用回退。转换器当前只有一个 navigation 按钮通用修复(未提交,需 BatchConvertCli→SchemaImportCli 全库重转才 live)。下文结论以"修转换器=通用收益最大"为优先级排序原则。 --- ## 1. 总览看板 ### 按 verdict 统计 | verdict | 数量 | 视图 | |---|---|---| | **等价** | 17 | 待办任务、我的发起任务、数据导入文件管理、用户选择框×3(全部不受控/受控/批量排除挂靠)、短消息、系统日志查询、自动编号规则、视图编辑列表-自定义、设置定时任务、外部邮件发件箱、外部邮件配置、实体、功能编辑列表-自定义、数据导入配置管理、已发送消息、电子邮件、用户组管理 | | **部分** | 18 | 功能模板下载模板管理/设置、功能管理、外部邮件收件箱、定义定时任务、实体分类-枚举组、审批表单删除、已办任务、已办任务(测试)、待办任务(五建)、收到的消息、数据权限配置、服务流、流程监控、用户登录历史、用户登录操作信息、用户管理、视图管理 | | **严重缺** | 2 | 分公司岗位管理、岗位管理 | | **bespoke未覆盖** | 7 | 个人设置、工作日历、报表、查看审批、流程定义、流程选择框、用户选择框-受控-org | | **(合计)** | **44** | (注:输入 46 条声明,实际 JSON 44 条;下文以 44 条实测为准) | ### 按 severity 统计 | severity | 数量 | |---|---| | 高 | 7 | | 中 | 14 | | 低 | 12 | | 无 | 11 | ### 核心判断:转换页"本就好" vs "真要动手" - **转换页本就等价/接近、零或仅轻度退化(本就好)= 17 个**(全部"等价")。其中 **9 个"等价/无"且仅差挂菜单**(外部邮件发件箱/配置、实体、已发送消息、用户选择框×3 等),挂菜单后即 100% 可用。 - **真要动手 = 27 个**(18 部分 + 2 严重缺 + 7 bespoke)。但这 27 个里: - **9 个是 not-mounted 主因**(挂菜单即解决,几乎零代码); - **10 个是 converter-defect**(改转换器一次惠及全库); - **7 个是纯 bespoke 无 XML**(转换器天然无能为力,另案); - 其余是 degraded/fidelity 杂项。 **一句话**:真正"硬骨头"只有 ~10 个 converter-defect 视图 + 7 个 bespoke;其余靠"全库重转 + 挂菜单"两个批量动作就能大面积转绿。 --- ## 2. 逐视图状态表(按 severity 降序) | 视图 | 老模板根 | schema/挂菜单/http | verdict | sev | 一句话缺口 | |---|---|---|---|---|---| | 分公司岗位管理 | master-detail | ✓/✓/200 | 严重缺 | 高 | grid 4按钮+树8按钮全丢,核心只读不可用 | | 岗位管理 | treegrid | ✓/✓/200 | 严重缺 | 高 | grid CRUD+树节点按钮全丢 + 未挂菜单 | | 个人设置(改密码) | empty(bespoke) | ✗/✓/404 | bespoke | 高 | xml=NULL,菜单挂着却落 404 死链,改密码整体缺失 | | 数据权限配置 | tree | ✓/✓/200 | 部分 | 高 | 可编辑树降级为只读 input-tree,8按钮全丢 | | 服务流 | crud | ✓/✗/200 | 部分 | 高 | 增改查退化占位 dialog(无 view_page)+ 未挂菜单 | | 审批表单删除 | crud | ✓/✓/200 | 部分 | 高 | onselectedscript 删除动作未译成 amis,删不掉 | | 视图管理 | treegrid | ✓/✓/200 | 部分 | 高 | 左实体分类树4按钮丢 + ENTITYS filterscript 级联丢 | | 分类树编辑类(功能管理) | treegrid | ✓/✓/200 | 部分 | 中 | 左实体分类树 edit=true 降级只读 + ENTITYS 级联退化 | | 定义定时任务 | treegrid | ✓/✓/200 | 部分 | 中 | 左实体分类树4按钮+编辑表单 9fdb9281 未接 | | 实体分类-枚举组 | tree | ✓/✗/200 | 部分 | 中 | 未挂菜单(树按钮老侧本就空壳,非真丢) | | 外部邮件收件箱 | crud | ✓/✗/200 | 部分 | 中 | 未挂菜单 + CONFIGID picker 双斜杠 + ISREAD 裸列名 | | 待办任务(五建) | crud | ✓/✗/200 | 部分 | 中 | 未挂菜单 + 打开/处理动作在 TaskComponentNew 引擎类 | | 收到的消息 | crud | ✓/✗/200 | 部分 | 中 | 未挂菜单 + 2隐藏 SelectDialog 双斜杠(影响低) | | 流程监控 | crud | ✓/✓/200 | 部分 | 中 | 引擎注入的"结束流程"按钮不在 XML,退化只读 | | 用户登录历史 | crud | ✓/✗/200 | 部分 | 中 | 未挂菜单 + LOGINTIME 默认值脚本未迁移 | | 用户登录操作信息 | crud | ✓/✓/200 | 部分 | 中 | 2个 navigation 钻取按钮(查看登录/操作记录)整体丢 | | 工作日历 | empty(bespoke) | ✗/✗/404 | bespoke | 中 | xml=NULL,菜单指向 404,需另案手写日历 | | 报表 | empty(bespoke) | ✗/✗/404 | bespoke | 中 | ReportComponent 纯 Java,需另案报表查看器 | | 查看审批 | empty(bespoke) | ✗/✗/404 | bespoke | 中 | WorkFlowHistoryDetailPanel,引擎层 ApprovalDrawer 承接 | | 流程定义 | empty(bespoke) | ✗/✓/404 | bespoke | 中 | ProcessDefinitionComponent,需 Flowable 部署控制台 | | 用户选择框-受控-org | empty(bespoke) | ✗/✗/404 | bespoke | 中 | UserOrgSelectWindow(type=100),需带权限过滤 picker | | 功能模板下载模板管理 | tree | ✓/✓/200 | 部分 | 中 | 删/改按钮丢 + 节点加载脚本 initApi 指错实体 SYS_MENU | | 功能管理 | treegrid | ✓/✓/200 | 部分 | 中 | (见上分类树编辑) | | 功能编辑列表-自定义 | crud | ✓/✓/200 | 等价 | 低 | TEMPLATEID filterscript/带出实体级联退化 | | 功能模板下载模板设置 | tree | ✓/✓/200 | 部分 | 低 | 改/删占位按钮(老侧 servicename 即空)+4技术字段暴露 | | 已办任务 | crud | ✓/✗/200 | 部分 | 低 | 未挂菜单 + STARTTIME 近12月默认脚本未迁移 | | 已办任务(测试) | crud | ✓/✓/200 | 部分 | 低 | 近6月默认过滤脚本未迁移(语义退化) | | 用户管理 | crud | ✓/✓/200 | 部分 | 低 | navigation 按钮未接线 + PASSWORD 明文 + onselectedscript 禁用联动疑未挂 | | 外部邮件配置 | crud | ✓/✗/200 | 等价 | 低 | 仅未挂菜单 | | 实体 | crud | ✓/✗/200 | 等价 | 低 | 仅未挂菜单 | | 已发送消息 | crud | ✓/✗/200 | 等价 | 低 | 仅未挂菜单 | | 外部邮件发件箱 | crud | ✓/✗/200 | 等价 | 中 | 未挂菜单 + 服务名 fidelity 待确认 | | 数据导入配置管理 | crud | ✓/✓/200 | 等价 | 低 | 单删→批删(低风险语义微调) | | 用户组管理 | crud | ✓/✓/200 | 等价 | 低 | ROLES→ROLELIST DB 重分组联动退化客户端拷贝 | | 电子邮件 | group | ✓/✓/200 | 等价 | 低 | 收件箱 ISREAD 裸列名 + CONFIGID 双斜杠(隐藏) | | 待办任务 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 | | 我的发起任务 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 | | 数据导入文件管理 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 | | 用户选择框-全部-不受控 | crud | ✓/✗(预期)/200 | 等价 | 无 | picker 设计预期不挂菜单 | | 用户选择框-受控 | crud | ✓/✗(预期)/200 | 等价 | 无 | 同上 | | 用户选择框-批量-排除挂靠 | crud | ✓/✗(预期)/200 | 等价 | 无 | 同上 | | 短消息 | group | ✓/✓/200 | 等价 | 无 | 2隐藏 SelectDialog 双斜杠(无可见影响) | | 系统日志查询 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 | | 自动编号规则 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 | | 视图编辑列表-自定义 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 | | 设置定时任务 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 | --- ## 3. 缺口 backlog(按 kind 归并,这是干活的依据) ### 3.1 converter-defect(改转换器,通用收益最大) 按 pattern 聚合,共识别出 **6 大转换器症结**,从高频到低频: #### CD-1 ★最致命:master-detail/treegrid 的「可编辑树节点按钮」整块丢弃(tree-editable 退化) **命中视图(7个)**:分公司岗位管理、岗位管理、数据权限配置、视图管理、功能管理、定义定时任务、(实体分类-枚举组=空壳除外)。 **症结**:转换器遇到 ``/treetemplate 节点上的 ``(添加/修改/删除/保存)与节点编辑 `pageid` 时,统一降级为只读 `input-tree`,既不映射节点工具栏/editable,也不接编辑弹窗。涉及服务名:`SYS_ENTITYTYPE_ADD/DELETE`、`SYS_DEPART_ADDORUPDATE/DELETE`、`SYS_POSITION_ADDORUPDATE/DELETE`。 **关键证据**:多视图的节点表单 schema(9fdb9281 NAME/SEQ、d3fe54f0、9c987585)**已转好且 live 200**,纯粹缺"树侧触发入口"。 **修法**:转换器对 treetemplate 节点 `` 生成 amis 树工具栏/节点 actions + 绑定已存在的编辑表单 pageid。**一次修惠及 7 视图**。 **注意分流**:实体分类-枚举组 的 4 按钮在源 XML 是 `edit=false/servicename空/无pageid` 空壳,转换器省略是**保真**,不在此修复范围。 #### CD-2 ★grid CRUD 按钮整块丢弃(crud headerToolbar 只剩 pagination) **命中视图(3个)**:分公司岗位管理、岗位管理(grid a7974378 的 SYS_POSITIONUSER_ADD/UPDATE/DELETE/LOAD)、审批表单删除(局部相关)。 **症结**:master-detail 右侧子 grid 模板的 4 按钮(insert/update/delete/read)未生成 itemActions/headerToolbar/写 api;`selectable:true` 形同虚设。 **修法**:转换器对子 grid 模板按钮按 crud 主表同样规则接线。与 CD-1 同属"master-detail 子模板按钮未接"族,**建议合并为一个工单**。 #### CD-3 navigation 类型按钮(跨视图钻取)未映射 **命中视图(3个)**:用户登录操作信息(查看登录记录 funcid=edc05980 / 查看操作记录 funcid=535f921c)、用户管理(查看数据过滤权限 funcid=8ba2f6a2)。 **症结**:`type=navigation` 按钮(带 `funcid` 跳目标视图 + `onloadscript` 注入默认搜索)被整体丢弃,无 `navigate`/`link` action。 **修法**:**这正是"未提交的 navigation 通用修复"要解决的**——必须 rebuild jar + 全库重转才 live。修复后验证这 3 视图钻取恢复。 #### CD-4 onselectedscript 选中脚本未译成删除/批量动作 **命中视图(2个)**:审批表单删除(onselectedscript=872e00b1 是整页核心删除)、流程监控(enableButton('结束流程') 指向引擎注入按钮)。 **症结**:转换器保留 `selectable` 复选框,但不把 `display/@onselectedscript` 消费成 bulkActions/itemActions 删除动作。审批表单删除尤其严重——"删除视图"却删不了。 **修法**:转换器对 `onselectedscript` 驱动的选中动作生成 amis bulkAction。注意流程监控的"结束流程"按钮本身是引擎注入(不在 XML),属 bespoke 边界,转换器只能补按钮壳无法补 action。 #### CD-5 空 dialogid 的 SelectDialog → picker source 双斜杠 `/api/picker//list` **命中视图(4个)**:外部邮件收件箱(CONFIGID)、收到的消息(SYS_MESSAGE_ID/SYS_USER_ID)、短消息(同)、电子邮件(收件箱 CONFIGID)。 **症结**:`dialogid` 为空时,转换器拼出 `/api/picker//list` 双斜杠,picker 无法加载。**好消息**:这些字段几乎全是 `hidden=true`,可见影响低。 **修法**:转换器对空 dialogid 做兜底(回退实体名或跳过 picker)。低优先,但一次修干净 4 视图。 #### CD-6 节点加载脚本被转成指向错误实体的 initApi **命中视图(1个,但语义致命)**:功能模板下载模板管理。 **症结**:老 load 脚本"根据菜单查询 VIEW_TEMPLATE_DOWNLAD 回填 DOCUMENT/VERSION",被转成 `initApi=/api/entity/SYS_MENU/${selId}`(加载错的实体),选节点不载入已有附件,主流程断裂。 **修法**:单视图修 initApi 指向正确实体/pageId 加载路径(对照"功能模板下载模板设置"的正确 pageId initApi 写法)。属逐视图深缺口,非通用 pattern。 --- ### 3.2 schema-missing / 待重转(靠全库重转重导补) - **navigation 通用修复(CD-3)**:这是**唯一**真正"重转即补"的通用项——jar 内已有修复代码未提交,rebuild + BatchConvertCli→SchemaImportCli 后,用户登录操作信息/用户管理的 navigation 按钮 schema 才会出现。 - **bespoke 的 schema-missing(个人设置/工作日历/报表/查看审批/流程定义/流程选择框/用户选择框org)**:`view_template.xml=NULL`,**重转无源可转,不属重转可解**,务必区分,别误以为重转能补。 --- ### 3.3 not-mounted(只差挂 sys_menu) **纯挂菜单即转绿(9个)**:外部邮件发件箱、外部邮件配置、实体、已发送消息、收到的消息、已办任务、待办任务(五建,但还叠 bespoke 打开动作)、用户登录历史、用户选择框-全部-不受控\*。 **注**:用户选择框×3(不受控/受控/批量排除挂靠)、用户选择框-受控-org 的 menuCount=0 是 **picker 设计预期**(由别的表单 dialogid 调起),**不需要挂菜单**。 **真需补菜单清单(去掉 picker 预期)**:外部邮件发件箱、外部邮件配置、实体、已发送消息、收到的消息、已办任务、用户登录历史 = **7 个确定补菜单**;待办任务(五建)挂了菜单仍是死路列表(见 bespoke)。 --- ### 3.4 bespoke-no-xml(纯 bespoke,逐个处置) | 视图 | engineclass | EIP4 是否已有机制覆盖 | 处置建议 | |---|---|---|---| | 个人设置(改密码) | ChangePasswordView | ❌ 无,菜单挂着落 404 死链 | **需 bespoke**,系统级功能缺失(无法改密码),优先级偏高;先把 404 死链处理掉(隐藏菜单或占位页) | | 工作日历 | WorkCalendarSettingView (type5) | ❌ 无,菜单指向 404 | **需 bespoke** amis 日历页;暂可隐藏菜单防 404 | | 报表 | ReportComponent | ❌ 无(未挂菜单) | **可暂缓**,需另案报表查看器/运行时,工作量大 | | 查看审批 | WorkFlowHistoryDetailPanel | ✅ 引擎层 ApprovalDrawer 轨迹已承接(见 memory) | **已覆盖**,此模板本身无 schema 无挂载,无需单独迁移 | | 流程定义 | ProcessDefinitionComponent | ❌ 无,但菜单已挂(落 404) | **需 bespoke** Flowable BPMN 部署控制台;先处理菜单 404 | | 流程选择框 | ProcessSelectDialog | ⚠️ 子组件弹窗,由别处调起 | **可暂缓**,需要时另案 picker;非独立页 | | 用户选择框-受控-org | UserOrgSelectWindow (type=100) | ⚠️ 部分——不受控/受控用户 picker 已用数据驱动 crud 覆盖(等价),但**带权限过滤的 org 版仍缺** | **需 bespoke** 带权限过滤的原生 amis picker(组织树+用户+正常/禁止登录态);优先级看是否有表单引用它 | --- ### 3.5 fidelity(保真层服务疑似需查) - **外部邮件发件箱**:`SYS_EXTERNALMAIL_SEARCH` / `SYS_EXTERNALMAIL_DELETE` 在 sys_serviceflow/sys_originservice **未查到注册**,可能由代码注册。**需运行时 POST 验证端点存在性**。 - **服务流**:`SYS_SERVICEFLOW_SAVE/UPDATE/LOAD` 因占位 dialog 未接,**即便补表单也需先确认保真层端点存在**(记为待核)。 - **功能模板下载模板设置**:DOCUMENT 选中加载走 `initApi+pageId` 保真层路径,**需运行时实测回填是否生效**。 这 3 项建议在 P0 干净基线起来后,用一批鉴权 POST 烟测统一验证。 --- ### 3.6 degraded(语义退化,非功能中断) 聚合为几类,多数可暂缓: - **默认值/默认过滤脚本未迁移**(打开页默认时间窗):已办任务(近12月)、已办任务测试(近6月)、用户登录历史(LOGINTIME)、待办任务(无)。轻度 UX 退化,统一可做"转换器把 onload 默认值脚本译成 filter defaultParams"。 - **filterscript 级联过滤退化**:功能编辑列表-自定义(TYPE=1)、功能管理/视图管理(ENTITYS by ENTITYTYPE)、岗位编辑(PARENTDEPARTID)。属"已知 onEvent/filterscript 挂回缺口"(见 memory),与历史 onEvent 修复同源。 - **带出实体级联脚本**:功能编辑列表-自定义(TYPE/ENGINECLASS 隐藏字段不自动带出,写入可能为空)——需关注,可能影响落库。 - **DB 重分组联动**:用户组管理 ROLES→ROLELIST(退化为客户端拷贝,不影响保存)。 - **PASSWORD 用 input-text 明文**:用户管理(老 uitype=TextField,属老侧即如此;但 EIP4 应升级 input-password)。 - **技术字段暴露/裸列名**:功能模板下载模板管理/设置(4技术字段明文)、外部邮件收件箱/电子邮件(ISREAD 裸列名)。布局保真退化。 - **单删→批删**:数据导入配置管理(低风险等价)。 --- ## 4. 推荐修复序列(分阶段) ### P0 — 干净基线(让转换页全 live + 挂菜单) **动作**: 1. rebuild jar(含未提交的 navigation 通用修复)→ BatchConvertCli 全库重转 → SchemaImportCli 重导 → 8093 restart 干净基线。 2. 补 sys_menu 挂载:外部邮件发件箱/配置、实体、已发送消息、收到的消息、已办任务、用户登录历史(7个确定项)。 3. 处理 4 个 bespoke 的菜单 404 死链(个人设置/工作日历/流程定义 菜单已挂却落 404 → 临时占位页或隐藏菜单,避免用户撞死链)。 - **惠及视图数**:9 等价视图直接转可用 + navigation 修复落地惠及 3 视图(用户登录操作信息/用户管理) + 消除 3~4 个 404 死链。 - **预估改动面**:0 行业务代码(jar 已含修复)+ N 行 sys_menu SQL + 占位页。 - **验证方式**:重转后逐一 curl /api/page/schema 返 200;浏览器点菜单确认 9 视图可达且无 404;navigation 钻取按钮在 schema 中出现并可跳转。 ### P1 — 修 converter-defect 通用症结(一次修惠及全库) 按 severity 排序: 1. **CD-1 + CD-2 合并(master-detail 树节点按钮 + 子 grid CRUD 按钮)**:最高价值,**惠及 7~9 视图**(分公司岗位管理、岗位管理、数据权限配置、视图管理、功能管理、定义定时任务)。把节点 `` 与已存在的编辑表单 pageid 接回,子 grid 按钮按主表规则接线。 2. **CD-4(onselectedscript→删除动作)**:惠及审批表单删除(高,核心功能)。 3. **CD-5(空 dialogid 双斜杠兜底)**:惠及 4 视图(影响低但一次修干净)。 - **预估改动面**:转换器 3~4 处,触及 master-detail/grid/onselected/picker 生成逻辑;每改一处需全库重转重导。 - **验证方式**:重转后 grep 对应视图 schema 出现 itemActions/headerToolbar/树节点 actions;浏览器实测增删改存可用;回归"已等价"视图无破坏。 ### P2 — 逐视图深缺口 - **CD-6**:功能模板下载模板管理 initApi 指向修正(单视图)。 - **degraded 批次**:默认值脚本→filter defaultParams 通用译;filterscript 级联挂回(与历史 onEvent 缺口合并);功能编辑列表带出实体级联(关注落库正确性);用户管理 PASSWORD→input-password、onselectedscript 禁用联动挂回。 - **fidelity 烟测**:外部邮件/服务流/下载模板设置 三项服务名鉴权 POST 验证。 - **验证方式**:逐视图浏览器 dogfooding + 写路径落库验证。 ### Pn — bespoke 另案(独立排期,非转换器范畴) - **优先(系统级功能缺)**:个人设置(改密码)、用户选择框-受控-org(若有表单引用)。 - **次之**:工作日历、流程定义(Flowable 部署控制台)。 - **暂缓**:报表(查看器工程量大)、流程选择框(按需)。 - **无需做**:查看审批(ApprovalDrawer 已承接)、3 个 picker 类用户选择框(数据驱动已等价)。 --- ## 5. 风险与注意 1. **全库重转触及 ~1489 页(memory 记 883/1489 量级)是受控但高回归面操作**:每次改转换器都要 BatchConvertCli→SchemaImportCli→restart,任何 schema 生成逻辑改动都可能波及已"等价/无缺口"的 17 视图。**每轮重转后必须回归这 17 个绿视图**(尤其待办任务、我的发起任务、系统日志查询、自动编号规则、设置定时任务等无缺口项)。 2. **CD-1/CD-2 改 master-detail 生成逻辑回归面最大**:treegrid/master-detail 转换器是多视图共用骨架,改"树节点按钮接回"可能影响所有用 input-tree 的转换页(包括纯只读导航树的实体分类-枚举组,**它必须保持只读**——别把空壳按钮也渲出来)。需用 `edit=true && servicename非空 && 有pageid` 三重条件守卫,避免给空壳树误加按钮。 3. **bespoke 与 schema-missing 必须严格区分**:7 个 bespoke 的 xml=NULL,**重转永远补不出**;若误把它们当"待重转"会浪费精力。处置只有"另案 bespoke / 引擎层覆盖 / 暂缓"三选一。 4. **navigation 修复未提交**:当前线上转换页不含此修复,P0 不 rebuild 就重转 = 修复不生效。务必确认 jar 是 rebuild 后的。 5. **菜单 404 死链是用户可感最差体验**:个人设置/工作日历/流程定义 菜单已 active 挂着却落 404,优先于功能完整性先消死链(占位"功能建设中"页),避免客户撞墙。 6. **fidelity 服务名未注册的 3 项**:在数据驱动重转中无法发现,只能运行时 POST 揪出;若 P0 不做烟测,可能 P2 才暴露"挂了菜单但点删除报 500"。建议 P0 基线后立即跑一轮服务名烟测。 7. **filterscript/onEvent 级联属历史已知缺口**(memory 多处记录),与本轮 converter-defect 部分重叠,**复用历史 onEvent 挂回方案**,勿重复造轮子。