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}。
|
*
|
* <p><b>核心设计:扁平存储 + parentId</b>。
|
* 数据库中不存在任何树形 JSON,所有消息平铺成一张表,通过 {@code parentId} 指向父消息。
|
* 树形结构在查询后由 {@link com.custom.webui.util.MessageTreeUtil} 在内存中组装。
|
* 这样做的收益:
|
* <ul>
|
* <li>消息编辑 / 重新生成天然产生分支(同一个 parentId 下挂多条 assistant 消息)</li>
|
* <li>单条消息更新代价 O(1),不必重写整棵树</li>
|
* <li>便于后续按需分页、增量加载</li>
|
* </ul>
|
*/
|
@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";
|
}
|