package com.custom.webui.service; import com.custom.webui.dto.req.ChatCreateRequest; import com.custom.webui.dto.req.ChatMetaRequest; import com.custom.webui.dto.req.ChatUpdateRequest; import com.custom.webui.dto.resp.ChatDTO; import com.custom.webui.entity.Chat; import java.util.List; /** * 会话服务。 * *
数据隔离约定:所有方法都必须接收 {@code userId} 并在查询条件中带上,
* 严禁提供「按 id 直接查」的公开方法 —— 越权访问是这类系统最常见的安全问题。
*/
public interface ChatService {
/** 当前用户的会话列表,按更新时间倒序(最近活跃的在最上方) */
List 数据库未使用外键,级联在 Service 层显式完成,便于控制与测试。
*/
void delete(Long userId, Long chatId);
/** 校验会话归属,返回实体;不属于该用户时抛 404(而非 403,避免探测他人会话是否存在) */
Chat requireOwnedChat(Long userId, Long chatId);
/** 读取会话的模型参数,meta 为空或非法 JSON 时返回全 null 的对象 */
ChatMetaRequest parseMeta(Chat chat);
/** 更新会话标题(用于 LLM 自动生成标题) */
void updateTitle(Long chatId, String title);
/**
* 搜索当前用户的历史对话。
*
* 同时匹配**标题**与**消息内容** —— 只搜标题不够用:
* 用户往往记得「聊过某个话题」却想不起原话,而标题只是首条提问的截断。
*
* 排序:命中的会话按最近活跃时间倒序,最多返回 {@code limit} 条。
*
* @param keyword 关键词,空白则返回空列表(不返回全部,避免把搜索框
* 当成「无过滤列表」误用)
* @return 命中的会话,附带命中片段与命中类型
*/
List