doc: 完善已有的接口文档

src/main/java/cn/teammodel/model/dto/Appraise/FindVoteRecordDto.java

@@ -13,10 +13,10 @@ import javax.validation.constraints.NotNull;
 public class FindVoteRecordDto {
 
     @NotNull
-    @ApiModelProperty(value = "必要参数,用于获取学年", required = true)
+    @ApiModelProperty(value = "必要参数,用于获取当前学年,注意: 其他参数不传则默认获取登录老师在该学年下评价的所有记录", required = true)
     private String periodId;
 
-    @ApiModelProperty(value = "班级或学生 id, 注意: 无参则默认获取登录老师在该学年下评价的所有记录")
+    @ApiModelProperty(value = "班级或学生 id")
     private String targetId;
 
     @ApiModelProperty(value = "评价对象类型:", allowableValues = "student ,class")

src/main/java/cn/teammodel/model/dto/Appraise/GetEvaluateTreeDto.java

@@ -1,5 +1,6 @@
 package cn.teammodel.model.dto.Appraise;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,5 +9,6 @@ import lombok.Data;
  */
 @Data
 public class GetEvaluateTreeDto {
+    @ApiModelProperty("学段 id, 默认为 default")
     String periodId;
 }

src/main/java/cn/teammodel/model/dto/Appraise/InsertNodeDto.java

@@ -3,16 +3,20 @@ package cn.teammodel.model.dto.Appraise;
 import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
+import javax.validation.constraints.NotBlank;
+
 /**
  * @author winter
  * @create 2023-11-22 16:16
  */
 @Data
 public class InsertNodeDto {
-    // 检索需要,但是有 bug
+    @ApiModelProperty(value = "不传则默认为 default 的树增加节点")
     String periodId;
     @ApiModelProperty(value = "父亲节点,不传则为根节点")
     String pid;
+    @ApiModelProperty(value = "父亲节点,不传则为根节点", required = true)
+    @NotBlank(message = "name 不能为空")
     String name;
     String logo;
     Integer order;

src/main/java/cn/teammodel/model/dto/Appraise/UpdateNodeDto.java

@@ -1,5 +1,6 @@
 package cn.teammodel.model.dto.Appraise;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,7 +9,7 @@ import lombok.Data;
  */
 @Data
 public class UpdateNodeDto {
-    // 检索需要,但是有 bug
+    @ApiModelProperty(value = "不传则默认为 default 的树修改节点")
     String periodId;
     String id;
     String name;

src/main/java/cn/teammodel/service/impl/EvaluationServiceImpl.java

@@ -52,7 +52,7 @@ public class EvaluationServiceImpl implements EvaluationService {
     private AppraiseRepository appraiseRepository;
 
     /**
-     * 通用的获取 evaluation 的方法: 判断参数,判断数据是否为空 <br/>
+     * 通用的获取用户学校和学段对应的 appraise 的方法: 判断参数,判断数据是否为空 <br/>
      * 从 token 中获取 schoolId
      */
     private Appraise findAppraise(String periodId) {
@@ -154,7 +154,6 @@ public class EvaluationServiceImpl implements EvaluationService {
 
     @Override
     public Appraise insertNode(InsertNodeDto insertNodeDto) {
-        // todo: 如果不存在
         Appraise appraise = findAppraise(insertNodeDto.getPeriodId());
         User loginUser = SecurityUtil.getLoginUser();