package com.ruoyi.system.service;

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

/**
 * 短信发送服务接口
 * 
 * @author ruoyi
 * @date 2025-12-07
 */
public interface ISmsService {

    /**
     * 检查短信服务是否启用
     * 
     * @return true=启用, false=禁用
     */
    boolean isEnabled();

    /**
     * 发送短信
     * 
     * @param phone 手机号
     * @param content 短信内容
     * @return 是否发送成功
     */
    boolean sendSms(String phone, String content);

    /**
     * 批量发送短信
     * 
     * @param phones 手机号列表
     * @param content 短信内容
     * @return 成功发送的数量
     */
    int sendSmsBatch(List<String> phones, String content);

    /**
     * 发送任务分配通知短信
     * 
     * @param taskId 任务ID
     * @param userIds 用户ID列表
     * @param excludeUserId 排除的用户ID（可选，如创建人）
     * @return 成功发送的数量
     */
    int sendTaskAssignSms(Long taskId, List<Long> userIds, Long excludeUserId);

    /**
     * 发送任务分配通知短信（不排除任何用户）
     * 
     * @param taskId 任务ID
     * @param userIds 用户ID列表
     * @return 成功发送的数量
     */
    int sendTaskAssignSms(Long taskId, List<Long> userIds);

    /**
     * 查询短信余额
     * 
     * @return 余额信息
     */
    String getBalance();
}