GPT Team 管理和兑换码自动邀请系统

一个基于 FastAPI 的 ChatGPT Team 账号管理系统，支持管理员批量管理 Team 账号，用户通过兑换码自动加入 Team。

本项目更新放缓，推荐另一个佬的项目 https://github.com/loLollipop/team-manage-refresh

🚀 Docker 一键部署 & 更新

一键部署

git clone https://github.com/tibbar213/team-manage.git
cd team-manage
cp .env.example .env
docker compose up -d

一键更新

git pull && docker compose down && docker compose up -d --build

✨ 功能特性

管理员功能

• Team 账号管理

  • 单个/批量导入 Team 账号（支持任意格式的 AT Token）
  • 智能识别和提取 AT Token、邮箱、Account ID
  • 自动同步 Team 信息（名称、订阅计划、到期时间、成员数）
  • Team 成员管理（查看、添加、删除成员）
  • Team 状态监控（可用/已满/已过期/错误）

• 兑换码管理

  • 单个/批量生成兑换码
  • 自定义兑换码和有效期
  • 兑换码状态筛选（未使用/已使用/已过期）
  • 导出兑换码为文本文件
  • 删除未使用的兑换码

• 使用记录查询

  • 多维度筛选（邮箱、兑换码、Team ID、日期范围）
  • 分页展示（每页20条记录）
  • 统计数据（总数、今日、本周、本月）

• 系统设置

  • 代理配置（HTTP/SOCKS5）
  • 管理员密码修改
  • 日志级别动态调整
  • 库存预警 Webhook (支持库存不足时自动通知第三方系统补货)

自动化与集成

• 库存预警与自动导入
  • 当可用兑换码低于设置阈值时，自动触发 Webhook 通知
  • 支持第三方程序通过 API 自动导入新 Team 账号
  • 详细对接说明见 integration_docs.md

用户功能

• 兑换流程
  • 输入邮箱和兑换码
  • 自动验证兑换码有效性
  • 展示可用 Team 列表
  • 手动选择或自动分配 Team
  • 自动发送 Team 邀请到用户邮箱

🛠️ 技术栈

• 后端框架: FastAPI 0.109+
• Web 服务器: Uvicorn
• 数据库: SQLite + SQLAlchemy 2.0 + aiosqlite
• 模板引擎: Jinja2
• HTTP 客户端: curl-cffi（模拟浏览器指纹，绕过 Cloudflare 防护）
• 认证: Session-based（bcrypt 密码哈希）
• 加密: cryptography（AES-256-GCM）
• JWT 解析: PyJWT
• 前端: HTML + CSS + 原生 JavaScript

📋 系统要求

• Python 3.10+
• pip（Python 包管理器）
• 操作系统：Windows / Linux / macOS

🚀 快速开始

1. 克隆项目

git clone https://github.com/tibbar213/team-manage.git
cd team-manage

2. 创建虚拟环境

# Windows
python -m venv venv
venv\Scripts\activate

# Linux/macOS
python3 -m venv venv
source venv/bin/activate

3. 安装依赖

pip install -r requirements.txt

4. 配置环境变量

复制 .env.example 为 .env 并修改配置：

cp .env.example .env

编辑 .env 文件：

# 应用配置
APP_NAME=GPT Team 管理系统
APP_VERSION=0.1.0
APP_HOST=0.0.0.0
APP_PORT=8008
DEBUG=True

# 数据库配置（默认使用 SQLite）
DATABASE_URL=sqlite+aiosqlite:///team_manage.db

# 安全配置（生产环境请修改）
SECRET_KEY=your-secret-key-here-change-in-production
ADMIN_PASSWORD=admin123

# 日志配置
LOG_LEVEL=INFO

# 代理配置（可选）
PROXY_ENABLED=False
PROXY=

# JWT 配置
JWT_VERIFY_SIGNATURE=False

5. 初始化数据库

python init_db.py

6. 启动应用

# 开发模式（自动重载）
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8008

# 或者直接运行
python app/main.py

7. 访问应用

• 用户兑换页面: http://localhost:8008/
• 管理员登录页面: http://localhost:8008/login
• 管理员控制台: http://localhost:8008/admin

默认管理员账号:

• 用户名: admin
• 密码: admin123（请在首次登录后修改）

---

🐳 Docker 部署 (推荐)

项目支持使用 Docker 快速部署，确保环境一致性并简化配置。

1. 准备工作

确保你的系统已安装：

• Docker
• Docker Compose

2. 快速启动

1. 克隆项目并进入目录。
2. 配置 .env 文件（参考上述"配置环境变量"章节）。
3. 运行 Docker Compose 命令：

# 构建并启动容器
docker compose up -d

3. 数据持久化

Docker 配置中已自动将宿主机的 team_manage.db 文件映射到容器内部，因此你的数据会自动保存在项目根目录下，容器删除后数据依然存在。

4. 常用命令

# 查看日志
docker compose logs -f

# 停止并移除容器
docker compose down

# 重新构建镜像
docker compose build --no-cache

📁 项目结构

team-manage/
├── app/                        # 应用主目录
│   ├── main.py                 # FastAPI 入口文件
│   ├── config.py               # 配置管理
│   ├── database.py             # 数据库连接
│   ├── models.py               # SQLAlchemy 模型
│   ├── routes/                 # 路由模块
│   │   ├── admin.py            # 管理员路由
│   │   ├── user.py             # 用户路由
│   │   ├── api.py              # API 端点
│   │   ├── auth.py             # 认证路由
│   │   └── redeem.py           # 兑换路由
│   ├── services/               # 业务逻辑服务
│   │   ├── auth.py             # 认证服务
│   │   ├── chatgpt.py          # ChatGPT API 集成
│   │   ├── encryption.py       # 加密服务
│   │   ├── redeem_flow.py      # 兑换流程服务
│   │   ├── redemption.py       # 兑换码管理服务
│   │   ├── settings.py         # 系统设置服务
│   │   └── team.py             # Team 管理服务
│   ├── utils/                  # 工具模块
│   │   ├── jwt_parser.py       # JWT Token 解析
│   │   └── token_parser.py     # Token 正则匹配
│   ├── dependencies/           # FastAPI 依赖
│   │   └── auth.py             # 认证依赖
│   ├── templates/              # Jinja2 模板
│   │   ├── base.html           # 基础布局
│   │   ├── auth/               # 认证页面
│   │   ├── admin/              # 管理员页面
│   │   └── user/               # 用户页面
│   └── static/                 # 静态文件
│       ├── css/                # 样式文件
│       └── js/                 # JavaScript 文件
├── init_db.py                  # 数据库初始化脚本
├── requirements.txt            # Python 依赖
├── Dockerfile                  # Docker 镜像构建文件
├── docker-compose.yml          # Docker 服务编排文件
├── .dockerignore               # Docker 忽略文件
├── .env.example                # 环境变量示例
├── CLAUDE.md                   # Claude Code 指南
├── 需求.md                     # 项目需求文档
├── 任务.md                     # 任务跟踪文档
├── 接口.md                     # API 接口文档
└── README.md                   # 项目说明文档

🔧 配置说明

数据库配置

默认使用 SQLite 数据库，数据库文件为 team_manage.db。如需使用其他数据库，请修改 DATABASE_URL。

代理配置

如果需要通过代理访问 ChatGPT API，可以在管理员面板的"系统设置"中配置代理：

• 支持 HTTP 代理：http://proxy.example.com:8080
• 支持 SOCKS5 代理：socks5://proxy.example.com:1080

安全配置

生产环境部署前，请务必修改以下配置：

1. SECRET_KEY: 用于 Session 签名，请使用随机字符串
2. ADMIN_PASSWORD: 管理员初始密码，首次登录后请立即修改
3. DEBUG: 生产环境请设置为 False

📖 使用指南

管理员操作流程

1. 登录管理员面板

   • 访问 http://localhost:8008/login
   • 使用默认账号登录（admin/admin123）
   • 首次登录后建议修改密码

2. 导入 Team 账号

   • 进入"Team 管理" → "导入 Team"
   • 单个导入：填写 AT Token、邮箱（可选）、Account ID（可选）
   • 批量导入：粘贴包含 AT Token 的文本（支持任意格式）
   • 系统会自动识别和提取信息

3. 生成兑换码

   • 进入"兑换码管理" → "生成兑换码"
   • 单个生成：可自定义兑换码和有效期
   • 批量生成：设置数量和有效期
   • 生成后可复制或下载

4. 查看使用记录

   • 进入"使用记录"
   • 可按邮箱、兑换码、Team ID、日期范围筛选
   • 查看统计数据（总数、今日、本周、本月）

5. 系统设置

   • 进入"系统设置"
   • 配置代理（如需）
   • 修改管理员密码
   • 调整日志级别

用户兑换流程

1. 访问兑换页面

   • 访问 http://localhost:8008/

2. 输入信息

   • 填写邮箱地址
   • 输入兑换码

3. 选择 Team

   • 系统展示可用 Team 列表
   • 手动选择 Team 或点击"自动选择"

4. 完成兑换

   • 系统自动发送邀请到邮箱
   • 查看兑换结果（Team 名称、到期时间）

5. 接受邀请

   • 检查邮箱收到的 ChatGPT Team 邀请邮件
   • 点击邮件中的链接接受邀请

🔌 API 接口

详细的 API 接口文档请参考 接口.md。

主要接口：

• POST /auth/login - 管理员登录
• POST /auth/logout - 管理员登出
• POST /redeem/verify - 验证兑换码
• POST /redeem/confirm - 确认兑换
• GET /admin - 管理员控制台
• GET /admin/teams/import - Team 导入页面
• GET /admin/codes - 兑换码列表
• GET /admin/records - 使用记录

🐛 故障排除

数据库初始化失败

# 删除旧数据库文件
rm team_manage.db

# 重新初始化
python init_db.py

无法访问 ChatGPT API

1. 检查网络连接
2. 配置代理（如需）
3. 检查 AT Token 是否有效
4. 查看日志文件排查错误

导入 Team 失败

1. 确保 AT Token 格式正确
2. 检查 Token 是否过期
3. 验证 Token 是否有 Team 管理权限

群辉 Docker 构建时报 exclude-patterns 非 ASCII 错误

如果在群辉 NAS / Container Manager 上执行 docker compose up -d 时出现类似下面的错误：

failed to solve: ... header key "exclude-patterns" contains value with non-printable ASCII characters

通常是因为较旧的 BuildKit 实现无法处理 .dockerignore 中的非 ASCII 文件名模式。

当前仓库已经改为仅使用 ASCII 的忽略规则。如果你是从旧版本更新上来的，请执行：

git pull
docker compose build --no-cache
docker compose up -d

📄 许可证

本项目仅供学习和研究使用。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

---

注意: 本系统仅用于合法的 ChatGPT Team 账号管理，请遵守 OpenAI 的服务条款。