commit：更新样例数据

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/app/controller/AreaCodeController.java

@@ -1,5 +1,6 @@
 package com.orangeforms.webadmin.app.controller;
 
+import io.swagger.annotations.Api;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.orangeforms.webadmin.app.model.AreaCode;
 import com.orangeforms.webadmin.app.service.AreaCodeService;
@@ -21,6 +22,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "行政区划数据访问接口")
 @RestController
 @RequestMapping("/admin/app/areaCode")
 public class AreaCodeController {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/app/vo/AreaCodeVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,26 +10,31 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("行政区划实体对象")
 @Data
 public class AreaCodeVo {
 
     /**
      * 行政区划主键Id
      */
+    @ApiModelProperty(value = "行政区划主键Id", required = true)
     private Long areaId;
 
     /**
      * 行政区划名称
      */
+    @ApiModelProperty(value = "行政区划名称")
     private String areaName;
 
     /**
      * 行政区划级别 (1: 省级别 2: 市级别 3: 区级别)
      */
+    @ApiModelProperty(value = "行政区划级别")
     private Integer areaLevel;
 
     /**
      * 父级行政区划Id
      */
+    @ApiModelProperty(value = "父级行政区划Id")
     private Long parentId;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/LoginController.java

@@ -3,6 +3,10 @@ package com.orangeforms.webadmin.upms.controller;
 import com.alibaba.fastjson.JSON;
 import com.alibaba.fastjson.JSONObject;
 import com.alibaba.fastjson.serializer.SerializerFeature;
+import com.github.xiaoymin.knife4j.annotations.ApiSupport;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiImplicitParams;
 import lombok.extern.slf4j.Slf4j;
 import com.orangeforms.webadmin.config.ApplicationConfig;
 import com.orangeforms.webadmin.upms.service.*;
@@ -42,6 +46,8 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiSupport(order = 1)
+@Api(tags = "用户登录接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/login")
@@ -81,6 +87,12 @@ public class LoginController {
      * @param password  密码。
      * @return 应答结果对象，其中包括JWT的Token数据，以及菜单列表。
      */
+    @ApiImplicitParams({
+            // 这里包含密码密文，仅用于方便开发期间的接口测试，集成测试和发布阶段，需要将当前注解去掉。
+            // 如果您重新生成了公钥和私钥，请替换password的缺省值。
+            @ApiImplicitParam(name = "loginName", defaultValue = "admin"),
+            @ApiImplicitParam(name = "password", defaultValue = "IP3ccke3GhH45iGHB5qP9p7iZw6xUyj28Ju10rnBiPKOI35sc%2BjI7%2FdsjOkHWMfUwGYGfz8ik31HC2Ruk%2Fhkd9f6RPULTHj7VpFdNdde2P9M4mQQnFBAiPM7VT9iW3RyCtPlJexQ3nAiA09OqG%2F0sIf1kcyveSrulxembARDbDo%3D")
+    })
     @NoAuthInterface
     @PostMapping("/doLogin")
     public ResponseResult<JSONObject> doLogin(

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/LoginUserController.java

@@ -6,6 +6,7 @@ import com.alibaba.fastjson.JSON;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.common.core.object.*;
 import com.orangeforms.common.core.util.RedisKeyUtil;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.redisson.api.RBucket;
 import org.redisson.api.RedissonClient;
@@ -22,6 +23,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "在线用户接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/loginUser")

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysDataPermController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.alibaba.fastjson.TypeReference;
 import com.github.pagehelper.Page;
 import com.github.pagehelper.page.PageMethod;
@@ -30,6 +32,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "数据权限管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysDataPerm")
@@ -47,6 +50,11 @@ public class SysDataPermController {
      * @param deptIdListString 数据权限关联的部门Id列表，多个之间逗号分隔。
      * @return 应答结果对象。包含新增数据权限对象的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysDataPermDto.dataPermId",
+            "sysDataPermDto.createTimeStart",
+            "sysDataPermDto.createTimeEnd",
+            "sysDataPermDto.searchString"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysDataPermDto sysDataPermDto, @MyRequestBody String deptIdListString) {
@@ -74,6 +82,10 @@ public class SysDataPermController {
      * @param deptIdListString 数据权限关联的部门Id列表，多个之间逗号分隔。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysDataPermDto.createTimeStart",
+            "sysDataPermDto.createTimeEnd",
+            "sysDataPermDto.searchString"})
     @PostMapping("/update")
     public ResponseResult<Void> update(
             @MyRequestBody SysDataPermDto sysDataPermDto, @MyRequestBody String deptIdListString) {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysDeptController.java

@@ -10,6 +10,8 @@ import com.orangeforms.common.core.object.*;
 import com.orangeforms.common.core.util.*;
 import com.orangeforms.common.core.constant.*;
 import com.orangeforms.common.core.annotation.MyRequestBody;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.lang3.ObjectUtils;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -24,6 +26,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "部门管理管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysDept")
@@ -40,6 +43,7 @@ public class SysDeptController {
      * @param sysDeptDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysDeptDto.deptId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody SysDeptDto sysDeptDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(sysDeptDto, false);

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysMenuController.java

@@ -2,6 +2,8 @@ package com.orangeforms.webadmin.upms.controller;
 
 import cn.hutool.core.util.ObjectUtil;
 import com.alibaba.fastjson.TypeReference;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import com.orangeforms.webadmin.upms.dto.SysMenuDto;
 import com.orangeforms.webadmin.upms.vo.SysMenuVo;
@@ -25,6 +27,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "菜单管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysMenu")
@@ -40,6 +43,7 @@ public class SysMenuController {
      * @param permCodeIdListString 与当前菜单Id绑定的权限Id列表，多个权限之间逗号分隔。
      * @return 应答结果对象，包含新增菜单的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysMenuDto.menuId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysMenuDto sysMenuDto, @MyRequestBody String permCodeIdListString) {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysPermCodeController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.alibaba.fastjson.TypeReference;
 import lombok.extern.slf4j.Slf4j;
 import com.orangeforms.webadmin.upms.dto.SysPermCodeDto;
@@ -24,6 +26,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "权限字管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysPermCode")
@@ -39,6 +42,7 @@ public class SysPermCodeController {
      * @param permIdListString 与当前权限Id绑定的权限资源Id列表，多个权限资源之间逗号分隔。
      * @return 应答结果对象，包含新增权限字的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysPermCodeDto.permCodeId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysPermCodeDto sysPermCodeDto, @MyRequestBody String permIdListString) {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysPermController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.github.pagehelper.Page;
 import com.github.pagehelper.page.PageMethod;
 import lombok.extern.slf4j.Slf4j;
@@ -25,6 +27,7 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "权限资源管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysPerm")
@@ -39,6 +42,7 @@ public class SysPermController {
      * @param sysPermDto 新增权限资源对象。
      * @return 应答结果对象，包含新增权限资源的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysPermDto.permId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody SysPermDto sysPermDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(sysPermDto);

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysPermModuleController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import com.orangeforms.webadmin.upms.dto.SysPermModuleDto;
 import com.orangeforms.webadmin.upms.vo.SysPermModuleVo;
@@ -27,6 +29,7 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "权限资源模块管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysPermModule")
@@ -41,6 +44,7 @@ public class SysPermModuleController {
      * @param sysPermModuleDto 新增权限资源模块对象。
      * @return 应答结果对象，包含新增权限资源模块的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysPermModuleDto.moduleId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody SysPermModuleDto sysPermModuleDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(sysPermModuleDto);

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysPostController.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.controller;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.github.pagehelper.page.PageMethod;
 import com.orangeforms.common.core.object.*;
@@ -24,6 +26,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "岗位管理操作管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysPost")
@@ -38,6 +41,7 @@ public class SysPostController {
      * @param sysPostDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysPostDto.postId"})
     @PostMapping("/add")
     public ResponseResult<Long> add(@MyRequestBody SysPostDto sysPostDto) {
         String errorMessage = MyCommonUtil.getModelValidationError(sysPostDto);

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysRoleController.java

@@ -1,6 +1,8 @@
 package com.orangeforms.webadmin.upms.controller;
 
 import cn.jimmyshi.beanquery.BeanQuery;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import com.alibaba.fastjson.TypeReference;
 import com.github.pagehelper.Page;
 import com.github.pagehelper.page.PageMethod;
@@ -32,6 +34,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "角色管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysRole")
@@ -49,6 +52,7 @@ public class SysRoleController {
      * @param menuIdListString 与当前角色Id绑定的menuId列表，多个menuId之间逗号分隔。
      * @return 应答结果对象，包含新增角色的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysRoleDto.roleId", "sysRoleDto.createTimeStart", "sysRoleDto.createTimeEnd"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysRoleDto sysRoleDto, @MyRequestBody String menuIdListString) {
@@ -76,6 +80,7 @@ public class SysRoleController {
      * @param menuIdListString 与当前角色Id绑定的menuId列表，多个menuId之间逗号分隔。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {"sysRoleDto.createTimeStart", "sysRoleDto.createTimeEnd"})
     @PostMapping("/update")
     public ResponseResult<Void> update(
             @MyRequestBody SysRoleDto sysRoleDto, @MyRequestBody String menuIdListString) {

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/controller/SysUserController.java

@@ -11,6 +11,8 @@ import com.orangeforms.common.core.util.*;
 import com.orangeforms.common.core.constant.*;
 import com.orangeforms.common.core.annotation.MyRequestBody;
 import com.orangeforms.webadmin.config.ApplicationConfig;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -24,6 +26,7 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@Api(tags = "用户管理管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysUser")
@@ -45,6 +48,10 @@ public class SysUserController {
      * @param roleIdListString     逗号分隔的角色Id列表。
      * @return 应答结果对象，包含新增用户的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysUserDto.userId",
+            "sysUserDto.createTimeStart",
+            "sysUserDto.createTimeEnd"})
     @PostMapping("/add")
     public ResponseResult<Long> add(
             @MyRequestBody SysUserDto sysUserDto,
@@ -77,6 +84,9 @@ public class SysUserController {
      * @param roleIdListString     逗号分隔的角色Id列表。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysUserDto.createTimeStart",
+            "sysUserDto.createTimeEnd"})
     @PostMapping("/update")
     public ResponseResult<Void> update(
             @MyRequestBody SysUserDto sysUserDto,

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysDataPermDeptDto.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.dto;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,16 +10,19 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("数据权限与部门关联Dto")
 @Data
 public class SysDataPermDeptDto {
 
     /**
      * 数据权限Id。
      */
+    @ApiModelProperty(value = "数据权限Id", required = true)
     private Long dataPermId;
 
     /**
      * 关联部门Id。
      */
+    @ApiModelProperty(value = "关联部门Id", required = true)
     private Long deptId;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysDataPermDto.java

@@ -4,6 +4,8 @@ import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.datafilter.constant.DataPermRuleType;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -14,24 +16,28 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("数据权限Dto")
 @Data
 public class SysDataPermDto {
 
     /**
      * 数据权限Id。
      */
+    @ApiModelProperty(value = "数据权限Id", required = true)
     @NotNull(message = "数据权限Id不能为空！", groups = {UpdateGroup.class})
     private Long dataPermId;
 
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称", required = true)
     @NotBlank(message = "数据权限名称不能为空！")
     private String dataPermName;
 
     /**
      * 数据权限规则类型(0: 全部可见 1: 只看自己 2: 只看本部门 3: 本部门及子部门 4: 多部门及子部门 5: 自定义部门列表)。
      */
+    @ApiModelProperty(value = "数据权限规则类型", required = true)
     @NotNull(message = "数据权限规则类型不能为空！")
     @ConstDictRef(constDictClass = DataPermRuleType.class)
     private Integer ruleType;
@@ -39,10 +45,12 @@ public class SysDataPermDto {
     /**
      * 部门Id列表(逗号分隔)。
      */
+    @ApiModelProperty(hidden = true)
     private String deptIdListString;
 
     /**
      * 搜索字符串。
      */
+    @ApiModelProperty(value = "LIKE 模糊搜索字符串")
     private String searchString;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysDeptDto.java

@@ -2,6 +2,8 @@ package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -14,49 +16,58 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("SysDeptDto对象")
 @Data
 public class SysDeptDto {
 
     /**
      * 部门Id。
      */
+    @ApiModelProperty(value = "部门Id", required = true)
     @NotNull(message = "数据验证失败，部门Id不能为空！", groups = {UpdateGroup.class})
     private Long deptId;
 
     /**
      * 部门名称。
      */
+    @ApiModelProperty(value = "部门名称", required = true)
     @NotBlank(message = "数据验证失败，部门名称不能为空！")
     private String deptName;
 
     /**
      * 显示顺序。
      */
+    @ApiModelProperty(value = "显示顺序", required = true)
     @NotNull(message = "数据验证失败，显示顺序不能为空！")
     private Integer showOrder;
 
     /**
      * 父部门Id。
      */
+    @ApiModelProperty(value = "父部门Id")
     private Long parentId;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysDeptPostDto.java

@@ -2,6 +2,8 @@ package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -12,30 +14,35 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("部门岗位Dto")
 @Data
 public class SysDeptPostDto {
 
     /**
      * 部门岗位Id。
      */
+    @ApiModelProperty(value = "部门岗位Id", required = true)
     @NotNull(message = "数据验证失败，部门岗位Id不能为空！", groups = {UpdateGroup.class})
     private Long deptPostId;
 
     /**
      * 部门Id。
      */
+    @ApiModelProperty(value = "部门Id", required = true)
     @NotNull(message = "数据验证失败，部门Id不能为空！", groups = {UpdateGroup.class})
     private Long deptId;
 
     /**
      * 岗位Id。
      */
+    @ApiModelProperty(value = "岗位Id", required = true)
     @NotNull(message = "数据验证失败，岗位Id不能为空！", groups = {UpdateGroup.class})
     private Long postId;
 
     /**
      * 部门岗位显示名称。
      */
+    @ApiModelProperty(value = "部门岗位显示名称", required = true)
     @NotBlank(message = "数据验证失败，部门岗位显示名称不能为空！")
     private String postShowName;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysMenuDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.webadmin.upms.dto;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.webadmin.upms.model.constant.SysMenuType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -14,29 +16,34 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("菜单Dto")
 @Data
 public class SysMenuDto {
 
     /**
      * 菜单Id。
      */
+    @ApiModelProperty(value = "菜单Id", required = true)
     @NotNull(message = "菜单Id不能为空！", groups = {UpdateGroup.class})
     private Long menuId;
 
     /**
      * 父菜单Id，目录菜单的父菜单为null
      */
+    @ApiModelProperty(value = "父菜单Id")
     private Long parentId;
 
     /**
      * 菜单显示名称。
      */
+    @ApiModelProperty(value = "菜单显示名称", required = true)
     @NotBlank(message = "菜单显示名称不能为空！")
     private String menuName;
 
     /**
      * 菜单类型 (0: 目录 1: 菜单 2: 按钮 3: UI片段)。
      */
+    @ApiModelProperty(value = "菜单类型", required = true)
     @NotNull(message = "菜单类型不能为空！")
     @ConstDictRef(constDictClass = SysMenuType.class, message = "数据验证失败，菜单类型为无效值！")
     private Integer menuType;
@@ -44,26 +51,31 @@ public class SysMenuDto {
     /**
      * 前端表单路由名称，仅用于menu_type为1的菜单类型。
      */
+    @ApiModelProperty(value = "前端表单路由名称")
     private String formRouterName;
 
     /**
      * 在线表单主键Id，仅用于在线表单绑定的菜单。
      */
+    @ApiModelProperty(value = "在线表单主键Id")
     private Long onlineFormId;
 
     /**
      * 仅用于在线表单的流程Id。
      */
+    @ApiModelProperty(value = "仅用于在线表单的流程Id")
     private Long onlineFlowEntryId;
 
     /**
      * 菜单显示顺序 (值越小，排序越靠前)。
      */
+    @ApiModelProperty(value = "菜单显示顺序", required = true)
     @NotNull(message = "菜单显示顺序不能为空！")
     private Integer showOrder;
 
     /**
      * 菜单图标。
      */
+    @ApiModelProperty(value = "菜单显示顺序")
     private String icon;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysPermCodeDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.webadmin.upms.dto;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.webadmin.upms.model.constant.SysPermCodeType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -14,29 +16,34 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限字Dto")
 @Data
 public class SysPermCodeDto {
 
     /**
      * 权限字Id。
      */
+    @ApiModelProperty(value = "权限字Id", required = true)
     @NotNull(message = "权限字Id不能为空！", groups = {UpdateGroup.class})
     private Long permCodeId;
 
     /**
      * 权限字标识(一般为有含义的英文字符串)。
      */
+    @ApiModelProperty(value = "权限字标识", required = true)
     @NotBlank(message = "权限字编码不能为空！")
     private String permCode;
 
     /**
      * 上级权限字Id。
      */
+    @ApiModelProperty(value = "上级权限字Id")
     private Long parentId;
 
     /**
      * 权限字类型(0: 表单 1: UI片段 2: 操作)。
      */
+    @ApiModelProperty(value = "权限字类型", required = true)
     @NotNull(message = "权限字类型不能为空！")
     @ConstDictRef(constDictClass = SysPermCodeType.class, message = "数据验证失败，权限类型为无效值！")
     private Integer permCodeType;
@@ -44,12 +51,14 @@ public class SysPermCodeDto {
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称", required = true)
     @NotBlank(message = "权限字显示名称不能为空！")
     private String showName;
 
     /**
      * 显示顺序(数值越小，越靠前)。
      */
+    @ApiModelProperty(value = "显示顺序", required = true)
     @NotNull(message = "权限字显示顺序不能为空！")
     private Integer showOrder;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysPermDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -12,41 +14,48 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限资源Dto")
 @Data
 public class SysPermDto {
 
     /**
      * 权限资源Id。
      */
+    @ApiModelProperty(value = "权限资源Id", required = true)
     @NotNull(message = "权限Id不能为空！", groups = {UpdateGroup.class})
     private Long permId;
 
     /**
      * 权限资源名称。
      */
+    @ApiModelProperty(value = "权限资源名称", required = true)
     @NotBlank(message = "权限资源名称不能为空！")
     private String permName;
 
     /**
      * shiro格式的权限字，如(upms:sysUser:add)。
      */
+    @ApiModelProperty(value = "权限字")
     private String permCode;
 
     /**
      * 权限所在的权限模块Id。
      */
+    @ApiModelProperty(value = "权限所在的权限模块Id")
     @NotNull(message = "权限模块Id不能为空！")
     private Long moduleId;
 
     /**
      * 关联的URL。
      */
+    @ApiModelProperty(value = "关联的URL", required = true)
     @NotBlank(message = "权限关联的url不能为空！")
     private String url;
 
     /**
      * 权限在当前模块下的顺序，由小到大。
      */
+    @ApiModelProperty(value = "显示顺序", required = true)
     @NotNull(message = "权限显示顺序不能为空！")
     private Integer showOrder;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysPermModuleDto.java

@@ -3,6 +3,8 @@ package com.orangeforms.webadmin.upms.dto;
 import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.common.core.validator.UpdateGroup;
 import com.orangeforms.webadmin.upms.model.constant.SysPermModuleType;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.NotBlank;
@@ -14,29 +16,34 @@ import javax.validation.constraints.NotNull;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限资源模块Dto")
 @Data
 public class SysPermModuleDto {
 
     /**
      * 权限模块Id。
      */
+    @ApiModelProperty(value = "权限模块Id", required = true)
     @NotNull(message = "权限模块Id不能为空！", groups = {UpdateGroup.class})
     private Long moduleId;
 
     /**
      * 权限模块名称。
      */
+    @ApiModelProperty(value = "权限模块名称", required = true)
     @NotBlank(message = "权限模块名称不能为空！")
     private String moduleName;
 
     /**
      * 上级权限模块Id。
      */
+    @ApiModelProperty(value = "上级权限模块Id")
     private Long parentId;
 
     /**
      * 权限模块类型(0: 普通模块 1: Controller模块)。
      */
+    @ApiModelProperty(value = "权限模块类型", required = true)
     @NotNull(message = "模块类型不能为空！")
     @ConstDictRef(constDictClass = SysPermModuleType.class, message = "数据验证失败，权限模块类型为无效值！")
     private Integer moduleType;
@@ -44,6 +51,7 @@ public class SysPermModuleDto {
     /**
      * 权限模块在当前层级下的顺序，由小到大。
      */
+    @ApiModelProperty(value = "显示顺序", required = true)
     @NotNull(message = "权限模块显示顺序不能为空！")
     private Integer showOrder;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysPostDto.java

@@ -2,6 +2,8 @@ package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -12,30 +14,35 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("岗位Dto")
 @Data
 public class SysPostDto {
 
     /**
      * 岗位Id。
      */
+    @ApiModelProperty(value = "岗位Id", required = true)
     @NotNull(message = "数据验证失败，岗位Id不能为空！", groups = {UpdateGroup.class})
     private Long postId;
 
     /**
      * 岗位名称。
      */
+    @ApiModelProperty(value = "岗位名称", required = true)
     @NotBlank(message = "数据验证失败，岗位名称不能为空！")
     private String postName;
 
     /**
      * 岗位层级，数值越小级别越高。
      */
+    @ApiModelProperty(value = "岗位层级", required = true)
     @NotNull(message = "数据验证失败，岗位层级不能为空！")
     private Integer level;
 
     /**
      * 是否领导岗位。
      */
+    @ApiModelProperty(value = "是否领导岗位", required = true)
     @NotNull(message = "数据验证失败，领导岗位不能为空！", groups = {UpdateGroup.class})
     private Boolean leaderPost;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysRoleDto.java

@@ -1,6 +1,8 @@
 package com.orangeforms.webadmin.upms.dto;
 
 import com.orangeforms.common.core.validator.UpdateGroup;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -11,18 +13,21 @@ import javax.validation.constraints.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("角色Dto")
 @Data
 public class SysRoleDto {
 
     /**
      * 角色Id。
      */
+    @ApiModelProperty(value = "角色Id", required = true)
     @NotNull(message = "角色Id不能为空！", groups = {UpdateGroup.class})
     private Long roleId;
 
     /**
      * 角色名称。
      */
+    @ApiModelProperty(value = "角色名称", required = true)
     @NotBlank(message = "角色名称不能为空！")
     private String roleName;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/dto/SysUserDto.java

@@ -6,6 +6,8 @@ import com.orangeforms.common.core.validator.ConstDictRef;
 import com.orangeforms.webadmin.upms.model.constant.SysUserType;
 import com.orangeforms.webadmin.upms.model.constant.SysUserStatus;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import javax.validation.constraints.*;
@@ -18,42 +20,49 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("SysUserDto对象")
 @Data
 public class SysUserDto {
 
     /**
      * 用户Id。
      */
+    @ApiModelProperty(value = "用户Id", required = true)
     @NotNull(message = "数据验证失败，用户Id不能为空！", groups = {UpdateGroup.class})
     private Long userId;
 
     /**
      * 登录用户名。
      */
+    @ApiModelProperty(value = "登录用户名", required = true)
     @NotBlank(message = "数据验证失败，登录用户名不能为空！")
     private String loginName;
 
     /**
      * 用户密码。
      */
+    @ApiModelProperty(value = "用户密码", required = true)
     @NotBlank(message = "数据验证失败，用户密码不能为空！", groups = {AddGroup.class})
     private String password;
 
     /**
      * 用户显示名称。
      */
+    @ApiModelProperty(value = "用户显示名称", required = true)
     @NotBlank(message = "数据验证失败，用户显示名称不能为空！")
     private String showName;
 
     /**
      * 用户部门Id。
      */
+    @ApiModelProperty(value = "用户部门Id", required = true)
     @NotNull(message = "数据验证失败，用户部门Id不能为空！")
     private Long deptId;
 
     /**
      * 用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)。
      */
+    @ApiModelProperty(value = "用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)", required = true)
     @NotNull(message = "数据验证失败，用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)不能为空！")
     @ConstDictRef(constDictClass = SysUserType.class, message = "数据验证失败，用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)为无效值！")
     private Integer userType;
@@ -61,11 +70,13 @@ public class SysUserDto {
     /**
      * 用户头像的Url。
      */
+    @ApiModelProperty(value = "用户头像的Url")
     private String headImageUrl;
 
     /**
      * 用户状态(0: 正常 1: 锁定)。
      */
+    @ApiModelProperty(value = "用户状态(0: 正常 1: 锁定)", required = true)
     @NotNull(message = "数据验证失败，用户状态(0: 正常 1: 锁定)不能为空！")
     @ConstDictRef(constDictClass = SysUserStatus.class, message = "数据验证失败，用户状态(0: 正常 1: 锁定)为无效值！")
     private Integer userStatus;
@@ -73,30 +84,36 @@ public class SysUserDto {
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * createTime 范围过滤起始值(>=)。
      */
+    @ApiModelProperty(value = "createTime 范围过滤起始值(>=)")
     private String createTimeStart;
 
     /**
      * createTime 范围过滤结束值(<=)。
      */
+    @ApiModelProperty(value = "createTime 范围过滤结束值(<=)")
     private String createTimeEnd;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysDataPermDeptVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,16 +10,19 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("数据权限与部门关联VO")
 @Data
 public class SysDataPermDeptVo {
 
     /**
      * 数据权限Id。
      */
+    @ApiModelProperty(value = "数据权限Id")
     private Long dataPermId;
 
     /**
      * 关联部门Id。
      */
+    @ApiModelProperty(value = "关联部门Id")
     private Long deptId;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysDataPermVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,51 +12,61 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("数据权限VO")
 @Data
 public class SysDataPermVo {
 
     /**
      * 数据权限Id。
      */
+    @ApiModelProperty(value = "数据权限Id")
     private Long dataPermId;
 
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称")
     private String dataPermName;
 
     /**
      * 数据权限规则类型(0: 全部可见 1: 只看自己 2: 只看本部门 3: 本部门及子部门 4: 多部门及子部门 5: 自定义部门列表)。
      */
+    @ApiModelProperty(value = "数据权限规则类型")
     private Integer ruleType;
 
     /**
      * 部门Id列表(逗号分隔)。
      */
+    @ApiModelProperty(value = "部门Id列表")
     private String deptIdListString;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 数据权限与部门关联对象列表。
      */
+    @ApiModelProperty(value = "数据权限与部门关联对象列表")
     private List<Map<String, Object>> dataPermDeptList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysDeptPostVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,26 +10,31 @@ import lombok.Data;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("部门岗位VO")
 @Data
 public class SysDeptPostVo {
 
     /**
      * 部门岗位Id。
      */
+    @ApiModelProperty(value = "部门岗位Id")
     private Long deptPostId;
 
     /**
      * 部门Id。
      */
+    @ApiModelProperty(value = "部门Id")
     private Long deptId;
 
     /**
      * 岗位Id。
      */
+    @ApiModelProperty(value = "岗位Id")
     private Long postId;
 
     /**
      * 部门岗位显示名称。
      */
+    @ApiModelProperty(value = "部门岗位显示名称")
     private String postShowName;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysDeptVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -10,46 +12,55 @@ import java.util.Date;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("SysDeptVO视图对象")
 @Data
 public class SysDeptVo {
 
     /**
      * 部门Id。
      */
+    @ApiModelProperty(value = "部门Id")
     private Long deptId;
 
     /**
      * 部门名称。
      */
+    @ApiModelProperty(value = "部门名称")
     private String deptName;
 
     /**
      * 显示顺序。
      */
+    @ApiModelProperty(value = "显示顺序")
     private Integer showOrder;
 
     /**
      * 父部门Id。
      */
+    @ApiModelProperty(value = "父部门Id")
     private Long parentId;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysMenuVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,81 +12,97 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("菜单VO")
 @Data
 public class SysMenuVo {
 
     /**
      * 菜单Id。
      */
+    @ApiModelProperty(value = "菜单Id")
     private Long menuId;
 
     /**
      * 父菜单Id，目录菜单的父菜单为null
      */
+    @ApiModelProperty(value = "父菜单Id")
     private Long parentId;
 
     /**
      * 菜单显示名称。
      */
+    @ApiModelProperty(value = "菜单显示名称")
     private String menuName;
 
     /**
      * 菜单类型 (0: 目录 1: 菜单 2: 按钮 3: UI片段)。
      */
+    @ApiModelProperty(value = "菜单类型")
     private Integer menuType;
 
     /**
      * 前端表单路由名称，仅用于menu_type为1的菜单类型。
      */
+    @ApiModelProperty(value = "前端表单路由名称")
     private String formRouterName;
 
     /**
      * 在线表单主键Id，仅用于在线表单绑定的菜单。
      */
+    @ApiModelProperty(value = "在线表单主键Id")
     private Long onlineFormId;
 
     /**
      * 在线表单菜单的权限控制类型，具体值可参考SysOnlineMenuPermType常量对象。
      */
+    @ApiModelProperty(value = "在线表单菜单的权限控制类型")
     private Integer onlineMenuPermType;
 
     /**
      * 仅用于在线表单的流程Id。
      */
+    @ApiModelProperty(value = "仅用于在线表单的流程Id")
     private Long onlineFlowEntryId;
 
     /**
      * 菜单显示顺序 (值越小，排序越靠前)。
      */
+    @ApiModelProperty(value = "菜单显示顺序")
     private Integer showOrder;
 
     /**
      * 菜单图标。
      */
+    @ApiModelProperty(value = "菜单显示顺序")
     private String icon;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 菜单与权限字关联对象列表。
      */
+    @ApiModelProperty(value = "菜单与权限字关联对象列表")
     private List<Map<String, Object>> sysMenuPermCodeList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysPermCodeVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,61 +12,73 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限字VO")
 @Data
 public class SysPermCodeVo {
 
     /**
      * 权限字Id。
      */
+    @ApiModelProperty(value = "权限字Id")
     private Long permCodeId;
 
     /**
      * 权限字标识(一般为有含义的英文字符串)。
      */
+    @ApiModelProperty(value = "权限字标识")
     private String permCode;
 
     /**
      * 上级权限字Id。
      */
+    @ApiModelProperty(value = "上级权限字Id")
     private Long parentId;
 
     /**
      * 权限字类型(0: 表单 1: UI片段 2: 操作)。
      */
+    @ApiModelProperty(value = "权限字类型")
     private Integer permCodeType;
 
     /**
      * 显示名称。
      */
+    @ApiModelProperty(value = "显示名称")
     private String showName;
 
     /**
      * 显示顺序(数值越小，越靠前)。
      */
+    @ApiModelProperty(value = "显示顺序")
     private Integer showOrder;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 权限字与权限资源关联对象列表。
      */
+    @ApiModelProperty(value = "权限字与权限资源关联对象列表")
     private List<Map<String, Object>> sysPermCodePermList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysPermModuleVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,56 +12,67 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限资源模块VO")
 @Data
 public class SysPermModuleVo {
 
     /**
      * 权限模块Id。
      */
+    @ApiModelProperty(value = "权限模块Id")
     private Long moduleId;
 
     /**
      * 权限模块名称。
      */
+    @ApiModelProperty(value = "权限模块名称")
     private String moduleName;
 
     /**
      * 上级权限模块Id。
      */
+    @ApiModelProperty(value = "上级权限模块Id")
     private Long parentId;
 
     /**
      * 权限模块类型(0: 普通模块 1: Controller模块)。
      */
+    @ApiModelProperty(value = "权限模块类型")
     private Integer moduleType;
 
     /**
      * 权限模块在当前层级下的顺序，由小到大。
      */
+    @ApiModelProperty(value = "显示顺序")
     private Integer showOrder;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 权限资源对象列表。
      */
+    @ApiModelProperty(value = "权限资源对象列表")
     private List<SysPermVo> sysPermList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysPermVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,61 +12,73 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("权限资源VO")
 @Data
 public class SysPermVo {
 
     /**
      * 权限资源Id。
      */
+    @ApiModelProperty(value = "权限资源Id")
     private Long permId;
 
     /**
      * 权限资源名称。
      */
+    @ApiModelProperty(value = "权限资源名称")
     private String permName;
 
     /**
      * shiro格式的权限字，如(upms:sysUser:add)。
      */
+    @ApiModelProperty(value = "权限字")
     private String permCode;
 
     /**
      * 权限所在的权限模块Id。
      */
+    @ApiModelProperty(value = "权限所在的权限模块Id")
     private Long moduleId;
 
     /**
      * 关联的URL。
      */
+    @ApiModelProperty(value = "关联的URL")
     private String url;
 
     /**
      * 权限在当前模块下的顺序，由小到大。
      */
+    @ApiModelProperty(value = "显示顺序")
     private Integer showOrder;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 模块Id的字典关联数据。
      */
+    @ApiModelProperty(value = "模块Id的字典关联数据")
     private Map<String, Object> moduleIdDictMap;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysPostVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,51 +13,61 @@ import java.util.Map;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("岗位VO")
 @Data
 public class SysPostVo {
 
     /**
      * 岗位Id。
      */
+    @ApiModelProperty(value = "岗位Id")
     private Long postId;
 
     /**
      * 岗位名称。
      */
+    @ApiModelProperty(value = "岗位名称")
     private String postName;
 
     /**
      * 岗位层级，数值越小级别越高。
      */
+    @ApiModelProperty(value = "岗位层级，数值越小级别越高")
     private Integer level;
 
     /**
      * 是否领导岗位。
      */
+    @ApiModelProperty(value = "是否领导岗位")
     private Boolean leaderPost;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * postId 的多对多关联表数据对象，数据对应类型为SysDeptPostVo。
      */
+    @ApiModelProperty(value = "postId 的多对多关联表数据对象")
     private Map<String, Object> sysDeptPost;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysRoleVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.*;
@@ -10,41 +12,49 @@ import java.util.*;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("角色VO")
 @Data
 public class SysRoleVo {
 
     /**
      * 角色Id。
      */
+    @ApiModelProperty(value = "角色Id")
     private Long roleId;
 
     /**
      * 角色名称。
      */
+    @ApiModelProperty(value = "角色名称")
     private String roleName;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 角色与菜单关联对象列表。
      */
+    @ApiModelProperty(value = "角色与菜单关联对象列表")
     private List<Map<String, Object>> sysRoleMenuList;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/java/com/orangeforms/webadmin/upms/vo/SysUserVo.java

@@ -1,5 +1,7 @@
 package com.orangeforms.webadmin.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -12,91 +14,109 @@ import java.util.List;
  * @author Jerry
  * @date 2021-06-06
  */
+@ApiModel("SysUserVO视图对象")
 @Data
 public class SysUserVo {
 
     /**
      * 用户Id。
      */
+    @ApiModelProperty(value = "用户Id")
     private Long userId;
 
     /**
      * 登录用户名。
      */
+    @ApiModelProperty(value = "登录用户名")
     private String loginName;
 
     /**
      * 用户显示名称。
      */
+    @ApiModelProperty(value = "用户显示名称")
     private String showName;
 
     /**
      * 用户部门Id。
      */
+    @ApiModelProperty(value = "用户部门Id")
     private Long deptId;
 
     /**
      * 用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)。
      */
+    @ApiModelProperty(value = "用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)")
     private Integer userType;
 
     /**
      * 用户头像的Url。
      */
+    @ApiModelProperty(value = "用户头像的Url")
     private String headImageUrl;
 
     /**
      * 用户状态(0: 正常 1: 锁定)。
      */
+    @ApiModelProperty(value = "用户状态(0: 正常 1: 锁定)")
     private Integer userStatus;
 
     /**
      * 创建者Id。
      */
+    @ApiModelProperty(value = "创建者Id")
     private Long createUserId;
 
     /**
      * 更新者Id。
      */
+    @ApiModelProperty(value = "更新者Id")
     private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * 多对多用户岗位数据集合。
      */
+    @ApiModelProperty(value = "多对多用户岗位数据集合")
     private List<Map<String, Object>> sysUserPostList;
 
     /**
      * 多对多用户角色数据集合。
      */
+    @ApiModelProperty(value = "多对多用户角色数据集合")
     private List<Map<String, Object>> sysUserRoleList;
 
     /**
      * 多对多用户数据权限数据集合。
      */
+    @ApiModelProperty(value = "多对多用户数据权限数据集合")
     private List<Map<String, Object>> sysDataPermUserList;
 
     /**
      * deptId 字典关联数据。
      */
+    @ApiModelProperty(value = "deptId 字典关联数据")
     private Map<String, Object> deptIdDictMap;
 
     /**
      * userType 常量字典关联数据。
      */
+    @ApiModelProperty(value = "userType 常量字典关联数据")
     private Map<String, Object> userTypeDictMap;
 
     /**
      * userStatus 常量字典关联数据。
      */
+    @ApiModelProperty(value = "userStatus 常量字典关联数据")
     private Map<String, Object> userStatusDictMap;
 }

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/resources/application.yml

@@ -127,6 +127,17 @@ common-flow:
   # 请慎重修改urlPrefix的缺省配置，注意不要以反斜杠(/)结尾。如必须修改其他路径，请同步修改数据库脚本。
   urlPrefix: /admin/flow
 
+swagger:
+  # 当enabled为false的时候，则可禁用swagger。
+  enabled: true
+  # 工程的基础包名。
+  basePackage: com.orangeforms
+  # 工程服务的基础包名。
+  serviceBasePackage: com.orangeforms.webadmin
+  title: 橙单单体服务工程
+  description: 橙单单体服务工程详情
+  version: 1.0
+
 datafilter:
   tenant:
     # 对于单体服务，该值始终为false。
@@ -167,7 +178,7 @@ spring:
     type: com.alibaba.druid.pool.DruidDataSource
     druid:
       main:
-        url: jdbc:mysql://localhost:3306/zzdemo-online-activiti?characterEncoding=utf8&useSSL=true&serverTimezone=Asia/Shanghai
+        url: jdbc:mysql://localhost:3306/zzdemo-online?characterEncoding=utf8&useSSL=true&serverTimezone=Asia/Shanghai
         username: root
         password: 123456
       driver-class-name: com.mysql.cj.jdbc.Driver

orange-demo-activiti/orange-demo-activiti-service/application-webadmin/src/main/resources/log4j2.xml

@@ -53,6 +53,9 @@
         <root level="${OUTPUT_LOG_LEVEL}">
             <AppenderRef ref="console"/>
         </root>
+        <Logger name="springfox.documentation" additivity="false" level="error">
+            <AppenderRef ref="console"/>
+        </Logger>
         <AsyncLogger name="com.orangeforms" additivity="false" level="info">
             <AppenderRef ref="console"/>
             <AppenderRef ref="file_log"/>