package com.ruoyi.info.collection.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.info.collection.domain.CcdiStaffTransfer;
import com.ruoyi.info.collection.domain.dto.CcdiStaffTransferQueryDTO;
import com.ruoyi.info.collection.domain.dto.TransferUniqueKey;
import com.ruoyi.info.collection.domain.vo.CcdiStaffTransferVO;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 员工调动记录 数据层
 *
 * @author ruoyi
 * @date 2026-02-10
 */
public interface CcdiStaffTransferMapper extends BaseMapper<CcdiStaffTransfer> {

    /**
     * 分页查询员工调动记录列表
     *
     * @param page     分页对象
     * @param queryDTO 查询条件
     * @return 员工调动记录VO分页结果
     */
    Page<CcdiStaffTransferVO> selectTransferPage(@Param("page") Page<CcdiStaffTransferVO> page,
                                                  @Param("query") CcdiStaffTransferQueryDTO queryDTO);

    /**
     * 查询员工调动记录详情
     *
     * @param id 主键ID
     * @return 员工调动记录VO
     */
    CcdiStaffTransferVO selectTransferById(@Param("id") Long id);

    /**
     * 查询员工调动记录列表（用于导出）
     *
     * @param queryDTO 查询条件
     * @return 员工调动记录VO列表
     */
    List<CcdiStaffTransferVO> selectTransferListForExport(@Param("query") CcdiStaffTransferQueryDTO queryDTO);

    /**
     * 批量插入员工调动记录数据
     *
     * @param list 员工调动记录列表
     * @return 插入行数
     */
    int insertBatch(@Param("list") List<CcdiStaffTransfer> list);

    /**
     * 查询单条记录是否存在（根据唯一键：员工ID + 调动前部门ID + 调动后部门ID + 调动日期）
     *
     * @param key 唯一键
     * @return 存在的记录，不存在返回null
     */
    CcdiStaffTransfer checkExists(@Param("key") TransferUniqueKey key);

    /**
     * 查询单条记录是否存在（排除指定ID）
     *
     * @param key  唯一键
     * @param excludeId 排除的记录ID
     * @return 存在的记录，不存在返回null
     */
    CcdiStaffTransfer checkExistsExcludeId(@Param("key") TransferUniqueKey key,
                                           @Param("excludeId") Long excludeId);
}
