[feat] 新增合同管理中的流程查询功能

yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApi.java

@@ -2,8 +2,12 @@ package cn.iocoder.yudao.module.bpm.api.task;
 
 import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO;
 
+import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceRespDTO;
+import cn.iocoder.yudao.module.bpm.api.task.dto.BpmTaskRespDTO;
 import jakarta.validation.Valid;
 
+import java.util.List;
+
 /**
  * 流程实例 Api 接口
  *
@@ -20,4 +24,20 @@ public interface BpmProcessInstanceApi {
      */
     String createProcessInstance(Long userId, @Valid BpmProcessInstanceCreateReqDTO reqDTO);
 
+
+    /**
+     * 查询流程
+     *
+     * @param id 流程id
+     * @return
+     */
+    BpmProcessInstanceRespDTO getProcessInstance(String id);
+
+
+    /**
+     * 查询指定流程的任务
+     * @param id 流程id
+     * @return
+     */
+    List<BpmTaskRespDTO> getTask(String id);
 }

yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/api/task/dto/BpmProcessDefinitionRespDTO.java

@@ -0,0 +1,115 @@
+package cn.iocoder.yudao.module.bpm.api.task.dto;
+
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 流程定义
+ */
+@Data
+public class BpmProcessDefinitionRespDTO {
+    /**
+     * 编号
+     */
+    private String id;
+
+    /**
+     * 版本
+     */
+    private Integer version;
+
+    /**
+     * 流程名称
+     */
+    private String name;
+
+    /**
+     * 流程标识
+     */
+    private String key;
+
+    /**
+     * 流程图标
+     */
+    private String icon;
+
+    /**
+     * 流程描述
+     */
+    private String description;
+
+    /**
+     * 流程分类
+     */
+    private String category;
+    /**
+     * 流程分类名字
+     */
+    private String categoryName;
+
+    /**
+     * 表单类型
+     */
+    private Integer formType;
+
+    /**
+     * 表单编号
+     */
+    private Long formId;
+
+    /**
+     * 表单名字
+     */
+    private String formName;
+    /**
+     * 表单的配置
+     */
+    private String formConf;
+
+    /**
+     * 表单项的数组
+     */
+    private List<String> formFields;
+
+    /**
+     * 自定义表单的提交路径
+     */
+    private String formCustomCreatePath;
+
+    /**
+     * 自定义表单的查看路径
+     */
+    private String formCustomViewPath;
+
+    /**
+     * 中断状态-参见 SuspensionState 枚举
+     */
+    private Integer suspensionState; // 参见 SuspensionState 枚举
+
+    /**
+     * 部署时间
+     */
+    private LocalDateTime deploymentTime; // 需要从对应的 Deployment 读取，非必须返回
+
+    /**
+     * BPMN XML
+     */
+    private String bpmnXml; // 需要从对应的 BpmnModel 读取，非必须返回
+
+    /**
+     * 发起用户需要选择审批人的任务数组
+     */
+    private List<UserTask> startUserSelectTasks; // 需要从对应的 BpmnModel 读取，非必须返回
+
+    @Data
+    public static class UserTask {
+
+        private String id;
+
+        private String name;
+
+    }
+
+}

yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/api/task/dto/BpmProcessInstanceRespDTO.java

@@ -0,0 +1,118 @@
+package cn.iocoder.yudao.module.bpm.api.task.dto;
+
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 流程实例的获得 Resp DTO
+ */
+@Data
+public class BpmProcessInstanceRespDTO {
+
+    /**
+     * 流程实例编号
+     */
+    private String id;
+
+    /**
+     * 流程实例名称
+     */
+    private String name;
+
+    /**
+     * 流程分类
+     */
+    private String category;
+
+    /**
+     * 流程分类名称
+     */
+    private String categoryName;
+
+    /**
+     * 流程实例状态
+     */
+    private Integer status; // 参见 BpmProcessInstanceStatusEnum 枚举
+
+    /**
+     * 发起时间
+     */
+    private LocalDateTime startTime;
+
+    /**
+     * 结束时间
+     */
+    private LocalDateTime endTime;
+
+    /**
+     * 持续时间
+     */
+    private Long durationInMillis;
+
+    /**
+     * 发起流程的用户
+     */
+    private User startUser;
+
+    /**
+     * 流程定义编号
+     */
+
+    private String processDefinitionId;
+    /**
+     * 流程定义
+     */
+    private BpmProcessDefinitionRespDTO processDefinition;
+
+
+    /**
+     * 当前审批中的任务
+     */
+    private List<Task> tasks; // 仅在流程实例分页才返回
+
+    /**
+     * 用户信息
+     */
+    @Data
+    public static class User {
+        /**
+         * 用户编号
+         */
+        private Long id;
+        /**
+         * 用户名称
+         */
+        private String nickname;
+        /**
+         * 部门编号
+         */
+        private Long deptId;
+        /**
+         * 部门名称
+         */
+        private String deptName;
+
+    }
+
+    /**
+     * 流程任务
+     */
+    @Data
+    public static class Task {
+
+        /**
+         * 流程任务编号
+         */
+        private String id;
+
+        /**
+         * 任务名称
+         */
+        private String name;
+
+
+    }
+
+}

yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/api/task/dto/BpmTaskRespDTO.java

@@ -0,0 +1,144 @@
+package cn.iocoder.yudao.module.bpm.api.task.dto;
+
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+
+
+/**
+ * 指定流程实例的任务
+ */
+@Data
+public class BpmTaskRespDTO {
+
+    /**
+     * 任务编号
+     */
+    private String id;
+
+    /**
+     * 任务名字
+     */
+    private String name;
+
+    /**
+     * 创建时间
+     */
+
+    private LocalDateTime createTime;
+
+    /**
+     * 结束时间
+     */
+    private LocalDateTime endTime;
+
+
+    /**
+     * 持续时间
+     */
+    private Long durationInMillis;
+
+    /**
+     * 任务状态
+     */
+    private Integer status; // 参见 BpmTaskStatusEnum 枚举
+
+    /**
+     * 审批理由
+     */
+    private String reason;
+
+    /**
+     * 负责人的用户信息
+     */
+    private BpmProcessInstanceRespDTO.User ownerUser;
+    /**
+     * 审核的用户信息
+     */
+    private BpmProcessInstanceRespDTO.User assigneeUser;
+
+    /**
+     * 任务定义的标识
+     */
+    private String taskDefinitionKey;
+
+    /**
+     * 所属流程实例编号
+     */
+    private String processInstanceId;
+    /**
+     * 所属流程实例
+     */
+    private ProcessInstance processInstance;
+
+    /**
+     * 父任务编号
+     */
+    private String parentTaskId;
+
+    /**
+     * 子任务列表（由加签生成）
+     */
+    private List<BpmTaskRespDTO> children;
+
+    /**
+     * 表单编号
+     */
+    private Long formId;
+
+    /**
+     * 表单名字
+     */
+    private String formName;
+
+    /**
+     * 表单的配置-JSON 字符串
+     */
+    private String formConf;
+
+    /**
+     * 表单项的数组
+     */
+    private List<String> formFields;
+
+    /**
+     * 提交的表单值
+     */
+    private Map<String, Object> formVariables;
+
+
+    /**
+     * 流程实例
+     */
+    @Data
+    public static class ProcessInstance {
+
+        /**
+         * 流程实例编号
+         */
+        private String id;
+
+        /**
+         * 流程实例名称
+         */
+        private String name;
+
+        /**
+         * 提交时间
+         */
+        private LocalDateTime createTime;
+
+        /**
+         * 流程定义的编号
+         */
+        private String processDefinitionId;
+
+        /**
+         * 发起人的用户信息
+         */
+        private BpmProcessInstanceRespDTO.User startUser;
+
+    }
+}