# 数据库设计文档

本数据库采用 `MySQL 5.7+`。

## 1. 表结构概览

- **users**: 用户信息表
- **roles**: 角色信息表
- **meetings**: 会议主表
- **attendees**: 参会人员关联表
- **tags**: 标签表
- **audio_files**: 会议音频文件表
- **attachments**: 会议附件表 (未来扩展)
- **transcript_tasks**: 语音转录任务表
- **transcript_segments**: 语音转录内容分段表
- **meeting_summaries**: AI 生成的会议纪要表(由llm_tasks替代)
- **llm_tasks**: AI总结任务表
- **prompts**: 提示词仓库表
- **knowledge_bases**: 知识库主表
- **knowledge_bases_task**: 知识库生成任务表
- **dict_data**: 字典/码表数据表
- **client_downloads**: 客户端下载管理表

---

## 2. 表结构详情

### 2.1. `users` - 用户表

存储用户信息和登录凭证。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `user_id` | INT | PRIMARY KEY, AUTO_INCREMENT | 用户唯一ID |
| `role_id` | INT | NOT NULL, FK | 角色ID (关联 `roles` 表) |
| `username` | VARCHAR(50) | UNIQUE, NOT NULL | 登录用户名 |
| `caption` | VARCHAR(50) | NOT NULL | 用户显示昵称 |
| `email` | VARCHAR(100) | UNIQUE, NOT NULL | 用户邮箱 |
| `password_hash` | VARCHAR(255) | NOT NULL | 哈希后的密码 |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 账户创建时间 |

### 2.1.1 'user_voiceprint' - 用户声纹表

| 字段名 | 类型 | 说明 |
|--------|------|------|
| vp_id | INT | 主键，自增ID |
| user_id | INT | 用户ID，唯一索引 |
| file_path | VARCHAR(255) | 音频文件相对路径 |
| file_size | INT | 文件大小（字节） |
| duration_seconds | DECIMAL(5,2) | 音频时长（秒），如 10.25 |
| vector_data | TEXT | 声纹向量JSON数组，如 [0.123, 0.456, ...] |
| collected_at | TIMESTAMP | 采集时间 |
| updated_at | TIMESTAMP | 更新时间 |

### 2.2. `roles` - 角色表

存储用户角色信息。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `role_id` | INT | PRIMARY KEY, AUTO_INCREMENT | 角色唯一ID |
| `role_name` | VARCHAR(50) | UNIQUE, NOT NULL | 角色名称 (e.g., "admin", "user") |

### 2.3. `meetings` - 会议表

存储会议的核心元数据。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `meeting_id` | INT | PRIMARY KEY, AUTO_INCREMENT | 会议唯一ID |
| `user_id` | INT | FK | 会议创建者ID (关联 `users` 表) |
| `title` | VARCHAR(255) | NOT NULL | 会议标题 |
| `meeting_time` | TIMESTAMP | NULL | 会议召开时间 |
| `user_prompt` | TEXT | NULL | 用户输入的提示词 （重复）|
| `summary` | TEXT | NULL | 会议摘要 (Markdown格式) |
| `tags` | VARCHAR(1024) | NULL | 以逗号分隔的标签字符串 |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 记录创建时间 |

### 2.4. `attendees` - 参会人表

会议与用户的多对多关联表。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `attendee_id` | INT | PRIMARY KEY, AUTO_INCREMENT | 唯一ID |
| `meeting_id` | INT | FK | 会议ID (关联 `meetings` 表) |
| `user_id` | INT | FK | 用户ID (关联 `users` 表) |
| | | UNIQUE (`meeting_id`, `user_id`) | |

### 2.5. `tags` - 标签表

存储所有唯一的标签及其颜色，用于快速检索和维护。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `id` | INT | PRIMARY KEY, AUTO_INCREMENT | 标签唯一ID |
| `name` | VARCHAR(255) | UNIQUE, NOT NULL | 标签名称 |
| `color` | VARCHAR(7) | DEFAULT '#409EFF' | 标签颜色 (HEX) |
| `creator_id` INT NOT NULL, COMMENT '创建者用户ID (关联 `users` 表) ' |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
### 2.6. `audio_files` - 音频文件表

存储上传的会议音频文件信息。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `audio_id` | INT | PRIMARY KEY, AUTO_INCREMENT | 音频文件唯一ID |
| `meeting_id` | INT | FK | 关联的会议ID |
| `file_name` | VARCHAR(255) | | 原始文件名 |
| `file_path` | VARCHAR(512) | NOT NULL | 文件存储相对路径 |
| `file_size` | BIGINT | NULL | 文件大小 (bytes) |
| `upload_time` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 上传时间 |

### 2.7. `attachments` - 会议附件表

存储会议相关的其他附件，如PPT、PDF等。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `attachment_id` | INT | PRIMARY KEY, AUTO_INCREMENT | 附件唯一ID |
| `meeting_id` | INT | FK | 关联的会议ID |
| `file_name` | VARCHAR(255) | NOT NULL | 原始文件名 |
| `file_path` | VARCHAR(512) | NOT NULL | 文件存储路径或URL |
| `file_type` | VARCHAR(100) | | 文件MIME类型 |
| `uploaded_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 上传时间 |

### 2.8. `transcript_tasks` - 转录任务表

记录语音转录任务的状态和元数据。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `task_id` | VARCHAR(100) | PRIMARY KEY | 业务任务唯一ID (UUID) |
| `paraformer_task_id`| VARCHAR(100) | NULL | 外部服务 (Dashscope) 的任务ID |
| `meeting_id` | INT | NOT NULL, FK | 关联的会议ID |
| `status` | ENUM(...) | DEFAULT 'pending' | 任务状态: 'pending', 'processing', 'completed', 'failed' |
| `progress` | INT | DEFAULT 0 | 任务进度百分比 (0-100) |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 任务创建时间 |
| `completed_at` | TIMESTAMP | NULL | 任务完成时间 |
| `error_message` | TEXT | NULL | 错误信息记录 |

### 2.9. `transcript_segments` - 转录内容分段表

存储转录后的文字内容，按句子和发言人分段。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `segment_id` | INT | PRIMARY KEY, AUTO_INCREMENT | 分段唯一ID |
| `meeting_id` | INT | FK | 关联的会议ID |
| `speaker_id` | INT | | AI识别的原始发言人ID (e.g., 0, 1, 2) |
| `speaker_tag` | VARCHAR(50) | NOT NULL | 用户可编辑的发言人标签 (e.g., "张三") |
| `start_time_ms` | INT | NOT NULL | 在音频中的开始时间 (毫秒) |
| `end_time_ms` | INT | NOT NULL | 在音频中的结束时间 (毫秒) |
| `text_content` | TEXT | NOT NULL | 转录的文本内容 |

### 2.10. `meeting_summaries` - 会议纪要表（作废）

存储由LLM生成的会议纪要。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `id` | INT | PRIMARY KEY, AUTO_INCREMENT | 纪要唯一ID |
| `meeting_id` | INT | FK | 关联的会议ID |
| `summary_content` | TEXT | NULL | 生成的纪要内容 |
| `user_prompt` | TEXT | NULL | 用户输入的额外提示 |
| `prompt_id` | INT | FK | 关联的提示词模版ID |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 生成时间 |

### 2.11. `llm_tasks` - AI总结任务表

记录异步生成AI总结的任务状态。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `task_id` | VARCHAR(100) | PRIMARY KEY | 业务任务唯一ID (UUID) |
| `meeting_id` | INT | NOT NULL, FK | 关联的会议ID |
| `prompt_id` | INT | NOT NULL, FK | 关联的提示词模版ID |
| `user_prompt` | TEXT | NULL | 用户输入的额外提示 |
| `status` | ENUM(...) | DEFAULT 'pending' | 任务状态: 'pending', 'processing', 'completed', 'failed' |
| `progress` | INT | DEFAULT 0 | 任务进度百分比 (0-100) |
| `result` | TEXT | NULL | 成功时存储生成的纪要内容 |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 任务创建时间 |
| `completed_at` | TIMESTAMP | NULL | 任务完成时间 |
| `error_message` | TEXT | NULL | 错误信息记录 |

### 2.13. `knowledge_bases` - 知识库表

存储用户生成和管理的知识库条目。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `kb_id` | INT | PRIMARY KEY, AUTO_INCREMENT | 知识库条目唯一ID |
| `title` | VARCHAR(255) | NOT NULL | 标题 |
| `user_prompt` | TEXT | NULL | 用户输入的提示词（重复） |
| `content` | TEXT | NULL | 生成的知识库内容 (Markdown格式) |
| `creator_id` | INT | NOT NULL, FK | 创建者用户ID (关联 `users` 表) |
| `is_shared` | BOOLEAN | NOT NULL, DEFAULT FALSE | 是否为共享知识库 (TRUE: 共享, FALSE: 个人) |
| `source_meeting_ids` | TEXT | NULL | 内容来源的会议ID列表 (逗号分隔) |
| `tags` | VARCHAR(255) | NULL | 逗号分隔的标签 |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
| `updated_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 最后更新时间 |

### 2.14. `knowledge_base_tasks` - 知识库生成任务表

记录异步生成知识库内容的AI任务状态。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `task_id` | VARCHAR(100) | PRIMARY KEY | 业务任务唯一ID (UUID) |
| `user_id` | INT | NOT NULL, FK | 发起任务的用户ID (关联 `users` 表) |
| `kb_id` | INT | NOT NULL, FK | 关联的知识库条目ID (关联 `knowledge_bases` 表) |
| `prompt_id` | INT | NOT NULL, FK | 关联的提示词模版ID |
| `user_prompt` | TEXT | NULL | 用户输入的提示词 |
| `status` | ENUM('pending', 'processing', 'completed', 'failed') | NOT NULL, DEFAULT 'pending' | 任务状态 |
| `progress` | INT | DEFAULT 0 | 任务进度百分比 (0-100) |
| `error_message` | TEXT | NULL | 任务失败时的错误信息 |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 任务创建时间 |
| `updated_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 任务状态更新时间 |
| `completed_at` | TIMESTAMP | NULL | 任务完成时间 |

### 2.12. `prompts` - 提示词仓库表

存储系统中各种任务使用的大模型提示词模板。每个任务类型（会议任务、知识库任务）可以有多个提示词，但只能有一个默认且启用的提示词。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `id` | INT | AUTO_INCREMENT, PRIMARY KEY | 提示词唯一ID |
| `name` | VARCHAR(255) | NOT NULL | 提示词名称 |
| `task_type` | ENUM('MEETING_TASK', 'KNOWLEDGE_TASK') | NOT NULL | 任务类型：MEETING_TASK-会议任务, KNOWLEDGE_TASK-知识库任务 |
| `content` | TEXT | NOT NULL | 完整的提示词内容 |
| `is_default` | BOOLEAN | NOT NULL, DEFAULT FALSE | 是否为该任务类型的默认模板 |
| `is_active` | BOOLEAN | NOT NULL, DEFAULT TRUE | 是否启用（只有启用的提示词才能被使用） |
| `creator_id` | INT | NOT NULL, FK | 创建者用户ID (关联 `users` 表) |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 创建时间 |

**约束说明：**
- 每个 `task_type` 同一时间只能有一个 `is_default=TRUE` 的提示词
- 业务逻辑需确保：设置新默认提示词时，自动取消同类型其他提示词的默认状态

### 2.15. `prompt_config` - 提示词配置表（已废弃）

**该表已废弃，功能整合到 `prompts` 表的 `task_type` 和 `is_default` 字段。**

### 2.16. `dict_data` - 字典/码表数据表

存储系统中的码表数据，支持树形结构和扩展属性，用于管理客户端平台类型等配置数据。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `id` | BIGINT | PRIMARY KEY, AUTO_INCREMENT | 主键ID |
| `dict_type` | VARCHAR(64) | NOT NULL, DEFAULT 'client_platform' | 字典类型（如 client_platform） |
| `dict_code` | VARCHAR(64) | NOT NULL | 业务编码（唯一Key，如 WIN、IOS、ANDROID） |
| `parent_code` | VARCHAR(64) | NOT NULL, DEFAULT 'ROOT' | 父级编码（ROOT为顶级，支持树形结构） |
| `tree_path` | VARCHAR(255) | NULL | 层级路径（辅助字段，如 0,1,10） |
| `label_cn` | VARCHAR(128) | NOT NULL | 中文名称 |
| `label_en` | VARCHAR(128) | NULL | 英文名称 |
| `sort_order` | INT | DEFAULT 0 | 排序权重 |
| `extension_attr` | JSON | NULL | 扩展属性（JSON格式，存储平台特有属性） |
| `is_default` | TINYINT | DEFAULT 0 | 是否默认选中（0: 否, 1: 是） |
| `status` | TINYINT | DEFAULT 1 | 状态（1: 正常, 0: 停用） |
| `create_time` | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
| | | UNIQUE KEY (`dict_type`, `dict_code`) | 确保编码在同类型下唯一 |

**扩展属性示例（extension_attr）：**
```json
{
  "suffix": ".exe",
  "arch_support": ["x86", "x64"],
  "icon": "monitor"
}
```

**树形结构示例：**
- ROOT
  - DESKTOP (桌面端)
    - WIN (Windows)
    - MAC (macOS)
    - LINUX (Linux)
  - MOBILE (移动端)
    - IOS (苹果iOS)
    - ANDROID (安卓)
  - TERMINAL (专用终端)
    - TERM_STD (通用终端)
    - TERM_S100 (中兴终端)

### 2.17. `client_downloads` - 客户端下载管理表

存储各平台客户端版本信息，用于管理客户端下载和版本更新。

| 字段名 | 类型 | 约束 | 描述 |
| :--- | :--- | :--- | :--- |
| `id` | INT | PRIMARY KEY, AUTO_INCREMENT | 主键ID |
| `platform_code` | VARCHAR(64) | NOT NULL | 平台编码（关联 `dict_data.dict_code`） |
| `version` | VARCHAR(50) | NOT NULL | 版本号（如 1.0.0） |
| `version_code` | INT | NOT NULL | 版本号数值（用于版本比较） |
| `download_url` | VARCHAR(512) | NOT NULL | 下载链接 |
| `file_size` | BIGINT | NULL | 文件大小（bytes） |
| `release_notes` | TEXT | NULL | 更新说明 |
| `is_active` | BOOLEAN | NOT NULL, DEFAULT TRUE | 是否启用 |
| `is_latest` | BOOLEAN | NOT NULL, DEFAULT FALSE | 是否为最新版本 |
| `min_system_version` | VARCHAR(50) | NULL | 最低系统版本要求 |
| `created_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
| `updated_at` | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
| `created_by` | INT | NULL, FK | 创建者用户ID（关联 `users` 表） |
| | | INDEX (`platform_code`) | 平台编码索引 |

**约束说明：**
- 同一 `platform_code` 同一时间只应有一个 `is_latest=TRUE` 的版本
- `platform_code` 关联 `dict_data` 表的 `dict_code` 字段（client_platform类型）
- 业务逻辑需确保：设置新最新版本时，自动取消同平台其他版本的最新状态

**相关API接口：**
- `GET /api/clients/latest/by-platform` - 获取最新版本客户端
  - 支持两种调用方式（兼容新旧版本，返回数据结构一致）：
    1. 旧版：传 `platform_type` 和 `platform_name` 参数
    2. 新版：传 `platform_code` 参数（推荐）
- `POST /api/clients/upload` - 上传客户端安装包（管理员）
  - 自动解析APK文件的版本信息
  - 自动读取文件大小并生成下载URL

---

## 3. 关系图 (ERD)

```mermaid
erDiagram
    users {
        int user_id PK
        varchar(50) username
        varchar(50) caption
        varchar(100) email
        varchar(255) password_hash
        int role_id FK
        timestamp created_at
    }

    roles {
        int role_id PK
        varchar(50) role_name
    }

    meetings {
        int meeting_id PK
        int user_id FK
        varchar(255) title
        timestamp meeting_time
        text summary
        varchar(1024) tags
        timestamp created_at
    }

    tags {
        int id PK
        varchar(255) name
        varchar(7) color
    }

    attendees {
        int attendee_id PK
        int meeting_id FK
        int user_id FK
    }

    audio_files {
        int audio_id PK
        int meeting_id FK
        varchar(512) file_path
        varchar(100) task_id
    }

    transcript_tasks {
        varchar(100) task_id PK
        int meeting_id FK
        varchar(100) paraformer_task_id
        enum status
        int progress
    }

    transcript_segments {
        int segment_id PK
        int meeting_id FK
        int speaker_id
        varchar(50) speaker_tag
        int start_time_ms
        int end_time_ms
        text text_content
    }

    meeting_summaries {
        int id PK
        int meeting_id FK
        text summary_content
    }

    llm_tasks {
        varchar(100) task_id PK
        int meeting_id FK
        enum status
        int progress
    }

    users ||--o{ meetings : "creates"
    users ||--o{ attendees : "attends"
    users }|..|| roles : "has role"
    meetings ||--|{ attendees : "has"
    meetings ||--|{ audio_files : "has"
    meetings ||--|{ transcript_tasks : "has"
    meetings ||--|{ transcript_segments : "has"
    meetings ||--|{ meeting_summaries : "has"
    meetings ||--|{ llm_tasks : "has"

```