Files
eip4-platform/docs/framework定制视图-engineclass移植backlog-2026-06-17.md

238 lines
25 KiB
Markdown
Raw 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.
I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The analysis JSON plus memory give me everything needed. Synthesizing the full backlog now.
# EIP4 framework 定制视图迁移 — 移植 Backlog(46 视图)
数据基准:上方 46 个 engineclass delta 分析 JSON。EIP4 现状基线:转换页存 `sys_page_schema` → `/api/page/schema/{id}` 下发;业务服务走保真层 `/api/flow/{servicename}`;已上线能力可复用(WfTemplate 驱动只读表单 + form_key 历史回补、ApprovalDrawer、BusinessRecordLoader、picker 加载显名修复、用户管理 picker 629463ae 实测可用)。
---
## 1. 总览(按 verdict 统计)
| verdict | 数量 | 含义 |
|---|---|---|
| 重度delta | 9 | 默认引擎页 + 大量 Java 重写/bespoke 编辑器,EIP4 必须重点移植,最危险 |
| 中等delta | 13 | 默认页保留 + 若干新按钮/弹窗/级联/服务,逐项接线 |
| 轻量delta | 14 | 默认页够用,补 1–2 个按钮/跳转/条件过滤即可 |
| 纯bespoke | 10 | 无 XML 默认引擎,转换器产不出任何东西,需从零搭 |
| 无delta | 0 | (本批 46 个无一例"零移植即可用") |
**关键结论(回答提问):**
- **"默认引擎即够、零移植"= 0 个。** 这批 46 个全是被挑出来的 engineclass 视图,每个都有 Java delta。但其中 **14 个轻量delta** 实质是"默认页 + 极少量接线",接近零成本。
- **"有 Java delta 要移植"(轻+中+重)= 36 个。**
- **"纯 bespoke 另案"当前剩 4 个**(个人设置/工作日历/报表/流程定义);原 10 个中的用户选择框 4 个已切标准 amis picker、流程选择框 1 个已接线,查看审批已复用只读 ApprovalDrawer 完成。
**去重提醒:**`PositionManageView` 出现 2 次(分公司岗位管理 bad92259 中等 / 岗位管理 81266f2b 轻量),同一 Java 类、同一「设置」按钮逻辑,**做 1 套复用到 2 个 templateId**。`FuncDownloadComponent` 出现 2 次(0246d4bd / 13accf09)、`FinishTaskComponentNew` 2 次(c6eb659c / efa62458)、`TaskComponentNew` 2 次(4ebfc9ee 待办 / 0f7531e2 五建)、`UserSelectWindow` 类被 3 个 picker 视图共享/继承——**按 Java 类去重后实际待写代码单元约 38 个**。
---
## 2. 移植 Backlog 总表(重度→轻量排序)
| 视图 | 基类 | verdict | 移植项数 | 关键移植项(一句话) |
|---|---|---|---|---|
| 功能管理 (8b89fd29) | TreeGridTemplate | 重度 | 6 | 按 type 反射打开可视化设计器 + AceEditor XML 源码回写 + 左树→右grid级联 |
| 外部邮件收件箱 (827e5a96) | GridTemplate | 重度 | 11 | 6 按钮 + ClientMailService(IMAP/SMTP)端点 + 详情/撰写 bespoke 子页 + 三态切换 |
| 外部邮件发件箱 (80ba2bef) | GridTemplate | 重度 | 8 | 查看/转发 + MailDetail/MailSend 组件 + clientMailService + 父级邮箱上下文过滤 |
| 外部邮件配置 (8b30b940) | GridTemplate | 重度 | 5 | 添加/改改写为自定义弹窗 + 设默认/切当前邮箱 + CREATEBY 数据隔离 + 父子协调 |
| 数据权限配置 (66a0376f) | TreeTemplate | 重度 | 7 | 右栏全自建规则编辑器(规则列表/角色多选/条件构造器)+ dataPrivilegeService 读写 |
| 服务流 (ad7849ec) | GridTemplate | 重度 | 7 | 新增/编辑旁路默认表单→3 个流程服务配置向导窗 + ISUPDATEABLE 守卫 + 移除查看按钮 |
| 自动编号规则 (0defce1e) | GridTemplate | 重度 | 7 | 编辑器全替换:代码编辑器 + 7 类 token 生成器 + 实体级联 + 规则正则校验 |
| 视图管理 (d7e12a83) | TreeGridTemplate | 重度 | 7 | 编辑模板(可视化设计器)+ 高级配置(XML)+ 左树→右grid级联(平台元数据页) |
| 电子邮件 (27e3d27b) | GroupTemplate | 重度 | 5 | webmail 聚合壳 + 写信按钮 + 邮箱上下文加载 + 写信组件 + clientMailService 全套 |
| 个人设置 (db87828a) | CustomComponent | 纯bespoke | 7 | 聚合设置页 + 改密卡片(MD5 比对/更新)+ 6 个内联子组件需单独分析 |
| 工作日历 (a13fa07f) | TemplateComponent | 纯bespoke | 5 | 年历网格 + 单击 toggle 例外日 + 3 态着色 + workCalendarService 端点(服务已存在) |
| 报表 (e81454af) | TreeGridTemplate | 纯bespoke | 5 | DOCUMENT 菜单树 + 右区按 VIEW_TEMPLATEID 路由复用已转换页(宿主/路由器) |
| 查看审批 (b4d00f1a) | WorkFlowHistory | 已完成 | 3 | 通用审批列表「查看审批」已复用只读 ApprovalDrawer,支持 businessKey/processInstanceId 双路历史查看 + 业务单据 + 轨迹 |
| 流程定义 (5628f2e9) | CustomComponent | 纯bespoke | 11 | Flowable Modeler 整页 + 新建/导入/编辑/部署/导出(含 VIEW_WFTEMPLATE 迁移 SQL) |
| 流程选择框 (b3070157) | Window | 已接线待验 | 1 | 已接 amis transfer-picker + `/api/process-select`,Flowable Model/ProcDef 优先、本地 dev 回退历史流程名;剩流程代理授权保存闭环验收 |
| 用户选择框-org (1b3bad0b) | UserSelectWindow | 已接线待验 | 2 | 最新已切标准 amis `picker`,数据源 `/api/picker/1b3bad0b-a24b-4347-9466-db78f7432756/list`;多选仅通过 `multiple: true`,弹窗为表格+checkbox+搜索分页;剩真实业务保存、ALL 互斥、权限差异验收 |
| 用户选择框-全部 (090981ba) | UserSelectWindow | 已接线待验 | 1 | 最新已切标准 amis `picker`,数据源 `/api/picker/090981ba-0c10-4d84-92dc-80e226594480/list`;剩 admin 上下文/权限差异验收 |
| 用户选择框-受控 (76d2f950) | CustomComponent | 已接线待验 | 2 | 最新已切标准 amis `picker`,数据源 `/api/picker/76d2f950-ef40-4eff-89ec-98ad9a4976b9/list`;单选/多选由转换器按原控件类型生成;剩真实引用页保存验收 |
| 用户选择框-批量 (e31ce405) | CustomComponent | 已接线待验 | 1 | 最新已切标准 amis `picker`,数据源 `/api/picker/e31ce405-21c4-4892-94bb-e87e07b7f8e7/list`;剩考勤排除挂靠业务验收 |
| 功能编辑列表-自定义 (117374e1) | GridTemplate | 中等 | 5 | 编辑模板(按 type 1/100/200 设计器)+ 高级配置 + TemplateCustomService |
| 视图编辑列表-自定义 (de403e76) | GridTemplate | 中等 | 5 | 编辑模板(FormPageTemplateCustomDesign)+ 高级配置 XML + PageCustomService |
| 实体 (b4154b1f) | GridTemplate | 中等 | 7 | 实体规则/脚本工具/编辑默认服务流 3 按钮 + flowService/dataDicService 端点 |
| 分公司岗位管理 (bad92259) | TreeGridTemplate | 中等 | 5 | 「设置」按钮 + 用户多选 picker + SYS_POSITION_LOAD/UPDATE + 差量 upsert |
| 功能模板下载模板设置 (13accf09) | TreeTemplate | 中等 | 3 | VIEW_TEMPLATEID 条件门控 + 去右表单增删按钮 + 标题改写 |
| 定义定时任务 (d99b5760) | TreeGridTemplate | 中等 | 7 | 编辑任务脚本弹窗 + 部分字段 update RUNSCRIPT + 左树→右grid ENTITYTYPE 级联 |
| 审批表单删除 (91ccbba3) | GridTemplate | 中等 | 6 | 查看(复用 WfTemplate 只读表单)+ 删除(dleteCompleteProcessInstance 物理删) |
| 设置定时任务 (70f85b21) | GridTemplate | 中等 | 6 | 「设置提醒人」按钮 + UserTable 6 类级联编辑器 + SENDINFO JSON 双向序列化 |
| 收到的消息 (83971d1a) | GridTemplate | 中等 | 5 | 查看 + 打开即已读联动 + MessageService 4 端点 + 深链接 process 入口 |
| 我的发起任务 (0db4af06) | GridTemplate | 中等 | 5 | 查看详细 + 撤回(activebackProcess + 已流转校验,flowable 桥+表映射) |
| 流程监控 (9f3b5a8b) | GridTemplate | 中等 | 5 | 处理/高级处理(groovy 脚本运行时)/结束流程(endProcess 作废) |
| 数据导入配置管理 (7821ef3b) | GridTemplate | 中等 | 6 | 编辑转换/保存脚本 + 下载模板(POI)+ 下载基础数据 + DataImportService |
| 短消息 (ae79a47b) | GroupTemplate | 中等 | 4 | 发送消息按钮 + MessageSendForm(用户多选 picker)+ SYS_MESSAGE_ADD(TYPE=2) |
| 系统日志查询 (54042d08) | GridTemplate | 轻量 | 4 | 全部删除 + 按类型删除(LogType 枚举下拉)+ systemLogManager 2 端点 |
| 用户登录历史 (edc05980) | GridTemplate | 轻量 | 3 | 按查询条件删除(USERID+LOGINTIME)+ deleteByLoginTime 端点 + 确认框 |
| 用户登录操作信息 (324388a6) | GridTemplate | 轻量 | 3 | 查看登录记录(下钻到 edc05980 页,透传 USERID+时间区间) |
| 用户管理 (629463ae) | GridTemplate | 轻量 | 4 | 设置主岗位弹窗 + 查看用户菜单(UserRoleView)+ 2 个 SYS_POSITIONUSER 服务 |
| 用户组管理 (5078945c) | GridTemplate | 轻量 | 3 | 查看用户组菜单(UserGroupRoleView 钻取,与用户管理同构) |
| 岗位管理 (81266f2b) | TreeGridTemplate | 轻量 | 5 | 同分公司岗位管理(复用「设置」按钮一套) |
| 功能模板下载模板管理 (0246d4bd) | TreeTemplate | 轻量 | 3 | 同 13accf09(VIEW_TEMPLATEID 门控 + 去增删 + 标题) |
| 实体分类-枚举组 (b114351f) | TreeTemplate | 轻量 | 1 | 树节点 key 用 UUID 保唯一(重复挂载场景);若 EIP4 key 天然唯一则已覆盖 |
| 已办任务 (c6eb659c) | GridTemplate | 轻量 | 2 | 查看详细(HisTaskDetailPage,复用轨迹引擎) |
| 已办任务(测试) (efa62458) | GridTemplate | 轻量 | 3 | 同 c6eb659c |
| 已发送消息 (b7635622) | GridTemplate | 轻量 | 3 | 查看只读详情弹窗 + SYS_MESSAGE 只读加载 |
| 待办任务 (4ebfc9ee) | GridTemplate | 轻量 | 6 | 查看详细 + 处理(对接 ApprovalDrawer)+ 处理完刷新闭环 |
| 待办任务(五建) (0f7531e2) | GridTemplate | 轻量 | 4 | 同 4ebfc9ee |
\* 「用户选择框-全部」JSON 判轻量,但其实质依赖「用户选择框-受控」整套 UI;当前已随受控 picker 一起接线,剩权限差异验收。
---
## 3. 按 delta 类型归并(干活依据)
### 3.1 new-button(新增 Java 按钮)— 按"依赖服务是否疑似已在保真层"标注
**A. 服务疑似已就绪 / 可复用已上线能力(优先做,接线为主):**
| 按钮 | 所属视图 | 依赖服务 | 保真层状态 |
|---|---|---|---|
| 设置(岗位↔用户) | 分公司岗位管理 / 岗位管理 | `SYS_POSITION_LOAD` / `SYS_POSITION_UPDATE` | 疑似已在(SYS_* 命名 + picker 629463ae 实测可用) |
| 设置主岗位 | 用户管理 | `SYS_POSITIONUSER_SEARCH` / `SYS_POSITIONUSER_UPDATEMASTER` | 疑似已在(SYS_*) |
| 查看用户菜单 / 查看用户组菜单 | 用户管理 / 用户组管理 | `loadPOJO SYS_USER/SYS_USERGROUP`(标准) | 已在(标准 CRUD) |
| 查看(只读详情) | 已发送消息 / 收到的消息 | `loadPOJO SYS_MESSAGE` + `MessageService.*` | 部分(loadPOJO 已在,MessageService 需补) |
| 查看详细 / 处理 | 待办/已办/五建/我的发起 | 纯跳转,详情数据走已有 WfTemplate/轨迹引擎 | 已在(复用 ApprovalDrawer/BusinessRecordLoader) |
| 查看 / 删除 | 审批表单删除 | 查看复用 form_key 历史回补;删除 `dleteCompleteProcessInstance` | 查看已在 / 删除需补 |
| 查看登录记录 | 用户登录操作信息 | 纯下钻 + `loadPOJO VIEW_TEMPLATE` | 已在 |
| 全部删除 / 按类型删除 | 系统日志查询 | `systemLogManager.deleteAll/deleteByType` | 需补(同模块同 bean) |
| 按查询条件删除 | 用户登录历史 | `systemLogManager.deleteByLoginTime` | 需补 |
**聚合同类:**
- **「岗位↔用户 设置」按钮** = 2 视图(分公司岗位/岗位管理)同 Java 类,**做 1 套**。
- **「查看XX菜单」下钻** = 用户管理 + 用户组管理,**结构完全同构**,1 套参数化。
- **「查看详细/处理」任务跳转** = 待办/已办/已办(测试)/五建定制/我的发起任务,**共用选行→taskId→打开详情页**逻辑,跳转目标复用 ApprovalDrawer/轨迹引擎。
- **systemLogManager 删除按钮** = 系统日志查询(全部删/按类型删)+ 用户登录历史(按条件删),**同 bean、3 个端点一起暴露**。
**B. 依赖工作流引擎(activiti→flowable 桥,需新端点 + 表映射,中高成本):**
| 按钮 | 视图 | 依赖 | 状态 |
|---|---|---|---|
| 撤回 | 我的发起任务 | `activebackProcess` + VIEW_ACT_TASK 已流转校验 | 需 flowable 桥端点 + act_hi_* 表映射 |
| 结束流程 | 流程监控 | `endProcess` 逐个作废 active 任务 | 需端点 |
| 高级处理 | 流程监控 | `evaluateGroovy` 运行时脚本 | 需端点(高危,加权限/审计) |
| 编辑默认服务流 | 实体 | `flowService.addDefaultFlowService` 返回 boolean 分支 | 需端点 |
**C. 依赖外部业务流水线 / 设计器(重,逐个独立):**
- 执行(数据导入) — FTP 下载+解压+Excel 解析+`dataImportService.excuteScript` 整条流水线(L)。
- 下载模板/下载基础数据(数据导入配置) — POI 动态生成 Excel(L+M)。
- 编辑模板/高级配置 — 功能管理/视图管理/功能编辑列表-自定义/视图编辑列表-自定义 4 视图共性:**按 type 打开可视化设计器 + AceEditor XML 源码回写**(见 3.2 override-service 与机制④)。
- 写信/发送消息 — 电子邮件/短消息,右侧面板切 bespoke 表单。
### 3.2 override-button / override-service(重写默认 CRUD 行为)— **最危险,EIP4 默认引擎页会用错行为**
这些视图的默认增/删/改语义被 Java **完全替换(不调 super)**,转换器吃 XML 会生成"标准 CRUD 按钮",运行时会调错服务/弹错表单:
| 视图 | 被替换的默认行为 | 危险点 |
|---|---|---|
| **服务流** (ad7849ec) | 新增/编辑全旁路默认实体表单 → 3 个流程服务配置向导窗;`bindingDataView` 置空移除查看按钮 | 默认页会弹错增改表单、且多出一个无用「查看」 |
| **自动编号规则** (0defce1e) | `createInsert/UpdateWindow` 不调 super → 自定义 CodeEditor;**update override 丢了空值校验** | 默认页会用标准表单,完全无法构建编号规则 |
| **外部邮件收件箱** (827e5a96) | 「删除」覆盖默认删除语义 → `deleteReceiveMail`(走 IMAP 服务而非 CRUD DELETE) | 默认删除会删库行不删服务器邮件 |
| **外部邮件配置** (8b30b940) | 「添加/修改」同名但行为换成自定义 `MailSettingWindow` | 默认页弹错表单 |
| **功能模板下载设置/管理** (13accf09/0246d4bd) | `refreshRightLayout` 全替换 → 去右表单 insert/del 按钮 + VIEW_TEMPLATEID 门控 | 默认页会显示增删按钮(应禁) |
| **数据权限配置** (66a0376f) | `refreshRightLayout` 全替换 → 右栏不是默认编辑表单而是规则编辑器 | 默认页渲染错的编辑表单 |
| **报表/视图管理/功能管理** | `init`/`refreshRightLayout` 全替换硬编码数据源 | 默认接线抓不到硬编码 4 GUID |
| 服务流 / 流程监控 / 系统日志 / 数据导入 等 | `*-service` 类:用非标 bean(clientMailService/processCoreService/dataImportService/systemLogManager/TemplateService/PageService/dataPrivilegeService) | 这些 bean 须在保真层显式暴露,否则按钮调用 404 |
**override-service 端点清单(须在保真层 `/api/flow/` 或新端点暴露):**
`clientMailService(IMAP/SMTP 全套)`、`processCoreService(dleteCompleteProcessInstance/endProcess/activebackProcess/getProcessInstanceIdByBusinessKey)`、`dataImportService`、`systemLogManager`、`dataPrivilegeService(getEntityDataFilterRule/saveOrUpdateDataPrivilege)`、`TemplateService/TemplateCustomService/PageService/PageCustomService(getPojoById/updateTemplate)`、`MessageService(getReceiveMessage/getMessage/updateMessageToRead*)`、`flowService.addDefaultFlowService`、`dataDicService.getSYSEntity`、`SYS_DIMENSION_INCLUDEALL`、`SYS_SCHEDULEJOB_SETTINGUSER`、`workCalendarService(已在 platform-legacy-core,仅需 REST 暴露)`。
### 3.3 custom-dialog / custom-validation / custom-cascade / default-value
**custom-dialog(定制弹窗,按复杂度聚类):**
- **脚本编辑器弹窗(ScriptAddWin / AceEditor)** = 定义定时任务(RUNSCRIPT)、数据导入配置(CONVERTSCRIPT/SAVESCRIPT)、流程监控(groovy)、功能管理/视图管理/功能&视图编辑列表-自定义(XML 高级配置)。**做 1 个通用 code-editor 弹窗(amis input-editor,xml/groovy/js 模式),参数化字段名/标题/保存端点**,7+ 视图复用。
- **用户/岗位多选 picker 弹窗** = 分公司岗位/岗位管理(用户多选 629463ae)、用户管理(主岗位单选表)、短消息/电子邮件(收件人多选 090981ba)、数据权限(角色多选 2753735a)。复用 picker 加载显名修复成果。
- **消息/邮件详情弹窗** = 已发送/收到的消息(MessageDetailComponent)、邮件详情(MailDetailComponent)。
- **可视化模板/页面设计器宿主** = 功能管理/视图管理 + 2 个 -自定义。最重,见机制④。
- **规则/配置编辑器(右栏内嵌非弹窗)** = 数据权限配置(三层组件)、设置定时任务(UserTable 6 类级联)、自动编号规则(token 构建器)。
**custom-validation(定制校验):**
- 改密前端校验链(原/新/确认非空 + 新=确认)— 个人设置。
- 撤回前"已流转"校验(comment.message 白名单)— 我的发起任务。
- 角色非空 — 数据权限;编号规则非空/仅一个流水号/固定段禁特殊字符 — 自动编号。
- 普适「恰好选中 1 条」校验 — 几乎所有 new-button 视图共有,**EIP4 用 `disabledOn: 选中数!=1` 统一覆盖**。
**custom-cascade(级联):**
- 左树选实体类型 → 右grid 按 ENTITYTYPE 过滤 + 注入新增默认值 = 功能管理/视图管理/定义定时任务(**同一 TreeGrid 级联模式,做 1 套**)。
- 实体 → 实体属性(ENTITYID→COLUMNID)= 自动编号规则。
- 公司 → 部门树 = 用户选择框-org。
- 打开即已读、处理完刷新列表 = 收到的消息 / 待办任务。
**default-value(默认值生成):**
- ISMASTER=0(岗位用户新增非主岗)— 岗位管理;ENTITYTYPE 新增带入 — 功能管理/定时任务;ISREPLY=true 隐藏字段 — 短消息;CONFIGID=-1 空结果守护 — 邮件收/发件箱。多为级联副产物,跟随主任务实现。
### 3.4 full-bespoke(纯 bespoke 视图)— 逐个标"该不该做"
| 视图 | 建议 | 理由 |
|---|---|---|
| 用户选择框-受控 (76d2f950) | 已接线待验 | 已切标准 amis `picker`;web 兼容历史 schema,platform 转换器已按单选/多选输出 picker;剩真实引用页保存验收 |
| 用户选择框-org (1b3bad0b) | 已接线待验 | 已切标准 amis `picker`;弹窗表格支持搜索/分页/checkbox 多选;剩 ALL 互斥/权限差异/业务保存验收 |
| 用户选择框-全部 (090981ba) | 已接线待验 | 已切标准 amis `picker`;剩权限差异验收 |
| 用户选择框-批量 (e31ce405) | 已接线待验 | 已切标准 amis `picker`;剩排除挂靠业务验收 |
| 流程选择框 (b3070157) | 已接线待验 | 流程多选 picker 已接;剩流程代理授权保存闭环验收 |
| 查看审批 (b4d00f1a) | 已完成 | 通用审批列表「查看审批」已接只读 ApprovalDrawer;见活清单 2026-06-18 记录 |
| 工作日历 (a13fa07f) | 做 P2 | 后端 workCalendarService 已在,只缺前端年历 + REST,性价比高 |
| 报表 (e81454af) | 做 P2 | 路由/宿主,右区复用已转换页,逻辑不重但需 DOCUMENT 菜单端点 |
| 个人设置 (db87828a) | 拆做 P2/P3 | 改密卡片 P2(改密接口),6 个内联子组件需先各自分析源文件(暂缓) |
| 流程定义 (5628f2e9) | **暂缓 / 另案** | Flowable Modeler 整页 + 部署 + 跨环境迁移 SQL,等同独立子系统;EIP4 是否需在线建模待客户确认 |
| 电子邮件全家桶 (27e3d27b + 收/发/配置) | **暂缓 / 另案** | 整套 webmail 客户端(IMAP/SMTP),工作量等同独立产品模块;按客户优先级单独立项 |
**被 EIP4 别的机制覆盖 / 可降级的:**
- 实体分类-枚举组:树 key 唯一若 EIP4 按父路径生成则**已覆盖**(只需核对)。
- 待办/已办/我的发起任务的"详情/办理页":**已被 EIP4 ApprovalDrawer + WfTemplate 驱动 + 轨迹引擎覆盖**,只补列表入口按钮,不从零搭。
- 查看审批的 ProcessInstanceDetailPanel:已复用 ApprovalDrawer/轨迹引擎完成;businessKey 与 processInstanceId 双路只读历史入口已接线。
---
## 4. 移植机制建议(Java delta 怎么进 EIP4 转换页)
四种机制 + 每类 delta 推荐:
**① 转换器按 engineclass 注册 per-view 钩子(加按钮 / 改默认行为)** — 推荐为**主力机制**。
转换器读到 `engineclass=PositionManageView` 等时,在生成 amis schema 时注入额外工具栏按钮 / 抑制默认按钮 / 注入 disabledOn 校验。
- 适用:**new-button(几乎全部)、override-button(移除查看/增删按钮)、custom-validation(选中校验)、default-value**。
- 优点:整页仍数据驱动、随重转重导生效;与现有 BatchConvertCli 工作流一致。
**② sys_page_schema_overlay 全量整页替换** — **仅用于重度 bespoke 编辑器/规则器**。
注:overlay 是整页替换非 patch,维护成本高,只在转换器无论如何产不出时用。
- 适用:**数据权限配置右栏规则器、自动编号 CodeEditor、设置定时任务 UserTable、自动编号/视图管理的可视化设计器宿主**。这些右栏/编辑器完全自建,转换无意义,直接写死整页 schema 覆盖。
**③ 保真层新端点 + 转换器通用识别** — **配套②、①的服务侧**。
所有 override-service 的非标 bean(3.2 端点清单)在保真层暴露为 `/api/flow/{servicename}` 或专用 REST;转换器对工作流类按钮(撤回/结束/查看审批)通用识别 act 表语义。
- 适用:**override-service 全部、工作流引擎按钮、工作日历/导入/日志服务**。
**④ 前端 amis 扩展组件 / 标准 picker 配置** — **picker 类 + 代码编辑器 + 设计器**。
- 用户 picker 最新按标准 amis `picker` 接线:单选默认、多选仅加 `multiple: true`,统一 `/api/picker/<dialogid>/list`,避免自定义穿梭框破坏查询/表单布局;历史 `user-transfer-picker` schema 由 web 兼容层归一。流程 picker 继续走 amis transfer-picker/专用流程源。后续只在标准 picker 无法覆盖时再考虑自定义组件。
- 代码编辑器:amis `input-editor`(xml/groovy 模式)做通用脚本弹窗。
- 可视化设计器:对接 amis-editor 或自有低代码设计器(最重,流程定义对接 Flowable Modeler)。
**推荐组合:** 轻/中量 delta → 机制①+③;重度 bespoke 编辑器 → 机制②+④+③;用户 picker → 机制④(标准 amis `picker` 配置)+③(查询端点),不再把旧双栏 `user-transfer-picker` 作为常规渲染路径。
---
## 5. 推荐移植序列
**P1(先做:高频/高价值/服务多已就绪,直接产出客户可感知能力)**
1. **picker 业务验收** — 用户选择框受控(76d2f950)+org(1b3bad0b)+全部(090981ba)+批量(e31ce405)最新均为标准 amis picker,流程选择框(b3070157)已接线待验;继续验真实保存、权限差异、ALL 互斥、流程代理授权写入。**审批/表单/短消息全链路依赖。**
2. **岗位↔用户 / 主岗位 / 查看菜单 一组按钮** — 分公司岗位+岗位管理(复用 1 套)+用户管理+用户组管理。SYS_* 服务疑似已在,接线即得。
3. **待办/已办/五建/我的发起 任务按钮(共用跳转逻辑)** — 对接已上线 ApprovalDrawer,补列表入口即闭环。
4. **消息查看一组** — 已发送/收到的消息(查看弹窗 + MessageService + 打开即已读)。
**P2(后做:中等 delta,服务需补但范围清晰)**
6. 通用脚本/XML 编辑器弹窗(机制④)→ 一次性解锁:定义定时任务、数据导入配置脚本、流程监控高级处理、功能/视图编辑列表-自定义 高级配置。
7. 左树→右grid ENTITYTYPE 级联(机制①,1 套)→ 功能管理(部分)、视图管理(部分)、定义定时任务。
8. 工作流引擎按钮(机制③)→ 我的发起·撤回、流程监控·结束流程、审批表单删除·物理删除。
9. 系统维护轻量项 → 系统日志删除、用户登录历史/操作信息、实体三按钮、功能模板下载门控(13accf09/0246d4bd)、枚举组树 key 核对。
10. 工作日历(后端已在)、报表(路由复用已转换页)、设置定时任务提醒人编辑器、数据权限配置规则器、自动编号规则编辑器、服务流配置向导。
**P3(暂缓 / 另案立项:等同独立子系统,需客户优先级确认)**
11. 电子邮件全家桶(webmail:聚合壳+收/发件箱+配置+写信+clientMailService IMAP/SMTP)。
12. 流程定义(Flowable Modeler 在线建模+部署+导出迁移 SQL)。
13. 个人设置 6 个内联子组件(需先逐个分析源文件)、功能管理/视图管理的可视化页面设计器(平台元工具,取决于 EIP4 自身低代码设计方式)。
---
**相关绝对路径(待移植/待伴生分析的源文件):**
- `/Users/zhengwr/workspace/eip3/eip4-platform`(EIP4 后端/转换器,机制①③ 落点)、`/Users/zhengwr/workspace/eip3/eip4-web`(机制④ 标准 amis 配置兼容层与少量前端扩展落点)
- picker 之母:`framework/com.dsasp.client.organize/src/com/dsasp/clinet/organize/view/UserSelectWindow.java`(及子类 UserOrgSelectWindow/AllUserSelectWindow)
- 待伴生分析(JSON 中标注需另读):`SqlScriptToolWindow.java`、`RuleMainView.java`、`MailSettingWindow.java`、个人设置 6 子组件(ChangeuserphoneView/LeaderSettingComponent/MainPoisitionSettingComponent/DefPageSizeComponent/CustomMenuSettingComponent/DefProSettingComponent)、`FlowServiceEditor.java`/`ServiceFlowAdvance.java`、`UserTable.java`(设置定时任务)、`EditorProcessDefinitionDetailPanel.java`(流程定义)