fix bug

themis-business/src/main/java/com/qmth/themis/business/dto/AuthDto.java

@@ -2,6 +2,7 @@ package com.qmth.themis.business.dto;
 
 import com.qmth.themis.business.entity.TBOrg;
 import com.qmth.themis.business.enums.RoleEnum;
+import io.swagger.annotations.ApiModelProperty;
 
 import java.io.Serializable;
 import java.util.Set;
@@ -16,8 +17,13 @@ import java.util.Set;
 public class AuthDto implements Serializable {
     private static final long serialVersionUID = 1L;
 
+    @ApiModelProperty(name = "角色集合")
     private Set<String> roleCodes;
+
+    @ApiModelProperty(name = "url集合")
     private Set<String> urls;
+
+    @ApiModelProperty(name = "机构信息")
     private TBOrg tbOrg;
 
     public TBOrg getTbOrg() {

themis-business/src/main/java/com/qmth/themis/business/dto/ExamPropCountDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.math.BigDecimal;
 import java.util.Set;
@@ -13,21 +15,52 @@ import java.util.Set;
  */
 public class ExamPropCountDto implements Serializable {
 
+    @ApiModelProperty(name = "考试id")
     private Long examId;//考试批次id
+
+    @ApiModelProperty(name = "应考人数")
     private Integer allCount;//应考人数
+
+    @ApiModelProperty(name = "已登录")
     private Integer loginCount;//已登录
+
+    @ApiModelProperty(name = "已待考")
     private Integer prepareCount;//已待考
+
+    @ApiModelProperty(name = "考试中")
     private Integer examCount;//考试中
+
+    @ApiModelProperty(name = "客户端通讯故障")
     private Integer clientCommunicationStatusCount;//客户端通讯故障
+
+    @ApiModelProperty(name = "监控设备通讯故障")
     private Integer monitorStatusSourceCount;//监控设备通讯故障
+
+    @ApiModelProperty(name = "已完成")
     private Integer alreadyComplete;//已完成
+
+    @ApiModelProperty(name = "未完成")
     private Integer notComplete;//未完成
+
+    @ApiModelProperty(name = "虚拟考场代码")
     private Set<String> roomCodes;//虚拟考场代码
+
+    @ApiModelProperty(name = "完成率")
     private BigDecimal completionRate;//完成率
+
+    @ApiModelProperty(name = "重考审核")
     private Integer reexamCount;//重考审核
+
+    @ApiModelProperty(name = "最大考试时长")
     private Long maxDurationSeconds;//最大考试时长
+
+    @ApiModelProperty(name = "强制交卷时间")
     private Long finishTime;//强制交卷时间
+
+    @ApiModelProperty(name = "异常人数")
     private Integer exceptionCount;//异常人数
+
+    @ApiModelProperty(name = "预警人数")
     private Integer warningCount;//预警人数
 
     public ExamPropCountDto() {

themis-business/src/main/java/com/qmth/themis/business/dto/WarningDto.java

@@ -1,6 +1,7 @@
 package com.qmth.themis.business.dto;
 
 import com.qmth.themis.business.enums.VerifyExceptionEnum;
+import io.swagger.annotations.ApiModelProperty;
 
 import java.io.Serializable;
 
@@ -13,10 +14,19 @@ import java.io.Serializable;
  */
 public class WarningDto implements Serializable {
 
+    @ApiModelProperty(name = "预警类型")
     private VerifyExceptionEnum warningEnum;//预警类型
+
+    @ApiModelProperty(name = "人脸数量，0：没有人脸，大于1：多张人脸")
     private Integer faceCount;//人脸数量，0：没有人脸，大于1：多张人脸
+
+    @ApiModelProperty(name = "真实性结果，-1：没有，0：异常，1：正常")
     private Double realness;//真实性结果，-1：没有，0：异常，1：正常
+
+    @ApiModelProperty(name = "考试记录id")
     private Long recordId;//考试记录id
+
+    @ApiModelProperty(name = "照片url")
     private String photoUrl;//照片url
 
     public WarningDto() {

themis-business/src/main/java/com/qmth/themis/business/dto/cache/TEStudentCacheDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.cache;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 
 /** 
@@ -11,12 +13,25 @@ import java.io.Serializable;
 */ 
 public class TEStudentCacheDto implements Serializable {
 
+    @ApiModelProperty(name = "学生id")
     private Long id;
+
+    @ApiModelProperty(name = "机构id")
     private Long orgId;
+
+    @ApiModelProperty(name = "证件号，机构内唯一")
     private String identity;
+
+    @ApiModelProperty(name = "姓名")
     private String name;
+
+    @ApiModelProperty(name = "学生底照")
     private String basePhotoPath;
+
+    @ApiModelProperty(name = "考试记录id")
     private Long examingRecordId;
+
+    @ApiModelProperty(name = "未完成的考试记录id")
     private Long unFinishedRecordId;
 
     public Long getId() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/RoomCodeQueryDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 
 /**
@@ -11,7 +13,10 @@ import java.io.Serializable;
  */
 public class RoomCodeQueryDto implements Serializable {
 
+    @ApiModelProperty(name = "虚拟考场代码，考试唯一")
     private String roomCode;
+
+    @ApiModelProperty(name = "虚拟考场名称")
     private String roomName;
 
     public String getRoomCode() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TBExamInvigilateUserDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 
 /** 
@@ -10,10 +12,17 @@ import java.io.Serializable;
 * @Date: 2020/8/3 
 */ 
 public class TBExamInvigilateUserDto implements Serializable {
-    
+
+    @ApiModelProperty(name = "虚拟考场代码，考试唯一")
     private String roomCode;//考场代码
+
+    @ApiModelProperty(name = "虚拟考场名称")
     private String roomName;//考场名称
+
+    @ApiModelProperty(name = "用户id")
     private String userId;//老师id
+
+    @ApiModelProperty(name = "用户姓名")
     private String name;//老师名称
 
     public String getRoomCode() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TBOrgDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.util.Date;
 
@@ -12,20 +14,49 @@ import java.util.Date;
 */ 
 public class TBOrgDto implements Serializable {
 
+    @ApiModelProperty(name = "机构id")
     private Long id;//机构id
+
+    @ApiModelProperty(name = "机构名称")
     private String name;//机构名称
+
+    @ApiModelProperty(name = "机构代码")
     private String code;//机构代码
+
+    @ApiModelProperty(name = "机构logo")
     private String logo;//logo
+
+    @ApiModelProperty(name = "是否开启模考")
     private Integer enableSimulate;//是否开启模考
+
+    @ApiModelProperty(name = "是否启用，0：停用，1：启用")
     private Integer enable;//是否启用
+
+    @ApiModelProperty(name = "联系人")
     private String contactName;//联系人
+
+    @ApiModelProperty(name = "联系电话")
     private String contactPhone;//联系电话
+
+    @ApiModelProperty(name = "更新人")
     private String updateName;//更新人
+
+    @ApiModelProperty(name = "更新时间")
     private Date updateTime;//更新时间
+
+    @ApiModelProperty(name = "模考试卷id")
     private Long simulatePaperId;//模考试卷id
+
+    @ApiModelProperty(name = "是否允许监控转录")
     private Integer enableMonitorRecord;//是否允许监控转录
+
+    @ApiModelProperty(name = "是否允许使用活体")
     private Integer enableLiveness;//是否允许使用活体
+
+    @ApiModelProperty(name = "外部访问凭证")
     private String accessKey;//外部访问凭证
+
+    @ApiModelProperty(name = "外部访问密钥")
     private String accessSecret;//外部访问密钥
 
     public String getLogo() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TBTaskDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.util.Date;
 
@@ -12,20 +14,49 @@ import java.util.Date;
  */
 public class TBTaskDto implements Serializable {
 
+    @ApiModelProperty(name = "任务id")
     private Long id;//id
+
+    @ApiModelProperty(name = "任务类型，calculate_exam_score：考试重新算分，import_exam_student：导入考生，import_exam_paper：导入试卷，import_invigilate_user：导入监考员，export_invigilate_user：导出监考员")
     private String type;//类型
+
+    @ApiModelProperty(name = "实体id")
     private Long entityId;//实体id
+
+    @ApiModelProperty(name = "任务状态，init：未开始，running：开始执行，finish：执行结束")
     private String status;//状态
-    private String summary;//任务状态，init：未开始，running：开始执行，finish：执行结束
+
+    @ApiModelProperty(name = "实时摘要信息")
+    private String summary;//实时摘要信息
+
+    @ApiModelProperty(name = "进度")
     private Double progress;//进度
+
+    @ApiModelProperty(name = "导出文件路径")
     private String hasResultFile;//导出文件路径
+
+    @ApiModelProperty(name = "报告路径")
     private String hasReportFile;//报告路径
+
+    @ApiModelProperty(name = "创建时间")
     private Date createTime;//创建时间
+
+    @ApiModelProperty(name = "开始时间")
     private Date startTime;//开始时间
+
+    @ApiModelProperty(name = "结束时间")
     private Date finishTime;//结束时间
+
+    @ApiModelProperty(name = "创建人id")
     private Long createId;//创建人id
+
+    @ApiModelProperty(name = "创建人")
     private String createName;//创建人
+
+    @ApiModelProperty(name = "导入文件名")
     private String importFileName;//导入文件名
+
+    @ApiModelProperty(name = "业务对象名")
     private String entityName;//业务对象名
 
     public String getImportFileName() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TBUserDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.util.Date;
 import java.util.List;
@@ -13,18 +15,43 @@ import java.util.List;
  */
 public class TBUserDto implements Serializable {
 
+    @ApiModelProperty(name = "用户id")
     private Long id;//id
+
+    @ApiModelProperty(name = "用户姓名")
     private String name;//姓名
+
+    @ApiModelProperty(name = "角色名")
     private String roleNameStr;//角色名
+
+    @ApiModelProperty(name = "是否启用，0：停用，1：启用")
     private Integer enable;//状态
+
+    @ApiModelProperty(name = "更新人")
     private String updateName;//更新人
+
+    @ApiModelProperty(name = "更新时间")
     private Date updateTime;//更新时间
+
+    @ApiModelProperty(name = "登录名")
     private String loginName;//登录名
+
+    @ApiModelProperty(name = "机构id")
     private Long orgId;//机构id
+
+    @ApiModelProperty(name = "机构名称")
     private String orgName;//机构名称
+
+    @ApiModelProperty(name = "手机号")
     private String mobileNumber;//手机号
+
+    @ApiModelProperty(name = "角色编码")
     private String roleCodeStr;//角色编码
+
+    @ApiModelProperty(name = "角色编码集合")
     private List<String> roleCode;
+
+    @ApiModelProperty(name = "角色名称集合")
     private List<String> roleName;
 
     public Long getOrgId() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEExamActivityDto.java

@@ -7,6 +7,7 @@ import com.qmth.themis.business.cache.bean.ExamStudentCacheBean;
 import com.qmth.themis.business.enums.EntryAuthenticationPolicyEnum;
 import com.qmth.themis.business.enums.HardwareTestEnum;
 import com.qmth.themis.business.enums.MonitorVideoSourceEnum;
+import io.swagger.annotations.ApiModelProperty;
 
 import java.io.Serializable;
 import java.util.*;
@@ -20,40 +21,109 @@ import java.util.*;
  */
 public class TEExamActivityDto implements Serializable {
 
+    @ApiModelProperty(name = "考试场次id")
     private Long id;//考试id
+
+    @ApiModelProperty(name = "考试场次代码")
     private String code;//考试场次代码
+
+    @ApiModelProperty(name = "考生id")
     private Long examStudentId;//考生id
+
+    @ApiModelProperty(name = "科目代码")
     private String courseCode;//科目代码
+
+    @ApiModelProperty(name = "科目名称")
     private String courseName;//科目名称
+
+    @ApiModelProperty(name = "提前多长时间开始候考(时间戳)")
     private Long prepareTime;
+
+    @ApiModelProperty(name = "最短考试时长")
     private Long minStartTime;
+
+    @ApiModelProperty(name = "最大考试时长")
     private Long maxStartTime;
+
+    @ApiModelProperty(name = "强制交卷时间")
     private Long maxFinishTime;
+
+    @ApiModelProperty(name = "监控源")
     private String monitorVideoSourceStr;
+
+    @ApiModelProperty(name = "监控源集合")
     private List<String> monitorVideoSource;
+
+    @ApiModelProperty(name = "允许开考开放时长，相当于迟到时间")
     private Integer openingSeconds;//允许开考开放时长(分钟)，相当于迟到时间
+
+    @ApiModelProperty(name = "允许开考开放时长，相当于迟到时间")
     private Integer activityOpeningSeconds;//允许开考开放时长(分钟)，相当于迟到时间
+
+    @ApiModelProperty(name = "提前多长时间开始候考")
     private Integer prepareSeconds;//提前多长时间开始候考(分钟)
+
+    @ApiModelProperty(name = "提前多长时间开始候考")
     private Integer activityPrepareSeconds;//提前多长时间开始候考(分钟)
+
+    @ApiModelProperty(name = "最短考试时长，相当于考试冻结时间")
     private Integer minDurationSeconds;//最短考试时长，相当于考试冻结时间(分钟)
+
+    @ApiModelProperty(name = "最大考试时长")
     private Integer maxDurationSeconds;//最大考试时长
+
+    @ApiModelProperty(name = "最大考试时长")
     private Integer activityMaxDurationSeconds;//最大考试时长
+
+    @ApiModelProperty(name = "允许考试次数")
     private Integer examCount;//允许考试次数
+
+    @ApiModelProperty(name = "是否在结束时间集中强制收卷，0：不强制，1：强制")
     private Integer forceFinish;//是否在结束时间集中强制收卷，0：不强制，1：强制
-    private String entryAuthenticationPolicy;//开考身份验证策略，off：关闭，face_verify_optional：非强制人脸验证，face_verify_force：强制人脸验证，liveness：活体验证
+
+    @ApiModelProperty(name = "开考身份验证策略，off：关闭，face_verify_optional：非强制人脸验证，face_verify_force：强制人脸验证，liveness_verify：活体验证")
+    private String entryAuthenticationPolicy;//开考身份验证策略，off：关闭，face_verify_optional：非强制人脸验证，face_verify_force：强制人脸验证，liveness_verify：活体验证
+
+    @ApiModelProperty(name = "考试过程中人脸检测是否开启，0：不开启，1：开启")
     private Integer inProcessFaceVerify;//考试过程中人脸检测是否开启，0：不开启，1：开启
+
+    @ApiModelProperty(name = "考试过程中人脸检测是否忽略陌生人 ，0：不忽略，1：忽略")
     private Integer inProcessFaceStrangerIgnore;//考试过程中人脸检测是否忽略陌生人 ，0：不忽略，1：忽略
+
+    @ApiModelProperty(name = "考试过程中是否启用活体检测 ，0：不启用，1：启用")
     private Integer inProcessLivenessVerify;//考试过程中是否启用活体检测 ，0：不启用，1：启用
+
+    @ApiModelProperty(name = "考试过程中活体检测间隔时间")
     private String inProcessLivenessFixedRangeStr;
+
+    @ApiModelProperty(name = "考试过程中活体检测间隔时间集合")
     private List<Integer> inProcessLivenessFixedRange;//考试过程中活体检测间隔时间
+
+    @ApiModelProperty(name = "考试过程中活体检测结果判定规则，any：任意一次通过，all：全部都要通过，more：通过次数大于失败次数")
     private String inProcessLivenessJudgePolicy;//考试过程中活体检测结果判定规则，any：任意一次通过，all：全部都要通过，more：通过次数大于失败次数
+
+    @ApiModelProperty(name = "是否允许使用摄像头拍照答题，0：不允许，1：允许")
     private Integer cameraPhotoUpload;//是否允许使用摄像头拍照答题，0：不允许，1：允许
+
+    @ApiModelProperty(name = "考场开始时间")
     private Date startTime;//考场开始时间
+
+    @ApiModelProperty(name = "考场结束时间")
     private Date finishTime;//考场结束时间
+
+    @ApiModelProperty(name = "剩余考试次数")
     private Integer leftExamCount;//剩余考试次数
+
+    @ApiModelProperty(name = "是否允许使用移动端拍照答题，0：不开启，1：开启")
     private Integer mobilePhotoUpload;//是否允许使用移动端拍照答题，0：不开启，1：开启
+
+    @ApiModelProperty(name = "客户端监控是否启用音频与麦克风")
     private Boolean monitorAudioEnable = false;//客户端监控是否启用音频与麦克风
+
+    @ApiModelProperty(name = "考试id")
     private Long examId;//考试id
+
+    @ApiModelProperty(name = "硬件检测集合")
     private List<String> hardwareTest;//硬件检测
 
     public TEExamActivityDto() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEExamActivityQueryDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.util.Date;
 
@@ -12,16 +14,37 @@ import java.util.Date;
  */
 public class TEExamActivityQueryDto implements Serializable {
 
+    @ApiModelProperty(name = "考试场次id")
     private Long id;//考试id
+
+    @ApiModelProperty(name = "考试场次代码")
     private String code;//考试场次id
+
+    @ApiModelProperty(name = "考试批次id")
     private Long examId;//考试批次id
+
+    @ApiModelProperty(name = "提前多长时间开始候考")
     private Integer prepareSeconds;//提前多长时间开始候考(分钟)
+
+    @ApiModelProperty(name = "最大考试时长")
     private Integer maxDurationSeconds;//最大考试时长
+
+    @ApiModelProperty(name = "是否启用，0：停用，1：启用")
     private Integer enable;//是否启用
+
+    @ApiModelProperty(name = "允许开考时长")
     private Integer openingSeconds;//允许开考时长(分钟);
+
+    @ApiModelProperty(name = "开始时间")
     private Date startTime;//开始时间
+
+    @ApiModelProperty(name = "结束时间")
     private Date finishTime;//结束时间
+
+    @ApiModelProperty(name = "更新时间")
     private Date updateTime;//更新时间
+
+    @ApiModelProperty(name = "更新人")
     private String updateName;//更新人
 
     public Long getId() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEExamCourseDto.java

@@ -12,6 +12,7 @@ import java.util.Date;
  */
 public class TEExamCourseDto implements Serializable {
 
+
     private Long id;//id
     private Long examId;//考试id
     private String courseCode;//科目代码

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEExamDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.util.List;
 import java.util.Map;
@@ -13,14 +15,31 @@ import java.util.Map;
  */
 public class TEExamDto implements Serializable {
 
+    @ApiModelProperty(name = "考试批次id")
     private Long id;//考试id
+
+    @ApiModelProperty(name = "考试场次id")
     private Long examActivityId;//考试场次id
+
+    @ApiModelProperty(name = "考试名称")
     private String name;//考试名称
+
+    @ApiModelProperty(name = "模式，together：集中统一，anytime：随到随考")
     private String mode;//考试模式
+
+    @ApiModelProperty(name = "考前须知")
     private String preNotice;//考前须知
+
+    @ApiModelProperty(name = "考试须知阅读时长")
     private Integer preNoticeStaySeconds;//考试须知阅读时长(秒)
+
+    @ApiModelProperty(name = "考后说明")
     private String postNotice;//考后说明，针对一个场次进行设置
+
+    @ApiModelProperty(name = "真实时间")
     private Integer reallyTime;
+
+    @ApiModelProperty(name = "考试场次集合")
     private List<TEExamActivityDto> activities;
 
     public List<TEExamActivityDto> getActivities() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEExamQueryDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.util.Date;
 import java.util.List;
@@ -13,16 +15,37 @@ import java.util.List;
  */
 public class TEExamQueryDto implements Serializable {
 
+    @ApiModelProperty(name = "考试id")
     private Long id;//考试id
+
+    @ApiModelProperty(name = "考试代码")
     private String code;//考试场次id
+
+    @ApiModelProperty(name = "考试名称")
     private String name;//考试名称
+
+    @ApiModelProperty(name = "模式，together：集中统一，anytime：随到随考")
     private String mode;//考试模式
+
+    @ApiModelProperty(name = "考试tag")
     private String tag;//考试tag
+
+    @ApiModelProperty(name = "是否启用，0：停用，1：启用")
     private Integer enable;//是否启用
+
+    @ApiModelProperty(name = "开始时间")
     private Date startTime;//开始时间
+
+    @ApiModelProperty(name = "结束时间")
     private Date endTime;//结束时间
+
+    @ApiModelProperty(name = "算分进度")
     private Double progress;//算分进度
+
+    @ApiModelProperty(name = "更新时间")
     private Date updateTime;//更新时间
+
+    @ApiModelProperty(name = "更新人")
     private String updateName;//更新人
 
     public Long getId() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEExamResultDto.java

@@ -2,6 +2,7 @@ package com.qmth.themis.business.dto.response;
 
 import com.qmth.themis.business.entity.TEConfig;
 import com.qmth.themis.business.entity.TEStudent;
+import io.swagger.annotations.ApiModelProperty;
 
 import java.io.Serializable;
 import java.util.List;
@@ -15,10 +16,19 @@ import java.util.List;
 */ 
 public class TEExamResultDto implements Serializable {
 
+    @ApiModelProperty(name = "考试批次信息")
     private TEExamDto waiting;
+
+    @ApiModelProperty(name = "考试场次信息集合")
     private List<TEExamActivityDto> activities;
+
+    @ApiModelProperty(name = "考试场次信息")
     private TEExamActivityDto activity;
+
+    @ApiModelProperty(name = "学生信息")
     private TEStudent student;
+
+    @ApiModelProperty(name = "全局配置信息")
     private TEConfig global;
 
     public TEExamDto getWaiting() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEExamStudentDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 
 /** 
@@ -11,20 +13,49 @@ import java.io.Serializable;
 */ 
 public class TEExamStudentDto implements Serializable {
 
+    @ApiModelProperty(name = "考生id")
     private Long id;//考生id
+
+    @ApiModelProperty(name = "考试批次名称")
     private String examName;//考试批次名称
+
+    @ApiModelProperty(name = "考生姓名")
     private String name;//考生姓名
+
+    @ApiModelProperty(name = "证件号")
     private String identity;//证件号
+
+    @ApiModelProperty(name = "考试场次代码")
     private String code;//考试场次代码
+
+    @ApiModelProperty(name = "科目代码")
     private String courseCode;//科目代码
+
+    @ApiModelProperty(name = "科目名称")
     private String courseName;//科目名称
+
+    @ApiModelProperty(name = "考生是否启用，0：停用，1：启用")
     private Integer enable;//考生是否启用
+
+    @ApiModelProperty(name = "考场代码")
     private String roomCode;//考场代码
+
+    @ApiModelProperty(name = "考场名称")
     private String roomName;//考场名称
+
+    @ApiModelProperty(name = "年级")
     private String grade;//年级
+
+    @ApiModelProperty(name = "教学班级")
     private String classNo;//教学班级
+
+    @ApiModelProperty(name = "场次id")
     private Long examActivityId;//场次id
+
+    @ApiModelProperty(name = "场次代码")
     private String activityCode;//场次代码
+
+    @ApiModelProperty(name = "考试批次id")
     private Long examId;//考试批次id
 
     public Long getExamId() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEExamUnFinishDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.util.Date;
 
@@ -12,39 +14,106 @@ import java.util.Date;
  */
 public class TEExamUnFinishDto implements Serializable {
 
+    @ApiModelProperty(name = "考试id")
     private Long id;//考试id
+
+    @ApiModelProperty(name = "考试场次id")
     private Long examActivityId;//考试场次id
+
+    @ApiModelProperty(name = "考试记录id")
     private Long recordId;//考试记录id
+
+    @ApiModelProperty(name = "考生id")
     private Long examStudentId;//考生id
+
+    @ApiModelProperty(name = "考试名称")
     private String name;//考试名称
+
+    @ApiModelProperty(name = "模式，together：集中统一，anytime：随到随考")
     private String mode;//考试模式
+
+    @ApiModelProperty(name = "考前须知")
     private String preNotice;//考前须知
+
+    @ApiModelProperty(name = "考试须知阅读时长")
     private Integer preNoticeStaySeconds;//考试须知阅读时长(秒)
+
+    @ApiModelProperty(name = "考后说明")
     private String postNotice;//考后说明，针对一个场次进行设置
+
+    @ApiModelProperty(name = "考试代码")
     private String examCode;//考试代码
+
+    @ApiModelProperty(name = "考试场次代码")
     private String examActivityCode;//考试场次代码
+
+    @ApiModelProperty(name = "考试开始时间")
     private Date examStartTime;//考试开始时间
+
+    @ApiModelProperty(name = "考试结束时间")
     private Date examEndTime;//考试结束时间
+
+    @ApiModelProperty(name = "考场开始时间")
     private Date examActivityStartTime;//考场开始时间
+
+    @ApiModelProperty(name = "考场结束时间")
     private Date examActivityFinishTime;//考场结束时间
+
+    @ApiModelProperty(name = "科目代码")
     private String courseCode;//科目代码
+
+    @ApiModelProperty(name = "科目名称")
     private String courseName;//科目名称
+
+    @ApiModelProperty(name = "提前多长时间开始候考")
     private Long prepareSeconds;//提前多长时间开始候考(分钟)
+
+    @ApiModelProperty(name = "最短考试时长")
     private Long minDurationSeconds;//最短考试时长，相当于考试冻结时间(分钟)
+
+    @ApiModelProperty(name = "最大考试时长")
     private Long maxDurationSeconds;//最大考试时长
+
+    @ApiModelProperty(name = "允许考试次数")
     private Integer examCount;//允许考试次数
+
+    @ApiModelProperty(name = "是否在结束时间集中强制收卷，0：不强制，1：强制")
     private Integer fouceFinish;//是否在结束时间集中强制收卷，0：不强制，1：强制
+
+    @ApiModelProperty(name = "开考身份验证策略，off：关闭，face_verify_optional：非强制人脸验证，face_verify_force：强制人脸验证，liveness_verify：活体验证")
     private String entryAuthenticationPolicy;//开考身份验证策略，off：关闭，face_verify_optional：非强制人脸验证，face_verify_force：强制人脸验证，liveness：活体验证
+
+    @ApiModelProperty(name = "考试过程中人脸检测是否开启，0：不开启，1：开启")
     private Integer inProcessFaceVerify;//考试过程中人脸检测是否开启，0：不开启，1：开启
+
+    @ApiModelProperty(name = "考试过程中人脸检测是否忽略陌生人 ，0：不忽略，1：忽略")
     private Integer inProcessFaceStrangerIgnore;//考试过程中人脸检测是否忽略陌生人 ，0：不忽略，1：忽略
+
+    @ApiModelProperty(name = "考试过程中是否启用活体检测 ，0：不启用，1：启用")
     private Integer inProcessLivenessVerify;//考试过程中是否启用活体检测 ，0：不启用，1：启用
+
+    @ApiModelProperty(name = "考试过程中活体检测间隔时间")
     private String inProcessLivenessFixedRange;//考试过程中活体检测间隔时间
+
+    @ApiModelProperty(name = "考试过程中活体检测结果判定规则，any：任意一次通过，all：全部都要通过，more：通过次数大于失败次数")
     private String inProcessLivenessJudgePolicy;//考试过程中活体检测结果判定规则，any：任意一次通过，all：全部都要通过，more：通过次数大于失败次数
+
+    @ApiModelProperty(name = "是否允许使用摄像头拍照答题，0：不允许，1：允许")
     private Integer cameraPhotoUpload;//是否允许使用摄像头拍照答题，0：不允许，1：允许
+
+    @ApiModelProperty(name = "断点失效时间")
     private Integer breakExpireSeconds;//断点失效时间(秒)
+
+    @ApiModelProperty(name = "断点续考次数")
     private Integer breakResumeCount;//断点续考次数
+
+    @ApiModelProperty(name = "累计考试用时")
     private Integer durationSeconds;//累计考试用时
+
+    @ApiModelProperty(name = "客户端最近同步时间")
     private Date clientLastSyncTime;//客户端最近同步时间
+
+    @ApiModelProperty(name = "是否允许使用移动端拍照答题，0：不开启，1：开启")
     private Integer mobilePhotoUpload;//是否允许使用移动端拍照答题，0：不开启，1：开启
 
     public Integer getMobilePhotoUpload() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEStudentDto.java

@@ -1,5 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
+import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import java.util.Date;
 
@@ -12,15 +14,34 @@ import java.util.Date;
  */
 public class TEStudentDto implements Serializable {
 
+    @ApiModelProperty(name = "学生id")
     private Long id;//id
+
+    @ApiModelProperty(name = "学生姓名")
     private String name;//姓名
+
+    @ApiModelProperty(name = "证件号")
     private String identity;//证件号
+
+    @ApiModelProperty(name = "机构名称")
     private String orgName;//机构名称
+
+    @ApiModelProperty(name = "是否启用，0：停用，1：启用")
     private Integer enable;//是否启用
+
+    @ApiModelProperty(name = "底照地址")
     private String basePhotoPath;//底照地址
+
+    @ApiModelProperty(name = "创建人")
     private String createName;//创建人
+
+    @ApiModelProperty(name = "更新人")
     private String updateName;//更新人
+
+    @ApiModelProperty(name = "创建时间")
     private Date createTime;//创建时间
+
+    @ApiModelProperty(name = "更新时间")
     private Date updateTime;//更新时间
 
     public Long getId() {

themis-business/src/main/java/com/qmth/themis/business/dto/response/TEStudentExamRecordDto.java

@@ -1,6 +1,7 @@
 package com.qmth.themis.business.dto.response;
 
 import com.qmth.themis.business.enums.ExamRecordStatusEnum;
+import io.swagger.annotations.ApiModelProperty;
 
 import java.io.Serializable;
 
@@ -13,15 +14,34 @@ import java.io.Serializable;
  */
 public class TEStudentExamRecordDto implements Serializable {
 
+    @ApiModelProperty(name = "考试批次id")
     private Long examId;//考试批次id
+
+    @ApiModelProperty(name = "考试名称")
     private String examName;//考试名称
+
+    @ApiModelProperty(name = "考生id")
     private Long examStudentId;//考生id
+
+    @ApiModelProperty(name = "考试记录id")
     private Long examRecordId;//考试记录id
+
+    @ApiModelProperty(name = "科目编码")
     private String courseCode;//科目编码
+
+    @ApiModelProperty(name = "科目名称")
     private String courseName;//科目名称
+
+    @ApiModelProperty(name = "证件号")
     private String identity;//证件号
+
+    @ApiModelProperty(name = "姓名")
     private String name;//姓名
+
+    @ApiModelProperty(name = "客观分数")
     private Double objectiveScore;//客观分数
+
+    @ApiModelProperty(name = "考试状态")
     private ExamRecordStatusEnum status;//考试状态
 
     public Long getExamId() {