package org.xyzh.study.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.xyzh.common.core.page.PageParam;
import org.xyzh.common.dto.study.TbLearningTask;
import org.xyzh.common.vo.TaskItemVO;

import java.util.List;

/**
 * @description LearningTaskMapper.java文件描述 学习任务数据访问层
 * @filename LearningTaskMapper.java
 * @author yslg
 * @copyright xyzh
 * @since 2025-10-15
 */
@Mapper
public interface LearningTaskMapper extends BaseMapper<TbLearningTask> {

    /**
     * @description 查询学习任务列表
     * @param filter 过滤条件
     * @return List<TbLearningTask> 学习任务列表
     * @author yslg
     * @since 2025-10-15
     */
    List<TbLearningTask> selectLearningTasks(TbLearningTask filter);

    /**
     * @description 根据任务ID查询任务信息
     * @param taskId 任务ID
     * @return TbLearningTask 任务信息
     * @author yslg
     * @since 2025-10-15
     */
    TbLearningTask selectByTaskId(@Param("taskId") String taskId);

    /**
     * @description 根据用户ID查询学习任务列表
     * @param userId 用户ID
     * @return List<TbLearningTask> 学习任务列表
     * @author yslg
     * @since 2025-10-15
     */
    List<TbLearningTask> selectByUserId(@Param("userId") String userId);

    /**
     * @description 根据任务名称查询任务
     * @param name 任务名称
     * @return TbLearningTask 任务信息
     * @author yslg
     * @since 2025-10-15
     */
    TbLearningTask selectByName(@Param("name") String name);

    /**
     * @description 根据状态查询学习任务列表
     * @param status 状态
     * @return List<TbLearningTask> 学习任务列表
     * @author yslg
     * @since 2025-10-15
     */
    List<TbLearningTask> selectByStatus(@Param("status") Integer status);

    /**
     * @description 根据优先级查询学习任务列表
     * @param priority 优先级
     * @return List<TbLearningTask> 学习任务列表
     * @author yslg
     * @since 2025-10-15
     */
    List<TbLearningTask> selectByPriority(@Param("priority") Integer priority);

    /**
     * @description 查询用户待完成任务列表
     * @param userId 用户ID
     * @return List<TbLearningTask> 学习任务列表
     * @author yslg
     * @since 2025-10-15
     */
    List<TbLearningTask> selectPendingTasksByUserId(@Param("userId") String userId);

    /**
     * @description 查询用户已完成任务列表
     * @param userId 用户ID
     * @return List<TbLearningTask> 学习任务列表
     * @author yslg
     * @since 2025-10-15
     */
    List<TbLearningTask> selectCompletedTasksByUserId(@Param("userId") String userId);

    /**
     * @description 检查任务名称是否存在
     * @param name 任务名称
     * @param excludeId 排除的任务ID（用于更新时排除自身）
     * @return int 存在的数量
     * @author yslg
     * @since 2025-10-15
     */
    int countByName(@Param("name") String name, @Param("excludeId") String excludeId);

    /**
     * @description 插入学习任务
     * @param learningTask 学习任务
     * @return int 影响行数
     * @author yslg
     * @since 2025-10-15
     */
    int insertLearningTask(TbLearningTask learningTask);

    /**
     * @description 更新学习任务
     * @param learningTask 学习任务
     * @return int 影响行数
     * @author yslg
     * @since 2025-10-15
     */
    int updateLearningTask(TbLearningTask learningTask);

    /**
     * @description 删除学习任务
     * @param learningTask 学习任务
     * @return int 影响行数
     * @author yslg
     * @since 2025-10-15
     */
    int deleteLearningTask(TbLearningTask learningTask);

    /**
     * @description 批量插入学习任务
     * @param learningTaskList 学习任务列表
     * @return int 影响行数
     * @author yslg
     * @since 2025-10-15
     */
    int batchInsertLearningTasks(@Param("learningTaskList") List<TbLearningTask> learningTaskList);

    /**
     * @description 批量删除学习任务
     * @param ids 任务ID列表
     * @return int 影响行数
     * @author yslg
     * @since 2025-10-15
     */
    int batchDeleteLearningTasks(@Param("ids") List<String> ids);

    /**
     * @description 分页查询学习任务
     * @param filter 过滤条件
     * @param pageParam 分页参数
     * @return List<TbLearningTask> 学习任务列表
     * @author yslg
     * @since 2025-10-15
     */
    List<TbLearningTask> selectLearningTasksPage(@Param("filter") TbLearningTask filter, @Param("pageParam") PageParam pageParam);

    List<TbLearningTask> selectUserLearningTasksPage(@Param("filter") TaskItemVO filter, @Param("pageParam") PageParam pageParam);

    /**
     * @description 统计学习任务总数
     * @param filter 过滤条件
     * @return long 总数
     * @author yslg
     * @since 2025-10-15
     */
    long countLearningTasks(@Param("filter") TbLearningTask filter);
}
