kongdeqiang
2026-10-12 ccf1a44c001e233c158bd168dc2d0d96721af929
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
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 upload_file}。
 *
 * <p>文件本体存放在磁盘(生产可替换为 MinIO),此表只记录元数据。
 * {@code chatId} 为空表示公共知识库文件,非空表示只服务于该会话。
 */
@Data
@TableName("upload_file")
public class UploadFile {
 
    @TableId(type = IdType.AUTO)
    private Long id;
 
    private Long userId;
 
    /** 绑定的会话 id,可为 null(公共知识库) */
    private Long chatId;
 
    /** 原始文件名,仅用于展示与解析时判断类型 */
    private String filename;
 
    /** 服务器磁盘上的真实存储路径 */
    private String savePath;
 
    private Long fileSize;
 
    private String mimeType;
 
    /**
     * 是否全局知识库。
     *
     * <p>true:由管理员上传,**所有登录用户**都能在「知识库」面板里看到并绑定到自己的会话;
     * false:仅上传者本人可见(普通用户上传的文件都是这种)。
     *
     * <p>用 Boolean 而不是 boolean:MyBatis-Plus 映射 tinyint(1) 时,
     * 若数据库存在 NULL(老数据迁移后可能出现),基本类型会抛 NPE。
     */
    private Boolean isGlobal;
 
    /**
     * 所属分类 id,NULL 表示未分类。
     *
     * <p>刻意不加外键约束:删除分类时只需要把文件的 category_id 置空
     * (文档本身必须保留),应用层显式处理比数据库级联更可控 ——
     * ON DELETE CASCADE 会把文档记录一起删掉,那是灾难性的。
     */
    private Long categoryId;
 
    private LocalDateTime createdAt;
}