package cn.iocoder.yudao.module.mes.service.cal.schedule;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.cal.schedule.vo.MesCalScheduleDetailCheckReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.cal.schedule.vo.MesCalScheduleDetailCheckRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.cal.schedule.vo.MesCalScheduleDetailPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.cal.schedule.vo.MesCalScheduleDetailSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.cal.schedule.MesCalScheduleDetailDO;

import java.util.List;

/**
 * MES 员工级排班明细 Service 接口
 *
 * @author 超级管理员
 */
public interface MesCalScheduleDetailService {

    /**
     * 按班组排班生成员工级排班明细（幂等：先清理该计划旧明细再展开班组成员）
     *
     * @param planId 排班计划编号
     */
    void generateDetails(Long planId);

    /**
     * 获得员工级排班明细分页
     *
     * @param reqVO 查询条件
     * @return 分页结果
     */
    PageResult<MesCalScheduleDetailDO> getDetailPage(MesCalScheduleDetailPageReqVO reqVO);

    /**
     * 获得员工级排班明细列表
     *
     * @param reqVO 查询条件
     * @return 明细列表
     */
    List<MesCalScheduleDetailDO> getDetailList(MesCalScheduleDetailPageReqVO reqVO);

    /**
     * 更新员工级排班明细（人工微调，source 置为 2-人工调整）
     *
     * @param updateReqVO 更新信息
     */
    void updateDetail(MesCalScheduleDetailSaveReqVO updateReqVO);

    /**
     * 员工排班合规校验（单日连续工时超长、相邻班次间休息不足）
     *
     * @param reqVO 校验条件
     * @return 校验结果列表，item.issue 为空表示该班次合规
     */
    List<MesCalScheduleDetailCheckRespVO> checkCompliance(MesCalScheduleDetailCheckReqVO reqVO);

}