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} 在内存中组装。
* 这样做的收益:
*
* - 消息编辑 / 重新生成天然产生分支(同一个 parentId 下挂多条 assistant 消息)
* - 单条消息更新代价 O(1),不必重写整棵树
* - 便于后续按需分页、增量加载
*
*/
@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";
}