# 11-AI知识库系统字段字典_Data_Dictionary_V1.0.xlsx

## Sheet: 00_文档说明
- Range: 30 rows x 6 columns

| 11-AI知识库系统字段字典（Data Dictionary） |  |  |  |  |  |
| 文档名称 | 11-AI知识库系统字段字典（Data Dictionary） |  |  |  |  |
| 版本 | V1.0 |  |  |  |  |
| 项目名称 | AI 企业知识库问答系统 |  |  |  |  |
| 依据文档 | 数据库设计 V1.0 |  |  |  |  |
| 适用版本 | V1.0 |  |  |  |  |
| 第一章 文档说明 |  |  |  |  |  |
| 1.1 编写目的 |  |  |  |  |  |
| 字段字典用于统一数据库字段定义，避免开发、测试、运维及 BI 人员理解不一致。  所有新增数据表均需遵循本规范。 |  |  |  |  |  |
| 工作表目录 |  |  |  |  |  |
| 序号 | 工作表 | 内容 |  |  |  |
| 1 | 01_通用字段规范 | 公共字段定义 |  |  |  |
| 2 | 02_sys_user | 用户表字段 |  |  |  |
| 3 | 03_sys_admin | 管理员表字段 |  |  |  |
| 4 | 04_sys_knowledge | 知识库表字段 |  |  |  |
| 5 | 05_sys_user_kb | 用户知识库权限表字段 |  |  |  |
| 6 | 06_sys_chat_session | 聊天会话表字段 |  |  |  |
| 7 | 07_sys_chat_message | 聊天消息表字段 |  |  |  |
| 8 | 08_sys_prompt | Prompt 表字段 |  |  |  |
| 9 | 09_sys_model | 模型配置表字段 |  |  |  |
| 10 | 10_sys_system_config | 系统配置表字段 |  |  |  |
| 11 | 11_sys_ai_request_log | AI 请求日志字段 |  |  |  |
| 12 | 12_sys_operation_log | 操作日志表字段 |  |  |  |
| 13 | 13_字段取值规范 | 状态、删除标识、消息状态取值 |  |  |  |
| 14 | 14_命名维护规范 | 表命名、字段命名及维护规范 |  |  |  |

## Sheet: 01_通用字段规范
- Range: 10 rows x 4 columns

| 第二章 通用字段规范 |  |  |  |
| 所有业务表建议包含以下公共字段 |  |  |  |
| 字段 | 类型 | 是否必填 | 说明 |
| id | BIGINT | √ | 主键 |
| created_at | DATETIME | √ | 创建时间 |
| updated_at | DATETIME | √ | 更新时间 |
| created_by | BIGINT | × | 创建人（管理员） |
| updated_by | BIGINT | × | 修改人（管理员） |
| is_deleted | TINYINT | √ | 逻辑删除标识（0=否，1=是） |

## Sheet: 02_sys_user
- Range: 17 rows x 6 columns

| 第三章 用户表字段（sys_user） |  |  |  |  |  |
| 表名：sys_user |  |  |  |  |  |
| 字段 | 类型 | 长度 | 必填 | 默认值 | 说明 |
| id | BIGINT | - | √ | 自增 | 主键 |
| phone | VARCHAR | 20 | √ | - | 手机号（唯一） |
| name | VARCHAR | 50 | √ | - | 姓名 |
| nickname | VARCHAR | 50 | × | NULL | 昵称 |
| status | TINYINT | - | √ | 1 | 账号状态 |
| daily_chat_limit | INT | - | √ | 100 | 每日聊天额度 |
| daily_chat_used | INT | - | √ | 0 | 今日已使用次数 |
| effective_at | DATETIME | - | × | NULL | 生效时间 |
| expired_at | DATETIME | - | × | NULL | 到期时间 |
| last_login_at | DATETIME | - | × | NULL | 最后登录时间 |
| created_at | DATETIME | - | √ | 当前时间 | 创建时间 |
| updated_at | DATETIME | - | √ | 当前时间 | 更新时间 |
| is_deleted | TINYINT | - | √ | 0 | 是否删除 |

## Sheet: 03_sys_admin
- Range: 13 rows x 3 columns

| 第四章 管理员表字段（sys_admin） |  |  |
| 表名：sys_admin |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| username | VARCHAR(50) | 登录账号 |
| password | VARCHAR(255) | 加密密码 |
| name | VARCHAR(50) | 姓名 |
| role_id | BIGINT | 角色ID |
| status | TINYINT | 状态 |
| last_login_at | DATETIME | 最后登录时间 |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |

## Sheet: 04_sys_knowledge
- Range: 12 rows x 3 columns

| 第五章 知识库表字段（sys_knowledge） |  |  |
| 表名：sys_knowledge |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| name | VARCHAR(100) | 知识库名称 |
| feishu_space_id | VARCHAR(100) | 飞书 Space ID |
| feishu_node_id | VARCHAR(100) | 飞书节点 ID |
| status | TINYINT | 启用/禁用 |
| remark | VARCHAR(255) | 备注 |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |

## Sheet: 05_sys_user_kb
- Range: 12 rows x 3 columns

| 第六章 用户知识库权限表（sys_user_kb） |  |  |
| 表名：sys_user_kb |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| user_id | BIGINT | 用户ID |
| knowledge_id | BIGINT | 知识库ID |
| effective_at | DATETIME | 生效时间 |
| expired_at | DATETIME | 到期时间 |
| created_by | BIGINT | 创建管理员 |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |

## Sheet: 06_sys_chat_session
- Range: 12 rows x 3 columns

| 第七章 聊天会话表（sys_chat_session） |  |  |
| 表名：sys_chat_session |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| user_id | BIGINT | 用户ID |
| title | VARCHAR(100) | 会话标题 |
| message_count | INT | 消息数量 |
| last_message_at | DATETIME | 最后消息时间 |
| is_deleted | TINYINT | 是否删除 |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |

## Sheet: 07_sys_chat_message
- Range: 15 rows x 3 columns

| 第八章 聊天消息表（sys_chat_message） |  |  |
| 表名：sys_chat_message |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| session_id | BIGINT | 会话ID |
| user_id | BIGINT | 用户ID |
| role | ENUM | user / assistant |
| content | LONGTEXT | 消息内容 |
| message_status | VARCHAR(20) | 消息状态 |
| token_input | INT | 输入 Token |
| token_output | INT | 输出 Token |
| response_time_ms | INT | 回复耗时（毫秒） |
| model_id | BIGINT | 模型ID |
| created_at | DATETIME | 创建时间 |

## Sheet: 08_sys_prompt
- Range: 8 rows x 3 columns

| 第九章 Prompt 表（sys_prompt） |  |  |
| 表名：sys_prompt |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| prompt_content | LONGTEXT | Prompt 内容 |
| updated_by | BIGINT | 修改人 |
| updated_at | DATETIME | 更新时间 |

## Sheet: 09_sys_model
- Range: 13 rows x 3 columns

| 第十章 模型配置表（sys_model） |  |  |
| 表名：sys_model |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| provider | VARCHAR(50) | 模型供应商 |
| model_name | VARCHAR(100) | 模型名称 |
| api_url | VARCHAR(255) | API 地址 |
| api_key | TEXT | API 密钥 |
| temperature | DECIMAL | 温度参数 |
| max_token | INT | 最大输出 Token |
| timeout_second | INT | 超时时间 |
| enabled | TINYINT | 是否启用 |

## Sheet: 10_sys_system_config
- Range: 10 rows x 3 columns

| 第十一章 系统配置表（sys_system_config） |  |  |
| 表名：sys_system_config |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| config_key | VARCHAR(100) | 配置键 |
| config_value | TEXT | 配置值 |
| description | VARCHAR(255) | 描述 |
| updated_by | BIGINT | 修改人 |
| updated_at | DATETIME | 更新时间 |

## Sheet: 11_sys_ai_request_log
- Range: 19 rows x 3 columns

| 第十二章 AI 请求日志（sys_ai_request_log） |  |  |
| 表名：sys_ai_request_log |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| session_id | BIGINT | 会话ID |
| message_id | BIGINT | 消息ID |
| user_id | BIGINT | 用户ID |
| model_name | VARCHAR(100) | 模型名称 |
| prompt | LONGTEXT | Prompt 内容 |
| knowledge_ids | VARCHAR(500) | 检索知识库 |
| retrieve_count | INT | 命中文档数 |
| input_token | INT | 输入 Token |
| output_token | INT | 输出 Token |
| total_token | INT | Token 总数 |
| cost_ms | INT | 请求耗时 |
| status | VARCHAR(20) | 请求状态 |
| error_message | TEXT | 错误信息 |
| created_at | DATETIME | 创建时间 |

## Sheet: 12_sys_operation_log
- Range: 14 rows x 3 columns

| 第十三章 操作日志表（sys_operation_log） |  |  |
| 表名：sys_operation_log |  |  |
| 字段 | 类型 | 说明 |
| id | BIGINT | 主键 |
| admin_id | BIGINT | 管理员ID |
| module | VARCHAR(50) | 操作模块 |
| action | VARCHAR(50) | 操作类型 |
| target_id | BIGINT | 操作对象ID |
| before_json | LONGTEXT | 修改前数据 |
| after_json | LONGTEXT | 修改后数据 |
| ip | VARCHAR(50) | IP 地址 |
| result | VARCHAR(20) | 操作结果 |
| created_at | DATETIME | 创建时间 |

## Sheet: 13_字段取值规范
- Range: 20 rows x 6 columns

| 第十四章 字段取值规范 |  |  |  |  |  |
| status |  |  |  |  |  |
| 值 | 含义 |  |  |  |  |
| 0 | 禁用 |  |  |  |  |
| 1 | 启用 |  |  |  |  |
| is_deleted |  |  |  |  |  |
| 值 | 含义 |  |  |  |  |
| 0 | 正常 |  |  |  |  |
| 1 | 已删除 |  |  |  |  |
| message_status |  |  |  |  |  |
| 值 | 含义 |  |  |  |  |
| WAITING | 等待处理 |  |  |  |  |
| GENERATING | 生成中 |  |  |  |  |
| FINISHED | 已完成 |  |  |  |  |
| STOPPED | 用户停止 |  |  |  |  |
| TIMEOUT | 超时 |  |  |  |  |
| FAILED | 失败 |  |  |  |  |

## Sheet: 14_命名维护规范
- Range: 21 rows x 6 columns

| 第十五章 命名规范 / 第十六章 数据字典维护规范 |  |  |  |  |  |
| 15.1 表命名 |  |  |  |  |  |
| 规范项 | 内容 |  |  |  |  |
| 统一格式 | sys_xxx |  |  |  |  |
| 示例 | sys_user |  |  |  |  |
| 示例 | sys_chat_message / sys_prompt |  |  |  |  |
| 15.2 字段命名 |  |  |  |  |  |
| 规范项 | 内容 |  |  |  |  |
| 统一格式 | snake_case |  |  |  |  |
| 示例 | created_at |  |  |  |  |
| 示例 | updated_at / user_id |  |  |  |  |
| 示例 | model_name |  |  |  |  |
| 第十六章 数据字典维护规范 |  |  |  |  |  |
| 序号 | 维护要求 |  |  |  |  |
| 1 | 新增数据表必须同步更新字段字典。 |  |  |  |  |
| 2 | 修改字段类型、长度或含义时，必须更新字段字典。 |  |  |  |  |
| 3 | 字段字典应与数据库脚本保持一致，并纳入版本管理。 |  |  |  |  |
| 4 | 建议同时维护 Excel 版本，供产品、开发、测试及运维共同使用。 |  |  |  |  |
