package jnpf.cultivate.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.github.pagehelper.PageInfo;
import jnpf.base.vo.PageListVO;
import jnpf.entity.cultivate.CultivateIdentifyApply;
import jnpf.model.cultivate.CultivatePage;
import jnpf.model.cultivate.dto.identify.*;
import jnpf.model.cultivate.dto.statistics.FtbCultivateStatisticsDTO;
import jnpf.model.cultivate.vo.identify.*;

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

/**
 * 实操鉴定申请表
 *
 * @author shitou
 * @email shitou@niujiekeji.com
 * @date 2023-12-19 11:10:53
 */
public interface CultivateIdentifyApplyService extends IService<CultivateIdentifyApply> {
    /**
     * 实操鉴定申请/列表
     *
     * @param req 筛选条件
     * @return 分页数据，包含鉴定申请列表信息
     */
    PageInfo<IdentifyApplyListVo> getPageApplyList(IdentifyApplyListDto req);

    /**
     * 实操鉴定申请/详情(基本信息)
     *
     * @param req 筛选条件
     * @return 鉴定申请的基本信息
     */
    IdentifyApplyBasicInfoVo getApplyBasicInfo(IdentifyTableInfoDto req);

    /**
     * 实操鉴定申请/详情(鉴定详情)
     *
     * @param req 筛选条件
     * @return 鉴定申请的详细信息
     */
    IdentifyApplyInfoVo getApplyInfo(IdentifyTableInfoDto req);

    /**
     * 实操鉴定申请/新增
     *
     * @param req 新增鉴定申请的数据传输对象
     * @throws RuntimeException 操作失败时抛出异常
     */
    void applyDataSave(IdentifyApplySaveDto req) throws RuntimeException;

    /**
     * 实操鉴定申请/批量新增
     *
     * @param req 批量新增鉴定申请的数据传输对象
     * @throws RuntimeException 操作失败时抛出异常
     */
    void applyDataSaveBatch(BatchIdentifyApplySaveDto req) throws RuntimeException;

    /**
     * 实操鉴定申请/重新鉴定
     *
     * @param req 重新鉴定的数据传输对象
     * @throws RuntimeException 操作失败时抛出异常
     */
    void applyDataReIdentify(IdentifyApplyReIdentifyDto req) throws RuntimeException;


    /**
     * 实操鉴定申请/cultivateMyLearnTaskInfoService检验
     *
     * @param req 筛选条件
     * @return 鉴定申请列表信息
     */
    List<IdentifyApplyListVo> applyDataDeleteCheck(IdentifyTableInfoDto req);

    /**
     * 实操鉴定申请/删除
     *
     * @param req 筛选条件
     * @throws RuntimeException 操作失败时抛出异常
     */
    void applyDataDelete(IdentifyTableInfoDto req) throws RuntimeException;

    /**
     * app/列表
     *
     * @param req 筛选条件
     * @return 分页数据，包含APP端鉴定申请列表信息
     */
    PageInfo<IdentifyApplyListAppVo> getPageAppList(IdentifyApplyListAppDto req);

    /**
     * app/列表数量统计
     *
     * @param req 筛选条件
     * @return 列表总数
     */
    Integer getPageAppListCount(IdentifyApplyListAppDto req);

    /**
     * app/清空-清空全部
     *
     * @param req 删除条件
     * @throws RuntimeException 操作失败时抛出异常
     */
    void deleteIds(IdentifyApplyDeleteAppDto req) throws RuntimeException;

    /**
     * app/鉴定详情
     *
     * @param req 筛选条件
     * @return APP端鉴定详情信息
     */
    IdentifyInfoAppVo getIdentifyApplyInfoApp(IdentifyTableInfoDto req);

    /**
     * app/鉴定项详情
     *
     * @param req 筛选条件
     * @return APP端鉴定项详情信息
     */
    IdentifyItemsInfoAppVo getApplyIdentifyItemsInfoApp(IdentifyTableInfoDto req);

    /**
     * app/鉴定提交
     *
     * @param req 提交鉴定申请的数据传输对象
     * @throws RuntimeException 操作失败时抛出异常
     */
    void applyDataSubmit(IdentifyApplySubmitDto req) throws RuntimeException;

    /**
     * app/设置鉴定时间
     *
     * @param req 设置鉴定时间的数据传输对象
     * @throws RuntimeException 操作失败时抛出异常
     */
    void setApplyDataTime(IdentifyApplySetTimeAppDto req) throws RuntimeException;

    /**
     * app/鉴定结果详情
     *
     * @param req 筛选条件
     * @return APP端鉴定结果详情信息
     */
    IdentifyApplyBasicInfoAppVo getApplyBasicInfoApp(IdentifyTableInfoDto req);

    /**
     * app/鉴定项结果详情
     *
     * @param req 筛选条件
     * @return APP端鉴定项结果详情信息
     */
    IdentifyApplyInfoAppVo getApplyInfoApp(IdentifyTableInfoDto req);

    /**
     * 岗位鉴定/课程鉴定推送/任务推送
     *
     * @param req 推送数据传输对象
     * @return 返回鉴定记录ID
     * @throws RuntimeException 操作失败时抛出异常
     */
    String applyDataPush(IdentifyApplyDataPushDto req) throws RuntimeException;

    /**
     * 打开可见性
     *
     * @param id     岗位ID
     * @param userId 用户ID
     */
    void turnOnVisibility(String id, String userId);


    /**
     * 任务鉴定考试合格后打开可见性
     *
     * @param taskId 任务ID
     * @param userId 用户ID
     * @param status 考试状态：3-合格，4-不合格，5-优秀
     */
    void turnOnVisibilityWithTaskId(String taskId, String userId, Integer status);


    /**
     * 岗位晋升/批量查看用户鉴定结果
     *
     * @param ids 鉴定申请记录ID集合
     * @return 用户鉴定结果列表
     */
    List<IdentifyApplyInfoApiVo> getUserIdentifyInfoApi(List<String> ids);

    /**
     * 成员培训进展/用户鉴定数据统计
     *
     * @param userIds 被鉴定用户ID集合
     * @return 用户鉴定统计数据映射
     */
    Map<String, IdentifyApplyStatisticsApiVo> getUserIdentifyStatistics(List<String> userIds);

    /**
     * 成员培训进展/分页列表
     *
     * @param userId 用户ID
     * @param page   分页参数
     * @return 用户鉴定分页列表
     */
    PageListVO<UserIdentifyPageVo> getUserIdentifyPage(String userId, CultivatePage page);

    /**
     * 数据看板/统计
     *
     * @param req 筛选条件
     * @return 鉴定统计数据
     */
    IdentifyStatisticsVo getIdentifyStatistics(FtbCultivateStatisticsDTO req);

    /**
     * 数据看板/排名
     *
     * @param req 筛选条件
     * @return 鉴定排名列表
     */
    List<IdentifyTopVo> getIdentifyTop(FtbCultivateStatisticsDTO req);

    /**
     * 处理鉴定逾期数据
     *
     * @return 是否处理成功
     */
    boolean setIdentifyBeOverdue();

    /**
     * 设置了计划鉴定时间提醒
     *
     * @param tenantId 租户ID
     * @return 是否设置成功
     */
    boolean setIdentifyRemind(String tenantId);

    /**
     * 查看用户鉴定结果
     *
     * @param userId 用户ID
     * @return 用户鉴定结果列表
     */
    List<IdentifyApplyInfoApiVo> getUserIdentifyInfoWithUserId(String userId);

    /**
     * 获取实操鉴定统计数据（新版）
     *
     * @param dto 统计筛选条件
     * @return 实操鉴定统计信息
     */
    IdentifyStatisticsForNewVo getHandsOnStatistics(FtbCultivateStatisticsDTO dto);

    /**
     * 判断用户是否已经鉴定
     *
     * @param userId     用户ID
     * @param positionId 岗位ID
     * @return null 无鉴定记录, false 未鉴定, true 已鉴定
     */
    Boolean whetherTheUserPositionHasBeenIdentified(String userId, String positionId);

    /**
     * 删除已鉴定的数据
     *
     * @param taskId 任务ID
     */
    void deleteLearnTaskApplyIdentified(String taskId);

    /**
     * 统计每个鉴定的鉴定人数
     *
     * @param taskIds 任务ID集合
     * @param type    类型：0-查询所有，1-查询已鉴定合格
     * @return 鉴定人数统计映射
     */
    Map<String, Integer> groupIdentifyCountNum(List<String> taskIds, Integer type);

    List<CultivateIdentifyApply> queryIdentifyApply(String userId, List<String> identifyIds, Integer source, String sourceId);
}

