Files
eip4-platform/docs/归档/framework定制视图-转换页审计-2026-06-17.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

21 KiB
Raw Permalink Blame History

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个):分公司岗位管理、岗位管理、数据权限配置、视图管理、功能管理、定义定时任务、(实体分类-枚举组=空壳除外)。 症结:转换器遇到 <tree>/treetemplate 节点上的 <buttons>(添加/修改/删除/保存)与节点编辑 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 节点 <buttons> 生成 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 视图(分公司岗位管理、岗位管理、数据权限配置、视图管理、功能管理、定义定时任务)。把节点 <buttons> 与已存在的编辑表单 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 挂回方案,勿重复造轮子。