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 chat},即侧边栏中的一个对话。 */ @Data @TableName("chat") public class Chat { @TableId(type = IdType.AUTO) private Long id; /** 所属用户 id,所有查询必须带上该条件做数据隔离 */ private Long userId; private String title; /** * 模型参数 JSON 字符串,MySQL 中列为 json 类型。 * 结构见 {@link com.custom.webui.dto.req.ChatMetaRequest}: * {@code {temperature, topP, systemPrompt, modelName}} */ private String meta; /** * 是否置顶(1=置顶)。 * *

用 {@code Boolean} 而不是 {@code boolean}:MyBatis-Plus 更新时 * 只把非 null 字段写进 SQL,所以 partial update 场景下 null 才代表「不修改」。 */ private Boolean pinned; /** * 置顶时间,置顶区按它倒序。 * *

不复用 {@code updatedAt}:置顶区内部要按「置顶的先后」排, * 而 updatedAt 会随新消息变化,导致置顶的老对话聊一句就跳到最前面。 */ private LocalDateTime pinnedAt; /** 是否归档(1=已归档,主列表不显示,但数据全部保留) */ private Boolean archived; /** 归档时间,归档列表按它倒序 */ private LocalDateTime archivedAt; /** * 所属自建分组 id,{@code null} 表示未分组。 * *

未分组的会话继续按「今天 / 昨天 / 更早」自动归类; * 一旦放进分组,就只出现在该分组下(不再重复出现在时间分组里)。 * *

用 NULL 而不是哨兵值表达「未分组」:哨兵值会让每个判断处 * 都要记得特殊处理,迟早漏一处。 */ private Long groupId; private LocalDateTime createdAt; private LocalDateTime updatedAt; }