Commit 7ada3155 authored by wujipeng's avatar wujipeng
Browse files

Merge remote-tracking branch 'origin/dev-v1.0' into dev-v1.0

parents 04355d28 a6e34844
package com.platform.business.model.dto;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import java.util.List;
/** 管理端批量撤回评价任务请求。 */
@Data
public class EvaluationBatchRevokeDTO {
@ApiModelProperty(value = "待撤回任务ID列表", required = true)
private List<String> taskIds;
}
package com.platform.business.model.dto;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
/** 学员提交七个必填维度及一项选填建议。 */
@Data
public class EvaluationSubmitDTO {
@ApiModelProperty(value = "教学态度:GOOD/FAIR/OK/POOR", required = true)
private String teachingAttitude;
@ApiModelProperty(value = "教学内容:GOOD/FAIR/OK/POOR", required = true)
private String teachingContent;
@ApiModelProperty(value = "教学方法:GOOD/FAIR/OK/POOR", required = true)
private String teachingMethod;
@ApiModelProperty(value = "教学手段:GOOD/FAIR/OK/POOR", required = true)
private String teachingMeans;
@ApiModelProperty(value = "讲解示范:GOOD/FAIR/OK/POOR", required = true)
private String demonstration;
@ApiModelProperty(value = "巡回指导:GOOD/FAIR/OK/POOR", required = true)
private String guidance;
@ApiModelProperty(value = "课时完成情况:GOOD/FAIR/OK/POOR", required = true)
private String classHourCompletion;
@ApiModelProperty("意见与建议,选填,最长1000字符")
private String comment;
}
package com.platform.business.model.dto;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
/** 管理员发起学员评议任务请求。 */
@Data
public class EvaluationTaskCreateDTO {
@ApiModelProperty(value = "班级课程ID(class_subject.id)", required = true)
private Integer subjectId;
@ApiModelProperty(value = "评价截止日期/时间;日期会按当天23:59:59处理",
required = true, example = "2026-08-14")
private String deadline;
}
package com.platform.business.model.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import java.util.Date;
/**
* 评价任务分页及导出筛选条件。
*
* <p>学员端只使用 status、pageNum 和 pageSize,且服务端会强制追加当前登录学员ID;
* 管理端可使用全部条件。</p>
*/
@Data
public class EvaluationTaskQueryDTO {
@ApiModelProperty("课程名称,支持模糊匹配")
private String courseName;
@ApiModelProperty("班级ID")
private Integer classId;
@ApiModelProperty("授课教师用户ID")
private String teacherId;
@ApiModelProperty("上课日期范围起点")
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
private Date startDate;
@ApiModelProperty("上课日期范围终点")
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
private Date endDate;
@ApiModelProperty("PENDING、COMPLETED、EXPIRED、REVOKED")
private String status;
@ApiModelProperty("课程类型,例如理论或实训")
private String type;
private Integer pageNum;
private Integer pageSize;
}
package com.platform.business.model.entity;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.util.Date;
/**
* 单个目标学员的评价记录。
*
* <p>管理员发起任务时即为班级内每位有效学员建立一行 PENDING 记录。这样既能准确计算
* 待评/已评人数,也能确保后来转入班级的学员不会被错误加入历史任务。</p>
*/
@Data
@TableName("evaluation_record")
public class EvaluationRecordEntity {
@TableId(value = "id", type = IdType.INPUT)
private String id;
private String taskId;
private String studentId;
/** PENDING 或 SUBMITTED;提交成功后禁止再次修改。 */
private String status;
private String teachingAttitude;
private String teachingContent;
private String teachingMethod;
private String teachingMeans;
private String demonstration;
private String guidance;
private String classHourCompletion;
/** 意见与建议,选填,最长1000字符。 */
private String comment;
private Date submittedAt;
private Date createdTime;
private Date updateTime;
}
package com.platform.business.model.entity;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.util.Date;
/**
* 学员评议任务主表。
*
* <p>任务只保存课程ID和状态等过程数据;课程、班级、教师名称由查询时关联业务表获取,
* 防止同一份展示信息被重复维护。目标学员则由评价记录表在发起时形成快照。</p>
*/
@Data
@TableName("evaluation_task")
public class EvaluationTaskEntity {
/** 雪花算法字符串ID,和项目现有业务主键风格保持一致。 */
@TableId(value = "id", type = IdType.INPUT)
private String id;
/** 对应一节具体课程,同一课程只能发起一个有效评价任务。 */
private Integer subjectId;
/** PENDING、COMPLETED、EXPIRED、REVOKED。 */
private String status;
/** 学员最晚可提交时间,精确到秒。 */
private Date deadline;
/** 发起任务的管理员用户ID。 */
private String createdBy;
private Date createdTime;
/** 状态或其他业务字段最后更新时间。 */
private Date updateTime;
/** 管理员撤回任务的时间,未撤回时为空。 */
private Date revokedAt;
/** 执行撤回的管理员用户ID,未撤回时为空。 */
private String revokedBy;
}
package com.platform.business.model.vo;
import lombok.Data;
/** 管理端单个评分维度的四档数量及占比。 */
@Data
public class EvaluationDimensionStatisticsVO {
/** 与提交DTO字段一致的稳定英文键。 */
private String dimensionKey;
private String dimensionName;
private Integer goodCount;
private Integer fairCount;
private Integer okCount;
private Integer poorCount;
private Integer submittedCount;
/** GOOD=4、FAIR=3、OK=2、POOR=1计算出的平均分,暂无提交时为0。 */
private Double averageScore;
}
package com.platform.business.model.vo;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.util.Date;
/** 管理员查看的实名学员评价明细。 */
@Data
public class EvaluationRecordVO {
private String id;
private String taskId;
private String studentId;
private String studentName;
private String phoneNumber;
private String status;
private String teachingAttitude;
private String teachingContent;
private String teachingMethod;
private String teachingMeans;
private String demonstration;
private String guidance;
private String classHourCompletion;
private String comment;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date submittedAt;
}
package com.platform.business.model.vo;
import lombok.Data;
import lombok.EqualsAndHashCode;
import java.util.List;
/** 管理端任务详情,包含实名评价明细和七维度汇总。 */
@Data
@EqualsAndHashCode(callSuper = true)
public class EvaluationTaskDetailVO extends EvaluationTaskVO {
private List<EvaluationRecordVO> records;
private List<EvaluationDimensionStatisticsVO> dimensionStatistics;
}
package com.platform.business.model.vo;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.util.Date;
/** 管理端评价任务列表和任务基础详情。 */
@Data
public class EvaluationTaskVO {
private String id;
private Integer subjectId;
private String courseName;
private Integer classId;
private String className;
/** 原型中的课次信息,对应 class_subject.subject_times。 */
private Integer subjectTimes;
private String teacherId;
private String teacherName;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date courseDate;
private String timeFrame;
private String type;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date deadline;
private String status;
private Integer totalCount;
private Integer pendingCount;
private Integer submittedCount;
/** 已评人数 / 总人数,返回0到100之间的百分比。 */
private Double completionRate;
private String createdBy;
private String creatorName;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date createdTime;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date revokedAt;
private String revokedBy;
private String revokerName;
}
package com.platform.business.model.vo;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.util.Date;
/**
* 学员端“我的评价”列表及本人评价详情。
*
* <p>该对象不包含其他学员信息和汇总结果。已提交时仅返回当前学员自己的内容。</p>
*/
@Data
public class StudentEvaluationTaskVO {
private String taskId;
private Integer subjectId;
private String courseName;
private String teacherName;
private String className;
private Integer subjectTimes;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date courseDate;
private String timeFrame;
private String type;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date deadline;
/** 任务最终状态;撤回任务不会出现在学员列表中。 */
private String taskStatus;
private String recordStatus;
private String teachingAttitude;
private String teachingContent;
private String teachingMethod;
private String teachingMeans;
private String demonstration;
private String guidance;
private String classHourCompletion;
private String comment;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date submittedAt;
}
package com.platform.business.constant;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashSet;
import java.util.Set;
/**
* 学员评议模块常量。
*
* <p>状态值和评分值会同时写入数据库、出现在接口报文中,因此集中定义,避免各层使用
* 不一致的大小写或中文值。数据库建表 SQL 中的字段注释也与本类保持一致。</p>
*/
public final class EvaluationConstants {
/** 任务尚可提交评价。 */
public static final String TASK_PENDING = "PENDING";
/** 任务下全部目标学员均已提交。 */
public static final String TASK_COMPLETED = "COMPLETED";
/** 到达截止时间后仍未全部完成。 */
public static final String TASK_EXPIRED = "EXPIRED";
/** 管理员主动撤回。 */
public static final String TASK_REVOKED = "REVOKED";
/** 学员尚未提交。 */
public static final String RECORD_PENDING = "PENDING";
/** 学员已提交,提交后不可修改。 */
public static final String RECORD_SUBMITTED = "SUBMITTED";
/** 原型中的四档评分值。 */
public static final String SCORE_GOOD = "GOOD";
public static final String SCORE_FAIR = "FAIR";
public static final String SCORE_OK = "OK";
public static final String SCORE_POOR = "POOR";
/** 允许写入的全部评分值,用于统一校验七个必填维度。 */
public static final Set<String> ALLOWED_SCORES = Collections.unmodifiableSet(new HashSet<>(Arrays.asList(
SCORE_GOOD, SCORE_FAIR, SCORE_OK, SCORE_POOR)));
/** 允许用于任务列表筛选的全部任务状态。 */
public static final Set<String> ALLOWED_TASK_STATUSES = Collections.unmodifiableSet(new HashSet<>(Arrays.asList(
TASK_PENDING, TASK_COMPLETED, TASK_EXPIRED, TASK_REVOKED)));
private EvaluationConstants() {
}
}
package com.platform.business.controller;
import com.platform.business.model.dto.EvaluationBatchRevokeDTO;
import com.platform.business.model.dto.EvaluationSubmitDTO;
import com.platform.business.model.dto.EvaluationTaskCreateDTO;
import com.platform.business.model.dto.EvaluationTaskQueryDTO;
import com.platform.business.model.entity.UserEntity;
import com.platform.business.model.vo.EvaluationTaskDetailVO;
import com.platform.business.model.vo.EvaluationTaskVO;
import com.platform.business.model.vo.StudentEvaluationTaskVO;
import com.platform.business.service.AuthenticatedUserService;
import com.platform.business.service.EvaluationService;
import com.platform.controller.BaseController;
import com.platform.model.resp.Result;
import com.platform.page.TableDataInfo;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;
/**
* 学员评议两端接口。
*
* <p>教师端没有对应原型,本控制器不提供任何教师查询入口。学员身份始终从JWT解析,客户端
* 无法通过传入studentId查看或提交他人评价;所有管理端接口均额外校验管理员角色。</p>
*/
@Api(tags = "学员评议")
@RestController
@RequestMapping("/evaluation")
public class EvaluationController extends BaseController {
@Resource
private EvaluationService evaluationService;
@Resource
private AuthenticatedUserService authenticatedUserService;
@ApiOperation("学员端-分页查询本人的待评价、已评价和已过期任务")
@PostMapping("/student/page")
public TableDataInfo studentPage(@RequestBody(required = false) EvaluationTaskQueryDTO query,
HttpServletRequest request) {
UserEntity student = authenticatedUserService.current(request);
EvaluationTaskQueryDTO safeQuery = query == null ? new EvaluationTaskQueryDTO() : query;
startEvaluationPage(safeQuery);
return getDataTable(evaluationService.queryStudentTasks(safeQuery, student.getId()));
}
@ApiOperation("学员端-查看本人评价表单或已提交内容")
@GetMapping("/student/{taskId}")
public Result<StudentEvaluationTaskVO> studentDetail(@PathVariable String taskId,
HttpServletRequest request) {
UserEntity student = authenticatedUserService.current(request);
return Result.data(evaluationService.studentDetail(taskId, student.getId()));
}
@ApiOperation("学员端-提交评价(七个维度必填且仅可提交一次)")
@PostMapping("/student/{taskId}/submit")
public Result<StudentEvaluationTaskVO> submit(@PathVariable String taskId,
@RequestBody EvaluationSubmitDTO body,
HttpServletRequest request) {
UserEntity student = authenticatedUserService.current(request);
return Result.data(evaluationService.submit(taskId, body, student.getId()));
}
@ApiOperation("管理端-发起评价任务并推送给班级当前有效学员")
@PostMapping("/admin/task")
public Result<EvaluationTaskVO> createTask(@RequestBody EvaluationTaskCreateDTO body,
HttpServletRequest request) {
UserEntity admin = requireAdmin(request);
return Result.data(evaluationService.createTask(body, admin.getId(), admin.getNickName()));
}
@ApiOperation("管理端-分页筛选评价任务")
@PostMapping("/admin/page")
public TableDataInfo adminPage(@RequestBody(required = false) EvaluationTaskQueryDTO query,
HttpServletRequest request) {
requireAdmin(request);
EvaluationTaskQueryDTO safeQuery = query == null ? new EvaluationTaskQueryDTO() : query;
startEvaluationPage(safeQuery);
return getDataTable(evaluationService.queryAdminTasks(safeQuery));
}
@ApiOperation("管理端-查看实名评价明细和七维度统计")
@GetMapping("/admin/{taskId}")
public Result<EvaluationTaskDetailVO> adminDetail(@PathVariable String taskId,
@RequestParam(required = false) String studentName,
HttpServletRequest request) {
requireAdmin(request);
return Result.data(evaluationService.adminDetail(taskId, studentName));
}
@ApiOperation("管理端-撤回一个待评价任务")
@PutMapping("/admin/{taskId}/revoke")
public Result<Boolean> revoke(@PathVariable String taskId, HttpServletRequest request) {
UserEntity admin = requireAdmin(request);
return Result.data(evaluationService.revoke(taskId, admin.getId()));
}
@ApiOperation("管理端-批量撤回待评价任务")
@PutMapping("/admin/batch-revoke")
public Result<Integer> batchRevoke(@RequestBody EvaluationBatchRevokeDTO body,
HttpServletRequest request) {
UserEntity admin = requireAdmin(request);
List<String> taskIds = body == null ? null : body.getTaskIds();
return Result.data(evaluationService.batchRevoke(taskIds, admin.getId()));
}
@ApiOperation("管理端-按筛选条件导出评价任务汇总Excel")
@PostMapping("/admin/export")
public void exportTasks(@RequestBody(required = false) EvaluationTaskQueryDTO query,
HttpServletRequest request,
HttpServletResponse response) {
requireAdmin(request);
evaluationService.exportAdminTasks(query, response);
}
@ApiOperation("管理端-导出单个任务实名明细及维度统计Excel")
@GetMapping("/admin/{taskId}/export")
public void exportDetail(@PathVariable String taskId,
HttpServletRequest request,
HttpServletResponse response) {
requireAdmin(request);
evaluationService.exportTaskDetail(taskId, response);
}
/** 评价列表缺省第1页、每页10条,并限制异常的大页请求。 */
private void startEvaluationPage(EvaluationTaskQueryDTO query) {
int pageNum = query.getPageNum() == null || query.getPageNum() < 1 ? 1 : query.getPageNum();
int pageSize = query.getPageSize() == null || query.getPageSize() < 1 ? 10 : query.getPageSize();
startPage(pageNum, Math.min(pageSize, 100));
}
/** 统一完成JWT用户解析和管理员角色校验。 */
private UserEntity requireAdmin(HttpServletRequest request) {
UserEntity user = authenticatedUserService.current(request);
authenticatedUserService.requireAdmin(user);
return user;
}
}
package com.platform.business.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.platform.business.model.entity.EvaluationRecordEntity;
import com.platform.business.model.vo.EvaluationRecordVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import java.util.Date;
import java.util.List;
/** 目标学员快照、评价提交和管理端实名明细的数据访问接口。 */
@Mapper
public interface EvaluationRecordMapper extends BaseMapper<EvaluationRecordEntity> {
/** 一次性写入一个班级的目标学员快照。 */
int batchInsert(@Param("records") List<EvaluationRecordEntity> records);
/** 学员提交前锁定本人的评价行,确保同一账号并发提交只有一次成功。 */
EvaluationRecordEntity selectByTaskAndStudentForUpdate(@Param("taskId") String taskId,
@Param("studentId") String studentId);
/**
* 仅更新PENDING记录。虽然调用方已经持有行锁,SQL仍保留状态条件作为最后一道幂等保护。
*/
int submitPending(@Param("record") EvaluationRecordEntity record,
@Param("now") Date now);
/** 管理端查询任务全部目标学员;可按姓名模糊筛选。 */
List<EvaluationRecordVO> queryTaskRecords(@Param("taskId") String taskId,
@Param("studentName") String studentName);
}
package com.platform.business.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.platform.business.model.dto.EvaluationTaskQueryDTO;
import com.platform.business.model.entity.EvaluationTaskEntity;
import com.platform.business.model.vo.EvaluationTaskVO;
import com.platform.business.model.vo.StudentEvaluationTaskVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import java.util.Date;
import java.util.List;
/** 评价任务查询、状态流转和目标学员快照的数据访问接口。 */
@Mapper
public interface EvaluationTaskMapper extends BaseMapper<EvaluationTaskEntity> {
/** 管理端按原型筛选条件查询全部任务及实时完成进度。 */
List<EvaluationTaskVO> queryAdminTasks(EvaluationTaskQueryDTO query);
/** 学员端仅查询已经分配给当前登录学员且未撤回的任务。 */
List<StudentEvaluationTaskVO> queryStudentTasks(@Param("query") EvaluationTaskQueryDTO query,
@Param("studentId") String studentId);
/** 查询管理端单个任务基础信息及实时人数统计。 */
EvaluationTaskVO selectTaskView(@Param("taskId") String taskId);
/** 查询当前学员自己的单条任务;taskId和studentId必须同时匹配。 */
StudentEvaluationTaskVO selectStudentTask(@Param("taskId") String taskId,
@Param("studentId") String studentId);
/**
* 锁定任务主记录。提交与撤回都先获取该锁,从而串行化两种互斥操作,
* 防止学员提交成功的同时管理员又把同一任务撤回。
*/
EvaluationTaskEntity selectByIdForUpdate(@Param("taskId") String taskId);
/** 将已过截止时间的待评价任务批量推进为EXPIRED。 */
int expireDueTasks(@Param("now") Date now);
/** 提交入口发现本任务已到期时,仅推进当前任务,避免额外扩大锁范围。 */
int expirePendingTask(@Param("taskId") String taskId,
@Param("now") Date now);
/** 仅当任务仍为PENDING时撤回,返回0表示状态已被并发改变。 */
int revokePending(@Param("taskId") String taskId,
@Param("operatorId") String operatorId,
@Param("now") Date now);
/** 最后一位学员提交后,把没有待评价记录的任务推进为COMPLETED。 */
int completeIfAllSubmitted(@Param("taskId") String taskId,
@Param("now") Date now);
/** 发起任务时读取班级当前所有未删除学员,后续写入评价记录形成快照。 */
List<String> selectActiveStudentIdsByClassId(@Param("classId") Integer classId);
}
......@@ -55,7 +55,8 @@ public class AuthenticatedUserService {
List<SysPhoneRoleEntity> roles = phoneRoleService.queryByPhone(user.getPhoneNumber());
boolean admin = roles != null && roles.stream().anyMatch(role -> "管理员".equals(role.getRoleName()));
if (!admin) {
throw new BusinessException("只有管理员可以发布平台消息");
// 本方法同时被消息中心、请假、评议等管理端模块复用,因此使用通用权限提示。
throw new BusinessException("只有管理员可以访问管理端接口");
}
}
......
package com.platform.business.service;
import com.platform.business.model.dto.EvaluationSubmitDTO;
import com.platform.business.model.dto.EvaluationTaskCreateDTO;
import com.platform.business.model.dto.EvaluationTaskQueryDTO;
import com.platform.business.model.vo.EvaluationTaskDetailVO;
import com.platform.business.model.vo.EvaluationTaskVO;
import com.platform.business.model.vo.StudentEvaluationTaskVO;
import javax.servlet.http.HttpServletResponse;
import java.util.List;
/** 学员端和管理端学员评议应用服务。 */
public interface EvaluationService {
/** 管理员发起任务,并向本次固化的目标学员推送待评价消息。 */
EvaluationTaskVO createTask(EvaluationTaskCreateDTO request, String adminId, String adminName);
/** 管理端按原型条件查询全部评价任务。 */
List<EvaluationTaskVO> queryAdminTasks(EvaluationTaskQueryDTO query);
/** 管理端查看任务实名明细;studentName为空时返回全部目标学员。 */
EvaluationTaskDetailVO adminDetail(String taskId, String studentName);
/** 管理员撤回一个仍处于待评价状态的任务。 */
boolean revoke(String taskId, String adminId);
/** 管理员以全有或全无的事务方式批量撤回待评价任务。 */
int batchRevoke(List<String> taskIds, String adminId);
/** 学员端查询只分配给本人的待评价、已评价或已过期记录。 */
List<StudentEvaluationTaskVO> queryStudentTasks(EvaluationTaskQueryDTO query, String studentId);
/** 学员查看本人的评价表单或已提交内容,不返回其他人的任何数据。 */
StudentEvaluationTaskVO studentDetail(String taskId, String studentId);
/** 学员一次性提交七个必填维度,成功后不可修改。 */
StudentEvaluationTaskVO submit(String taskId, EvaluationSubmitDTO request, String studentId);
/** 按当前管理端筛选条件导出任务汇总Excel。 */
void exportAdminTasks(EvaluationTaskQueryDTO query, HttpServletResponse response);
/** 导出单个任务的实名评价明细和七维度统计Excel。 */
void exportTaskDetail(String taskId, HttpServletResponse response);
}
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.platform.business.mapper.EvaluationRecordMapper">
<insert id="batchInsert">
insert into evaluation_record (
id, task_id, student_id, status, created_time, update_time
) values
<foreach collection="records" item="record" separator=",">
(#{record.id}, #{record.taskId}, #{record.studentId}, #{record.status},
#{record.createdTime}, #{record.updateTime})
</foreach>
</insert>
<select id="selectByTaskAndStudentForUpdate"
resultType="com.platform.business.model.entity.EvaluationRecordEntity">
select id, task_id, student_id, status,
teaching_attitude, teaching_content, teaching_method, teaching_means,
demonstration, guidance, class_hour_completion, comment,
submitted_at, created_time, update_time
from evaluation_record
where task_id = #{taskId} and student_id = #{studentId}
for update
</select>
<update id="submitPending">
update evaluation_record
set status = 'SUBMITTED',
teaching_attitude = #{record.teachingAttitude},
teaching_content = #{record.teachingContent},
teaching_method = #{record.teachingMethod},
teaching_means = #{record.teachingMeans},
demonstration = #{record.demonstration},
guidance = #{record.guidance},
class_hour_completion = #{record.classHourCompletion},
comment = #{record.comment},
submitted_at = #{now},
update_time = #{now}
where id = #{record.id} and status = 'PENDING'
</update>
<select id="queryTaskRecords" resultType="com.platform.business.model.vo.EvaluationRecordVO">
select r.id,
r.task_id as taskId,
r.student_id as studentId,
u.nick_name as studentName,
u.phone_number as phoneNumber,
r.status,
r.teaching_attitude as teachingAttitude,
r.teaching_content as teachingContent,
r.teaching_method as teachingMethod,
r.teaching_means as teachingMeans,
r.demonstration,
r.guidance,
r.class_hour_completion as classHourCompletion,
r.comment,
r.submitted_at as submittedAt
from evaluation_record r
inner join user u on u.id = r.student_id
where r.task_id = #{taskId}
<if test="studentName != null and studentName.trim() != ''">
and u.nick_name like concat('%', #{studentName}, '%')
</if>
order by case when r.status = 'SUBMITTED' then 0 else 1 end,
r.submitted_at desc, u.nick_name asc, r.id asc
</select>
</mapper>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.platform.business.mapper.EvaluationTaskMapper">
<!-- 公共展示字段:任务自身、课程/班级/教师信息以及记录表实时统计。 -->
<sql id="taskViewColumns">
t.id,
t.subject_id as subjectId,
cs.subject_name as courseName,
cs.class_id as classId,
c.name as className,
cs.subject_times as subjectTimes,
cs.teacher_id as teacherId,
teacher.nick_name as teacherName,
cs.date as courseDate,
cs.time_frame as timeFrame,
cs.type,
t.deadline,
t.status,
coalesce(stat.total_count, 0) as totalCount,
case when t.status = 'REVOKED' then 0
else coalesce(stat.pending_count, 0) end as pendingCount,
coalesce(stat.submitted_count, 0) as submittedCount,
case when coalesce(stat.total_count, 0) = 0 then 0
else round(stat.submitted_count * 100.0 / stat.total_count, 2) end as completionRate,
t.created_by as createdBy,
creator.nick_name as creatorName,
t.created_time as createdTime,
t.revoked_at as revokedAt,
t.revoked_by as revokedBy,
revoker.nick_name as revokerName
</sql>
<sql id="taskViewJoins">
inner join class_subject cs on cs.id = t.subject_id
inner join class c on c.id = cs.class_id
left join user teacher on teacher.id = cs.teacher_id
left join user creator on creator.id = t.created_by
left join user revoker on revoker.id = t.revoked_by
left join (
select task_id,
count(*) as total_count,
sum(case when status = 'PENDING' then 1 else 0 end) as pending_count,
sum(case when status = 'SUBMITTED' then 1 else 0 end) as submitted_count
from evaluation_record
group by task_id
) stat on stat.task_id = t.id
</sql>
<select id="queryAdminTasks" resultType="com.platform.business.model.vo.EvaluationTaskVO">
select <include refid="taskViewColumns"/>
from evaluation_task t
<include refid="taskViewJoins"/>
<where>
<if test="courseName != null and courseName.trim() != ''">
and cs.subject_name like concat('%', #{courseName}, '%')
</if>
<if test="classId != null">
and cs.class_id = #{classId}
</if>
<if test="teacherId != null and teacherId.trim() != ''">
and cs.teacher_id = #{teacherId}
</if>
<if test="startDate != null">
and cs.date &gt;= #{startDate}
</if>
<if test="endDate != null">
and cs.date &lt; date_add(#{endDate}, interval 1 day)
</if>
<if test="status != null and status.trim() != ''">
and t.status = #{status}
</if>
<if test="type != null and type.trim() != ''">
and cs.type = #{type}
</if>
</where>
order by t.created_time desc, t.id desc
</select>
<select id="queryStudentTasks" resultType="com.platform.business.model.vo.StudentEvaluationTaskVO">
select t.id as taskId,
t.subject_id as subjectId,
cs.subject_name as courseName,
teacher.nick_name as teacherName,
c.name as className,
cs.subject_times as subjectTimes,
cs.date as courseDate,
cs.time_frame as timeFrame,
cs.type,
t.deadline,
t.status as taskStatus,
r.status as recordStatus,
r.teaching_attitude as teachingAttitude,
r.teaching_content as teachingContent,
r.teaching_method as teachingMethod,
r.teaching_means as teachingMeans,
r.demonstration,
r.guidance,
r.class_hour_completion as classHourCompletion,
r.comment,
r.submitted_at as submittedAt
from evaluation_record r
inner join evaluation_task t on t.id = r.task_id
inner join class_subject cs on cs.id = t.subject_id
inner join class c on c.id = cs.class_id
left join user teacher on teacher.id = cs.teacher_id
where r.student_id = #{studentId}
and t.status != 'REVOKED'
<if test="query != null and query.status != null and query.status.trim() != ''">
<choose>
<!-- 学员端“已评价”取本人提交状态,不要求整个班级均已完成。 -->
<when test="query.status == 'COMPLETED'">
and r.status = 'SUBMITTED'
</when>
<when test="query.status == 'EXPIRED'">
and r.status = 'PENDING' and t.status = 'EXPIRED'
</when>
<otherwise>
and r.status = 'PENDING' and t.status = 'PENDING'
</otherwise>
</choose>
</if>
order by case when t.status = 'PENDING' and r.status = 'PENDING' then 0
when r.status = 'SUBMITTED' then 1 else 2 end,
t.deadline asc, t.created_time desc
</select>
<select id="selectTaskView" resultType="com.platform.business.model.vo.EvaluationTaskVO">
select <include refid="taskViewColumns"/>
from evaluation_task t
<include refid="taskViewJoins"/>
where t.id = #{taskId}
</select>
<select id="selectStudentTask" resultType="com.platform.business.model.vo.StudentEvaluationTaskVO">
select t.id as taskId,
t.subject_id as subjectId,
cs.subject_name as courseName,
teacher.nick_name as teacherName,
c.name as className,
cs.subject_times as subjectTimes,
cs.date as courseDate,
cs.time_frame as timeFrame,
cs.type,
t.deadline,
t.status as taskStatus,
r.status as recordStatus,
r.teaching_attitude as teachingAttitude,
r.teaching_content as teachingContent,
r.teaching_method as teachingMethod,
r.teaching_means as teachingMeans,
r.demonstration,
r.guidance,
r.class_hour_completion as classHourCompletion,
r.comment,
r.submitted_at as submittedAt
from evaluation_record r
inner join evaluation_task t on t.id = r.task_id
inner join class_subject cs on cs.id = t.subject_id
inner join class c on c.id = cs.class_id
left join user teacher on teacher.id = cs.teacher_id
where r.task_id = #{taskId}
and r.student_id = #{studentId}
and t.status != 'REVOKED'
</select>
<select id="selectByIdForUpdate" resultType="com.platform.business.model.entity.EvaluationTaskEntity">
select id, subject_id, status, deadline, created_by, created_time, update_time, revoked_at, revoked_by
from evaluation_task
where id = #{taskId}
for update
</select>
<update id="expireDueTasks">
update evaluation_task
set status = 'EXPIRED', update_time = #{now}
where status = 'PENDING' and deadline &lt;= #{now}
</update>
<update id="expirePendingTask">
update evaluation_task
set status = 'EXPIRED', update_time = #{now}
where id = #{taskId} and status = 'PENDING' and deadline &lt;= #{now}
</update>
<update id="revokePending">
update evaluation_task
set status = 'REVOKED', revoked_at = #{now}, revoked_by = #{operatorId}, update_time = #{now}
where id = #{taskId} and status = 'PENDING'
</update>
<update id="completeIfAllSubmitted">
update evaluation_task t
set status = 'COMPLETED', update_time = #{now}
where t.id = #{taskId}
and t.status = 'PENDING'
and not exists (
select 1 from evaluation_record r
where r.task_id = t.id and r.status = 'PENDING'
)
</update>
<select id="selectActiveStudentIdsByClassId" resultType="java.lang.String">
select distinct cs.user_id
from class_student cs
inner join user u on u.id = cs.user_id
where cs.class_id = #{classId}
and (u.del_flag is null or u.del_flag = 0)
order by cs.user_id
</select>
</mapper>
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment