loLollipop / team-manage-refresh

GPT Team 车位管理与兑换系统 一个基于 FastAPI 的 ChatGPT Team 管理系统，围绕「账号导入 → 兑换分配 → 质保售后 → 库存预警」完整流程设计，适合需要稳定管理 Team 车位与兑换业务的场景。 🚀 Docker 一键部署 & 更新 一键部署 一键更新 覆盖旧项目（重写历史/强推后推荐） ✨ 功能特性 管理员功能 • **Team 账号管理** • 单个/批量导入 Team 账号（支持 Access Token / Refresh Token / Session Token / Client ID） • 智能识别和提取 AT Token、邮箱、Account ID（支持从混合文本中提取） • 自动同步 Team 信息（名称、订阅计划、到期时间、成员数） • Team 成员管理（查看、添加、删除成员） • Team 状态监控（可用/已满/已过期/错误） • 支持 OAuth 授权链接生成与回调解析，便于获取和整理导入凭据 • **兑换码管理** • 单个/批量生成兑换码 • 自定义兑换码和有效期 • 支持质保兑换码（可配置质保天数） • 兑换码状态筛选（未使用/已使用/已过期） • 导出兑换码为文本文件 • 删除未使用的兑换码 • **使用记录查询** • 多维度筛选（邮箱、兑换码、Team ID、日期范围） • 分页展示（每页20条记录） • 统计数据（总数、今日、本周、本月） • **系统设置** • 代理配置（HTTP/SOCKS5） • 管理员密码修改 • 日志级别动态调整 • Token 预刷新频率与刷新窗口配置（降低过期导致的可用性问题） • **库存预警 Webhook**（基于剩余可用车位自动通知补货系统） • 顶部导航分区切换（点击标签仅显示当前设置板块，无需长页面滚动） • **公告通知管理**（支持 Markdown 公告，用户访问兑换页时弹窗展示） • **福利车位（独立池）** • 福利 Team 与常规 Team 完全分池管理（导入、列表、兑换逻辑独立） • 福利通用兑换码为 settings 管理的虚拟码（新码生成会立即使旧码失效） • 福利通用码卡片支持单行紧凑展示、悬停查看完整码，并可一键复制 • 福利通用码剩余次数按“可邀请席位”统计（ ），更贴合实际可拉人数量 • 控制台保留原始 Team ID 展示，福利页使用独立“编号”便于单独核对 • **售后与风控能力** • 质保查询：支持按邮箱或兑换码追溯历史记录 • 设备身份验证：支持用户一键开启 Device Code Auth • Team 封禁关联追踪：辅助判断是否可复用或重新分配 自动化与集成 • **库存预警与自动导入** • 当可用兑换码低于设置阈值时，自动触发 Webhook 通知 • 支持第三方程序通过 API 自动导入新 Team 账号 • 内置定时任务：Token 预刷新 + Team 周期状态同步（默认 7 天维度） • 详细对接说明见 integration_docs.md 用户功能 • **兑换流程** • 输入邮箱和兑换码 • 自动验证兑换码有效性 • 展示可用 Team 列表 • 手动选择或自动分配 Team • 自动发送 Team 邀请到用户邮箱 • 兑换首页显示常规车位与福利车位剩余数量 • **公告弹窗** • 管理员启用公告后，用户打开兑换页会自动弹出公告 • 公告内容支持 Markdown（标题、列表、加粗、链接） 🛠️ 技术栈 • **后端框架**: FastAPI 0.109+ • **Web 服务器**: Uvicorn • **数据库**: SQLite + SQLAlchemy 2.0 + aiosqlite • **模板引擎**: Jinja2 • **HTTP 客户端**: curl-cffi（模拟浏览器指纹，绕过 Cloudflare 防护） • **调度任务**: APScheduler（Token 预刷新、Team 周期同步） • **认证**: Session-based（bcrypt 密码哈希） • **加密**: cryptography（AES-256-GCM） • **JWT 解析**: PyJWT • **前端**: HTML + CSS + 原生 JavaScript 📋 系统要求 • Python 3.10+ • pip（Python 包管理器） • 操作系统：Windows / Linux / macOS 🚀 快速开始 • 克隆项目 • 创建虚拟环境 • 安装依赖 • 配置环境变量 复制 为 并修改配置： 编辑 文件： • 初始化数据库 • 启动应用 • 访问应用 • **用户兑换页面**: http://localhost:8008/ • **管理员登录页面**: http://localhost:8008/login • **管理员控制台**: http://localhost:8008/admin • **福利车位管理页面**: http://localhost:8008/admin/welfare **默认管理员账号**: • 用户名: • 密码: （请在首次登录后修改） --- 🐳 Docker 部署 (推荐) 项目支持使用 Docker 快速部署，确保环境一致性并简化配置。 • 准备工作 确保你的系统已安装： • Docker • Docker Compose • 快速启动 • 克隆项目并进入目录。 • 配置 文件（参考上述"配置环境变量"章节）。 • 运行 Docker Compose 命令： • 数据持久化 Docker 配置中已自动将宿主机的 文件映射到容器内部，因此你的数据会自动保存在项目根目录下，容器删除后数据依然存在。 • 常用命令 📁 项目结构 🔧 配置说明 数据库配置 默认使用 SQLite 数据库，数据库文件为 。如需使用其他数据库，请修改 。 代理配置 如果需要通过代理访问 ChatGPT API，可以在管理员面板的"系统设置"中配置代理： • 支持 HTTP 代理： • 支持 SOCKS5 代理： 安全配置 **生产环境部署前，请务必修改以下配置**： • : 用于 Session 签名，请使用随机字符串 • : 管理员初始密码，首次登录后请立即修改 • : 生产环境请设置为 📖 使用指南 管理员操作流程 • **登录管理员面板** • 访问 http://localhost:8008/login • 使用默认账号登录（admin/admin123） • 首次登录后建议修改密码 • **导入 Team 账号** • 进入"Team 管理" → "导入 Team" • 单个导入支持两种模式： • 一键获取 Token（授权链接 → 粘贴回调 → 解析自动填充 → 导入） • 已有 Token 直接填写（手动模式） • 批量导入支持 JSON 文件一键选择导入 • 系统会自动识别并尽量补全邮箱、Account ID 等信息 • **生成兑换码** • 进入"兑换码管理" → "生成兑换码" • 单个生成：可自定义兑换码和有效期 • 批量生成：设置数量和有效期 • 生成后可复制或下载 • **查看使用记录与售后状态** • 进入"使用记录" • 可按邮箱、兑换码、Team ID、日期范围筛选 • 查看统计数据（总数、今日、本周、本月） • 需要售后时，可通过质保查询快速定位原始兑换记录 • **系统设置与公告** • 进入"系统设置"可配置代理、修改密码、调整日志级别、Token 刷新与库存预警 • 设置页支持顶部导航标签切换，仅显示当前板块，便于快速操作 • 进入"公告通知"可编辑 Markdown 公告并控制是否启用弹窗 用户兑换流程 • **访问兑换页面** • 访问 http://localhost:8008/ • **输入信息** • 填写邮箱地址 • 输入兑换码 • **选择 Team** • 系统展示可用 Team 列表 • 手动选择 Team 或点击"自动选择" • **完成兑换** • 系统自动发送邀请到邮箱 • 查看兑换结果（Team 名称、到期时间） • **接受邀请** • 检查邮箱收到的 ChatGPT Team 邀请邮件 • 点击邮件中的链接接受邀请 🔌 API 接口 详细的 API 接口文档请参考 接口.md。 主要接口： • - 管理员登录 • - 管理员登出 • - 验证兑换码 • - 确认兑换 • - 管理员控制台 • - Team 导入页面 • - 兑换码列表 • - 使用记录 • - 查询兑换码/邮箱质保状态 • - 开启设备身份验证 🐛 故障排除 数据库初始化失败 无法访问 ChatGPT API • 检查网络连接 • 配置代理（如需） • 检查 AT Token 是否有效 • 查看日志文件排查错误 导入 Team 失败 • 确保 AT Token 格式正确 • 检查 Token 是否过期 • 验证 Token 是否有 Team 管理权限 📄 许可证 本仓库当前采用 MIT License。 🤝 贡献 欢迎提交 Issue 和 Pull Request！ --- **注意**: 本系统仅用于合法的 ChatGPT Team 账号管理，请遵守 OpenAI 的服务条款。