238 lines
25 KiB
Markdown
238 lines
25 KiB
Markdown
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 | 列表改走 Flowable startedBy 聚合端点;查看详细复用只读 ApprovalDrawer;撤回桥接 Flowable changeActivityState + 挂起实例;起流写 authenticated user |
|
||
| 流程监控 (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/processInstanceId→打开详情页**逻辑,跳转目标复用 ApprovalDrawer/轨迹引擎;我的发起任务已按 processInstanceId 验收。
|
||
- **systemLogManager 删除按钮** = 系统日志查询(全部删/按类型删)+ 用户登录历史(按条件删),**同 bean、3 个端点一起暴露**。
|
||
|
||
**B. 依赖工作流引擎(activiti→flowable 桥,需新端点 + 表映射,中高成本):**
|
||
|
||
| 按钮 | 视图 | 依赖 | 状态 |
|
||
|---|---|---|---|
|
||
| 撤回 | 我的发起任务 | `activebackProcess` + VIEW_ACT_TASK 已流转校验 | 已完成:`/api/flow/process/{id}/withdraw` + `/api/workflow/process/{id}/withdraw`,含 DATASTATUS 守卫、已流转评论校验、回起始节点并挂起 |
|
||
| 结束流程 | 流程监控 | `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`(流程定义)
|