package com.ruoyi.system.service;

import java.util.Date;
import java.util.List;
import com.ruoyi.system.domain.DutyConfig;

/**
 * 值班配置Service接口
 *
 * @author ruoyi
 * @date 2024-12-19
 */
public interface IDutyConfigService
{
    /**
     * 查询值班配置
     *
     * @param id 值班配置主键
     * @return 值班配置
     */
    public DutyConfig selectDutyConfigById(Long id);

    /**
     * 查询值班配置列表
     *
     * @param dutyConfig 值班配置
     * @return 值班配置集合
     */
    public List<DutyConfig> selectDutyConfigList(DutyConfig dutyConfig);

    /**
     * 根据当前时间获取下一个值班用户ID
     *
     * @return 值班用户ID，如果没有匹配的配置则返回null
     */
    public Long getNextDutyUserId();

    /**
     * 根据当前时间查询有效的值班配置
     *
     * @param currentTime 当前时间
     * @return 值班配置
     */
    public DutyConfig selectActiveDutyConfig(Date currentTime);

    /**
     * 新增值班配置
     *
     * @param dutyConfig 值班配置
     * @param dutyUserIds 值班用户ID字符串（逗号分隔）
     * @return 结果
     */
    public int insertDutyConfig(DutyConfig dutyConfig, String dutyUserIds);

    /**
     * 修改值班配置
     *
     * @param dutyConfig 值班配置
     * @param dutyUserIds 值班用户ID字符串（逗号分隔）
     * @return 结果
     */
    public int updateDutyConfig(DutyConfig dutyConfig, String dutyUserIds);

    /**
     * 批量删除值班配置
     *
     * @param ids 需要删除的值班配置主键集合
     * @return 结果
     */
    public int deleteDutyConfigByIds(String ids);

    /**
     * 删除值班配置信息
     *
     * @param id 值班配置主键
     * @return 结果
     */
    public int deleteDutyConfigById(Long id);

    /**
     * 检查时间段是否冲突
     *
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param excludeId 排除的配置ID（用于修改时排除自己）
     * @return 是否冲突
     */
    public boolean checkTimeConflict(Date startTime, Date endTime, Long excludeId);

    /**
     * 修改值班配置状态
     *
     * @param dutyConfig 值班配置
     * @return 结果
     */
    public int changeStatus(DutyConfig dutyConfig);
}