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

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

✨ 功能特性

管理员功能

• Team 账号管理

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

• 兑换码管理

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

• 使用记录查询

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

• 系统设置

  • 代理配置（HTTP/SOCKS5）
  • 管理员密码修改
  • 日志级别动态调整

用户功能

• LinuxDo 账号体系（仅此一种登录/注册方式）

  • 通过 LinuxDo OAuth 登录
  • 首次登录自动注册本地用户

• 积分系统

  • 每日签到领取积分
  • 记录积分变动流水

• 积分商城

  • 使用积分购买兑换码
  • 订单记录可追踪

• 兑换流程

  • 输入邮箱和兑换码
  • 自动验证兑换码有效性
  • 展示可用 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

<EFBFBD> 快速开始 (Docker 部署，推荐)

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

1. 准备工作

确保你的系统已安装：

• Docker
• Docker Compose

2. 创建目录和配置文件

新建一个目录并进入：

mkdir team-manage && cd team-manage

创建 docker-compose.yml 文件：

services:
  app:
    image: npckf/team-manage:latest
    container_name: team-manage-app
    ports:
      - "${APP_PORT:-8008}:${APP_PORT:-8008}"
    volumes:
      - ./data:/app/data
      - ./.env:/app/.env
    restart: always
    environment:
      - DATABASE_URL=sqlite+aiosqlite:////app/data/team_manage.db

创建 .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

# 💡 注意提示 💡
# LinuxDo OAuth 配置、积分商城配置、网站公告、系统维护模式、外部 API、质保天数及所有系统级的动态设置，
# 现已全面迁移至 管理员后台（/admin/settings）通过图形界面动态配置，无需且不应在 .env 中设置。

3. 启动应用

# 拉取镜像并启动容器
docker compose up -d

Docker 配置中已自动将宿主机的 data/ 目录和 .env 文件映射到容器内部，因此你的数据会自动保存在项目根目录下，容器重启或升级更新时数据依然存在。

4. 访问应用

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

默认管理员账号:

• 用户名: admin
• 密码: admin123（建议在首次登录后在后台修改密码配置）

5. 常用 Docker 命令

# 查看日志
docker compose logs -f

# 停止并移除容器
docker compose down

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

---

💻 源码运行 (二选一，面向开发者)

1. 创建虚拟环境

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

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

2. 安装依赖

pip install -r requirements.txt

3. 初始化数据库

python init_db.py

4. 启动应用

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

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

📁 项目结构

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 管理权限

📄 许可证

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

🤝 贡献

欢迎提交 Issue 和 Pull Request！

---

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