# 数据库表结构说明

本文档描述项目使用的 PostgreSQL 数据库表及字段，便于配置数据库、排查问题或二次开发。  
表名与代码中 `lib/db/schema.ts` 一致，迁移文件位于 `lib/db/migrations/`。

---

## 1. User（用户表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| email | varchar(64) | 是 | - | 邮箱 |
| password | varchar(64) | 否 | - | 密码（可为空，如钉钉登录） |
| name | varchar(100) | 否 | - | 用户姓名（显示用） |
| department | varchar(256) | 否 | - | 部门 |
| dingtalkUserId | varchar(128) | 否 | - | 钉钉用户ID |
| role | varchar | 是 | 'regular' | 角色：guest / regular / admin |
| isActive | boolean | 是 | true | 是否启用 |
| monthlyImageLimit | integer | 否 | - | 每月出图限额，NULL/0 表示无限制 |
| createdAt | timestamp | 是 | now() | 创建时间 |
| updatedAt | timestamp | 是 | now() | 更新时间 |

---

## 2. Chat（会话表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| createdAt | timestamp | 是 | - | 创建时间 |
| title | text | 是 | - | 会话标题 |
| userId | uuid | 是 | - | 用户ID，外键 → User.id |
| visibility | varchar | 是 | 'private' | 可见性：public / private |
| lastContext | jsonb | 否 | - | 上次使用上下文（AppUsage） |

---

## 3. Message（消息表，新）— 表名：Message_v2

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| chatId | uuid | 是 | - | 会话ID，外键 → Chat.id |
| role | varchar | 是 | - | 角色（user/assistant 等） |
| parts | json | 是 | - | 消息内容片段 |
| attachments | json | 是 | - | 附件 |
| createdAt | timestamp | 是 | - | 创建时间 |
| video_storage_status | varchar(20) | 否 | 'temporary' | 视频存储状态 |
| temporary_video_url | text | 否 | - | 临时视频URL |
| permanent_video_url | text | 否 | - | 永久视频URL |
| archived_at | timestamp | 否 | - | 归档时间 |
| video_metadata | jsonb | 否 | - | 视频元数据 |

---

## 4. Message（旧版，已弃用）— 表名：Message

保留兼容，新逻辑请用 Message_v2。

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| chatId | uuid | 是 | - | 会话ID |
| role | varchar | 是 | - | 角色 |
| content | json | 是 | - | 内容 |
| createdAt | timestamp | 是 | - | 创建时间 |

---

## 5. Vote_v2（投票表，新）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| chatId | uuid | 是 | - | 会话ID，外键 → Chat.id |
| messageId | uuid | 是 | - | 消息ID，外键 → Message_v2.id |
| isUpvoted | boolean | 是 | - | 是否点赞 |
| （主键） | - | - | - | (chatId, messageId) 联合主键 |

---

## 6. Vote（旧版，已弃用）— 表名：Vote

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| chatId | uuid | 是 | - | 会话ID |
| messageId | uuid | 是 | - | 消息ID（旧 Message 表） |
| isUpvoted | boolean | 是 | - | 是否点赞 |

---

## 7. Document（文档表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键之一 |
| createdAt | timestamp | 是 | - | 主键之一 |
| title | text | 是 | - | 标题 |
| content | text | 否 | - | 内容 |
| text | varchar | 是 | 'text' | 类型：text / code / image / sheet |
| userId | uuid | 是 | - | 用户ID，外键 → User.id |

主键：(id, createdAt)

---

## 8. Suggestion（建议表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| documentId | uuid | 是 | - | 文档ID |
| documentCreatedAt | timestamp | 是 | - | 文档创建时间 |
| originalText | text | 是 | - | 原文 |
| suggestedText | text | 是 | - | 建议文本 |
| description | text | 否 | - | 描述 |
| isResolved | boolean | 是 | false | 是否已解决 |
| userId | uuid | 是 | - | 用户ID，外键 → User.id |
| createdAt | timestamp | 是 | - | 创建时间 |

---

## 9. Stream（流表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| chatId | uuid | 是 | - | 会话ID，外键 → Chat.id |
| createdAt | timestamp | 是 | - | 创建时间 |

---

## 10. SystemSettings（系统设置表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| key | varchar(128) | 是 | - | 配置键，唯一 |
| value | jsonb | 是 | - | 配置值 |
| updatedAt | timestamp | 是 | now() | 更新时间 |
| updatedBy | uuid | 否 | - | 更新人，外键 → User.id |

---

## 11. ToolConfig（工具配置表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| toolName | varchar(128) | 是 | - | 工具名称，唯一 |
| isEnabled | boolean | 是 | true | 是否启用 |
| description | text | 否 | - | 描述 |
| config | jsonb | 否 | - | 配置 |
| updatedAt | timestamp | 是 | now() | 更新时间 |
| updatedBy | uuid | 否 | - | 更新人，外键 → User.id |

---

## 12. AiProvider（AI 提供商表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| name | varchar(128) | 是 | - | 提供商名称 |
| type | varchar | 是 | 'custom' | 类型：alibaba / openai / custom / local / gemini / huanke-gemini / qianwen-video / volcano-vision / volcano-video / alibaba-image |
| baseUrl | text | 是 | - | API 基础 URL |
| apiKey | text | 是 | - | API Key |
| isEnabled | boolean | 是 | true | 是否启用 |
| createdAt | timestamp | 是 | now() | 创建时间 |
| updatedAt | timestamp | 是 | now() | 更新时间 |
| updatedBy | uuid | 否 | - | 更新人，外键 → User.id |

---

## 13. AiModel（AI 模型表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| providerId | uuid | 是 | - | 提供商ID，外键 → AiProvider.id |
| modelId | varchar(128) | 是 | - | 模型ID（如 qwen-turbo） |
| displayName | varchar(128) | 是 | - | 显示名称 |
| description | text | 否 | - | 描述 |
| supportsVision | boolean | 是 | false | 是否支持视觉 |
| supportsImageGen | boolean | 是 | false | 是否支持生图 |
| isEnabled | boolean | 是 | true | 是否启用 |
| isDefault | boolean | 是 | false | 是否默认模型 |
| sortOrder | integer | 是 | 0 | 排序 |
| capabilities | jsonb | 否 | - | 能力配置（如视频） |
| defaultParams | jsonb | 否 | - | 默认参数 |
| is_sub_model | boolean | 是 | false | 是否子模型（不单独展示） |
| parent_model_id | uuid | 否 | - | 父模型ID |
| fallbackModelId1 | varchar(128) | 否 | - | 备用模型ID 1 |
| fallbackModelId2 | varchar(128) | 否 | - | 备用模型ID 2 |
| imageGenConfig | jsonb | 否 | - | 生图配置 |
| createdAt | timestamp | 是 | now() | 创建时间 |
| updatedAt | timestamp | 是 | now() | 更新时间 |

---

## 14. StorageConfig（存储配置表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| name | varchar(128) | 是 | - | 配置名称 |
| type | varchar | 是 | 's3' | 类型：s3 / local |
| endpoint | text | 否 | - | S3 端点 |
| region | varchar(64) | 否 | - | 区域 |
| bucket | varchar(128) | 否 | - | 存储桶 |
| accessKeyId | text | 否 | - | Access Key ID |
| secretAccessKey | text | 否 | - | Secret Access Key |
| publicUrl | text | 否 | - | 公开访问 URL 前缀 |
| isDefault | boolean | 是 | false | 是否默认存储 |
| isEnabled | boolean | 是 | true | 是否启用 |
| createdAt | timestamp | 是 | now() | 创建时间 |
| updatedAt | timestamp | 是 | now() | 更新时间 |
| updatedBy | uuid | 否 | - | 更新人，外键 → User.id |

---

## 15. SiteSettings（网站设置表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| siteName | varchar(128) | 是 | 'AI Chatbot' | 站点名称 |
| siteLogo | text | 否 | - | 站点 LOGO（日间） |
| siteLogoDark | text | 否 | - | 站点 LOGO（夜间） |
| favicon | text | 否 | - |  favicon |
| showAutoModel | boolean | 是 | true | 是否显示「自动」模型 |
| defaultTheme | varchar(16) | 是 | 'system' | 默认主题：system / light / dark |
| usageTimeEnabled | boolean | 是 | false | 是否启用使用时间限制 |
| usageTimeStart | varchar(5) | 否 | '08:00' | 开始时间 HH:mm |
| usageTimeEnd | varchar(5) | 否 | '20:00' | 结束时间 HH:mm |
| usageTimeMessage | text | 否 | - | 超时提示文案 |
| bannerEnabled | boolean | 是 | true | 是否显示广告横幅 |
| bannerText | text | 否 | - | 横幅文案 |
| bannerLink | text | 否 | - | 横幅链接 |
| toolbox1Name | varchar(64) | 否 | '工具箱' | 工具箱1名称 |
| toolbox1Enabled | boolean | 是 | true | 工具箱1是否显示 |
| toolbox2Name | varchar(64) | 否 | '工具箱2' | 工具箱2名称 |
| toolbox2Enabled | boolean | 是 | false | 工具箱2是否显示 |
| tutorialVideoUrl | text | 否 | - | 教程视频链接 |
| tutorialEnabled | boolean | 是 | false | 是否显示教程 |
| rankingEnabled | boolean | 是 | true | 是否显示精选榜 |
| canvasEnabled | boolean | 是 | true | 是否启用无限画布 |
| canvasDefaultModelId | varchar(128) | 否 | - | 画布默认模型ID |
| canvasAutoModeDefaultModelId | varchar(128) | 否 | - | 画布智能自动模式默认模型ID |
| updatedAt | timestamp | 是 | now() | 更新时间 |
| updatedBy | uuid | 否 | - | 更新人，外键 → User.id |

---

## 16. NavLinks（导航链接表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| name | varchar(64) | 是 | - | 名称 |
| url | text | 是 | - | 链接 |
| order | integer | 是 | 0 | 排序 |
| isEnabled | boolean | 是 | true | 是否启用 |
| toolboxGroup | integer | 是 | 1 | 工具箱分组：1 或 2 |
| createdAt | timestamp | 是 | now() | 创建时间 |
| updatedAt | timestamp | 是 | now() | 更新时间 |
| createdBy | uuid | 否 | - | 创建人，外键 → User.id |

---

## 17. TutorialVideos（教程视频表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| title | varchar(128) | 是 | - | 标题 |
| videoUrl | text | 是 | - | 视频链接 |
| coverUrl | text | 否 | - | 封面图链接 |
| description | text | 否 | - | 描述 |
| order | integer | 是 | 0 | 排序 |
| isEnabled | boolean | 是 | true | 是否启用 |
| createdAt | timestamp | 是 | now() | 创建时间 |
| updatedAt | timestamp | 是 | now() | 更新时间 |
| createdBy | uuid | 否 | - | 创建人，外键 → User.id |

---

## 18. AuthSettings（认证配置表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| dingTalkAppKey | text | 否 | - | 钉钉 AppKey |
| dingTalkAppSecret | text | 否 | - | 钉钉 AppSecret |
| dingTalkOrganizations | jsonb | 否 | - | 多组织钉钉配置 [{ name, appKey, appSecret }] |
| isDingTalkEnabled | boolean | 是 | false | 是否启用钉钉登录 |
| isRegistrationEnabled | boolean | 是 | true | 是否开放注册 |
| updatedAt | timestamp | 是 | now() | 更新时间 |
| updatedBy | uuid | 否 | - | 更新人，外键 → User.id |

---

## 19. LoginToken（临时登录令牌表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| token | text | 是 | - | 令牌，唯一 |
| email | varchar(64) | 是 | - | 邮箱 |
| expiresAt | timestamp | 是 | - | 过期时间 |
| createdAt | timestamp | 是 | now() | 创建时间 |

---

## 20. GeneratedImage（生成图片记录表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| userId | uuid | 是 | - | 用户ID，外键 → User.id |
| chatId | uuid | 否 | - | 会话ID，外键 → Chat.id |
| messageId | uuid | 否 | - | 消息ID |
| thumbnailUrl | text | 是 | - | 缩略图 URL |
| originalUrl | text | 是 | - | 原图 URL |
| imageSize | varchar(10) | 否 | '2K' | 图片尺寸 |
| prompt | text | 否 | - | 提示词 |
| modelId | varchar(128) | 否 | - | 模型ID |
| isFeatured | boolean | 是 | false | 是否精选 |
| featuredAt | timestamp | 否 | - | 精选时间 |
| featuredBy | uuid | 否 | - | 精选操作人，外键 → User.id |
| createdAt | timestamp | 是 | now() | 创建时间 |

---

## 21. CanvasProject（画布项目表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| userId | uuid | 是 | - | 用户ID，外键 → User.id |
| title | varchar(256) | 是 | '未命名画布' | 标题 |
| description | text | 否 | - | 描述 |
| thumbnail | text | 否 | - | 缩略图 URL |
| canvasData | jsonb | 否 | - | 画布数据 { nodes, edges, viewport } |
| createdAt | timestamp | 是 | now() | 创建时间 |
| updatedAt | timestamp | 是 | now() | 更新时间 |

---

## 22. CanvasNode（画布节点表）

| 字段名 | 类型 | 必填 | 默认 | 说明 |
|--------|------|------|------|------|
| id | uuid | 是 | defaultRandom() | 主键 |
| projectId | uuid | 是 | - | 画布项目ID，外键 → CanvasProject.id |
| type | varchar(32) | 是 | - | 类型：message / image / video / text / scene-fusion |
| position | jsonb | 否 | - | 位置 { x, y } |
| size | jsonb | 否 | - | 尺寸 { width, height } |
| data | jsonb | 否 | - | 节点数据 |
| connections | jsonb | 否 | [] | 连接列表 |
| parentId | uuid | 否 | - | 父节点ID |
| createdAt | timestamp | 是 | now() | 创建时间 |
| updatedAt | timestamp | 是 | now() | 更新时间 |

---

## 使用说明

- **建表**：项目使用 Drizzle 迁移，首次部署请执行 `pnpm run db:migrate` 或项目内定义的迁移命令，表会按 `lib/db/migrations/` 中的 SQL 自动创建/更新。
- **连接**：数据库连接由环境变量配置（如 `POSTGRES_URL`），请勿将包含密码的 `.env` 提交到仓库。
- **系统配置**：部分功能依赖 `SystemSettings` 表中的 key（如 `scene_fusion_config`、站点相关 key），具体 key 名见代码中 `getSystemSetting` 的用法。