docs: 完善公共模块相关接口文档信息

continew-admin-common/src/main/java/top/charles7c/cnadmin/common/base/BaseDetailVO.java

@@ -45,14 +45,14 @@ public class BaseDetailVO extends BaseVO {
     /**
      * 修改人
      */
-    @Schema(description = "修改人")
+    @Schema(description = "修改人", example = "李四")
     @ExcelProperty(value = "修改人")
     private String updateUserString;
 
     /**
      * 修改时间
      */
-    @Schema(description = "修改时间")
+    @Schema(description = "修改时间", example = "2023-08-08 08:08:08")
     @ExcelProperty(value = "修改时间")
     private LocalDateTime updateTime;
 }

continew-admin-common/src/main/java/top/charles7c/cnadmin/common/base/BaseVO.java

@@ -41,7 +41,7 @@ public class BaseVO implements Serializable {
     /**
      * ID
      */
-    @Schema(description = "ID")
+    @Schema(description = "ID", example = "1")
     @ExcelProperty(value = "ID")
     private Long id;
 
@@ -54,14 +54,14 @@ public class BaseVO implements Serializable {
     /**
      * 创建人
      */
-    @Schema(description = "创建人")
+    @Schema(description = "创建人", example = "超级管理员")
     @ExcelProperty(value = "创建人")
     private String createUserString;
 
     /**
      * 创建时间
      */
-    @Schema(description = "创建时间")
+    @Schema(description = "创建时间", example = "2023-08-08 08:08:08")
     @ExcelProperty(value = "创建时间")
     private LocalDateTime createTime;
 

continew-admin-common/src/main/java/top/charles7c/cnadmin/common/model/query/SortQuery.java

@@ -46,7 +46,7 @@ public class SortQuery implements Serializable {
     /**
      * 排序条件
      */
-    @Schema(description = "排序条件", example = "sort=published,desc&sort=title,asc")
+    @Schema(description = "排序条件", example = "createTime,desc")
     private String[] sort;
 
     /**
@@ -61,7 +61,7 @@ public class SortQuery implements Serializable {
 
         List<Sort.Order> orders = new ArrayList<>(sort.length);
         if (StrUtil.contains(sort[0], StringConsts.COMMA)) {
-            // e.g "sort=published,desc&sort=title,asc"
+            // e.g "sort=createTime,desc&sort=name,asc"
             for (String s : sort) {
                 List<String> sortList = StrUtil.splitTrim(s, StringConsts.COMMA);
                 Sort.Order order =
@@ -69,7 +69,7 @@ public class SortQuery implements Serializable {
                 orders.add(order);
             }
         } else {
-            // e.g "sort=published,desc"
+            // e.g "sort=createTime,desc"
             Sort.Order order = new Sort.Order(Sort.Direction.valueOf(sort[1].toUpperCase()), sort[0]);
             orders.add(order);
         }

continew-admin-common/src/main/java/top/charles7c/cnadmin/common/model/request/UpdateStatusRequest.java

@@ -41,7 +41,7 @@ public class UpdateStatusRequest implements Serializable {
     /**
      * 状态（1启用 2禁用）
      */
-    @Schema(description = "状态（1启用 2禁用）", type = "Integer", allowableValues = {"1", "2"})
+    @Schema(description = "状态（1启用 2禁用）", type = "Integer", allowableValues = {"1", "2"}, example = "1")
     @NotNull(message = "状态非法")
     private DisEnableStatusEnum status;
 }

continew-admin-common/src/main/java/top/charles7c/cnadmin/common/model/vo/CaptchaVO.java

@@ -39,12 +39,13 @@ public class CaptchaVO implements Serializable {
     /**
      * 验证码标识
      */
-    @Schema(description = "验证码标识")
+    @Schema(description = "验证码标识", example = "8a5a0296acd141a8b1bd789da867bc1a")
     private String uuid;
 
     /**
      * 验证码图片（Base64编码，带图片格式：data:image/gif;base64）
      */
-    @Schema(description = "验证码图片（Base64编码，带图片格式：data:image/gif;base64）")
+    @Schema(description = "验证码图片（Base64编码，带图片格式：data:image/gif;base64）",
+        example = "data:image/png;base64,iVBORw0KGgoAAAAN...")
     private String img;
 }

continew-admin-common/src/main/java/top/charles7c/cnadmin/common/model/vo/LabelValueVO.java

@@ -40,13 +40,13 @@ public class LabelValueVO<V> implements Serializable {
     /**
      * 标签
      */
-    @Schema(description = "标签")
+    @Schema(description = "标签", example = "男")
     private String label;
 
     /**
      * 值
      */
-    @Schema(description = "值")
+    @Schema(description = "值", example = "1")
     private V value;
 
     public LabelValueVO(String label, V value) {

continew-admin-webapi/src/main/java/top/charles7c/cnadmin/webapi/controller/tool/GeneratorController.java

@@ -68,8 +68,7 @@ public class GeneratorController {
     @Parameters({
         @Parameter(name = "tableName", description = "表名称", required = true, example = "sys_user",
             in = ParameterIn.PATH),
-        @Parameter(name = "requireSync", description = "是否需要同步", example = "true",
+        @Parameter(name = "requireSync", description = "是否需要同步", example = "true", in = ParameterIn.QUERY)})
-            in = ParameterIn.QUERY)})
     @GetMapping("/field/{tableName}")
     public R<List<FieldConfigDO>> listFieldConfig(@PathVariable String tableName,
         @RequestParam(required = false, defaultValue = "false") Boolean requireSync) {