feat(oapi): 办件进度/流程图token出图/托管撤回 + CAS直嵌示意图（两会话产物合入）

2026-09-17 01:03:57 +08:00
parent b8441065d0
commit 6afc7d7b92
10 changed files with 978 additions and 1 deletions
@@ -87,4 +87,62 @@ public final class OapiModels {
    public static class CallbackRegResultVo {
        private String secret;
    }
+
+    /**
+     * 办件进度（结构化轨迹，2026-09-16 用户拍板：SDK 对外提供图3/图4时间线数据源）。
+     * steps 按 nodeId 任务到达顺序聚合（同人多任务行保留原始顺序），发起申请固定为第 0 步。
+     * SDK DTO com.yunhai.platform.openapi.flow.model.FlowProgress 与本契约逐字对齐。
+     */
+    @Data
+    public static class ProgressVo {
+        private Long instanceId;
+        private String bizType;
+        private String bizId;
+        private String bizTitle;
+        /** 办件状态：10 审批中 / 20 已完成 / 30 已拒绝 / 40 已撤回 */
+        private Integer status;
+        private String currentNodes;
+        private Integer submitterId;
+        private String submitterName;
+        private String submitTime;
+        private String finishTime;
+        private List<ProgressStepVo> steps;
+    }
+
+    /** 进度步骤（同一节点全部任务行聚合为一步，b 会签时 assignees 多行） */
+    @Data
+    public static class ProgressStepVo {
+        private String nodeId;
+        private String nodeName;
+        /** 步骤标签：发起申请/待审核/已同意/已拒绝/已退回/已移交/失效（任务状态汇总口径见 FlowProgress.stage） */
+        private String label;
+        /** 节点当前是否在办 */
+        private boolean active;
+        private List<ProgressTaskVo> assignees;
+    }
+
+    /** 进度步骤内的办理人行（多人步骤每人一条；状态取自该行任务真实状态） */
+    @Data
+    public static class ProgressTaskVo {
+        private Long taskId;
+        private Integer userId;
+        private String userName;
+        /** 任务状态：0 待办 / 1 同意 / 2 拒绝 / 3 失效 / 4 已退回 / 5 已移交 */
+        private Integer status;
+        private String statusLabel;
+        private String opinion;
+        private String arriveTime;
+        private String handleTime;
+        /** 多出口节点办理时所选出口名 */
+        private String edgeName;
+    }
+
+    /** 流程图图片流换图响应（token 换图模式：imgUrl 可直接放 <img src>，免 app-sign） */
+    @Data
+    public static class DiagramUrlVo {
+        /** 免签图片端点相对路径（?token=xxx），消费方可拼到本服务的对外网关地址后 */
+        private String imgUrl;
+        /** 相对 token 有效期（秒） */
+        private long expiresIn;
+    }
 }