# GPT Manager 数据库表结构

此项目共有 **6 张表**，用于实现 ChatGPT Team 账号管理与邀请系统。

---

## 1. `admins` - 管理员表

| 字段名 | 类型 | 约束 | 说明 |
|--------|------|------|------|
| `id` | Integer | PK | 主键 |
| `username` | String(50) | UNIQUE, NOT NULL, INDEX | 用户名 |
| `email` | String(120) | UNIQUE, NOT NULL, INDEX | 邮箱 |
| `password_hash` | String(128) | NOT NULL | 密码哈希 (bcrypt) |
| `is_super_admin` | Boolean | NOT NULL, DEFAULT FALSE | 是否超级管理员 |
| `is_active` | Boolean | NOT NULL, DEFAULT TRUE | 是否激活 |
| `created_at` | DateTime | NOT NULL | 创建时间 |
| `last_login` | DateTime | NULLABLE | 最后登录时间 |

**关系**: → `card_keys` (一对多) / → `api_keys` (一对多)

---

## 2. `chatgpt_accounts` - ChatGPT Team 账号表

| 字段名 | 类型 | 约束 | 说明 |
|--------|------|------|------|
| `id` | Integer | PK | 主键 |
| `name` | String(100) | NOT NULL | 账号名称 |
| `email` | String(120) | NOT NULL | 邮箱地址 |
| `auth_token` | Text | NOT NULL | 授权 Token |
| `team_account_id` | String(100) | NOT NULL | Team Account ID (UUID) |
| `max_invitations` | Integer | NOT NULL, DEFAULT 50 | 最大邀请数 |
| `current_invitations` | Integer | NOT NULL, DEFAULT 0 | 当前已用邀请数 |
| `is_active` | Boolean | NOT NULL, DEFAULT TRUE, INDEX | 是否激活 |
| `consecutive_failures` | Integer | NOT NULL, DEFAULT 0 | 连续失败次数 |
| `last_check` | DateTime | NULLABLE | 最后检测时间 |
| `last_used` | DateTime | NULLABLE | 最后使用时间 |
| `created_at` | DateTime | NOT NULL | 创建时间 |
| `updated_at` | DateTime | NULLABLE | 更新时间 |

**关系**: → `invitations` (一对多)

---

## 3. `card_keys` - 卡密表

| 字段名 | 类型 | 约束 | 说明 |
|--------|------|------|------|
| `id` | Integer | PK | 主键 |
| `key` | String(19) | UNIQUE, NOT NULL, INDEX | 卡密 (XXXX-XXXX-XXXX-XXXX) |
| `max_uses` | Integer | NOT NULL, DEFAULT 1 | 最大使用次数 |
| `used_count` | Integer | NOT NULL, DEFAULT 0 | 已使用次数 |
| `validity_type` | String(20) | NOT NULL | 有效期类型 (month/quarter/year/custom) |
| `expires_at` | DateTime | NOT NULL, INDEX | 过期时间 |
| `is_active` | Boolean | NOT NULL, DEFAULT TRUE, INDEX | 是否激活 |
| `created_by_id` | Integer | FK → `admins.id`, NOT NULL | 创建者 |
| `created_at` | DateTime | NOT NULL | 创建时间 |

**关系**: → `invitations` (一对多)

---

## 4. `invitations` - 邀请记录表

| 字段名 | 类型 | 约束 | 说明 |
|--------|------|------|------|
| `id` | Integer | PK | 主键 |
| `card_key_id` | Integer | FK → `card_keys.id`, NULLABLE, INDEX | 关联卡密 |
| `account_id` | Integer | FK → `chatgpt_accounts.id`, NOT NULL, INDEX | 关联账号 |
| `invited_email` | String(120) | NOT NULL, INDEX | 被邀请邮箱 |
| `status` | String(20) | NOT NULL, DEFAULT 'pending', INDEX | 状态 |
| `error_message` | Text | NULLABLE | 错误信息 |
| `expires_at` | DateTime | NULLABLE | 邀请过期时间 |
| `created_at` | DateTime | NOT NULL, INDEX | 创建时间 |
| `updated_at` | DateTime | NULLABLE | 更新时间 |
| `api_response` | Text | NULLABLE | API 响应 (JSON) |

**状态值**: `pending` / `sent` / `accepted` / `failed` / `expired`

---

## 5. `api_keys` - API 密钥表

| 字段名 | 类型 | 约束 | 说明 |
|--------|------|------|------|
| `id` | Integer | PK | 主键 |
| `key` | String(64) | UNIQUE, NOT NULL, INDEX | API Key (sk_live_xxx) |
| `name` | String(100) | NOT NULL | 名称 |
| `created_by_id` | Integer | FK → `admins.id`, NOT NULL | 创建者 |
| `is_active` | Boolean | NOT NULL, DEFAULT TRUE, INDEX | 是否激活 |
| `rate_limit` | Integer | NOT NULL, DEFAULT 60 | 速率限制 (次/分钟) |
| `allowed_ips` | Text | DEFAULT '[]' | IP 白名单 (JSON 数组) |
| `last_used` | DateTime | NULLABLE | 最后使用时间 |
| `request_count` | Integer | NOT NULL, DEFAULT 0 | 请求计数 |
| `created_at` | DateTime | NOT NULL | 创建时间 |

---

## 6. `system_settings` - 系统配置表

| 字段名 | 类型 | 约束 | 说明 |
|--------|------|------|------|
| `id` | Integer | PK | 主键 |
| `key` | String(100) | UNIQUE, NOT NULL, INDEX | 配置键名 |
| `value` | Text | NOT NULL | 配置值 |
| `value_type` | String(20) | NOT NULL, DEFAULT 'string' | 值类型 (string/int/float/bool/json) |
| `description` | String(255) | NULLABLE | 配置描述 |
| `updated_at` | DateTime | NULLABLE | 更新时间 |

**默认配置项**:
| 键名 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `turnstile_enabled` | bool | false | Cloudflare Turnstile 开关 |
| `turnstile_site_key` | string | '' | Turnstile Site Key |
| `turnstile_secret_key` | string | '' | Turnstile Secret Key |
| `token_check_interval` | int | 6 | Token 检测间隔（小时）|
| `token_failure_threshold` | int | 2 | 连续失败禁用阈值 |
| `invitation_validity_days` | int | 30 | 邀请有效期（天）|
| `site_title` | string | 'ChatGPT Team 邀请' | 站点标题 |

---

## ER 关系图

```
┌─────────────┐       ┌──────────────────┐       ┌─────────────┐
│   admins    │       │ chatgpt_accounts │       │  card_keys  │
├─────────────┤       ├──────────────────┤       ├─────────────┤
│ id (PK)     │───┐   │ id (PK)          │───┐   │ id (PK)     │
│ username    │   │   │ name             │   │   │ key         │
│ email       │   │   │ auth_token       │   │   │ max_uses    │
│ password    │   │   │ team_account_id  │   │   │ expires_at  │
└─────────────┘   │   └──────────────────┘   │   └─────────────┘
      │           │             │             │         │
      │           │             │             │         │
      ▼           │             ▼             │         ▼
┌─────────────┐   │   ┌──────────────────┐   │         │
│  api_keys   │   │   │   invitations    │◄──┴─────────┘
├─────────────┤   │   ├──────────────────┤
│ id (PK)     │   │   │ id (PK)          │
│ key         │   │   │ account_id (FK)  │
│created_by_id│◄──┘   │ card_key_id (FK) │
└─────────────┘       │ invited_email    │
                      │ status           │
                      └──────────────────┘

┌──────────────────┐
│ system_settings  │
├──────────────────┤
│ id (PK)          │
│ key              │
│ value            │
│ value_type       │
└──────────────────┘
```