package cn.iocoder.yudao.module.hrm.service.training;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.hrm.controller.admin.training.vo.HrmTrainingPageReqVO;
import cn.iocoder.yudao.module.hrm.controller.admin.training.vo.HrmTrainingParticipantUpdateReqVO;
import cn.iocoder.yudao.module.hrm.controller.admin.training.vo.HrmTrainingSaveReqVO;
import cn.iocoder.yudao.module.hrm.dal.dataobject.training.HrmTrainingDO;
import cn.iocoder.yudao.module.hrm.dal.dataobject.training.HrmTrainingParticipantDO;

import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * HRM 培训活动 Service 接口
 *
 * <p>管理安全培训、技能培训等培训计划与参训/考核结果；培训完成时对合格人员联动生成证书资质。
 *
 * @author 超级管理员
 */
public interface HrmTrainingService {

    /**
     * 创建培训活动
     *
     * @param createReqVO 创建信息
     * @return 培训活动ID
     */
    Long createTraining(HrmTrainingSaveReqVO createReqVO);

    /**
     * 更新培训活动（仅草稿/待开展可改，且不改状态）
     *
     * @param updateReqVO 更新信息
     */
    void updateTraining(HrmTrainingSaveReqVO updateReqVO);

    /**
     * 删除培训活动（级联删除参训人员；已完成/已取消不可删）
     *
     * @param ids 培训活动ID集合
     */
    void deleteTraining(Collection<Long> ids);

    /**
     * 获得培训活动
     *
     * @param id 培训活动ID
     * @return 培训活动
     */
    HrmTrainingDO getTraining(Long id);

    /**
     * 获得培训活动分页
     *
     * @param pageReqVO 分页查询
     * @return 培训活动分页
     */
    PageResult<HrmTrainingDO> getTrainingPage(HrmTrainingPageReqVO pageReqVO);

    /**
     * 开始培训（草稿 → 待开展）
     *
     * @param id 培训活动ID
     */
    void startTraining(Long id);

    /**
     * 完成培训（待开展/草稿 → 已完成），完成时对合格人员联动自动发证
     *
     * @param id 培训活动ID
     */
    void completeTraining(Long id);

    /**
     * 取消培训（草稿/待开展 → 已取消）
     *
     * @param id 培训活动ID
     */
    void cancelTraining(Long id);

    /**
     * 添加参训员工（自动跳过已在名单中的员工）
     *
     * @param trainingId 培训活动ID
     * @param employeeIds 员工ID集合
     * @return 实际新增数量
     */
    int addParticipants(Long trainingId, Collection<Long> employeeIds);

    /**
     * 更新参训记录（参加情况/成绩/是否合格）
     *
     * @param updateReqVO 更新信息
     */
    void updateParticipant(HrmTrainingParticipantUpdateReqVO updateReqVO);

    /**
     * 删除参训记录
     *
     * @param ids 参训记录ID集合
     */
    void deleteParticipants(Collection<Long> ids);

    /**
     * 获得某次培训的全部参训记录
     *
     * @param trainingId 培训活动ID
     * @return 参训记录列表
     */
    List<HrmTrainingParticipantDO> getParticipantsByTrainingId(Long trainingId);

    /**
     * 批量统计各培训活动的参训人数（分页列表展示用）
     *
     * @param trainingIds 培训活动ID集合
     * @return 培训活动ID → 参训人数
     */
    Map<Long, Integer> getParticipantCountMap(Collection<Long> trainingIds);

}