1. 升级 3.0.35 补全 bpm api

pom.xml

@@ -32,7 +32,7 @@
     <url>https://github.com/YunaiV/ruoyi-vue-pro</url>
 
     <properties>
-        <revision>3.0.34</revision>
+        <revision>3.0.35</revision>
         <!-- Maven 相关 -->
         <java.version>17</java.version>
         <maven.compiler.source>${java.version}</maven.compiler.source>

zt-dependencies/pom.xml

@@ -26,7 +26,7 @@
     <url>https://github.com/YunaiV/ruoyi-vue-pro</url>
 
     <properties>
-        <revision>3.0.34</revision>
+        <revision>3.0.35</revision>
         <flatten-maven-plugin.version>1.6.0</flatten-maven-plugin.version>
         <!-- 统一依赖管理 -->
         <spring.boot.version>3.4.5</spring.boot.version>

zt-gateway/src/main/resources/application.yaml

@@ -264,6 +264,9 @@ knife4j:
       - name: iot-server
         service-name: iot-server
         url: /admin-api/iot/v3/api-docs
+      - name: template-server
+        service-name: template-server
+        url: /admin-api/template/v3/api-docs
 
 --- #################### 芋道相关配置 ####################
 

zt-module-bpm/zt-module-bpm-api/src/main/java/com/zt/plat/module/bpm/api/definition/BpmCategoryApi.java

@@ -0,0 +1,55 @@
+package com.zt.plat.module.bpm.api.definition;
+
+import com.zt.plat.framework.common.pojo.CommonResult;
+import com.zt.plat.framework.common.pojo.PageResult;
+import com.zt.plat.module.bpm.api.definition.dto.BpmCategoryPageReqDTO;
+import com.zt.plat.module.bpm.api.definition.dto.BpmCategoryRespDTO;
+import com.zt.plat.module.bpm.api.definition.dto.BpmCategorySaveReqDTO;
+import com.zt.plat.module.bpm.enums.ApiConstants;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@FeignClient(name = ApiConstants.NAME)
+@Tag(name = "RPC 服务 - BPM 流程分类")
+public interface BpmCategoryApi {
+
+    String PREFIX = ApiConstants.PREFIX + "/category";
+
+    @PostMapping(PREFIX + "/create")
+    @Operation(summary = "创建流程分类")
+    CommonResult<Long> createCategory(@Valid @RequestBody BpmCategorySaveReqDTO createReqDTO);
+
+    @PutMapping(PREFIX + "/update")
+    @Operation(summary = "更新流程分类")
+    CommonResult<Boolean> updateCategory(@Valid @RequestBody BpmCategorySaveReqDTO updateReqDTO);
+
+    @PutMapping(PREFIX + "/update-sort-batch")
+    @Operation(summary = "批量更新流程分类的排序")
+    @Parameter(name = "ids", description = "分类编号列表", required = true, example = "1,2,3")
+    CommonResult<Boolean> updateCategorySortBatch(@RequestParam("ids") List<Long> ids);
+
+    @DeleteMapping(PREFIX + "/delete")
+    @Operation(summary = "删除流程分类")
+    @Parameter(name = "id", description = "编号", required = true)
+    CommonResult<Boolean> deleteCategory(@RequestParam("id") Long id);
+
+    @GetMapping(PREFIX + "/get")
+    @Operation(summary = "获得流程分类")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    CommonResult<BpmCategoryRespDTO> getCategory(@RequestParam("id") Long id);
+
+    @PostMapping(PREFIX + "/page")
+    @Operation(summary = "获得流程分类分页")
+    CommonResult<PageResult<BpmCategoryRespDTO>> getCategoryPage(@Valid @RequestBody BpmCategoryPageReqDTO pageReqDTO);
+
+    @GetMapping(PREFIX + "/simple-list")
+    @Operation(summary = "获取流程分类的精简信息列表", description = "只包含被开启的分类，主要用于前端的下拉选项")
+    CommonResult<List<BpmCategoryRespDTO>> getCategorySimpleList();
+
+}

zt-module-bpm/zt-module-bpm-api/src/main/java/com/zt/plat/module/bpm/api/definition/BpmFormApi.java

@@ -0,0 +1,50 @@
+package com.zt.plat.module.bpm.api.definition;
+
+import com.zt.plat.framework.common.pojo.CommonResult;
+import com.zt.plat.framework.common.pojo.PageResult;
+import com.zt.plat.module.bpm.api.definition.dto.BpmFormPageReqDTO;
+import com.zt.plat.module.bpm.api.definition.dto.BpmFormRespDTO;
+import com.zt.plat.module.bpm.api.definition.dto.BpmFormSaveReqDTO;
+import com.zt.plat.module.bpm.enums.ApiConstants;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@FeignClient(name = ApiConstants.NAME)
+@Tag(name = "RPC 服务 - 动态表单")
+public interface BpmFormApi {
+
+    String PREFIX = ApiConstants.PREFIX + "/form";
+
+    @PostMapping(PREFIX + "/create")
+    @Operation(summary = "创建动态表单")
+    CommonResult<Long> createForm(@Valid @RequestBody BpmFormSaveReqDTO createReqDTO);
+
+    @PutMapping(PREFIX + "/update")
+    @Operation(summary = "更新动态表单")
+    CommonResult<Boolean> updateForm(@Valid @RequestBody BpmFormSaveReqDTO updateReqDTO);
+
+    @DeleteMapping(PREFIX + "/delete")
+    @Operation(summary = "删除动态表单")
+    @Parameter(name = "id", description = "编号", required = true)
+    CommonResult<Boolean> deleteForm(@RequestParam("id") Long id);
+
+    @GetMapping(PREFIX + "/get")
+    @Operation(summary = "获得动态表单")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    CommonResult<BpmFormRespDTO> getForm(@RequestParam("id") Long id);
+
+    @PostMapping(PREFIX + "/page")
+    @Operation(summary = "获得动态表单分页")
+    CommonResult<PageResult<BpmFormRespDTO>> getFormPage(@Valid @RequestBody BpmFormPageReqDTO pageReqDTO);
+
+    @GetMapping(PREFIX + "/simple-list")
+    @Operation(summary = "获得动态表单的精简列表", description = "用于表单下拉框")
+    CommonResult<List<BpmFormRespDTO>> getFormSimpleList();
+
+}

zt-module-bpm/zt-module-bpm-api/src/main/java/com/zt/plat/module/bpm/api/definition/BpmUserGroupApi.java

@@ -0,0 +1,29 @@
+package com.zt.plat.module.bpm.api.definition;
+
+import com.zt.plat.framework.common.pojo.CommonResult;
+import com.zt.plat.module.bpm.api.definition.dto.BpmUserGroupRespDTO;
+import com.zt.plat.module.bpm.enums.ApiConstants;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@FeignClient(name = ApiConstants.NAME)
+@Tag(name = "RPC 服务 - 用户组")
+public interface BpmUserGroupApi {
+
+    String PREFIX = ApiConstants.PREFIX + "/user-group";
+
+    @GetMapping(PREFIX + "/get")
+    @Operation(summary = "获得用户组")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    CommonResult<BpmUserGroupRespDTO> getUserGroup(@RequestParam("id") Long id);
+
+    @GetMapping(PREFIX + "/simple-list")
+    @Operation(summary = "获取用户组精简信息列表", description = "只包含被开启的用户组，主要用于前端的下拉选项")
+    CommonResult<List<BpmUserGroupRespDTO>> getUserGroupSimpleList();
+
+}

zt-module-bpm/zt-module-bpm-api/src/main/java/com/zt/plat/module/bpm/api/definition/dto/BpmCategoryPageReqDTO.java

@@ -0,0 +1,32 @@
+package com.zt.plat.module.bpm.api.definition.dto;
+
+import com.zt.plat.framework.common.enums.CommonStatusEnum;
+import com.zt.plat.framework.common.pojo.PageParam;
+import com.zt.plat.framework.common.validation.InEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static com.zt.plat.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "RPC 服务 - BPM 流程分类分页 Request DTO")
+@Data
+public class BpmCategoryPageReqDTO extends PageParam {
+
+    @Schema(description = "分类名", example = "王五")
+    private String name;
+
+    @Schema(description = "分类标志", example = "OA")
+    private String code;
+
+    @Schema(description = "分类状态", example = "1")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] createTime;
+
+}

zt-module-bpm/zt-module-bpm-api/src/main/java/com/zt/plat/module/bpm/api/definition/dto/BpmCategoryRespDTO.java

@@ -0,0 +1,33 @@
+package com.zt.plat.module.bpm.api.definition.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "RPC 服务 - BPM 流程分类 Response DTO")
+@Data
+public class BpmCategoryRespDTO {
+
+    @Schema(description = "分类编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3167")
+    private Long id;
+
+    @Schema(description = "分类名", requiredMode = Schema.RequiredMode.REQUIRED, example = "王五")
+    private String name;
+
+    @Schema(description = "分类标志", requiredMode = Schema.RequiredMode.REQUIRED, example = "OA")
+    private String code;
+
+    @Schema(description = "分类描述", requiredMode = Schema.RequiredMode.REQUIRED, example = "你猜")
+    private String description;
+
+    @Schema(description = "分类状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer status;
+
+    @Schema(description = "分类排序", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

zt-module-bpm/zt-module-bpm-api/src/main/java/com/zt/plat/module/bpm/api/definition/dto/BpmCategorySaveReqDTO.java

@@ -0,0 +1,37 @@
+package com.zt.plat.module.bpm.api.definition.dto;
+
+import com.zt.plat.framework.common.enums.CommonStatusEnum;
+import com.zt.plat.framework.common.validation.InEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "RPC 服务 - BPM 流程分类新增/修改 Request DTO")
+@Data
+public class BpmCategorySaveReqDTO {
+
+    @Schema(description = "分类编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3167")
+    private Long id;
+
+    @Schema(description = "分类名", requiredMode = Schema.RequiredMode.REQUIRED, example = "王五")
+    @NotEmpty(message = "分类名不能为空")
+    private String name;
+
+    @Schema(description = "分类描述", example = "你猜")
+    private String description;
+
+    @Schema(description = "分类标志", requiredMode = Schema.RequiredMode.REQUIRED, example = "OA")
+    @NotEmpty(message = "分类标志不能为空")
+    private String code;
+
+    @Schema(description = "分类状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "分类状态不能为空")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+    @Schema(description = "分类排序", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "分类排序不能为空")
+    private Integer sort;
+
+}

zt-module-bpm/zt-module-bpm-api/src/main/java/com/zt/plat/module/bpm/api/definition/dto/BpmFormPageReqDTO.java

@@ -0,0 +1,18 @@
+package com.zt.plat.module.bpm.api.definition.dto;
+
+import com.zt.plat.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "动态表单分页 Request DTO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class BpmFormPageReqDTO extends PageParam {
+
+    @Schema(description = "表单名称", example = "芋道")
+    private String name;
+
+}