# 游铛铛产品技术方案 - 总览

## 一、产品概述

### 1.1 产品信息
- **产品品牌名称**：游铛铛
- **产品功能**：Buff平台选品 + Steam平台扫货
- **产品销售模式**：客户端exe需要激活后使用
- **产品特征码**：buff-xp-steam-sh（标识Buff选品、Steam扫货软件）

### 1.2 系统架构

产品分为三个部分：

```
┌─────────────────┐
│   客户端exe     │  Windows桌面应用
│  (PyQt6+Python) │
└────────┬────────┘
         │ HTTP + RSA加密
         ▼
┌─────────────────┐
│   后台API端      │  Python Flask/FastAPI
│  (统一接口服务)  │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   MySQL数据库   │  47.99.164.66:3306
└─────────────────┘
         ▲
         │
┌────────┴────────┐
│   管理web端     │  React/Vue + Chrome浏览器
│  (后台管理)     │
└─────────────────┘
```

## 二、技术选型

### 2.1 客户端exe技术栈

| 技术组件 | 选型 | 说明 |
|---------|------|------|
| **编程语言** | Python 3.10+ | 开发效率高，代码简洁 |
| **桌面框架** | PyQt6 | Qt的Python绑定，功能完整 |
| **浏览器自动化** | Playwright | 比Selenium更强大的自动化能力 |
| **加密库** | cryptography | RSA加密，支持密钥轮换 |
| **打包工具** | PyInstaller | 打包为exe |
| **代码保护** | PyArmor + Nuitka | 代码混淆和编译保护 |
| **Steam集成** | subprocess + SDA | Steam Desktop Authenticator |

### 2.2 管理web端技术栈

| 技术组件 | 选型 | 说明 |
|---------|------|------|
| **前端框架** | React / Vue 3 | 现代化前端框架 |
| **UI组件库** | Ant Design / Element Plus | 企业级UI组件 |
| **HTTP客户端** | Axios | API请求 |
| **状态管理** | Redux / Pinia | 状态管理 |
| **构建工具** | Vite / Webpack | 打包构建 |

### 2.3 后台API端技术栈

| 技术组件 | 选型 | 说明 |
|---------|------|------|
| **Web框架** | FastAPI / Flask | Python Web框架 |
| **数据库** | MySQL 8.0 | 关系型数据库 |
| **ORM** | SQLAlchemy | 数据库ORM |
| **加密** | cryptography | RSA加密，密钥管理 |
| **API文档** | Swagger/OpenAPI | API文档自动生成 |

### 2.4 数据库信息

- **服务器**：47.99.164.66:3306
- **数据库名**：buff
- **用户名**：root
- **密码**：hn02le.34lkdLKD

## 三、核心功能模块

### 3.1 客户端exe功能

1. **登录注册模块**
   - 用户登录/注册
   - 机器码绑定/解绑
   - 卡密激活
   - 免登录功能

2. **主界面模块**
   - 头部区域（Logo、有效期、用户名、退出）
   - 左侧菜单（充值、Steam账号绑定、选品、扫货、公告）
   - 右侧Tab页系统

3. **扫货模块**（核心难点）
   - 内置Chrome浏览器
   - Chrome插件支持
   - 浏览器自动化操作
   - 数据抓取和处理

4. **Steam集成模块**
   - Steam账号绑定
   - Steam Guard验证码生成
   - 交易确认

5. **安全模块**
   - 接口加密（RSA）
   - 密钥轮换（每10天）
   - 许可证验证
   - 心跳检测

### 3.2 管理web端功能

1. **用户管理**
   - 管理员登录/退出
   - 注册用户信息查看

2. **软件管理**
   - 软件特征码管理
   - 收费基数配置（每天多少钱）

3. **卡密管理**
   - 卡密生成（按特征码、天数、折扣）
   - 卡密激活信息查看

4. **密钥管理**
   - API公钥/私钥展示
   - 历史密钥记录
   - 更新周期配置

5. **日志管理**
   - API接口日志记录
   - 日志查询和导出

6. **公告管理**
   - 公告发布和编辑

### 3.3 后台API端功能

1. **统一接口服务**
   - 所有接口统一管理
   - 接口加密开关（开发/生产环境）

2. **认证授权**
   - 用户登录/注册
   - 机器码验证
   - 卡密验证

3. **密钥管理**
   - RSA密钥生成
   - 密钥轮换（每10天）
   - 密钥分发

4. **数据接口**
   - 用户信息
   - 卡密信息
   - 软件配置
   - 公告信息

## 四、安全方案

### 4.1 客户端安全

- **代码保护**：PyArmor混淆 + Nuitka编译核心模块
- **接口加密**：所有API请求使用RSA加密
- **密钥轮换**：每10天自动更换密钥
- **机器码绑定**：防止多机使用
- **许可证验证**：在线验证 + 心跳检测

### 4.2 服务端安全

- **接口加密**：支持加密开关，方便调试
- **密钥管理**：服务端私钥，客户端公钥
- **数据验证**：签名验证，防止篡改
- **日志记录**：所有接口调用记录日志

## 五、部署方案

### 5.1 客户端打包

- **打包方式**：PyInstaller打包为exe
- **安装包**：NSIS创建安装包（~180MB）
- **浏览器**：内置Chrome浏览器（~120MB）
- **代码保护**：PyArmor加密后打包

### 5.2 服务端部署

- **API服务**：Python服务（FastAPI/Flask）
- **数据库**：MySQL 8.0
- **Web管理端**：Nginx + 静态文件

## 六、开发计划

### 6.1 第一阶段：基础框架
- 客户端登录注册功能
- 后台API基础接口
- 数据库设计

### 6.2 第二阶段：核心功能
- 扫货模块（浏览器自动化）
- Steam集成
- 管理web端

### 6.3 第三阶段：安全加固
- 接口加密
- 密钥轮换
- 代码保护

### 6.4 第四阶段：测试和优化
- 功能测试
- 性能优化
- 打包部署

## 七、详细文档索引

- [客户端技术方案](./游铛铛-技术方案-客户端.md)
- [管理web端技术方案](./游铛铛-技术方案-管理端.md)
- [后台API技术方案](./游铛铛-技术方案-后端API.md)
- [安全加固方案](./游铛铛-技术方案-安全方案.md)
- [打包部署方案](./游铛铛-技术方案-打包部署.md)