package com.gkhy.exam.system.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.gkhy.exam.common.api.CommonPage;
import com.gkhy.exam.system.domain.ExPaperStudent;
import com.gkhy.exam.system.domain.vo.BatchPaperStudentVO;
import com.gkhy.exam.system.domain.vo.ExPaperStudentVO;

import java.util.List;

/**
 * <p>
 * 学员与考卷关系表 服务类
 * </p>
 *
 * @author kzy
 * @since 2024-06-06 13:53:17
 */
public interface ExPaperStudentService extends IService<ExPaperStudent> {

    /**
     * 新增考卷与学员关系
     * @param paperStudent
     * @return
     */
    public int addPaperStudent(ExPaperStudent paperStudent);

    /**
     * 批量新增考卷与学员关系
     * @param batchPaperStudentVO
     * @return
     */
    public int batchAddPaperStudent(BatchPaperStudentVO batchPaperStudentVO);

    /**
     * 分页获取学员的试卷列表
     * @return
     */
    public CommonPage selectPaperStudentListForStudent(ExPaperStudent paperStudent);

    /**
     * 删除考卷下面的学员
     * @param paperStudentId
     * @return
     */
    public int deletePaperStudent(Long paperStudentId);

    /**
     * 批量删除考卷下面的学员
     * @param paperStudentIds
     * @return
     */
    public void batchDeletePaperStudent(List<Long> paperStudentIds);


    /**
     * 根据条件分页查询学员考卷列表
     * @param paperStudent
     * @return
     */
    CommonPage selectPaperStudentList(ExPaperStudent paperStudent);

    /**
     * 根据id查询学员试卷信息
     *
     * @param paperStudentId
     * @return 试卷信息
     */
    public ExPaperStudent selectPaperStudentById(Long paperStudentId);


    /**
     * 根据试卷id和学员id查询试卷信息
     *
     * @param paperStudent
     * @return 试卷信息
     */
    public ExPaperStudent selectPaperStudentById(ExPaperStudent paperStudent);


    /**
     * 开始考试
     * @param paperStudent
     */
    public void endExam(ExPaperStudent paperStudent);

    /**
     * 检查学员是否已存在
     * @param paperStudents
     */
    public void checkStudentUnique(List<ExPaperStudent> paperStudents);

    /**
     * 批改试卷
     * @param paperStudentVO
     */
    public void doReview(ExPaperStudentVO paperStudentVO);

    /**
     * 计算试卷分数
     * @param paperStudent
     */
    public void handlePaperData(ExPaperStudent paperStudent);

}