kongdeqiang
2026-10-14 9f9e043849b6f497e00399900ff234cf097eba82
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
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=置顶)。
     *
     * <p>用 {@code Boolean} 而不是 {@code boolean}:MyBatis-Plus 更新时
     * 只把非 null 字段写进 SQL,所以 partial update 场景下 null 才代表「不修改」。
     */
    private Boolean pinned;
 
    /**
     * 置顶时间,置顶区按它倒序。
     *
     * <p>不复用 {@code updatedAt}:置顶区内部要按「置顶的先后」排,
     * 而 updatedAt 会随新消息变化,导致置顶的老对话聊一句就跳到最前面。
     */
    private LocalDateTime pinnedAt;
 
    /** 是否归档(1=已归档,主列表不显示,但数据全部保留) */
    private Boolean archived;
 
    /** 归档时间,归档列表按它倒序 */
    private LocalDateTime archivedAt;
 
    /**
     * 所属自建分组 id,{@code null} 表示未分组。
     *
     * <p>未分组的会话继续按「今天 / 昨天 / 更早」自动归类;
     * 一旦放进分组,就只出现在该分组下(不再重复出现在时间分组里)。
     *
     * <p>用 NULL 而不是哨兵值表达「未分组」:哨兵值会让每个判断处
     * 都要记得特殊处理,迟早漏一处。
     */
    private Long groupId;
 
    private LocalDateTime createdAt;
 
    private LocalDateTime updatedAt;
}