package com.srs.routine.mapper;

import java.util.List;

import com.srs.common.doman.vo.TeacherVo;
import com.srs.routine.domain.RtEnlistmentReserve;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Options;
import org.apache.ibatis.annotations.Param;

/**
 * 应征入伍保留学籍申请Mapper接口
 *
 * @author srs
 * @date 2025-10-31
 */
public interface RtEnlistmentReserveMapper extends BaseMapper<RtEnlistmentReserve> {
    /**
     * 查询应征入伍保留学籍申请
     *
     * @param id 应征入伍保留学籍申请主键
     * @return 应征入伍保留学籍申请
     */
    public RtEnlistmentReserve selectRtEnlistmentReserveById(Long id);

    /**
     * 查询应征入伍保留学籍申请
     *
     * @param processInstanceId Flowable流程实例ID
     * @return 应征入伍保留学籍申请
     */
    public RtEnlistmentReserve selectRtEnlistmentReserveByProcessInstanceId(String processInstanceId);


    /**
     * 查询应征入伍保留学籍申请
     *
     * @param studentName 学生姓名
     * @return 应征入伍保留学籍申请
     */
    public RtEnlistmentReserve getEnlistmentReserveByStuNameAndStuNo(@Param("studentName") String studentName, @Param("studentNo") String studentNo);

    //    <!--  根据学号查询辅导员信息  -->
    public TeacherVo getCounselorInfo(String stuNo);

    /**
     * 查询应征入伍保留学籍申请列表
     *
     * @param rtEnlistmentReserve 应征入伍保留学籍申请
     * @return 应征入伍保留学籍申请集合
     */
    List<RtEnlistmentReserve> selectRtEnlistmentReserveList(RtEnlistmentReserve rtEnlistmentReserve);

    //    查询全部申请记录
    List<RtEnlistmentReserve> getEnlistmentReserves();

    /**
     * 新增应征入伍保留学籍申请
     *
     * @param rtEnlistmentReserve 应征入伍保留学籍申请
     * @return 结果
     */
    @Options(useGeneratedKeys = true, keyProperty = "id", keyColumn = "id")
    int insertRtEnlistmentReserve(RtEnlistmentReserve rtEnlistmentReserve);

    /**
     * 批量插入应征入伍预约信息
     * @param list 应征入伍预约信息列表
     * @return 插入成功的记录数
     */
    int batchInsertRtEnlistmentReserve(List<RtEnlistmentReserve> list);

    /**
     * 查询数据库中已存在的学生（姓名+学号拼接）
     * @param list 待插入的学生列表
     * @return 已存在的学生标识（格式：姓名_学号）
     */
    List<String> selectExistStudents(List<RtEnlistmentReserve> list);

    /**
     * Mapper接口方法：统计指定年份的保留学籍记录数
     * @param year 年份（如2026）
     * @return 该年份的记录总数
     */
    int countByYear(@Param("year") String year);

    /**
     * 修改应征入伍保留学籍申请
     *
     * @param rtEnlistmentReserve 应征入伍保留学籍申请
     * @return 结果
     */
    int updateRtEnlistmentReserve(RtEnlistmentReserve rtEnlistmentReserve);

    /**
     * 删除应征入伍保留学籍申请
     *
     * @param id 应征入伍保留学籍申请主键
     * @return 结果
     */
    int deleteRtEnlistmentReserveById(Long id);

    /**
     * 批量删除应征入伍保留学籍申请
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    int deleteRtEnlistmentReserveByIds(Long[] ids);
}
