package com.ruoyi.system.service;

import com.ruoyi.system.domain.NotifyTask;
import java.util.List;

/**
 * 通知任务服务接口
 * 
 * @author ruoyi
 * @date 2025-12-07
 */
public interface INotifyTaskService {

    /**
     * 查询通知任务
     * 
     * @param id 主键ID
     * @return 通知任务
     */
    NotifyTask selectNotifyTaskById(Long id);

    /**
     * 查询通知任务列表
     * 
     * @param notifyTask 查询条件
     * @return 通知任务列表
     */
    List<NotifyTask> selectNotifyTaskList(NotifyTask notifyTask);

    /**
     * 查询待处理的通知任务
     * 
     * @param limit 查询数量限制
     * @return 待处理的通知任务列表
     */
    List<NotifyTask> selectPendingNotifyTasks(int limit);

    /**
     * 检查通知任务是否已存在（防重）
     * 
     * @param taskId 业务任务ID
     * @param userId 用户ID
     * @param notifyType 通知类型
     * @return true=已存在, false=不存在
     */
    boolean existsNotifyTask(Long taskId, Long userId, String notifyType);

    /**
     * 创建通知任务（带防重）
     * 如果已存在则返回null，否则创建并返回
     * 
     * @param notifyTask 通知任务
     * @return 创建的通知任务，如果已存在返回null
     */
    NotifyTask createNotifyTask(NotifyTask notifyTask);

    /**
     * 批量创建通知任务
     * 
     * @param notifyTasks 通知任务列表
     * @return 成功创建的数量
     */
    int createNotifyTasks(List<NotifyTask> notifyTasks);

    /**
     * 修改通知任务
     * 
     * @param notifyTask 通知任务
     * @return 影响行数
     */
    int updateNotifyTask(NotifyTask notifyTask);

    /**
     * 更新通知任务状态为处理中
     * 
     * @param id 主键ID
     * @return 影响行数
     */
    int markProcessing(Long id);

    /**
     * 更新通知任务状态为完成
     * 
     * @param id 主键ID
     * @return 影响行数
     */
    int markCompleted(Long id);

    /**
     * 更新通知任务状态为失败
     * 
     * @param id 主键ID
     * @param errorMsg 错误信息
     * @return 影响行数
     */
    int markFailed(Long id, String errorMsg);

    /**
     * 增加重试次数
     * 
     * @param id 主键ID
     * @return 影响行数
     */
    int incrementRetryCount(Long id);

    /**
     * 删除通知任务
     * 
     * @param id 主键ID
     * @return 影响行数
     */
    int deleteNotifyTaskById(Long id);

    /**
     * 批量删除通知任务
     * 
     * @param ids 主键ID数组
     * @return 影响行数
     */
    int deleteNotifyTaskByIds(Long[] ids);
}