成立单独的冀北技术监督项目

pqs-bpm/bpm-api/src/main/java/com/njcn/bpm/api/BpmProcessFeignClient.java

@@ -0,0 +1,30 @@
+package com.njcn.bpm.api;
+
+import com.njcn.bpm.api.fallback.BpmProcessFeignClientFallbackFactory;
+import com.njcn.bpm.pojo.dto.BpmProcessInstanceCreateReqDTO;
+import com.njcn.common.pojo.constant.ServerInfo;
+import com.njcn.common.pojo.response.HttpResult;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+
+/**
+ * 流程实例 Api 接口
+ *
+ * @author 芋道源码
+ */
+@FeignClient(value = ServerInfo.SUPERVISION,path = "/process",fallbackFactory = BpmProcessFeignClientFallbackFactory.class)
+public interface BpmProcessFeignClient {
+
+    /**
+     *
+     * @param userId 用户编号
+     * @param reqDTO 创建信息
+     * @return 实例的编号
+     */
+    @PostMapping("/createProcessInstance")
+    HttpResult<String> createProcessInstance(@RequestParam("userId") String userId, @RequestBody BpmProcessInstanceCreateReqDTO reqDTO);
+
+}

pqs-bpm/bpm-api/src/main/java/com/njcn/bpm/api/fallback/BpmProcessFeignClientFallbackFactory.java

@@ -0,0 +1,39 @@
+package com.njcn.bpm.api.fallback;
+
+import com.njcn.bpm.api.BpmProcessFeignClient;
+import com.njcn.bpm.pojo.dto.BpmProcessInstanceCreateReqDTO;
+import com.njcn.bpm.utils.BpmEnumUtil;
+import com.njcn.common.pojo.enums.response.CommonResponseEnum;
+import com.njcn.common.pojo.exception.BusinessException;
+import com.njcn.common.pojo.response.HttpResult;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+import feign.hystrix.FallbackFactory;
+
+/**
+ * @author denghuajun
+ * @version 1.0.0
+ * @date 2022/3/16
+ */
+@Slf4j
+@Component
+public class BpmProcessFeignClientFallbackFactory implements FallbackFactory<BpmProcessFeignClient> {
+    @Override
+    public BpmProcessFeignClient create(Throwable throwable) {
+        //判断抛出异常是否为解码器抛出的业务异常
+        Enum<?> exceptionEnum = CommonResponseEnum.SERVICE_FALLBACK;
+        if (throwable.getCause() instanceof BusinessException) {
+            BusinessException businessException = (BusinessException) throwable.getCause();
+            exceptionEnum = BpmEnumUtil.getExceptionEnum(businessException.getResult());
+        }
+        Enum<?> finalExceptionEnum = exceptionEnum;
+        return new BpmProcessFeignClient() {
+            @Override
+            public HttpResult<String> createProcessInstance(String userId, BpmProcessInstanceCreateReqDTO reqDTO) {
+                log.error("{}异常，降级处理，异常为：{}", "创建流程实例", throwable.toString());
+                throw new BusinessException(finalExceptionEnum);
+            }
+
+        };
+    }
+}

pqs-bpm/bpm-api/src/main/java/com/njcn/bpm/enums/BpmConstants.java

@@ -1,40 +0,0 @@
-package com.njcn.bpm.enums;
-
-import org.flowable.engine.runtime.ProcessInstance;
-
-/**
- * BPM 通用常量
- *
- * @author 芋道源码
- */
-public class BpmConstants {
-
-    /**
-     * 流程实例的变量 - 状态
-     *
-     * @see ProcessInstance#getProcessVariables()
-     */
-    public static final String PROCESS_INSTANCE_VARIABLE_STATUS = "PROCESS_STATUS";
-    /**
-     * 流程实例的变量 - 发起用户选择的审批人 Map
-     *
-     * @see ProcessInstance#getProcessVariables()
-     */
-    public static final String PROCESS_INSTANCE_VARIABLE_START_USER_SELECT_ASSIGNEES = "PROCESS_START_USER_SELECT_ASSIGNEES";
-
-    /**
-     * 任务的变量 - 状态
-     *
-     * @see org.flowable.task.api.Task#getTaskLocalVariables()
-     */
-    public static final String TASK_VARIABLE_STATUS = "TASK_STATUS";
-    /**
-     * 任务的变量 - 理由
-     *
-     * 例如说：审批通过、不通过的理由
-     *
-     * @see org.flowable.task.api.Task#getTaskLocalVariables()
-     */
-    public static final String TASK_VARIABLE_REASON = "TASK_REASON";
-
-}

pqs-bpm/bpm-api/src/main/java/com/njcn/bpm/enums/BpmProcessInstanceStatusEnum.java

@@ -0,0 +1,38 @@
+package com.njcn.bpm.enums;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * 流程实例 ProcessInstance 的状态
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum BpmProcessInstanceStatusEnum implements IntArrayValuable {
+
+    RUNNING(1, "审批中"),
+    APPROVE(2, "审批通过"),
+    REJECT(3, "审批不通过"),
+    CANCEL(4, "已取消");
+
+    public static final int[] ARRAYS = Arrays.stream(values()).mapToInt(BpmProcessInstanceStatusEnum::getStatus).toArray();
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 描述
+     */
+    private final String desc;
+
+    @Override
+    public int[] array() {
+        return new int[0];
+    }
+
+}

pqs-bpm/bpm-api/src/main/java/com/njcn/bpm/enums/BpmResponseEnum.java

@@ -25,6 +25,10 @@ public enum BpmResponseEnum {
 
     PROCESS_DEFINITION_NOT_EXISTS("A00568","流程定义不存在"),
 
+
+
+    PROCESS_DEFINITION_IS_SUSPENDED("A00568", "流程定义处于挂起状态"),
+
     FORM_NOT_EXISTS("A00568","动态表单不存在"),
 
     MODEL_DEPLOY_FAIL_FORM_NOT_CONFIG("A00568","部署流程失败，原因：流程表单未配置，请点击【修改流程】按钮进行配置"),

pqs-bpm/bpm-api/src/main/java/com/njcn/bpm/pojo/dto/BpmProcessInstanceCreateReqDTO.java

@@ -0,0 +1,44 @@
+package com.njcn.bpm.pojo.dto;
+
+import lombok.Builder;
+import lombok.Data;
+
+import javax.validation.constraints.NotEmpty;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 流程实例的创建 Request DTO
+ */
+@Data
+public class BpmProcessInstanceCreateReqDTO {
+
+    /**
+     * 流程定义的标识
+     */
+    @NotEmpty(message = "流程定义的标识不能为空")
+    private String processDefinitionKey;
+
+    /**
+     * 变量实例（动态表单）
+     */
+    private Map<String, Object> variables;
+
+    /**
+     * 业务的唯一标识
+     *
+     * 例如说，请假申请的编号。通过它，可以查询到对应的实例
+     */
+    @NotEmpty(message = "业务的唯一标识")
+    private String businessKey;
+
+    /**
+     * 发起人自选审批人 Map
+     *
+     * key：taskKey 任务编码
+     * value：审批人的数组
+     * 例如：{ taskKey1 :[1, 2] }，则表示 taskKey1 这个任务，提前设定了，由 userId 为 1,2 的用户进行审批
+     */
+    private Map<String, List<String>> startUserSelectAssignees;
+
+}

pqs-bpm/bpm-api/src/main/java/com/njcn/bpm/pojo/param/BpmModelParam.java

@@ -44,9 +44,10 @@ public class BpmModelParam implements Serializable {
 
     private Integer formType = 10;
 
-
+    @ApiModelProperty("表单提交路由")
     private String formCustomCreatePath;
 
+    @ApiModelProperty("表单查看路由")
     private String formCustomViewPath;
 
     /**

pqs-bpm/bpm-api/src/main/java/com/njcn/bpm/utils/BpmEnumUtil.java

@@ -15,7 +15,7 @@ import java.util.Objects;
  * @version 1.0.0
  * @date 2021年12月20日 10:03
  */
-public class ProcessEnumUtil {
+public class BpmEnumUtil {
 
     /**
      * 获取HarmonicResponseEnum实例