1. 数据库设计规范

1.1 命名规范

对象命名规则示例
表名小写字母+下划线kb\_user, kb\_document
字段名小写字母+下划线user\_id, created\_at
索引名idx\_表名\_字段名idx\_kb\_user\_username
唯一索引uk\_表名\_字段名uk\_kb\_user\_email

1.2 数据类型规范

类型MySQL类型说明示例
主键BIGINT(20)分布式雪花ID1234567890123456789
外键BIGINT(20)关联主键同主键类型
状态TINYINT枚举值状态0-127
金额DECIMAL(18,2)精确金额DECIMAL(18,2)
布尔TINYINT(1)0或10/1
时间戳DATETIME精确到秒2026-04-29 12:00:00
JSONJSON复杂结构{"key": "value"}
文本TEXT长文本文档内容

1.3 设计原则

  1. 雪花ID主键:所有表使用BIGINT(20)存储雪花算法生成的ID
  2. 公共字段:

    • id BIGINT(20):主键
    • created_at DATETIME:创建时间
    • updated_at DATETIME:更新时间
    • deleted TINYINT(1):逻辑删除标记
  3. 索引设计:所有外键字段建立索引,高频查询字段建立索引
  4. 字符集:统一使用utf8mb4,支持emoji和完整Unicode

2. 数据库与服务对应关系

系统采用8个核心服务 + 1个网关的微服务架构,每个服务有独立的数据库。

服务名称数据库名称说明
用户权限服务kb\_user用户、角色、权限、团队相关表
文档服务kb\_document文档、分类、标签、评论、版本、审核记录相关表
AI服务kb\_aiAI对话历史、消息相关表
搜索服务kb\_search搜索历史相关表
文件服务kb\_file文件信息相关表
知识图谱服务kb\_graph图谱节点、边、社区相关表
统计服务kb\_statistics文档统计、用户统计相关表
基础服务kb\_foundation系统配置、通知、操作日志、字典相关表

3. kb\_user(用户权限服务)

3.1 用户表 (kb\_user)

字段名类型必填默认值说明
idBIGINT(20)是 用户ID(雪花ID)
usernameVARCHAR(50)是 用户名
passwordVARCHAR(128)是 密码(BCrypt加密)
real\_nameVARCHAR(50)否 真实姓名
emailVARCHAR(100)否 邮箱
phoneVARCHAR(20)否 手机号
avatar\_urlVARCHAR(500)否 头像URL
statusTINYINT是1状态:0-禁用,1-正常,2-锁定
user\_typeTINYINT是1用户类型:0-超级管理员,1-知识管理员,2-编辑,3-普通用户
doc\_countINT否0创建文档数
like\_countINT否0获得点赞数
view\_countINT否0被查看次数
departmentVARCHAR(100)否 部门
positionVARCHAR(100)否 职位
bioTEXT否 个人简介
preferencesJSON否 用户偏好设置
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_username (username)
  • UNIQUE KEY uk\_email (email)
  • KEY idx\_status (status)
  • KEY idx\_user\_type (user\_type)

3.2 角色表 (kb\_role)

字段名类型必填默认值说明
idBIGINT(20)是 角色ID(雪花ID)
role\_codeVARCHAR(50)是 角色编码
role\_nameVARCHAR(50)是 角色名称
descriptionVARCHAR(500)否 角色描述
statusTINYINT是1状态:0-禁用,1-正常
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_role\_code (role\_code)
  • KEY idx\_status (status)

3.3 权限表 (kb\_permission)

字段名类型必填默认值说明
idBIGINT(20)是 权限ID(雪花ID)
permission\_codeVARCHAR(50)是 权限编码
permission\_nameVARCHAR(50)是 权限名称
resource\_typeVARCHAR(20)是 资源类型
permission\_urlVARCHAR(200)否 权限URL
descriptionVARCHAR(500)否 权限描述
statusTINYINT是1状态:0-禁用,1-正常
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_permission\_code (permission\_code)
  • KEY idx\_resource\_type (resource\_type)

3.4 用户角色关联表 (kb\_user\_role)

字段名类型必填默认值说明
idBIGINT(20)是 关联ID(雪花ID)
user\_idBIGINT(20)是 用户ID
role\_idBIGINT(20)是 角色ID
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_user\_role (user\_id, role\_id)
  • KEY idx\_user\_id (user\_id)
  • KEY idx\_role\_id (role\_id)

3.5 角色权限关联表 (kb\_role\_permission)

字段名类型必填默认值说明
idBIGINT(20)是 关联ID(雪花ID)
role\_idBIGINT(20)是 角色ID
permission\_idBIGINT(20)是 权限ID
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_role\_permission (role\_id, permission\_id)
  • KEY idx\_role\_id (role\_id)
  • KEY idx\_permission\_id (permission\_id)

3.6 团队表 (kb\_team)

字段名类型必填默认值说明
idBIGINT(20)是 团队ID(雪花ID)
team\_nameVARCHAR(100)是 团队名称
team\_codeVARCHAR(50)是 团队编码
descriptionVARCHAR(500)否 团队描述
parent\_idBIGINT(20)否 父团队ID
levelINT否1团队层级
pathVARCHAR(500)否 团队路径
leader\_idBIGINT(20)否 团队负责人ID
member\_countINT否0成员数量
doc\_countINT否0文档数量
statusTINYINT是1状态:0-禁用,1-正常
sortINT否0排序号
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_team\_code (team\_code)
  • KEY idx\_parent\_id (parent\_id)
  • KEY idx\_leader\_id (leader\_id)

3.7 团队成员表 (kb\_team\_member)

字段名类型必填默认值说明
idBIGINT(20)是 成员ID(雪花ID)
team\_idBIGINT(20)是 团队ID
user\_idBIGINT(20)是 用户ID
member\_roleVARCHAR(20)是 成员角色:leader-负责人,member-成员
joined\_atDATETIME是CURRENT\_TIMESTAMP加入时间
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_team\_user (team\_id, user\_id)
  • KEY idx\_user\_id (user\_id)

4. kb\_document(文档服务)

4.1 文档表 (kb\_document)

字段名类型必填默认值说明
idBIGINT(20)是 文档ID(雪花ID)
titleVARCHAR(200)是 文档标题
summaryVARCHAR(500)否 文档摘要
contentLONGTEXT否 文档内容(Markdown格式)
category\_idBIGINT(20)否 分类ID
author\_idBIGINT(20)是 作者ID
author\_nameVARCHAR(50)否 作者姓名(冗余)
doc\_typeVARCHAR(20)是MARKDOWN文档类型:MARKDOWN, WORD, PDF, EXCEL, PPT
doc\_statusTINYINT是0文档状态:0-草稿,1-待审核,2-已发布,3-已驳回
view\_countINT否0浏览次数
like\_countINT否0点赞次数
comment\_countINT否0评论次数
is\_publicTINYINT(1)是0是否公开:0-私有,1-公开
versionINT否1当前版本号
published\_atDATETIME否 发布时间
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_category\_id (category\_id)
  • KEY idx\_author\_id (author\_id)
  • KEY idx\_doc\_status (doc\_status)
  • KEY idx\_doc\_type (doc\_type)
  • FULLTEXT KEY ft\_title\_content (title, content)

4.2 分类表 (kb\_category)

字段名类型必填默认值说明
idBIGINT(20)是 分类ID(雪花ID)
category\_nameVARCHAR(100)是 分类名称
category\_codeVARCHAR(50)是 分类编码
parent\_idBIGINT(20)否 父分类ID
levelINT否1分类层级
pathVARCHAR(500)否 分类路径
iconVARCHAR(50)否 图标
colorVARCHAR(20)否 颜色
sortINT否0排序号
level\_noVARCHAR(50)否 层级编号(如:01, 0101)
doc\_countINT否0文档数量
statusTINYINT是1状态:0-禁用,1-正常
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_category\_code (category\_code)
  • KEY idx\_parent\_id (parent\_id)
  • KEY idx\_level\_no (level\_no)

4.3 标签表 (kb\_tag)

字段名类型必填默认值说明
idBIGINT(20)是 标签ID(雪花ID)
tag\_nameVARCHAR(50)是 标签名称
tag\_codeVARCHAR(50)否 标签编码
category\_idBIGINT(20)否 所属分类ID
tag\_typeVARCHAR(20)是 标签类型:SYSTEM-系统标签,USER-用户标签
colorVARCHAR(20)否 颜色
iconVARCHAR(50)否 图标
doc\_countINT否0文档数量
statusTINYINT是1状态:0-禁用,1-正常
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_tag\_name (tag\_name)
  • KEY idx\_category\_id (category\_id)

4.4 文档标签关联表 (kb\_document\_tag)

字段名类型必填默认值说明
idBIGINT(20)是 关联ID(雪花ID)
document\_idBIGINT(20)是 文档ID
tag\_idBIGINT(20)是 标签ID
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_document\_tag (document\_id, tag\_id)
  • KEY idx\_tag\_id (tag\_id)

4.5 评论表 (kb\_comment)

字段名类型必填默认值说明
idBIGINT(20)是 评论ID(雪花ID)
document\_idBIGINT(20)是 文档ID
parent\_idBIGINT(20)否 父评论ID
contentTEXT是 评论内容
commenter\_idBIGINT(20)是 评论人ID
commenter\_nameVARCHAR(50)否 评论人姓名(冗余)
like\_countINT否0点赞数
statusTINYINT是1状态:0-隐藏,1-正常
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_document\_id (document\_id)
  • KEY idx\_parent\_id (parent\_id)
  • KEY idx\_commenter\_id (commenter\_id)

4.6 文档审核记录表 (kb\_document\_review)

字段名类型必填默认值说明
idBIGINT(20)是 审核记录ID(雪花ID)
document\_idBIGINT(20)是 文档ID
reviewer\_idBIGINT(20)是 审核人ID
reviewer\_nameVARCHAR(50)否 审核人姓名(冗余)
review\_resultTINYINT是 审核结果:1-通过,2-驳回
review\_commentTEXT否 审核意见
before\_statusTINYINT否 审核前状态
review\_roundINT否1审核轮次
reviewed\_atDATETIME是CURRENT\_TIMESTAMP审核时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_document\_id (document\_id)
  • KEY idx\_reviewer\_id (reviewer\_id)

4.7 文档版本表 (kb\_document\_version)

字段名类型必填默认值说明
idBIGINT(20)是 版本ID(雪花ID)
document\_idBIGINT(20)是 文档ID
versionINT是 版本号
titleVARCHAR(200)否 文档标题
contentLONGTEXT否 文档内容
summaryVARCHAR(500)否 文档摘要
change\_descriptionVARCHAR(500)否 版本变更说明
operator\_idBIGINT(20)否 操作人ID
operator\_nameVARCHAR(50)否 操作人姓名
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_doc\_version (document\_id, version)
  • KEY idx\_document\_id (document\_id)

5. kb\_search(搜索服务)

5.1 搜索历史表 (kb\_search\_history)

字段名类型必填默认值说明
idBIGINT(20)是 历史ID(雪花ID)
user\_idBIGINT(20)是 用户ID
keywordVARCHAR(200)是 搜索关键词
search\_typeVARCHAR(20)是 搜索类型:all, document, user
result\_countINT否0结果数量
created\_atDATETIME是CURRENT\_TIMESTAMP搜索时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_user\_id (user\_id)
  • KEY idx\_keyword (keyword)
  • KEY idx\_created\_at (created\_at)

6. kb\_file(文件服务)

6.1 文件表 (kb\_file)

字段名类型必填默认值说明
idBIGINT(20)是 文件ID(雪花ID)
original\_nameVARCHAR(255)是 原始文件名
stored\_nameVARCHAR(255)是 存储文件名
file\_pathVARCHAR(500)是 文件路径
file\_sizeBIGINT是 文件大小(字节)
file\_typeVARCHAR(20)是 文件类型:DOCUMENT, IMAGE, VIDEO, AUDIO, OTHER
mime\_typeVARCHAR(100)是 MIME类型
file\_hashVARCHAR(64)是 文件哈希(SHA-256)
uploader\_idBIGINT(20)否 上传者ID
download\_countINT否0下载次数
statusTINYINT是1状态:0-删除,1-正常
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
deletedTINYINT(1)是0删除标记

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_file\_hash (file\_hash)
  • KEY idx\_uploader\_id (uploader\_id)
  • KEY idx\_file\_type (file\_type)

7. kb\_ai(AI服务)

7.1 AI对话表 (kb\_ai\_conversation)

字段名类型必填默认值说明
idBIGINT(20)是 对话ID(雪花ID)
user\_idBIGINT(20)是 用户ID
user\_nameVARCHAR(50)否 用户姓名(冗余)
titleVARCHAR(200)否 对话标题
model\_nameVARCHAR(50)否 模型名称
message\_countINT否0消息数量
statusTINYINT是1状态:0-已结束,1-进行中
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_user\_id (user\_id)
  • KEY idx\_status (status)

7.2 AI消息表 (kb\_ai\_message)

字段名类型必填默认值说明
idBIGINT(20)是 消息ID(雪花ID)
conversation\_idBIGINT(20)是 对话ID
roleVARCHAR(20)是 角色:user-用户,assistant-助手
contentTEXT是 消息内容
context\_doc\_idsJSON否 上下文文档ID列表(JSON数组)
model\_nameVARCHAR(50)否 使用的模型名称
tokensINT否 Token数量
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_conversation\_id (conversation\_id)
  • KEY idx\_created\_at (created\_at)

7.3 AI反馈表 (kb\_ai\_feedback)

字段名类型必填默认值说明
idBIGINT(20)是 反馈ID(雪花ID)
message\_idBIGINT(20)是 消息ID
feedback\_typeTINYINT是 反馈类型:1-点赞,2-点踩
feedback\_reasonVARCHAR(500)否 反馈原因
feedback\_textTEXT否 反馈详细内容
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_message\_type (message\_id, feedback\_type)
  • KEY idx\_message\_id (message\_id)

8. kb\_statistics(统计服务)

8.1 文档统计表 (kb\_document\_statistics)

字段名类型必填默认值说明
idBIGINT(20)是 统计ID(雪花ID)
document\_idBIGINT(20)是 文档ID
document\_titleVARCHAR(200)否 文档标题(冗余)
view\_countINT否0浏览次数
like\_countINT否0点赞次数
comment\_countINT否0评论次数
collect\_countINT否0收藏次数
share\_countINT否0分享次数
stat\_dateDATE是CURRENT\_DATE统计日期

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_document\_date (document\_id, stat\_date)
  • KEY idx\_stat\_date (stat\_date)

8.2 用户统计表 (kb\_user\_statistics)

字段名类型必填默认值说明
idBIGINT(20)是 统计ID(雪花ID)
user\_idBIGINT(20)是 用户ID
user\_nameVARCHAR(50)否 用户姓名(冗余)
document\_countINT否0创建文档数
comment\_countINT否0评论次数
like\_countINT否0点赞次数
view\_countINT否0浏览次数
login\_countINT否0登录次数
stat\_dateDATE是CURRENT\_DATE统计日期

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_user\_date (user\_id, stat\_date)
  • KEY idx\_stat\_date (stat\_date)

8.3 浏览记录表 (kb\_view\_record)

字段名类型必填默认值说明
idBIGINT(20)是 记录ID(雪花ID)
user\_idBIGINT(20)否 用户ID
document\_idBIGINT(20)是 文档ID
access\_durationINT否0访问时长(秒)
ip\_addressVARCHAR(50)否 IP地址
user\_agentVARCHAR(500)否 用户代理
created\_atDATETIME是CURRENT\_TIMESTAMP访问时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_user\_id (user\_id)
  • KEY idx\_document\_id (document\_id)
  • KEY idx\_created\_at (created\_at)

8.4 评论统计表 (kb\_comment\_statistics)

字段名类型必填默认值说明
idBIGINT(20)是 统计ID(雪花ID)
comment\_idBIGINT(20)是 评论ID
like\_countINT否0点赞数
reply\_countINT否0回复数
stat\_dateDATE是CURRENT\_DATE统计日期

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_comment\_date (comment\_id, stat\_date)
  • KEY idx\_stat\_date (stat\_date)

9. kb\_graph(知识图谱服务)

9.1 图谱节点表 (kb\_graph\_node)

字段名类型必填默认值说明
idBIGINT(20)是 节点ID(雪花ID)
node\_typeVARCHAR(50)是 节点类型:document, user, category, tag
node\_nameVARCHAR(200)是 节点名称
propertiesJSON否 节点属性
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间
updated\_atDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_node\_type (node\_type)

9.2 图谱边表 (kb\_graph\_edge)

字段名类型必填默认值说明
idBIGINT(20)是 边ID(雪花ID)
source\_idBIGINT(20)是 源节点ID
target\_idBIGINT(20)是 目标节点ID
edge\_typeVARCHAR(50)是 边类型:belongs\_to, has\_tag, created\_by, likes
weightDECIMAL(5,2)否1.0权重
propertiesJSON否 边属性
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_source\_id (source\_id)
  • KEY idx\_target\_id (target\_id)
  • KEY idx\_edge\_type (edge\_type)

9.3 图谱社区表 (kb\_graph\_community)

字段名类型必填默认值说明
idBIGINT(20)是 社区ID(雪花ID)
community\_nameVARCHAR(100)是 社区名称
node\_countINT否0节点数量
algorithm\_typeVARCHAR(50)是 算法类型
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)

9.4 社区节点关联表 (kb\_graph\_community\_node)

字段名类型必填默认值说明
idBIGINT(20)是 关联ID(雪花ID)
community\_idBIGINT(20)是 社区ID
node\_idBIGINT(20)是 节点ID
created\_atDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_community\_id (community\_id)
  • KEY idx\_node\_id (node\_id)

10. kb\_foundation(基础服务)

10.1 系统通知表 (kb\_notification)

字段名类型必填默认值说明
idBIGINT(20)是 通知ID(雪花ID)
user\_idBIGINT(20)是 接收用户ID
user\_nameVARCHAR(50)否 用户姓名(冗余字段)
notification\_typeVARCHAR(20)是 通知类型:system/comment/mention/review/like
titleVARCHAR(200)是 通知标题
contentTEXT是 通知内容
linkVARCHAR(500)否 跳转链接
related\_typeVARCHAR(50)否 关联类型
related\_idBIGINT(20)否 关联ID
is\_readTINYINT是0是否已读:0-未读,1-已读
read\_timeDATETIME否 阅读时间
create\_timeDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_user\_id (user\_id)
  • KEY idx\_is\_read (is\_read)
  • KEY idx\_notification\_type (notification\_type)
  • KEY idx\_user\_read (user\_id, is\_read)
  • KEY idx\_create\_time (create\_time)

10.2 系统配置表 (kb\_system\_config)

字段名类型必填默认值说明
idBIGINT(20)是 配置ID(雪花ID)
config\_keyVARCHAR(100)是 配置键
config\_valueTEXT是 配置值
config\_typeVARCHAR(20)是string配置类型:string/number/boolean/json
categoryVARCHAR(50)否 配置分类:AI/STORAGE/NOTIFICATION/SECURITY/SYSTEM
descriptionVARCHAR(500)否 配置描述
is\_publicTINYINT是0是否公开:0-私有,1-公开
create\_timeDATETIME是CURRENT\_TIMESTAMP创建时间
update\_timeDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_config\_key (config\_key)
  • KEY idx\_category (category)

10.3 操作日志表 (kb\_operation\_log)

字段名类型必填默认值说明
idBIGINT(20)是 日志ID(雪花ID)
moduleVARCHAR(50)是 模块名称
operation\_typeVARCHAR(50)是 操作类型:LOGIN/CREATE/UPDATE/DELETE等
operation\_descVARCHAR(500)是 操作描述
request\_methodVARCHAR(10)否 请求方法:GET/POST/PUT/DELETE
request\_urlVARCHAR(500)否 请求URL
request\_paramsTEXT否 请求参数(JSON)
response\_resultTEXT否 响应结果(JSON)
user\_idBIGINT(20)否 操作用户ID
usernameVARCHAR(50)否 操作用户名
ip\_addressVARCHAR(50)否 IP地址
locationVARCHAR(200)否 地理位置
user\_agentVARCHAR(500)否 用户代理
execute\_timeINT否 执行时长(毫秒)
statusTINYINT是1状态:0-失败,1-成功
error\_msgTEXT否 错误信息
create\_timeDATETIME是CURRENT\_TIMESTAMP操作时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_module (module)
  • KEY idx\_user\_id (user\_id)
  • KEY idx\_operation\_type (operation\_type)
  • KEY idx\_create\_time (create\_time)
  • KEY idx\_status (status)

10.4 字典类型表 (kb\_dict)

字段名类型必填默认值说明
idBIGINT(20)是 字典ID(雪花ID)
dict\_codeVARCHAR(50)是 字典编码
dict\_nameVARCHAR(100)是 字典名称
dict\_typeVARCHAR(50)是 字典类型
descriptionVARCHAR(500)否 描述
sortINT否0排序
statusTINYINT是1状态:0-禁用,1-正常
create\_timeDATETIME是CURRENT\_TIMESTAMP创建时间
update\_timeDATETIME是CURRENT\_TIMESTAMP ON UPDATE更新时间

索引设计:

  • PRIMARY KEY (id)
  • UNIQUE KEY uk\_dict\_code (dict\_code)
  • KEY idx\_dict\_type (dict\_type)

10.5 字典数据表 (kb\_dict\_data)

字段名类型必填默认值说明
idBIGINT(20)是 字典数据ID(雪花ID)
dict\_idBIGINT(20)是 字典ID
dict\_codeVARCHAR(50)是 字典编码(冗余)
dict\_labelVARCHAR(100)是 字典标签
dict\_valueVARCHAR(200)是 字典值
dict\_sortINT否0排序
css\_classVARCHAR(100)否 样式类名
list\_classVARCHAR(100)否 列表样式
is\_defaultTINYINT是0是否默认:0-否,1-是
statusTINYINT是1状态:0-禁用,1-正常
create\_timeDATETIME是CURRENT\_TIMESTAMP创建时间

索引设计:

  • PRIMARY KEY (id)
  • KEY idx\_dict\_id (dict\_id)
  • KEY idx\_dict\_code (dict\_code)

11. 索引设计

11.1 索引创建原则

  1. 主键索引:所有表必须有主键
  2. 唯一索引:保证数据唯一性
  3. 外键索引:关联字段建立索引
  4. 查询索引:高频查询字段建立索引
  5. 联合索引:遵循最左前缀原则

11.2 索引命名规范

索引类型命名格式示例
主键索引PRIMARY KEYPRIMARY KEY (id)
唯一索引uk\_表名\_字段名uk\_kb\_user\_email
普通索引idx\_表名\_字段名idx\_kb\_user\_status
全文索引ft\_表名\_字段名ft\_kb\_document\_content

11.3 索引优化建议

  1. 避免过多索引,影响写入性能
  2. 定期分析慢查询,优化索引
  3. 联合索引字段顺序考虑查询频率
  4. 监控索引使用率,删除无用索引

附录A:数据字典

A.1 通用状态枚举

字段枚举值说明
status0,1禁用、正常
deleted0,1未删除、已删除
is\_public0,1私有、公开
is\_read0,1未读、已读

A.2 文档状态枚举

值说明
0草稿
1待审核
2已发布
3已驳回

A.3 通知类型枚举

值说明
system系统通知
comment评论通知
mention@提醒
review审核通知
like点赞通知

A.4 用户类型枚举

值说明
0超级管理员
1知识管理员
2编辑
3普通用户

A.5 配置类型枚举

值说明
string字符串
number数字
boolean布尔值
jsonJSON对象
最后修改:2026 年 10 月 24 日
如果觉得我的文章对你有用,请随意赞赏