数据库字典

> **文档版本**: v1.0.0
> **创建日期**: 2026-02-12
> **最后更新**: 2026-02-12
> **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组
> **状态**: [最新]

> **搜索标签**: 数据库, 表结构, 数据字典, 数据模型, schema, 表定义
---

# 数据库字典

## 概述

本文档详细介绍了企业管理数字化中台的数据库表结构、字段定义、索引和关联关系。

## 核心表

### 1. saas_users（用户表）

存储系统用户信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| user_no | varchar(32) | 是 | 用户编号（唯一） |
| tenant_id | varchar(36) | 否 | 所属租户 ID |
| company_id | varchar(36) | 否 | 所属企业 ID |
| username | varchar(50) | 是 | 用户名（唯一） |
| email | varchar(100) | 是 | 邮箱（唯一） |
| phone | varchar(20) | 否 | 手机号 |
| real_name | varchar(50) | 是 | 真实姓名 |
| avatar_url | text | 否 | 头像 URL |
| role | varchar(30) | 是 | 角色（ADMIN, PARTNER, COMPANY_ADMIN, EMPLOYEE） |
| status | varchar(20) | 是 | 状态（ACTIVE, INACTIVE） |
| password | text | 否 | 密码（加密） |
| last_login_at | timestamp | 否 | 最后登录时间 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |
| employee_id | integer | 否 | 关联员工 ID |
| roles | jsonb | 否 | 角色列表 |
| permissions | jsonb | 否 | 权限列表 |
| is_admin | boolean | 否 | 是否管理员 |
| can_export | boolean | 否 | 是否可以导出 |
| allowed_modules | jsonb | 否 | 允许访问的模块 |

**索引**:
- `saas_users_tenant_id_idx`
- `saas_users_company_id_idx`
- `saas_users_role_idx`
- `saas_users_email_idx`
- `saas_users_user_no_idx`

### 2. saas_tenants（租户表）

存储 SaaS 租户信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| tenant_no | varchar(32) | 是 | 租户编号（唯一） |
| tenant_name | varchar(200) | 是 | 租户名称 |
| contact_name | varchar(50) | 否 | 联系人姓名 |
| contact_phone | varchar(20) | 否 | 联系人电话 |
| contact_email | varchar(100) | 否 | 联系人邮箱 |
| status | varchar(20) | 是 | 状态（ACTIVE, INACTIVE） |
| logo_url | text | 否 | Logo URL |
| theme_color | varchar(20) | 否 | 主题颜色 |
| login_page_text | text | 否 | 登录页文案 |
| balance | numeric(15,2) | 是 | 余额 |
| commission_rate | numeric(5,2) | 是 | 佣金比例 |
| enable_custom_storage | boolean | 是 | 启用自定义对象存储 |
| storage_provider | varchar(20) | 否 | 存储提供商 |
| storage_endpoint | text | 否 | 存储端点 |
| storage_access_key | varchar(500) | 否 | 存储访问密钥 |
| storage_secret_key | varchar(500) | 否 | 存储密钥 |
| storage_bucket | varchar(200) | 否 | 存储桶 |
| storage_region | varchar(50) | 否 | 存储区域 |
| storage_domain | varchar(500) | 否 | 存储域名 |
| storage_zone | varchar(10) | 否 | 存储区域 |
| enable_custom_payment | boolean | 是 | 启用自定义支付 |
| payment_wechat_app_id | varchar(200) | 否 | 微信支付 App ID |
| payment_wechat_app_secret | varchar(500) | 否 | 微信支付 App Secret |
| payment_alipay_app_id | varchar(200) | 否 | 支付宝 App ID |
| payment_alipay_app_secret | varchar(500) | 否 | 支付宝 App Secret |
| enable_custom_sms | boolean | 是 | 启用自定义短信 |
| sms_access_key_id | varchar(200) | 否 | 短信 Access Key |
| sms_secret_key | varchar(500) | 否 | 短信 Secret Key |
| sms_sign_name | varchar(100) | 否 | 短信签名 |
| sms_template_code | varchar(200) | 否 | 短信模板代码 |
| enable_custom_email | boolean | 是 | 启用自定义邮件 |
| email_host | varchar(200) | 否 | 邮件服务器 |
| email_port | integer | 否 | 邮件端口 |
| email_secure | boolean | 是 | 是否使用 SSL |
| email_user | varchar(200) | 否 | 邮件用户名 |
| email_password | varchar(500) | 否 | 邮件密码 |
| email_from | varchar(200) | 否 | 邮件发件人 |
| email_from_name | varchar(200) | 否 | 邮件发件人名称 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

### 3. saas_companies（企业表）

存储企业客户信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| company_no | varchar(32) | 是 | 企业编号（唯一） |
| tenant_id | varchar(36) | 是 | 所属租户 ID |
| company_name | varchar(200) | 是 | 企业名称 |
| unified_credit_code | varchar(18) | 否 | 统一社会信用代码 |
| industry_type | varchar(50) | 否 | 行业类型 |
| scale | varchar(20) | 否 | 企业规模 |
| contact_name | varchar(50) | 是 | 联系人姓名 |
| contact_phone | varchar(20) | 是 | 联系人电话 |
| contact_email | varchar(100) | 否 | 联系人邮箱 |
| address | text | 否 | 地址 |
| company_type | varchar(50) | 否 | 企业类型 |
| username | varchar(50) | 是 | 管理员用户名 |
| password | varchar(200) | 否 | 管理员密码 |
| status | varchar(20) | 是 | 状态（NORMAL, FROZEN） |
| service_version | varchar(50) | 是 | 服务版本 |
| service_start_date | timestamp | 否 | 服务开始日期 |
| service_end_date | timestamp | 否 | 服务结束日期 |
| employee_count | integer | 是 | 员工数量 |
| features | jsonb | 是 | 功能配置 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| last_login_at | timestamp | 否 | 最后登录时间 |
| is_deleted | boolean | 是 | 是否删除 |

### 4. salary_slips（工资条表）

存储工资条信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| slip_no | varchar(32) | 是 | 工资条编号（唯一） |
| company_id | varchar(36) | 是 | 所属企业 ID |
| tenant_id | varchar(36) | 是 | 所属租户 ID |
| employee_id | varchar(36) | 是 | 员工 ID |
| employee_name | varchar(50) | 是 | 员工姓名 |
| employee_no | varchar(32) | 是 | 员工编号 |
| department | varchar(50) | 否 | 部门 |
| salary_period | varchar(20) | 是 | 薪资期间（YYYY-MM） |
| gross_salary | numeric(15,2) | 是 | 税前工资 |
| net_salary | numeric(15,2) | 是 | 税后工资 |
| details | jsonb | 是 | 工资明细 |
| status | varchar(20) | 是 | 状态（DRAFT, SENT, READ, SIGNED） |
| sent_at | timestamp | 否 | 发送时间 |
| sent_method | varchar(20) | 否 | 发送方式（EMAIL, SMS, WECHAT） |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

**索引**:
- `salary_slips_company_id_idx`
- `salary_slips_employee_id_idx`
- `salary_slips_salary_period_idx`
- `salary_slips_slip_no_idx`
- `salary_slips_status_idx`
- `salary_slips_tenant_id_idx`

### 5. saas_orders（订单表）

存储订单信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| order_no | varchar(32) | 是 | 订单编号（唯一） |
| tenant_id | varchar(36) | 是 | 所属租户 ID |
| company_id | varchar(36) | 是 | 所属企业 ID |
| order_type | varchar(20) | 是 | 订单类型 |
| package_name | varchar(100) | 否 | 套餐名称 |
| package_features | jsonb | 是 | 套餐功能 |
| amount | numeric(15,2) | 是 | 订单金额 |
| discount_amount | numeric(15,2) | 是 | 折扣金额 |
| actual_amount | numeric(15,2) | 是 | 实际支付金额 |
| start_date | timestamp | 否 | 开始日期 |
| end_date | timestamp | 否 | 结束日期 |
| status | varchar(20) | 是 | 状态（PENDING, PAID, CANCELLED） |
| payment_method | varchar(20) | 否 | 支付方式 |
| payment_time | timestamp | 否 | 支付时间 |
| remark | text | 否 | 备注 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

## 配置表

### 6. salary_configs（薪资配置表）

存储薪资配置信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| company_id | varchar(36) | 是 | 所属企业 ID |
| config_name | varchar(100) | 是 | 配置名称 |
| description | text | 否 | 描述 |
| effective_date | timestamp | 是 | 生效日期 |
| expiry_date | timestamp | 否 | 失效日期 |
| is_active | boolean | 是 | 是否激活 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

### 7. salary_item_configs（薪资项配置表）

存储薪资项配置信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| salary_config_id | varchar(36) | 是 | 所属薪资配置 ID |
| item_code | varchar(50) | 是 | 薪资项代码 |
| item_name | varchar(100) | 是 | 薪资项名称 |
| item_type | varchar(20) | 是 | 薪资项类型（ADD, SUBTRACT） |
| calculation_formula | text | 否 | 计算公式 |
| is_taxable | boolean | 是 | 是否应税 |
| is_social_insurance_base | boolean | 是 | 是否社保基数 |
| sort_order | integer | 是 | 排序 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

### 8. social_insurance_configs（社保配置表）

存储社保配置信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| company_id | varchar(36) | 是 | 所属企业 ID |
| insurance_type | varchar(20) | 是 | 保险类型（PENSION, MEDICAL, UNEMPLOYMENT, PROVIDENT_FUND） |
| company_rate | numeric(5,4) | 是 | 企业费率 |
| employee_rate | numeric(5,4) | 是 | 员工费率 |
| base_lower_limit | numeric(15,2) | 是 | 基数下限 |
| base_upper_limit | numeric(15,2) | 否 | 基数上限 |
| is_enabled | boolean | 是 | 是否启用 |
| effective_date | timestamp | 是 | 生效日期 |
| expiry_date | timestamp | 否 | 失效日期 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

### 9. tax_rate_tables（税率表）

存储个税税率信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| company_id | varchar(36) | 是 | 所属企业 ID |
| table_name | varchar(100) | 是 | 表名称 |
| effective_date | timestamp | 是 | 生效日期 |
| expiry_date | timestamp | 否 | 失效日期 |
| is_default | boolean | 是 | 是否默认 |
| threshold | numeric(15,2) | 是 | 起征点 |
| rate | numeric(5,4) | 是 | 税率 |
| deduction | numeric(15,2) | 是 | 速算扣除数 |
| level | integer | 是 | 级别 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

### 10. employee_social_insurance（员工社保表）

存储员工社保信息。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| employee_id | varchar(36) | 是 | 员工 ID |
| company_id | varchar(36) | 是 | 所属企业 ID |
| base_salary | numeric(15,2) | 是 | 基数工资 |
| pension_base | numeric(15,2) | 是 | 养老保险基数 |
| medical_base | numeric(15,2) | 是 | 医疗保险基数 |
| unemployment_base | numeric(15,2) | 是 | 失业保险基数 |
| provident_fund_base | numeric(15,2) | 是 | 公积金基数 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

## CRM 表

### 11. crm_follow_records（跟进记录表）

存储 CRM 跟进记录。

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | varchar(36) | 是 | 主键（UUID） |
| follow_no | varchar(32) | 是 | 跟进编号（唯一） |
| tenant_id | varchar(36) | 是 | 所属租户 ID |
| target_id | varchar(36) | 是 | 目标对象 ID |
| target_type | varchar(20) | 是 | 目标类型（LEAD, CUSTOMER） |
| owner_id | varchar(36) | 是 | 负责人 ID |
| follow_method | varchar(20) | 是 | 跟进方式（PHONE, EMAIL, VISIT） |
| follow_stage | varchar(20) | 是 | 跟进阶段 |
| follow_content | text | 否 | 跟进内容 |
| next_contact_time | timestamp | 否 | 下次联系时间 |
| created_at | timestamp | 是 | 创建时间 |
| updated_at | timestamp | 否 | 更新时间 |
| is_deleted | boolean | 是 | 是否删除 |

## 索引策略

### 主键索引
所有表的主键都使用 UUID，并通过 B-tree 索引优化查询性能。

### 唯一索引
- `saas_users`: username, email, user_no
- `saas_tenants`: tenant_no
- `saas_companies`: company_no, username
- `salary_slips`: slip_no
- `crm_follow_records`: follow_no

### 查询索引
根据常用查询条件建立的索引：
- `saas_users`: tenant_id, company_id, role
- `saas_companies`: tenant_id
- `salary_slips`: company_id, employee_id, salary_period, status, tenant_id
- `crm_follow_records`: tenant_id, target_id, owner_id, next_contact_time

## 数据关系

### 核心关系
```
saas_tenants (1) ── (N) saas_users
saas_tenants (1) ── (N) saas_companies
saas_companies (1) ── (N) saas_users
saas_companies (1) ── (N) salary_slips
saas_companies (1) ── (N) salary_configs
salary_configs (1) ── (N) salary_item_configs
```

### 配置关系
```
saas_companies (1) ── (N) social_insurance_configs
saas_companies (1) ── (N) tax_rate_tables
salary_slips (N) ── (1) employee_social_insurance
```

### CRM 关系
```
saas_tenants (1) ── (N) crm_follow_records
saas_users (1) ── (N) crm_follow_records (as owner)
```

## 数据类型说明

### 基础类型
- `varchar(n)`: 变长字符串，n 为最大长度
- `text`: 不限长文本
- `timestamp`: 时间戳（带时区）
- `boolean`: 布尔值
- `integer`: 整数
- `numeric(p,s)`: 精确数值，p 为总位数，s 为小数位数
- `jsonb`: JSON 二进制格式，支持索引

### 时间戳格式
所有时间戳字段使用 `timestamp with time zone` 格式，存储为 UTC 时间。

### JSONB 字段
- `details`: 工资条明细，存储薪资项和金额
- `features`: 功能配置，存储企业可用的功能列表
- `roles`: 角色列表，字符串数组
- `permissions`: 权限列表，字符串数组

## 数据完整性

### 软删除
所有表都包含 `is_deleted` 字段，实现软删除功能，默认值为 `false`。

### 默认值
- `created_at`: 当前时间
- `is_deleted`: false
- `status`: 根据表结构设置默认值

### 必填字段
所有标记为"必填"的字段在创建记录时必须提供值。

## 性能优化建议

### 查询优化
1. 使用索引字段进行查询
2. 避免在 WHERE 条件中使用函数
3. 使用 LIMIT 分页查询
4. 避免使用 `SELECT *`

### 索引优化
1. 为常用查询条件添加索引
2. 定期分析索引使用情况
3. 删除不再使用的索引
4. 避免过多的索引影响写入性能

### 数据归档
1. 定期归档历史数据
2. 使用分区表存储大量历史数据
3. 定期清理软删除的数据

## 数据安全

### 敏感字段加密
- `password`: 使用 bcrypt 加密
- `storage_secret_key`: 加密存储
- `sms_secret_key`: 加密存储
- `email_password`: 加密存储
- `payment_*_app_secret`: 加密存储

### 访问控制
- 基于租户的数据隔离
- 基于角色的权限控制
- 行级数据安全

## 备份策略

### 备份频率
- 每日全量备份
- 每小时增量备份

### 保留策略
- 全量备份保留 30 天
- 增量备份保留 7 天

### 恢复策略
- 支持 Point-in-Time Recovery (PITR)
- 快速恢复最近 24 小时的数据