docs: 增加Swagger的APi说明

@@ -4,6 +4,7 @@ package org.thingsboard.server.common.data.yunteng.dto;
 import com.fasterxml.jackson.annotation.JsonFormat;
 import com.fasterxml.jackson.annotation.JsonIgnore;
 import com.fasterxml.jackson.annotation.JsonInclude;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 import org.springframework.beans.BeanUtils;
 import org.thingsboard.server.common.data.yunteng.common.UpdateGroup;
@@ -20,16 +21,21 @@ import java.time.LocalDateTime;
 @JsonInclude(JsonInclude.Include.NON_NULL)
 public class BaseDTO {
   @NotEmpty(message = "ID不能为空或者空字符串",groups = {UpdateGroup.class})
+  @ApiModelProperty(value = "ID")
   private String id;
   /**创建用户*/
+  @ApiModelProperty(value = "创建用户")
   private String creator;
   /**创建时间*/
   @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+  @ApiModelProperty(value = "创建时间")
   private LocalDateTime createTime;
   /**更新用户*/
+  @ApiModelProperty(value = "更新用户")
   private String updater;
   /**更新时间*/
   @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+  @ApiModelProperty(value = "更新时间")
   private LocalDateTime updateTime;
   @JsonIgnore
   public <E> void copyToEntity(E entity, String... ignoreProperties) {

 package org.thingsboard.server.common.data.yunteng.dto;
 
-import com.fasterxml.jackson.annotation.JsonFormat;
+
 import com.fasterxml.jackson.annotation.JsonIgnore;
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.databind.JsonNode;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
 import org.thingsboard.server.common.data.yunteng.enums.MenuTypeEnum;
-
-import java.time.LocalDateTime;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
@@ -16,24 +15,26 @@ import java.util.Objects;
 @EqualsAndHashCode(callSuper = true)
 @Data
 public class MenuDTO extends BaseDTO implements Comparable<MenuDTO> {
-  private String id;
-  /**
-   * if menu type is system default, the menu name can be null; if menu type is not system default,
-   * menu name is user defined
-   */
+  @ApiModelProperty(value = "菜单名称", required = true)
   private String name;
-
-  //  @JsonIgnore
+  @ApiModelProperty(value = "上级ID")
   private String parentId;
+  @ApiModelProperty(value = "子节点")
   private List<MenuDTO> children;
+  @ApiModelProperty(value = "路由地址", required = true)
   private String path;
-  //  @JsonIgnore
   private MenuTypeEnum type;
+  @ApiModelProperty(value = "权限标识")
   private String permission;
+  @ApiModelProperty(value = "排序字段")
   private Integer sort;
+  @ApiModelProperty(value = "租户ID")
   @JsonIgnore private String tenantId;
+  @ApiModelProperty(value = "组件路径", required = true)
   private String component;
+  @ApiModelProperty(value = "元数据")
   private JsonNode meta;
+  @ApiModelProperty(value = "别名")
   @JsonIgnore private String alias;
 
   @JsonInclude(JsonInclude.Include.NON_NULL)
@@ -42,12 +43,6 @@ public class MenuDTO extends BaseDTO implements Comparable<MenuDTO> {
   @JsonInclude(JsonInclude.Include.NON_NULL)
   private Boolean caseSensitive;
 
-  @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
-  private LocalDateTime createTime;
-
-  @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
-  private LocalDateTime updateTime;
-
   public MenuDTO() {
     this.children = new ArrayList<>();
   }