package org.xyzh.api.workcase.service;

import org.xyzh.api.workcase.dto.TbWordCloudDTO;
import org.xyzh.common.core.domain.ResultDomain;
import org.xyzh.common.core.page.PageRequest;

/**
 * @description    客服聊天服务，涉及agent回答客户和微信客服回答客户
 * @filename    WorkcaseChatService.java
 * @author    yslg
 * @copyright xyzh
 * @since 2025-12-18
 */
public interface WorkcaseChatService {

    // =============================== 对话、工单等词云管理 ==========================

    /**
     * @description    添加词云
     * @param wordCloud 词云对象
     * @author    yslg
     * @since 2025-12-19
     */
    ResultDomain<TbWordCloudDTO> addWordCloud(TbWordCloudDTO wordCloud);

    /**
     * @description    更新词云
     * @param wordCloud 词云对象
     * @author    yslg
     * @since 2025-12-19
     */
    ResultDomain<TbWordCloudDTO> updateWordCloud(TbWordCloudDTO wordCloud);

    /**
     * @description    获取词云列表
     * @param filter 词云过滤条件
     * @author    yslg
     * @since 2025-12-19
     */
    ResultDomain<TbWordCloudDTO> getWordCloudList(TbWordCloudDTO filter);

    /**
     * @description    获取词云分页
     * @param pageRequest 分页请求
     * @author    yslg
     * @since 2025-12-19
     */
    ResultDomain<TbWordCloudDTO> getWordCloudPage(PageRequest<TbWordCloudDTO> pageRequest);

}
