# MobTestPlatform

**Repository Path**: lethe-c/mob-test-platform

## Basic Information

- **Project Name**: MobTestPlatform
- **Description**: 毕业设计项目1：基于 Flask 的移动测试平台的设计与实现
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-28
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 移动测试平台 (Mobile Test Platform)

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
[![Node.js](https://img.shields.io/badge/node.js-16%2B-green.svg)](https://nodejs.org/)
[![Vue.js](https://img.shields.io/badge/vue.js-3.0%2B-green.svg)](https://vuejs.org/)

一个功能全面的移动测试平台，支持移动设备管理、测试用例管理（手动创建+AI自动化生成）、测试任务执行（手工执行+自动化测试）、报告管理等功能。

## 🚀 功能特性

### 核心功能
- **设备管理**: 支持Android/iOS设备连接、监控、远程控制
- **测试用例管理**: 可视化用例编辑、版本控制、标签分类
- **自动化测试**: 支持UI自动化、性能测试、兼容性测试
- **报告管理**: 多维度测试报告、统计分析、导出分享
- **用户管理**: 角色权限控制、团队协作

### 技术特性
- **现代化架构**: Vue3 + Flask + MySQL技术栈
- **响应式设计**: 支持桌面端和移动端访问
- **实时监控**: WebSocket实时设备状态监控
- **高性能**: 异步任务处理、分布式执行
- **易扩展**: 模块化设计、插件化架构

## 📋 系统要求

### 后端环境
- Python 3.8+
- MySQL 5.7+ / PostgreSQL 10+
- Redis 6.0+ (可选，用于缓存和任务队列)

### 前端环境
- Node.js 16+
- npm 8+ 或 yarn 1.22+

### 硬件要求
- CPU: 2核心以上
- 内存: 4GB以上
- 存储: 20GB可用空间

## 🛠️ 快速开始

### 1. 克隆项目
```bash
git clone https://github.com/your-org/mob-test-platform.git
cd mob-test-platform
```

### 2. 一键启动 (推荐)

#### Windows用户
```bash
# 双击运行或在命令行执行
start.bat
```

#### Linux/macOS用户
```bash
# 给脚本执行权限
chmod +x start.sh

# 运行启动脚本
./start.sh
```

### 3. 手动启动

#### 启动后端
```bash
cd backend
pip install -r requirements.txt
python main.py
```

#### 启动前端
```bash
cd frontend
npm install
npm run dev
```

### 4. 访问应用
- 前端地址: http://localhost:5173
- 后端API: http://localhost:8000
- API文档: http://localhost:8000/docs

## 📁 项目结构

```
MobTestPlatform/
├── backend/                 # 后端代码
│   ├── app/                # 应用核心
│   │   ├── api/           # API路由
│   │   ├── models/        # 数据模型
│   │   ├── services/      # 业务逻辑
│   │   └── utils/         # 工具函数
│   ├── config/            # 配置文件
│   ├── migrations/        # 数据库迁移
│   ├── tests/             # 测试代码
│   └── main.py           # 应用入口
├── frontend/              # 前端代码
│   ├── src/              # 源代码
│   │   ├── api/          # API调用
│   │   ├── components/   # 组件
│   │   ├── views/        # 页面
│   │   ├── router/       # 路由配置
│   │   ├── store/        # 状态管理
│   │   └── utils/        # 工具函数
│   ├── public/           # 静态资源
│   └── package.json      # 依赖配置
├── docs/                 # 文档
├── scripts/              # 脚本工具
├── start.py             # Python启动脚本
├── start.bat            # Windows启动脚本
├── start.sh             # Linux/macOS启动脚本
└── README.md            # 项目说明
```

## 🔧 配置说明

### 后端配置
主要配置文件位于 `backend/config/` 目录：

- `config.py`: 基础配置
- `database.py`: 数据库配置
- `redis.py`: Redis配置
- `email.py`: 邮件配置

### 前端配置
主要配置文件位于 `frontend/src/` 目录：

- `config/index.js`: 环境配置
- `utils/request.js`: HTTP请求配置
- `router/index.js`: 路由配置

## 📖 使用指南

### 设备管理
1. 连接移动设备到测试机
2. 在设备管理页面添加设备
3. 配置设备参数和权限
4. 开始使用设备进行测试

### 测试用例管理
1. 创建测试项目
2. 编写测试用例
3. 设置用例参数和预期结果
4. 组织用例到测试套件

### 执行测试
1. 选择测试用例或套件
2. 配置执行参数
3. 选择目标设备
4. 启动测试执行

### 查看报告
1. 在报告管理页面查看测试结果
2. 分析测试数据和统计信息
3. 导出或分享报告

## 🔌 API文档

### 认证接口
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/logout` - 用户登出
- `GET /api/auth/profile` - 获取用户信息

### 设备管理接口
- `GET /api/devices` - 获取设备列表
- `POST /api/devices` - 添加设备
- `PUT /api/devices/{id}` - 更新设备信息
- `DELETE /api/devices/{id}` - 删除设备

### 测试用例接口
- `GET /api/testcases` - 获取测试用例列表
- `POST /api/testcases` - 创建测试用例
- `PUT /api/testcases/{id}` - 更新测试用例
- `DELETE /api/testcases/{id}` - 删除测试用例

详细API文档请访问: http://localhost:8000/docs

## 🧪 测试

### 运行后端测试
```bash
cd backend
python -m pytest tests/
```

### 运行前端测试
```bash
cd frontend
npm run test
```

### 端到端测试
```bash
cd frontend
npm run test:e2e
```

## 🚀 部署

### Docker部署
```bash
# 构建镜像
docker-compose build

# 启动服务
docker-compose up -d
```

### 生产环境部署
1. 配置生产环境变量
2. 构建前端静态文件
3. 配置Web服务器 (Nginx)
4. 部署后端应用
5. 配置数据库和缓存

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

### 代码规范
- 后端遵循 PEP 8 规范
- 前端遵循 ESLint 规范
- 提交信息遵循 Conventional Commits 规范

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🆘 支持

如果您遇到问题或有建议，请：

1. 查看 [FAQ](docs/FAQ.md)
2. 搜索 [Issues](https://github.com/your-org/mob-test-platform/issues)
3. 创建新的 [Issue](https://github.com/your-org/mob-test-platform/issues/new)

## 📞 联系我们

- 邮箱: support@mobtestplatform.com
- 官网: https://mobtestplatform.com
- 文档: https://docs.mobtestplatform.com

## 🙏 致谢

感谢所有为这个项目做出贡献的开发者和用户！

---

⭐ 如果这个项目对您有帮助，请给我们一个星标！