package com.ruoyi.system.mapper;

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

/**
 * 聊天记录Mapper接口
 * 
 * @author ruoyi
 * @date 2024-01-01
 */
public interface ChatHistoryMapper 
{
    /**
     * 查询聊天记录
     * 
     * @param id 聊天记录主键
     * @return 聊天记录
     */
    public ChatHistory selectChatHistoryById(Long id);

    /**
     * 查询聊天记录列表
     * 
     * @param chatHistory 聊天记录
     * @return 聊天记录集合
     */
    public List<ChatHistory> selectChatHistoryList(ChatHistory chatHistory);

    /**
     * 根据会话ID查询聊天记录
     * 
     * @param sessionId 会话ID
     * @return 聊天记录集合
     */
    public List<ChatHistory> selectChatHistoryBySessionId(String sessionId);

    /**
     * 根据用户ID查询聊天记录
     * 
     * @param userId 用户ID
     * @return 聊天记录集合
     */
    public List<ChatHistory> selectChatHistoryByUserId(String userId);

    /**
     * 新增聊天记录
     * 
     * @param chatHistory 聊天记录
     * @return 结果
     */
    public int insertChatHistory(ChatHistory chatHistory);

    /**
     * 批量新增聊天记录
     * 
     * @param chatHistoryList 聊天记录列表
     * @return 结果
     */
    public int batchInsertChatHistory(List<ChatHistory> chatHistoryList);

    /**
     * 修改聊天记录
     * 
     * @param chatHistory 聊天记录
     * @return 结果
     */
    public int updateChatHistory(ChatHistory chatHistory);

    /**
     * 删除聊天记录
     * 
     * @param id 聊天记录主键
     * @return 结果
     */
    public int deleteChatHistoryById(Long id);

    /**
     * 批量删除聊天记录
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteChatHistoryByIds(Long[] ids);

    /**
     * 删除指定会话的聊天记录
     * 
     * @param sessionId 会话ID
     * @return 结果
     */
    public int deleteChatHistoryBySessionId(String sessionId);

    /**
     * 根据用户ID删除聊天记录
     * 
     * @param userId 用户ID
     * @return 结果
     */
    public int deleteChatHistoryByUserId(String userId);

    /**
     * 根据消息ID查询聊天记录
     * 
     * @param messageId 消息ID
     * @return 聊天记录
     */
    public ChatHistory selectChatHistoryByMessageId(String messageId);

    /**
     * 根据发送者ID查询聊天记录列表
     * 
     * @param senderId 发送者ID
     * @return 聊天记录集合
     */
    public List<ChatHistory> selectChatHistoryBySenderId(String senderId);

    /**
     * 根据接收者ID查询聊天记录列表
     * 
     * @param receiverId 接收者ID
     * @return 聊天记录集合
     */
    public List<ChatHistory> selectChatHistoryByReceiverId(String receiverId);

    /**
     * 根据发送者类型查询聊天记录列表
     * 
     * @param senderType 发送者类型
     * @return 聊天记录集合
     */
    public List<ChatHistory> selectChatHistoryBySenderType(String senderType);

    /**
     * 查询未读聊天记录列表
     * 
     * @param userId 用户ID（可选）
     * @return 聊天记录集合
     */
    public List<ChatHistory> selectUnreadChatHistory(String userId);

    /**
     * 根据时间范围查询聊天记录列表
     * 
     * @param params 查询参数（包含startTime、endTime、userId等）
     * @return 聊天记录集合
     */
    public List<ChatHistory> selectChatHistoryByTimeRange(java.util.Map<String, Object> params);
}