package com.custom.webui.entity; import com.baomidou.mybatisplus.annotation.IdType; import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableName; import lombok.Data; import java.time.LocalDateTime; /** * 消息实体,对应表 {@code message}。 * *

核心设计:扁平存储 + parentId。 * 数据库中不存在任何树形 JSON,所有消息平铺成一张表,通过 {@code parentId} 指向父消息。 * 树形结构在查询后由 {@link com.custom.webui.util.MessageTreeUtil} 在内存中组装。 * 这样做的收益: *

*/ @Data @TableName("message") public class Message { @TableId(type = IdType.AUTO) private Long id; private Long chatId; /** 父消息 id;会话首条消息为 null,是树的根 */ private Long parentId; /** user / assistant / system */ private String role; private String content; /** 生成该条 assistant 消息所用的模型名 */ private String model; /** 0 = 流式生成中,1 = 流式已完成。用于刷新页面时识别被中断的消息 */ private Boolean done; /** 扩展元信息 JSON,如 token 用量、RAG 引用来源、耗时等 */ private String metadata; private LocalDateTime createdAt; // ---------- role 常量,避免各处硬编码字符串 ---------- public static final String ROLE_USER = "user"; public static final String ROLE_ASSISTANT = "assistant"; public static final String ROLE_SYSTEM = "system"; }