# 测试平台

**Repository Path**: zheng-the-young/test-platform

## Basic Information

- **Project Name**: 测试平台
- **Description**: 专注于测试流程优化与自动化，提供全面的测试工具与框架，支持多环境部署，加速产品质量提升。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-26
- **Last Updated**: 2025-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Mango 项目文档

## 项目概述
Mango 是一个前后端分离的开源测试平台，集成了接口自动化测试、UI自动化测试、数据库性能分析和测试报告可视化等功能。前端基于 Vue.js 框架开发，后端使用 Python 的 Django 框架，结合 HttpRunner 进行自动化测试，支持接口和 UI 测试的执行与管理。

## 项目结构
```
mango/                         # 前端项目主目录
├── public/                     # 静态资源
├── src/                        # 源代码目录
│   ├── assets/                 # 图片等资源
│   ├── components/             # Vue 组件
│   ├── views/                  # 页面视图
│   ├── layouts/                # 页面布局
│   ├── router/                 # 路由配置
│   └── App.vue, main.js        # 项目入口
├── vue.config.js               # Vue 构建配置
└── package.json                # 依赖和脚本配置

mango_service/                  # 后端项目主目录
├── HttpRunner/                 # HttpRunner 测试脚本和报告
│   ├── testcase/               # 测试用例脚本
│   ├── reports/                # 测试报告
│   ├── config/                 # 测试配置文件
│   └── utils/                  # 测试工具类
├── integration/                # 自动化测试模块
│   ├── testcases/              # 自动化测试用例
│   ├── utils/                  # 测试辅助工具
│   ├── logs/                   # 日志文件
│   └── exceptionPictures/      # 异常截图
├── ai/                         # AI 测试模块
├── apiautomation/              # 接口自动化模块
│   ├── models/                 # ORM 模型
│   ├── views/                  # 接口处理逻辑
│   └── urls.py                 # 接口路由
├── crypto_api/                 # 加密解密处理模块
├── database/                   # 数据库 SOAR 模块
├── manage.py                   # Django 项目管理脚本
├── requirements.txt            # 后端依赖文件
└── static/                     # 静态文件（CSS/JS/HTML）
```

## 功能模块说明

### 前端模块
- 使用 Vue.js 构建的单页应用（SPA），提供用户交互界面
- 主要功能：登录、接口管理、测试执行、报告查看、用户管理
- 使用 Font Awesome 图标和现代 UI 设计

### 后端模块
- 基于 Django 框架提供 RESTful API 接口
- 支持接口自动化测试管理（上传、执行、删除、查看报告）
- 提供 AI 自动化测试服务
- 支持数据库 SOAR 查询分析
- 包含加密/解密 API 服务
- 使用 HttpRunner 实现自动化测试引擎

### 自动化测试模块
- 接口自动化：使用 HttpRunner 编写并执行测试脚本，生成 HTML 和 Allure 测试报告
- UI 自动化：使用 Selenium 进行 Web 界面测试，支持截图、元素定位、断言等
- 测试报告：提供可视化 HTML 报告界面，可查看测试结果、日志、图表等

## 安装与部署

### 前端部署
1. 安装 Node.js 和 npm
2. 进入 mango 目录
3. 安装依赖：
   ```bash
   npm install
   ```
4. 启动开发服务器：
   ```bash
   npm run serve
   ```

### 后端部署
1. 安装 Python 3.8+
2. 创建虚拟环境：
   ```bash
   python -m venv venv
   source venv/bin/activate
   ```
3. 安装依赖：
   ```bash
   pip install -r mango_service/requirements.txt
   ```
4. 启动 Django 服务：
   ```bash
   cd mango_service
   python manage.py runserver
   ```

## 使用说明

### 接口自动化测试
1. 上传测试用例（YAML/JSON）
2. 执行测试：
   ```bash
   python -m HttpRunner.run <testcase>
   ```
3. 查看测试报告：
   ```bash
   打开 mango_service/static/reports/<report_name>.html
   ```

### UI 自动化测试
- 支持通过 Selenium 进行 UI 测试
- 测试脚本位于 mango_service/integration/testcases/
- 测试数据位于 mango_service/integration/testdata/
- 执行测试：
  ```bash
  python mango_service/integration/testcases/test_case.py
  ```

### 测试报告查看
- 测试报告位于 mango_service/static/reports/
- 所有报告均为 HTML 格式，可直接在浏览器中打开查看
- 支持 Allure 格式报告，可通过 Allure 命令行工具生成

## 开发与维护

### 贡献指南
- Fork 仓库
- 创建 feature 分支
- 提交代码
- 创建 Pull Request

## 许可证
本项目采用 MIT 许可证。详见 LICENSE 文件。