# 数据库结构文档（PostgreSQL）

本文档根据 `backend/design/db_schema_pgsql.sql` 生成，描述当前核心表结构、字段、约束与索引。

## 0. 租户与组织

### 0.1 `sys_tenant`（租户表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 租户ID |
| tenant_code | VARCHAR(64) | NOT NULL, UNIQUE | 租户编码 |
| tenant_name | VARCHAR(128) | NOT NULL | 租户名称 |
| status | SMALLINT | NOT NULL, DEFAULT 1 | 状态 |
| expire_time | TIMESTAMP(6) |  | 过期时间 |
| contact_name | VARCHAR(64) |  | 联系人 |
| contact_phone | VARCHAR(32) |  | 联系电话 |
| remark | VARCHAR(255) |  | 备注 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT CURRENT_TIMESTAMP | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT CURRENT_TIMESTAMP | 更新时间 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除标记 |

索引：
- `uk_tenant_code`：`UNIQUE (tenant_code) WHERE is_deleted = FALSE`

### 0.2 `sys_org`（组织架构表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 组织ID |
| tenant_id | BIGINT | NOT NULL | 租户ID |
| parent_id | BIGINT |  | 父级组织ID |
| org_name | VARCHAR(128) | NOT NULL | 组织名称 |
| org_code | VARCHAR(64) |  | 组织编码 |
| org_path | VARCHAR(512) |  | 组织路径 |
| sort_order | INTEGER | DEFAULT 0 | 排序 |
| status | SMALLINT | DEFAULT 1 | 状态 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT CURRENT_TIMESTAMP | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT CURRENT_TIMESTAMP | 更新时间 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除标记 |

外键：
- `fk_org_parent`：`parent_id -> sys_org(id)`
- `fk_org_tenant`：`tenant_id -> sys_tenant(id)`

索引：
- `idx_org_tenant`：`(tenant_id)`

## 1. 用户与角色

### 1.1 `sys_user`（用户表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| user_id | BIGSERIAL | PK | 用户ID |
| username | VARCHAR(50) | NOT NULL, UNIQUE | 登录名 |
| display_name | VARCHAR(50) | NOT NULL | 显示名 |
| email | VARCHAR(100) |  | 邮箱 |
| phone | VARCHAR(30) | UNIQUE | 手机号 |
| password_hash | VARCHAR(255) | NOT NULL | 密码哈希 |
| status | SMALLINT | NOT NULL, DEFAULT 1 | 状态 |
| pwd_reset_required | SMALLINT | DEFAULT 1 | 首次登录是否需改密 |
| is_deleted | SMALLINT | NOT NULL, DEFAULT 0 | 逻辑删除标记 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |
| is_platform_admin | BOOLEAN | DEFAULT false | 是否平台管理员 |

索引：
- `uk_user_username`：`UNIQUE (username) WHERE is_deleted = FALSE`

### 1.2 `sys_role`（角色表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| role_id | BIGSERIAL | PK | 角色ID |
| tenant_id | BIGINT |  | 租户ID |
| role_code | VARCHAR(50) | NOT NULL, UNIQUE | 角色编码 |
| role_name | VARCHAR(50) | NOT NULL | 角色名称 |
| status | SMALLINT | NOT NULL, DEFAULT 1 | 状态 |
| remark | TEXT |  | 备注 |
| is_deleted | SMALLINT | NOT NULL, DEFAULT 0 | 逻辑删除标记 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |

索引：
- `idx_sys_role_tenant`：`(tenant_id)`
- `uk_role_code`：`UNIQUE (tenant_id, role_code) WHERE is_deleted = FALSE`

### 1.3 `sys_user_role`（用户-角色关联表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 关联ID |
| tenant_id | BIGINT |  | 租户ID |
| user_id | BIGINT | NOT NULL | 用户ID |
| role_id | BIGINT | NOT NULL | 角色ID |
| is_deleted | SMALLINT | NOT NULL, DEFAULT 0 | 逻辑删除标记 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |

唯一约束：
- `UNIQUE (user_id, role_id)`

### 1.4 `sys_tenant_user`（租户成员关联表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 关联ID |
| user_id | BIGINT | NOT NULL | 用户ID |
| tenant_id | BIGINT | NOT NULL | 租户ID |
| org_id | BIGINT |  | 组织ID |
| status | SMALLINT | DEFAULT 1 | 状态 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除标记 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |

索引：
- `uk_tenant_user`：`UNIQUE (user_id, tenant_id) WHERE is_deleted = 0`

## 2. 权限/字典/参数（全局共享）

### 2.1 `sys_permission`（权限表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| perm_id | BIGSERIAL | PK | 权限ID |
| parent_id | BIGINT |  | 父级权限ID |
| name | VARCHAR(100) | NOT NULL | 权限名称 |
| code | VARCHAR(100) | NOT NULL, UNIQUE | 权限编码 |
| perm_type | VARCHAR(20) | NOT NULL | 权限类型 |
| level | INTEGER | NOT NULL | 层级 |
| path | VARCHAR(255) |  | 路径 |
| component | VARCHAR(255) |  | 组件 |
| icon | VARCHAR(100) |  | 图标 |
| sort_order | INTEGER | NOT NULL, DEFAULT 0 | 排序 |
| is_visible | SMALLINT | NOT NULL, DEFAULT 1 | 是否可见 |
| status | SMALLINT | NOT NULL, DEFAULT 1 | 状态 |
| description | TEXT |  | 描述 |
| meta | JSONB |  | 扩展信息 |
| is_deleted | SMALLINT | NOT NULL, DEFAULT 0 | 逻辑删除标记 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |

### 2.2 `sys_dict_type`（字典类型表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| dict_type_id | BIGSERIAL | PK | 类型ID |
| type_code | VARCHAR(50) | NOT NULL, UNIQUE | 类型编码 |
| type_name | VARCHAR(50) | NOT NULL | 类型名称 |
| status | SMALLINT | DEFAULT 1 | 状态 |
| remark | TEXT |  | 备注 |
| created_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | 创建时间 |
| updated_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | 更新时间 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除标记 |

**初始化数据：**
- `sys_common_status`: 通用状态 (启用/禁用)
- `sys_permission_type`: 权限类型 (目录/菜单/按钮)
- `sys_common_visibility`: 可见性 (显示/隐藏)
- `sys_permission_level`: 权限层级 (1, 2, 3)
- `sys_log_type`: 日志类型 (LOGIN/OPERATION)
- `sys_param_type`: 参数类型 (String/Number/Boolean/JSON)
- `sys_log_status`: 操作状态 (成功/失败)

### 2.3 `sys_dict_item`（字典项表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| dict_item_id | BIGSERIAL | PK | 字典项ID |
| type_code | VARCHAR(50) | NOT NULL | 字典类型编码 |
| item_label | VARCHAR(100) | NOT NULL | 展示文本 |
| item_value | VARCHAR(100) | NOT NULL | 存储值 |
| sort_order | INT | DEFAULT 0 | 排序 |
| status | SMALLINT | DEFAULT 1 | 状态 |
| created_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | 创建时间 |
| updated_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | 更新时间 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除标记 |

索引：
- `idx_dict_item_type`：`(type_code)`
- `uk_dict_item_value`：`UNIQUE (type_code, item_value)`

### 2.4 `sys_param`（系统参数表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 参数ID |
| param_key | VARCHAR(100) | NOT NULL, UNIQUE | 参数键 |
| param_value | TEXT | NOT NULL | 参数值 |
| param_type | VARCHAR(20) | NOT NULL | 参数类型 |
| is_system | SMALLINT | DEFAULT 0 | 是否系统内置 |
| status | SMALLINT | DEFAULT 1 | 状态 |
| description | TEXT |  | 描述 |
| created_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | 创建时间 |

## 3. 日志（租户隔离）

### 3.1 `sys_log`（系统日志表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 日志ID |
| tenant_id | BIGINT | NOT NULL, DEFAULT 0 | 租户ID |
| user_id | BIGINT |  | 用户ID |
| username | VARCHAR(50) |  | 用户名 |
| log_type | VARCHAR(20) |  | 日志类型（如 LOGIN、OPERATION） |
| operation | VARCHAR(100) | NOT NULL | 操作描述 |
| method | VARCHAR(200) |  | 方法 |
| params | TEXT |  | 请求参数 |
| status | SMALLINT | DEFAULT 1 | 状态 |
| ip | VARCHAR(50) |  | IP |
| duration | BIGINT |  | 耗时（ms） |
| created_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | 创建时间 |

索引：
- `idx_log_tenant_type`：`(tenant_id, log_type, created_at)`

## 4. 平台配置

### 4.1 `sys_platform_config`（平台管理表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGINT | PK | 固定为 1 |
| project_name | VARCHAR(128) | NOT NULL | 项目名称 |
| logo_url | VARCHAR(512) |  | Logo URL |
| icon_url | VARCHAR(512) |  | Icon URL |
| login_bg_url | VARCHAR(512) |  | 登录页背景 |
| icp_info | VARCHAR(128) |  | 备案信息 |
| copyright_info | VARCHAR(255) |  | 版权信息 |
| system_description | TEXT |  | 系统描述 |
| created_at | TIMESTAMP | NOT NULL | 创建时间 |
| updated_at | TIMESTAMP | NOT NULL | 更新时间 |

## 5. 业务模块

### 5.1 `biz_speakers`（声纹发言人表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 主键ID |
| tenant_id | BIGINT | NOT NULL | 租户ID |
| user_id | BIGINT |  | 关联系统用户ID |
| name | VARCHAR(100) | NOT NULL | 发言人姓名 |
| voice_path | VARCHAR(512) |  | 原始文件路径 |
| voice_ext | VARCHAR(10) |  | 文件后缀 |
| voice_size | BIGINT |  | 文件大小 |
| status | SMALLINT | DEFAULT 1 | 状态 (1:已保存, 2:注册中, 3:已注册) |
| embedding | VECTOR |  | 声纹特征向量 |
| remark | TEXT |  | 备注 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除 |

索引：
- `idx_speaker_tenant`: `(tenant_id)`
- `idx_speaker_user`: `(user_id) WHERE is_deleted = 0`

### 5.2 `biz_hot_words`（热词管理表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 主键ID |
| tenant_id | BIGINT | NOT NULL | 租户ID |
| word | VARCHAR(100) | NOT NULL | 热词原文 |
| pinyin_list | JSONB |  | 拼音数组 |
| match_strategy | SMALLINT | DEFAULT 1 | 匹配策略 (1:精确, 2:模糊) |
| category | VARCHAR(50) |  | 类别 (人名、术语等) |
| weight | INTEGER | DEFAULT 10 | 权重 (1-100) |
| status | SMALLINT | DEFAULT 1 | 状态 (1:启用, 0:禁用) |
| is_synced | SMALLINT | DEFAULT 0 | 已同步第三方标记 |
| remark | TEXT |  | 备注 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除 |

索引：
- `idx_hotword_tenant`: `(tenant_id)`
- `idx_hotword_word`: `(word) WHERE is_deleted = 0`

### 5.3 `biz_prompt_templates`（提示词模板表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 主键ID |
| tenant_id | BIGINT | NOT NULL | 租户ID |
| template_name | VARCHAR(100) | NOT NULL | 模板名称 |
| category | VARCHAR(20) |  | 分类 (字典: biz_prompt_category) |
| is_system | SMALLINT | DEFAULT 0 | 是否预置 (1:是, 0:否) |
| creator_id | BIGINT |  | 创建人ID |
| tags | JSONB |  | 标签数组 |
| usage_count | INTEGER | DEFAULT 0 | 使用次数 |
| prompt_content | TEXT | NOT NULL | 提示词内容 |
| status | SMALLINT | DEFAULT 1 | 状态 (1:启用, 0:禁用) |
| remark | VARCHAR(255) |  | 备注 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除 |

索引：
- `idx_prompt_tenant`: `(tenant_id)`
- `idx_prompt_system`: `(is_system) WHERE is_deleted = 0`

### 5.4 `biz_ai_models`（AI 模型管理表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 主键ID |
| tenant_id | BIGINT | NOT NULL | 租户ID |
| model_type | VARCHAR(20) | NOT NULL | ASR (语音) 或 LLM (总结) |
| model_name | VARCHAR(100) | NOT NULL | 自定义名称 |
| provider | VARCHAR(50) |  | 提供商 (Aliyun, OpenAI等) |
| base_url | VARCHAR(255) |  | 基础请求地址 |
| model_code | VARCHAR(100) |  | 模型代码 |
| ws_url | VARCHAR(255) |  | WebSocket 地址 (ASR) |
| temperature | DECIMAL | DEFAULT 0.7 | 随机性 (LLM) |
| media_config | JSONB |  | 采样率、协议等 |
| is_default | SMALLINT | DEFAULT 0 | 默认模型标记 |
| status | SMALLINT | DEFAULT 1 | 启用状态 |
| created_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 创建时间 |
| updated_at | TIMESTAMP(6) | NOT NULL, DEFAULT now() | 更新时间 |
| is_deleted | SMALLINT | DEFAULT 0 | 逻辑删除 |

索引：
- `idx_aimodel_tenant`: `(tenant_id)`
- `idx_aimodel_type`: `(model_type, is_default) WHERE is_deleted = 0`

### 5.5 `biz_meetings`（会议主表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 主键ID |
| tenant_id | BIGINT | NOT NULL | 租户ID |
| title | VARCHAR(200) | NOT NULL | 会议标题 |
| asr_model_id | BIGINT |  | 使用的 ASR 模型 |
| summary_model_id | BIGINT |  | 使用的 LLM 模型 |
| prompt_content | TEXT |  | **[快照]** 发起任务时的提示词模板内容 |
| summary_content | TEXT |  | **[固化]** 最终生成的 Markdown 总结内容 |
| status | SMALLINT | DEFAULT 0 | 0:待处理, 1:识别中, 2:总结中, 3:已完成, 4:失败 |

### 5.6 `biz_meeting_transcripts`（转录明细表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 主键ID |
| meeting_id | BIGINT | NOT NULL | 关联会议ID |
| speaker_label | VARCHAR(50) |  | 发言人标签 |
| content | TEXT |  | 转录文字 |
| start_time | INTEGER |  | 开始时间 (ms) |

### 5.7 `biz_ai_tasks`（AI 任务流水表）
| 字段 | 类型 | 约束 | 说明 |
| --- | --- | --- | --- |
| id | BIGSERIAL | PK | 主键ID |
| task_type | VARCHAR(20) |  | ASR / SUMMARY |
| request_data | JSONB |  | 请求原始数据 |
| response_data | JSONB |  | 响应原始数据 |
| status | SMALLINT |  | 0:排队, 1:处理中, 2:成功, 3:失败 |