# CursorPro 后台管理系统

基于 FastAPI 的 Cursor 账号管理和激活码系统，兼容原 CursorPro 插件 API。

## 功能特性

- 账号管理：导入、编辑、删除 Cursor 账号
- 激活码系统：生成、管理激活码，支持换号次数限制
- Web 管理后台：Vue.js + Tailwind CSS 构建的现代化界面
- 客户端 API：完全兼容原 CursorPro 插件

## 快速开始

### 方式一：本地运行

1. **安装 MySQL 数据库**

2. **配置环境**
   ```bash
   # 复制配置文件
   cp .env.example .env

   # 编辑 .env 填入数据库信息
   ```

3. **启动服务**
   ```bash
   # Windows
   start.bat

   # Linux/Mac
   chmod +x start.sh
   ./start.sh
   ```

4. **访问管理后台**
   - 地址: http://localhost:8000
   - 默认账号: admin / admin123

### 方式二：Docker 部署

```bash
# 启动 MySQL + 后台服务
docker-compose up -d

# 查看日志
docker-compose logs -f backend
```

## API 文档

启动后访问 http://localhost:8000/docs 查看 Swagger API 文档。

### 客户端 API（兼容原插件）

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/verify-key` | POST | 验证激活码 |
| `/api/switch-account` | POST | 切换账号 |
| `/api/version` | GET | 获取版本信息 |

### 管理 API

| 接口 | 方法 | 说明 |
|------|------|------|
| `/admin/login` | POST | 管理员登录 |
| `/admin/dashboard` | GET | 仪表盘统计 |
| `/admin/accounts` | GET/POST | 账号列表/创建 |
| `/admin/accounts/import` | POST | 批量导入账号 |
| `/admin/keys` | GET/POST | 激活码列表/生成 |

## 账号数据格式

导入账号时使用 JSON 格式：

```json
[
  {
    "email": "user@example.com",
    "access_token": "...",
    "refresh_token": "...",
    "workos_session_token": "...",
    "membership_type": "pro"
  }
]
```

## 目录结构

```
backend/
├── app/
│   ├── api/           # API 路由
│   │   ├── admin.py   # 管理后台 API
│   │   └── client.py  # 客户端 API（兼容原插件）
│   ├── models/        # 数据库模型
│   ├── schemas/       # Pydantic 数据模式
│   ├── services/      # 业务逻辑
│   ├── config.py      # 配置
│   ├── database.py    # 数据库连接
│   └── main.py        # 应用入口
├── templates/         # HTML 模板
├── static/           # 静态文件
├── .env.example      # 环境变量示例
├── docker-compose.yml
├── Dockerfile
├── requirements.txt
├── run.py            # 启动脚本
└── start.bat/sh      # 快捷启动
```

## 配置说明

`.env` 文件配置项：

| 变量 | 说明 | 默认值 |
|------|------|--------|
| DB_HOST | 数据库地址 | localhost |
| DB_PORT | 数据库端口 | 3306 |
| DB_USER | 数据库用户 | root |
| DB_PASSWORD | 数据库密码 | - |
| DB_NAME | 数据库名 | cursorpro |
| JWT_SECRET_KEY | JWT 密钥 | - |
| ADMIN_USERNAME | 管理员账号 | admin |
| ADMIN_PASSWORD | 管理员密码 | admin123 |

## 安全提示

- 生产环境请修改 `JWT_SECRET_KEY`
- 修改默认管理员密码
- 建议使用 HTTPS