Compare commits

..

2 Commits

Author SHA1 Message Date
f736d33a20 docs(platform): record approval history completion
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 02:13:09 +08:00
21e3865dcf fix(platform): restore approval history drawer 2026-06-18 02:12:27 +08:00
6 changed files with 220 additions and 73 deletions

View File

@@ -9,9 +9,9 @@
| 口径 | 数量 | 说明 | | 口径 | 数量 | 说明 |
|---|---:|---| |---|---:|---|
| framework 定制视图总数 | 46 | README 总览口径;backlog 表格当前可解析出 45 行,需后续校正缺的 1 行。 | | framework 定制视图总数 | 46 | README 总览口径;backlog 表格当前可解析出 45 行,需后续校正缺的 1 行。 |
| 已逐功能验收 / 可算 Done | 约 6 | 用户管理、功能模板下载、实体分类-枚举组、已办任务、消息查看/已读、短消息。功能模板下载/已办/消息查看各覆盖 2 个 templateId,但按 engineclass 各计 1 组。 | | 已逐功能验收 / 可算 Done | 约 7 | 用户管理、功能模板下载、实体分类-枚举组、已办任务、消息查看/已读、短消息、查看审批。功能模板下载/已办/消息查看各覆盖 2 个 templateId,但按 engineclass 各计 1 组。 |
| 代码已提交但待最终副作用验收 | 约 3 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;两者都未覆盖所有真实业务保存和权限差异验收。 | | 代码已提交但待最终副作用验收 | 约 3 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;两者都未覆盖所有真实业务保存和权限差异验收。 |
| 仍需修或逐功能验收 | 约 41 | 含上面的 3 个待验组;大多是通用页已产出,但 engineclass Java delta 未迁移。 | | 仍需修或逐功能验收 | 约 40 | 含上面的 3 个待验组;大多是通用页已产出,但 engineclass Java delta 未迁移。 |
| 剩余工程单元 | 约 28+ | 多视图可复用同一套组件/端点,如脚本编辑器、消息详情、工作流按钮。 | | 剩余工程单元 | 约 28+ | 多视图可复用同一套组件/端点,如脚本编辑器、消息详情、工作流按钮。 |
## Done(已完成 / 已验收) ## Done(已完成 / 已验收)
@@ -30,6 +30,7 @@
| 2026-06-17 | 用户管理 Delta 端到端案例 | Done | 见 `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | 已逐字段 dogfood | | 2026-06-17 | 用户管理 Delta 端到端案例 | Done | 见 `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | 已逐字段 dogfood |
| 2026-06-18 | 消息查看/已读:收到的消息查看弹窗、打开即已读、已发送消息只读详情 | Done | `eip4-platform f690f30` | `NoticeControllerTest`; 浏览器验收 `83971d1a`:本地记录 `94d3645c-2487-47f6-bbf5-ebdff3434f6e` 置未读后列表显示“否”,打开详情后 DB 与列表均回“是”;浏览器验收 `b7635622`:已发送消息只读详情正常,无“消息详情加载失败” | | 2026-06-18 | 消息查看/已读:收到的消息查看弹窗、打开即已读、已发送消息只读详情 | Done | `eip4-platform f690f30` | `NoticeControllerTest`; 浏览器验收 `83971d1a`:本地记录 `94d3645c-2487-47f6-bbf5-ebdff3434f6e` 置未读后列表显示“否”,打开详情后 DB 与列表均回“是”;浏览器验收 `b7635622`:已发送消息只读详情正常,无“消息详情加载失败” |
| 2026-06-18 | 短消息 `MessageManageView`:发送消息弹窗、标准用户多选 picker、写 `sys_message/sys_messageuser`、发送后刷新已发列表 | Done | `eip4-platform 723443e` | `NoticeControllerTest`; `TemplateToAmisConverterTest#engineclass_MessageSendView_注入查看按钮,#engineclass_MessageManageView_注入发送消息弹窗`; live 浏览器验收 `ae79a47b`:打开「发送消息」→ 接收人标准 amis 表格 picker(搜索/分页/checkbox)→ 发送成功 → 不点搜索即在已发列表第一行出现 `codex短消息live刷新-*` | | 2026-06-18 | 短消息 `MessageManageView`:发送消息弹窗、标准用户多选 picker、写 `sys_message/sys_messageuser`、发送后刷新已发列表 | Done | `eip4-platform 723443e` | `NoticeControllerTest`; `TemplateToAmisConverterTest#engineclass_MessageSendView_注入查看按钮,#engineclass_MessageManageView_注入发送消息弹窗`; live 浏览器验收 `ae79a47b`:打开「发送消息」→ 接收人标准 amis 表格 picker(搜索/分页/checkbox)→ 发送成功 → 不点搜索即在已发列表第一行出现 `codex短消息live刷新-*` |
| 2026-06-18 | 查看审批 `WorkFlowHistoryDetailPanel`:通用审批业务列表「查看审批」从轨迹表弹窗升级为只读 `ApprovalDrawer`,支持 businessKey/processInstanceId 双路历史查看,展示业务单据 + 流程轨迹 | Done | `eip4-platform 21e3865`, `eip4-web d03c2ba` | `TemplateToAmisConverterTest#buildToolbar_审批列表补查看审批按钮`; `ApprovalControllerHistoryTest`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl platform-app -am package -DskipTests`; 全量重转 2757 项,导入更新 636 项;浏览器验收 `18fb15c9`:选中第一行 →「查看审批」打开“审批详情”抽屉,含“业务单据(总包合同评审)/流程轨迹”,无旧“审批记录”弹窗 |
## In Progress / Needs Verification ## In Progress / Needs Verification
@@ -45,7 +46,6 @@
| 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 | | 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 |
|---|---|---|---|---| |---|---|---|---|---|
| P1 | 查看审批 | `b4d00f1a` | businessKey/processInstanceId 双路解析;接轨迹与业务单据只读页 | 复用 `ApprovalDrawer`/trace |
| P1 | 我的发起任务 | `0db4af06` | 查看详细、撤回;撤回需 Flowable 桥和已流转校验 | 机制① + 流程端点 | | P1 | 我的发起任务 | `0db4af06` | 查看详细、撤回;撤回需 Flowable 桥和已流转校验 | 机制① + 流程端点 |
| P1 | 流程监控 | `9f3b5a8b` | 处理、高级处理、结束流程;高级处理涉及 Groovy 权限/审计 | 机制① + 流程端点,需权限守卫 | | P1 | 流程监控 | `9f3b5a8b` | 处理、高级处理、结束流程;高级处理涉及 Groovy 权限/审计 | 机制① + 流程端点,需权限守卫 |
| P1 | 审批表单删除 | `91ccbba3` | 查看只读表单、删除历史流程实例 | 复用只读审批抽屉 + 流程删除端点 | | P1 | 审批表单删除 | `91ccbba3` | 查看只读表单、删除历史流程实例 | 复用只读审批抽屉 + 流程删除端点 |

View File

@@ -19,7 +19,7 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
**关键结论(回答提问):** **关键结论(回答提问):**
- **"默认引擎即够、零移植"= 0 个。** 这批 46 个全是被挑出来的 engineclass 视图,每个都有 Java delta。但其中 **14 个轻量delta** 实质是"默认页 + 极少量接线",接近零成本。 - **"默认引擎即够、零移植"= 0 个。** 这批 46 个全是被挑出来的 engineclass 视图,每个都有 Java delta。但其中 **14 个轻量delta** 实质是"默认页 + 极少量接线",接近零成本。
- **"有 Java delta 要移植"(轻+中+重)= 36 个。** - **"有 Java delta 要移植"(轻+中+重)= 36 个。**
- **"纯 bespoke 另案"当前剩 5 个**(个人设置/工作日历/报表/查看审批/流程定义);原 10 个中的用户选择框 4 个已切标准 amis picker、流程选择框 1 个已接线,转入业务逐页验收队列。 - **"纯 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 个**。 **去重提醒:**`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 个**。
@@ -41,7 +41,7 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
| 个人设置 (db87828a) | CustomComponent | 纯bespoke | 7 | 聚合设置页 + 改密卡片(MD5 比对/更新)+ 6 个内联子组件需单独分析 | | 个人设置 (db87828a) | CustomComponent | 纯bespoke | 7 | 聚合设置页 + 改密卡片(MD5 比对/更新)+ 6 个内联子组件需单独分析 |
| 工作日历 (a13fa07f) | TemplateComponent | 纯bespoke | 5 | 年历网格 + 单击 toggle 例外日 + 3 态着色 + workCalendarService 端点(服务已存在) | | 工作日历 (a13fa07f) | TemplateComponent | 纯bespoke | 5 | 年历网格 + 单击 toggle 例外日 + 3 态着色 + workCalendarService 端点(服务已存在) |
| 报表 (e81454af) | TreeGridTemplate | 纯bespoke | 5 | DOCUMENT 菜单树 + 右区按 VIEW_TEMPLATEID 路由复用已转换页(宿主/路由器) | | 报表 (e81454af) | TreeGridTemplate | 纯bespoke | 5 | DOCUMENT 菜单树 + 右区按 VIEW_TEMPLATEID 路由复用已转换页(宿主/路由器) |
| 查看审批 (b4d00f1a) | WorkFlowHistory | 纯bespoke | 3 | businessKey→processInstanceId 双路解析 + 接 ProcessInstanceDetailPanel(P1 缺口) | | 查看审批 (b4d00f1a) | WorkFlowHistory | 已完成 | 3 | 通用审批列表「查看审批」已复用只读 ApprovalDrawer,支持 businessKey/processInstanceId 双路历史查看 + 业务单据 + 轨迹 |
| 流程定义 (5628f2e9) | CustomComponent | 纯bespoke | 11 | Flowable Modeler 整页 + 新建/导入/编辑/部署/导出(含 VIEW_WFTEMPLATE 迁移 SQL) | | 流程定义 (5628f2e9) | CustomComponent | 纯bespoke | 11 | Flowable Modeler 整页 + 新建/导入/编辑/部署/导出(含 VIEW_WFTEMPLATE 迁移 SQL) |
| 流程选择框 (b3070157) | Window | 已接线待验 | 1 | 已接 amis transfer-picker + `/api/process-select`,Flowable Model/ProcDef 优先、本地 dev 回退历史流程名;剩流程代理授权保存闭环验收 | | 流程选择框 (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 互斥、权限差异验收 | | 用户选择框-org (1b3bad0b) | UserSelectWindow | 已接线待验 | 2 | 最新已切标准 amis `picker`,数据源 `/api/picker/1b3bad0b-a24b-4347-9466-db78f7432756/list`;多选仅通过 `multiple: true`,弹窗为表格+checkbox+搜索分页;剩真实业务保存、ALL 互斥、权限差异验收 |
@@ -169,7 +169,7 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
| 用户选择框-全部 (090981ba) | 已接线待验 | 已切标准 amis `picker`;剩权限差异验收 | | 用户选择框-全部 (090981ba) | 已接线待验 | 已切标准 amis `picker`;剩权限差异验收 |
| 用户选择框-批量 (e31ce405) | 已接线待验 | 已切标准 amis `picker`;剩排除挂靠业务验收 | | 用户选择框-批量 (e31ce405) | 已接线待验 | 已切标准 amis `picker`;剩排除挂靠业务验收 |
| 流程选择框 (b3070157) | 已接线待验 | 流程多选 picker 已接;剩流程代理授权保存闭环验收 | | 流程选择框 (b3070157) | 已接线待验 | 流程多选 picker 已接;剩流程代理授权保存闭环验收 |
| 查看审批 (b4d00f1a) | **必做 P1** | 正中 memory 记录的 P1 缺口(查看审批未接业务页);双路解析已有基础 | | 查看审批 (b4d00f1a) | 已完成 | 通用审批列表「查看审批」已接只读 ApprovalDrawer;见活清单 2026-06-18 记录 |
| 工作日历 (a13fa07f) | 做 P2 | 后端 workCalendarService 已在,只缺前端年历 + REST,性价比高 | | 工作日历 (a13fa07f) | 做 P2 | 后端 workCalendarService 已在,只缺前端年历 + REST,性价比高 |
| 报表 (e81454af) | 做 P2 | 路由/宿主,右区复用已转换页,逻辑不重但需 DOCUMENT 菜单端点 | | 报表 (e81454af) | 做 P2 | 路由/宿主,右区复用已转换页,逻辑不重但需 DOCUMENT 菜单端点 |
| 个人设置 (db87828a) | 拆做 P2/P3 | 改密卡片 P2(改密接口),6 个内联子组件需先各自分析源文件(暂缓) | | 个人设置 (db87828a) | 拆做 P2/P3 | 改密卡片 P2(改密接口),6 个内联子组件需先各自分析源文件(暂缓) |
@@ -179,7 +179,7 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
**被 EIP4 别的机制覆盖 / 可降级的:** **被 EIP4 别的机制覆盖 / 可降级的:**
- 实体分类-枚举组:树 key 唯一若 EIP4 按父路径生成则**已覆盖**(只需核对)。 - 实体分类-枚举组:树 key 唯一若 EIP4 按父路径生成则**已覆盖**(只需核对)。
- 待办/已办/我的发起任务的"详情/办理页":**已被 EIP4 ApprovalDrawer + WfTemplate 驱动 + 轨迹引擎覆盖**,只补列表入口按钮,不从零搭。 - 待办/已办/我的发起任务的"详情/办理页":**已被 EIP4 ApprovalDrawer + WfTemplate 驱动 + 轨迹引擎覆盖**,只补列表入口按钮,不从零搭。
- 查看审批的 ProcessInstanceDetailPanel:复用轨迹引擎,只缺 businessKey→processInstanceId 解析接线。 - 查看审批的 ProcessInstanceDetailPanel:已复用 ApprovalDrawer/轨迹引擎完成;businessKey 与 processInstanceId 双路只读历史入口已接线。
--- ---
@@ -214,9 +214,8 @@ I have the structure confirmed (eip4-platform / eip4-web live under eip3/). The
**P1(先做:高频/高价值/服务多已就绪,直接产出客户可感知能力)** **P1(先做:高频/高价值/服务多已就绪,直接产出客户可感知能力)**
1. **picker 业务验收** — 用户选择框受控(76d2f950)+org(1b3bad0b)+全部(090981ba)+批量(e31ce405)最新均为标准 amis picker,流程选择框(b3070157)已接线待验;继续验真实保存、权限差异、ALL 互斥、流程代理授权写入。**审批/表单/短消息全链路依赖。** 1. **picker 业务验收** — 用户选择框受控(76d2f950)+org(1b3bad0b)+全部(090981ba)+批量(e31ce405)最新均为标准 amis picker,流程选择框(b3070157)已接线待验;继续验真实保存、权限差异、ALL 互斥、流程代理授权写入。**审批/表单/短消息全链路依赖。**
2. **岗位↔用户 / 主岗位 / 查看菜单 一组按钮** — 分公司岗位+岗位管理(复用 1 套)+用户管理+用户组管理。SYS_* 服务疑似已在,接线即得。 2. **岗位↔用户 / 主岗位 / 查看菜单 一组按钮** — 分公司岗位+岗位管理(复用 1 套)+用户管理+用户组管理。SYS_* 服务疑似已在,接线即得。
3. **查看审批 (b4d00f1a)** — 正中 memory P1 缺口,双路解析 + 复用轨迹引擎。 3. **待办/已办/五建/我的发起 任务按钮(共用跳转逻辑)** — 对接已上线 ApprovalDrawer,补列表入口即闭环。
4. **待办/已办/五建/我的发起 任务按钮(共用跳转逻辑)** — 对接已上线 ApprovalDrawer,补列表入口即闭环。 4. **消息查看一组** — 已发送/收到的消息(查看弹窗 + MessageService + 打开即已读)。
5. **消息查看一组** — 已发送/收到的消息(查看弹窗 + MessageService + 打开即已读)。
**P2(后做:中等 delta,服务需补但范围清晰)** **P2(后做:中等 delta,服务需补但范围清晰)**
6. 通用脚本/XML 编辑器弹窗(机制④)→ 一次性解锁:定义定时任务、数据导入配置脚本、流程监控高级处理、功能/视图编辑列表-自定义 高级配置。 6. 通用脚本/XML 编辑器弹窗(机制④)→ 一次性解锁:定义定时任务、数据导入配置脚本、流程监控高级处理、功能/视图编辑列表-自定义 高级配置。

View File

@@ -704,55 +704,30 @@ public class TemplateToAmisConverter {
} }
/** /**
* 「查看审批」按钮(审批列表通用):dialog → service 调 {@code GET /api/flow/business/${PK}/trace} 拉审批轨迹, * 「查看审批」按钮(审批列表通用):旧系统按选中行业务主键打开 WorkFlowHistoryDetailPanel。
* 表格展示环节/办理人/意见/结果/时间。trace 端点返裸数组,用 adaptor 包成 amis 信封并取出 nodes。 * EIP4 复用全局 ApprovalDrawer 只读模式,展示业务单据 + 流程轨迹,而不再只弹轨迹表。
*/ */
private Map<String, Object> buildViewApprovalButton(String table) { private Map<String, Object> buildViewApprovalButton(String table) {
String pk = table + "_ID"; String pk = table + "_ID";
Map<String, Object> api = new LinkedHashMap<>(); Map<String, Object> args = new LinkedHashMap<>();
api.put("method", "get"); args.put("taskName", "审批详情");
api.put("url", "/api/flow/business/${selectedItems[0]." + pk + "}/trace"); args.put("processInstanceId", "${selectedItems[0].processInstanceId || selectedItems[0].PROCESSINSTANCEID || ''}");
api.put("adaptor", args.put("businessKey", "${selectedItems[0]." + pk + "}");
"return {status:0,msg:'',data:{nodes:Array.isArray(payload)?payload:((payload&&payload.data)||[])}};"); args.put("businessTable", table);
args.put("readOnly", true);
args.put("mode", "read");
List<Object> cols = new ArrayList<>(); Map<String, Object> action = new LinkedHashMap<>();
cols.add(new LinkedHashMap<>(Map.of("name", "taskName", "label", "审批环节"))); action.put("actionType", "openApprovalDrawer");
cols.add(new LinkedHashMap<>(Map.of("name", "assigneeName", "label", "办理人"))); action.put("args", args);
cols.add(new LinkedHashMap<>(Map.of("name", "result", "label", "结果")));
cols.add(new LinkedHashMap<>(Map.of("name", "comment", "label", "审批意见")));
// valueFormat:"x" 告诉 amis 输入是 epoch-ms(trace 节点 startTime/endTime=getTime()),否则被当秒解析成乱码年份。
cols.add(new LinkedHashMap<>(Map.of("name", "startTime", "label", "开始时间",
"type", "date", "format", "YYYY-MM-DD HH:mm", "valueFormat", "x")));
cols.add(new LinkedHashMap<>(Map.of("name", "endTime", "label", "完成时间",
"type", "date", "format", "YYYY-MM-DD HH:mm", "valueFormat", "x")));
Map<String, Object> tbl = new LinkedHashMap<>();
tbl.put("type", "table");
tbl.put("source", "${nodes}");
tbl.put("placeholder", "暂无审批记录");
tbl.put("columns", cols);
Map<String, Object> svc = new LinkedHashMap<>();
svc.put("type", "service");
svc.put("api", api);
svc.put("body", tbl);
Map<String, Object> dlg = new LinkedHashMap<>();
dlg.put("type", "dialog");
dlg.put("title", "审批记录");
dlg.put("size", "lg");
dlg.put("body", svc);
dlg.put("actions", List.of(new LinkedHashMap<>(Map.of(
"type", "button", "actionType", "close", "label", "关闭"))));
Map<String, Object> btn = new LinkedHashMap<>(); Map<String, Object> btn = new LinkedHashMap<>();
btn.put("type", "button"); btn.put("type", "button");
btn.put("id", "查看审批"); btn.put("id", "查看审批");
btn.put("label", "查看审批"); btn.put("label", "查看审批");
btn.put("icon", "fa fa-search"); btn.put("icon", "fa fa-search");
btn.put("actionType", "dialog");
btn.put("disabledOn", DISABLED_ON_NO_SELECTION); btn.put("disabledOn", DISABLED_ON_NO_SELECTION);
btn.put("dialog", dlg); btn.put("onEvent", Map.of("click", Map.of("actions", List.of(action))));
return btn; return btn;
} }

View File

@@ -2773,7 +2773,7 @@ class TemplateToAmisConverterTest {
// ── 查看审批按钮(审批列表统一补)───────────────────────────────────── // ── 查看审批按钮(审批列表统一补)─────────────────────────────────────
/** 审批列表(有提交审批按钮)→ toolbar 统一补「查看审批」按钮(dialog→service 调 trace 端点)。 */ /** 审批列表(有提交审批按钮)→ toolbar 统一补「查看审批」按钮(只读审批抽屉:业务单据 + 轨迹)。 */
@Test @Test
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
void buildToolbar_审批列表补查看审批按钮() { void buildToolbar_审批列表补查看审批按钮() {
@@ -2783,14 +2783,18 @@ class TemplateToAmisConverterTest {
Map<String, Object> schema = converter.convertGraded(xml, new ArrayList<>(), noPage).getSchema(); Map<String, Object> schema = converter.convertGraded(xml, new ArrayList<>(), noPage).getSchema();
List<Object> toolbar = (List<Object>) body(schema).get("headerToolbar"); List<Object> toolbar = (List<Object>) body(schema).get("headerToolbar");
Map<String, Object> view = btnById(toolbar, "查看审批"); Map<String, Object> view = btnById(toolbar, "查看审批");
assertEquals("dialog", view.get("actionType"));
assertEquals(TemplateToAmisConverter.DISABLED_ON_NO_SELECTION, view.get("disabledOn"), assertEquals(TemplateToAmisConverter.DISABLED_ON_NO_SELECTION, view.get("disabledOn"),
"查看审批任何状态可查 → 纯选中态"); "查看审批任何状态可查 → 纯选中态");
Map<String, Object> svc = (Map<String, Object>) ((Map<String, Object>) view.get("dialog")).get("body"); Map<String, Object> onEvent = (Map<String, Object>) view.get("onEvent");
Map<String, Object> api = (Map<String, Object>) svc.get("api"); Map<String, Object> click = (Map<String, Object>) onEvent.get("click");
assertTrue(((String) api.get("url")).contains("/api/flow/business/"), "应调 businessKey→trace 端点"); List<Object> actions = (List<Object>) click.get("actions");
assertTrue(((String) api.get("url")).contains("PM_DEMO_ID"), "应传选中行业务主键"); Map<String, Object> action = (Map<String, Object>) actions.get(0);
assertTrue(((String) api.get("adaptor")).contains("nodes"), "adaptor 把裸数组包成 amis 信封"); assertEquals("openApprovalDrawer", action.get("actionType"));
Map<String, Object> args = (Map<String, Object>) action.get("args");
assertEquals("${selectedItems[0].PM_DEMO_ID}", args.get("businessKey"));
assertEquals("PM_DEMO", args.get("businessTable"));
assertEquals(true, args.get("readOnly"));
assertEquals("read", args.get("mode"));
} }
/** 非审批列表(无提交审批按钮)→ 不补查看审批按钮。 */ /** 非审批列表(无提交审批按钮)→ 不补查看审批按钮。 */

View File

@@ -15,6 +15,7 @@ import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController; import org.springframework.web.bind.annotation.RestController;
import com.dsasp.server.common.core.service.FlowExcuteService; import com.dsasp.server.common.core.service.FlowExcuteService;
@@ -141,24 +142,61 @@ public class ApprovalController {
wfTemplateService.parse(ctx.formKey), ctx.startFormKey); wfTemplateService.parse(ctx.formKey), ctx.startFormKey);
String table = businessSummaryService.summarize(ctx.businessKey).tableName(); String table = businessSummaryService.summarize(ctx.businessKey).tableName();
Map<String, Object> record = businessRecordLoader.load(formMeta.loadScript(), table, ctx.businessKey); Map<String, Object> record = businessRecordLoader.load(formMeta.loadScript(), table, ctx.businessKey);
// 引用列 id→名(全站统一口径):主表 + 子表行补 <COL>_DISPLAY__,前端引用列显名不显 id resolveDisplayColumns(table, record);
if (table != null && record != null && !record.isEmpty()) { envelope.put("data", record);
try { return ResponseEntity.ok(envelope);
userColumnResolver.resolveFormRecord(table, record); }
} catch (RuntimeException e) {
log.debug("[审批表单] 引用列解析降级 table={}: {}", table, e.toString()); @Operation(summary = "历史审批元数据(按业务主键或流程实例,只读)",
} description = "用于转换页通用「查看审批」按钮。支持 businessKey/processInstanceId 双路解析,"
// 多选人员列(值为 id 列表,如接收人 NOTICEDRAFTPEOPLES,元数据未登记为引用列单值解析漏掉)→ 解析为姓名串 + "返回可复用 ApprovalDrawer 的只读业务表单模板、业务表与流程实例信息。")
try { @GetMapping("/api/approval/history/meta")
for (Map.Entry<String, Object> e : new java.util.ArrayList<>(record.entrySet())) { public ResponseEntity<Map<String, Object>> historyMeta(
if (e.getValue() instanceof List<?> list && !list.isEmpty() && list.get(0) instanceof String) { @RequestParam(required = false) String businessKey,
record.put(e.getKey() + "_DISPLAY__", userColumnResolver.joinUserDisplayNames(list)); @RequestParam(required = false) String processInstanceId,
} @RequestParam(required = false) String businessTable) {
} String processId = trimToNull(processInstanceId);
} catch (RuntimeException e) { ProcessInstanceDto pi = tryProcessInstance(processId);
log.debug("[审批表单] 多选人员列解析降级 table={}: {}", table, e.toString()); String bk = firstNonBlank(businessKey, pi == null ? null : pi.businessKey);
} String table = resolveTable(businessTable, bk);
}
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("found", bk != null || processId != null);
resp.put("taskId", "");
resp.put("taskName", "审批详情");
resp.put("formKey", null);
resp.put("buttons", List.of());
resp.put("buttonsSource", "default");
resp.put("loadScript", null);
resp.put("showsend", false);
resp.put("businessKey", bk);
resp.put("businessTable", table);
resp.put("businessTableName", wfTemplateService.entityDisplayName(table));
resp.put("processInstanceId", processId);
resp.put("ended", pi != null && pi.ended);
resp.put("suspended", pi != null && pi.suspended);
resp.put("formTemplateId", wfTemplateService.resolveBusinessFormTemplateId(null, table));
return ResponseEntity.ok(resp);
}
@Operation(summary = "历史审批业务单据数据(只读)",
description = "用于无 taskId 的审批历史查看。优先按 businessKey+业务表载入;若只给 processInstanceId,"
+ "先查流程实例取 businessKey,再走表单加载服务。返回 amis 单记录契约 {status:0,data:{...record}}。")
@GetMapping("/api/approval/history/business-data")
public ResponseEntity<Map<String, Object>> historyBusinessData(
@RequestParam(required = false) String businessKey,
@RequestParam(required = false) String processInstanceId,
@RequestParam(required = false) String businessTable) {
String processId = trimToNull(processInstanceId);
ProcessInstanceDto pi = tryProcessInstance(processId);
String bk = firstNonBlank(businessKey, pi == null ? null : pi.businessKey);
String table = resolveTable(businessTable, bk);
Map<String, Object> envelope = new LinkedHashMap<>();
envelope.put("status", 0);
envelope.put("msg", "");
Map<String, Object> record = businessRecordLoader.load(null, table, bk);
resolveDisplayColumns(table, record);
envelope.put("data", record); envelope.put("data", record);
return ResponseEntity.ok(envelope); return ResponseEntity.ok(envelope);
} }
@@ -357,6 +395,53 @@ public class ApprovalController {
return pi == null || pi.ended; return pi == null || pi.ended;
} }
private ProcessInstanceDto tryProcessInstance(String processInstanceId) {
if (processInstanceId == null || processInstanceId.isBlank()) {
return null;
}
try {
return flowableClient.processInstance(processInstanceId);
} catch (RuntimeException e) {
log.debug("[审批历史] 流程实例解析降级 processInstanceId={}: {}", processInstanceId, e.toString());
return null;
}
}
/** 引用列 id→名(全站统一口径):主表 + 子表行补 <COL>_DISPLAY__,前端引用列显名不显 id。 */
private void resolveDisplayColumns(String table, Map<String, Object> record) {
if (table == null || record == null || record.isEmpty()) {
return;
}
try {
userColumnResolver.resolveFormRecord(table, record);
} catch (RuntimeException e) {
log.debug("[审批表单] 引用列解析降级 table={}: {}", table, e.toString());
}
// 多选人员列(值为 id 列表,如接收人 NOTICEDRAFTPEOPLES,元数据未登记为引用列单值解析漏掉)→ 解析为姓名串
try {
for (Map.Entry<String, Object> e : new java.util.ArrayList<>(record.entrySet())) {
if (e.getValue() instanceof List<?> list && !list.isEmpty() && list.get(0) instanceof String) {
record.put(e.getKey() + "_DISPLAY__", userColumnResolver.joinUserDisplayNames(list));
}
}
} catch (RuntimeException e) {
log.debug("[审批表单] 多选人员列解析降级 table={}: {}", table, e.toString());
}
}
private static String trimToNull(String value) {
if (value == null) {
return null;
}
String s = value.trim();
return s.isEmpty() ? null : s;
}
private static String firstNonBlank(String a, String b) {
String aa = trimToNull(a);
return aa != null ? aa : trimToNull(b);
}
private static List<Map<String, Object>> buttonsToMaps(WfTemplateMeta meta) { private static List<Map<String, Object>> buttonsToMaps(WfTemplateMeta meta) {
List<Map<String, Object>> list = new ArrayList<>(); List<Map<String, Object>> list = new ArrayList<>();
for (WfTemplateService.Button b : meta.buttons()) { for (WfTemplateService.Button b : meta.buttons()) {

View File

@@ -0,0 +1,84 @@
package com.eip4.platform.flowgateway;
import static org.assertj.core.api.Assertions.assertThat;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.verifyNoInteractions;
import static org.mockito.Mockito.when;
import java.util.LinkedHashMap;
import java.util.Map;
import org.junit.jupiter.api.Test;
import org.springframework.http.ResponseEntity;
import com.dsasp.server.common.core.service.FlowExcuteService;
import com.eip4.platform.flowgateway.aggregate.BusinessRecordLoader;
import com.eip4.platform.flowgateway.aggregate.BusinessSummaryService;
import com.eip4.platform.flowgateway.aggregate.WfTemplateService;
import com.eip4.platform.flowgateway.client.FlowableClient;
import com.eip4.platform.flowgateway.client.ProcessInstanceDto;
import com.eip4.platform.flowgateway.web.ApprovalController;
import com.eip4.platform.flowgateway.writeback.StatusWriteback;
import com.eip4.platform.metadata.flow.UserColumnResolver;
class ApprovalControllerHistoryTest {
private final FlowableClient flowableClient = mock(FlowableClient.class);
private final WfTemplateService wfTemplateService = mock(WfTemplateService.class);
private final BusinessSummaryService businessSummaryService = mock(BusinessSummaryService.class);
private final StatusWriteback statusWriteback = mock(StatusWriteback.class);
private final FlowExcuteService flowExcuteService = mock(FlowExcuteService.class);
private final BusinessRecordLoader businessRecordLoader = mock(BusinessRecordLoader.class);
private final UserColumnResolver userColumnResolver = mock(UserColumnResolver.class);
private final ApprovalController controller = new ApprovalController(flowableClient, wfTemplateService,
businessSummaryService, statusWriteback, flowExcuteService, businessRecordLoader, userColumnResolver);
@Test
@SuppressWarnings("unchecked")
void historyMeta_byBusinessKey_resolvesTableAndReadonlyFormTemplate() {
when(businessSummaryService.summarize("BK-1"))
.thenReturn(new BusinessSummaryService.Summary("OA_NOTICE", Map.of("TITLE", "会议通知")));
when(wfTemplateService.entityDisplayName("OA_NOTICE")).thenReturn("通知管理");
when(wfTemplateService.resolveBusinessFormTemplateId(null, "OA_NOTICE")).thenReturn("edit-tpl");
ResponseEntity<Map<String, Object>> response = controller.historyMeta("BK-1", null, null);
Map<String, Object> body = response.getBody();
assertThat(body).isNotNull();
assertThat(body).containsEntry("found", true)
.containsEntry("businessKey", "BK-1")
.containsEntry("businessTable", "OA_NOTICE")
.containsEntry("businessTableName", "通知管理")
.containsEntry("formTemplateId", "edit-tpl")
.containsEntry("taskId", "")
.containsEntry("taskName", "审批详情");
assertThat((java.util.List<Map<String, Object>>) body.get("buttons")).isEmpty();
verifyNoInteractions(flowableClient);
}
@Test
void historyBusinessData_byProcessInstance_usesProcessBusinessKeyAndResolvesDisplayColumns() {
ProcessInstanceDto pi = new ProcessInstanceDto();
pi.id = "pi-1";
pi.businessKey = "BK-1";
when(flowableClient.processInstance("pi-1")).thenReturn(pi);
when(businessSummaryService.summarize("BK-1"))
.thenReturn(new BusinessSummaryService.Summary("OA_NOTICE", Map.of()));
Map<String, Object> record = new LinkedHashMap<>();
record.put("OA_NOTICE_ID", "BK-1");
record.put("TITLE", "会议通知");
when(businessRecordLoader.load(null, "OA_NOTICE", "BK-1")).thenReturn(record);
ResponseEntity<Map<String, Object>> response = controller.historyBusinessData(null, "pi-1", null);
Map<String, Object> body = response.getBody();
assertThat(body).isNotNull();
assertThat(body).containsEntry("status", 0).containsEntry("msg", "");
assertThat(body.get("data")).isSameAs(record);
verify(businessRecordLoader).load(null, "OA_NOTICE", "BK-1");
verify(userColumnResolver).resolveFormRecord(eq("OA_NOTICE"), any());
}
}