package com.ruoyi.system.service;

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

/**
 * 系统消息Service接口
 * 
 * @author ruoyi
 * @date 2025-10-25
 */
public interface ISysMessageService {
    
    /**
     * 查询系统消息
     * 
     * @param messageId 系统消息主键
     * @return 系统消息
     */
    public SysMessage selectSysMessageByMessageId(Long messageId);

    /**
     * 查询系统消息列表
     * 
     * @param sysMessage 系统消息
     * @return 系统消息集合
     */
    public List<SysMessage> selectSysMessageList(SysMessage sysMessage);

    /**
     * 查询用户的消息列表
     * 
     * @param receiverId 接收人ID
     * @return 系统消息集合
     */
    public List<SysMessage> selectSysMessageListByReceiverId(Long receiverId);

    /**
     * 查询用户未读消息数量
     * 
     * @param receiverId 接收人ID
     * @return 未读消息数量
     */
    public int countUnreadMessageByReceiverId(Long receiverId);

    /**
     * 新增系统消息
     * 
     * @param sysMessage 系统消息
     * @return 结果
     */
    public int insertSysMessage(SysMessage sysMessage);

    /**
     * 修改系统消息
     * 
     * @param sysMessage 系统消息
     * @return 结果
     */
    public int updateSysMessage(SysMessage sysMessage);

    /**
     * 批量删除系统消息
     * 
     * @param messageIds 需要删除的系统消息主键集合
     * @return 结果
     */
    public int deleteSysMessageByMessageIds(Long[] messageIds);

    /**
     * 删除系统消息信息
     * 
     * @param messageId 系统消息主键
     * @return 结果
     */
    public int deleteSysMessageByMessageId(Long messageId);

    /**
     * 标记消息为已读
     * 
     * @param messageId 消息ID
     * @return 结果
     */
    public int markMessageAsRead(Long messageId);

    /**
     * 标记用户所有消息为已读
     * 
     * @param receiverId 接收人ID
     * @return 结果
     */
    public int markAllMessagesAsRead(Long receiverId);

    // ========== 消息推送业务方法 ==========

    /**
     * 推送任务创建成功消息（给创建人）
     * 
     * @param task 任务对象
     */
    public void pushTaskCreateMessage(SysTask task);

    /**
     * 推送任务分配消息（给执行人）
     * 
     * @param task 任务对象
     * @param assigneeIds 执行人ID列表
     */
    public void pushTaskAssignMessage(SysTask task, List<Long> assigneeIds);

    /**
     * 推送任务状态变更消息（给相关人员）
     * 
     * @param task 任务对象
     * @param oldStatus 旧状态
     * @param newStatus 新状态
     */
    public void pushTaskStatusChangeMessage(SysTask task, String oldStatus, String newStatus);
}