# 接口测试平台Django

**Repository Path**: daveliu185/apiTestEnd

## Basic Information

- **Project Name**: 接口测试平台Django
- **Description**: welcome to my place
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-03-03
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Django, Python

## README



# 接口测试平台 (API Test End)

#### 介绍

接口测试平台是一个基于 Django 开发的全功能接口测试与自动化测试管理平台。平台集成了接口用例管理、测试计划执行、Bug 跟踪统计、服务部署管理、Nacos 配置同步等核心功能，支持测试数据生成、自动化执行、测试报告生成等完整测试流程。

#### 软件架构

- **后端框架**: Django + Django REST Framework
- **任务队列**: Celery + Redis
- **数据库**: MySQL (主数据存储)
- **缓存**: Redis
- **测试引擎**: 自研接口测试执行引擎 (apitestengine)
- **前端集成**: SimpleUI (Django admin 主题)

**核心模块**:
- `apitestengine` - 测试执行引擎，支持接口测试、场景测试、变量提取、断言处理
- `apps/projects` - 项目管理与接口定义
- `apps/testplans` - 测试计划与场景管理
- `apps/reports` - 测试报告与执行记录
- `apps/bugs` - Bug 跟踪管理
- `apps/testtools` - 测试工具集（部署、统计等）
- `apps/backendservice` - 后端服务管理与部署
- `apps/parksystem` - 停车场系统接口模拟
- `apps/users` - 用户认证与权限管理

#### 功能特性

1. **接口测试管理**
   - 项目与接口用例管理
   - 环境配置管理
   - 接口调试与快速测试

2. **测试计划执行**
   - 测试场景编排
   - 测试计划定时任务
   - 支持并发执行
   - Celery 异步任务执行

3. **测试引擎**
   - 动态变量生成（手机号、姓名、身份证等）
   - 加密解密工具（MD5、AES、Base64、RSA）
   - 响应数据提取（JSONPath、正则）
   - 断言验证
   - 脚本执行支持（setup/teardown）

4. **Bug 跟踪统计**
   - 禅道 Bug 爬取
   - Bug 统计分析
   - 缺陷率计算

5. **服务部署管理**
   - 服务器节点管理
   - FTP/SFTP 文件传输
   - SSH 远程命令执行
   - 服务部署与回滚

6. **Nacos 配置同步**
   - 命名空间管理
   - 服务与实例同步
   - Excel 批量导入

7. **停车场系统模拟**
   - 车辆入场/出场模拟
   - 停车费用计算
   - 支付通知模拟

#### 安装教程

1. **环境要求**
   - Python 3.8+
   - MySQL 5.7+
   - Redis 3.0+

2. **安装依赖**
   ```bash
   pip install -r requirements.txt
   ```

3. **数据库配置**
   - 复制 `apitest/settings/dev.py` 或 `apitest/settings/pro.py` 进行配置
   - 配置数据库连接信息
   - 配置 Redis 连接信息

4. **数据迁移**
   ```bash
   python manage.py migrate
   ```

5. **创建超级用户**
   ```bash
   python manage.py createsuperuser
   ```

6. **启动服务**
   ```bash
   # 启动 Django 开发服务器
   python manage.py runserver 0.0.0.0:8000

   # 启动 Celery Worker (Windows)
   celery -A apitest worker -P eventlet -l info -c 4

   # 启动 Celery Worker (Linux/Mac)
   celery -A apitest worker -l info -c 4
   ```

#### 使用说明

1. **配置环境变量**
   - `DJANGO_SETTINGS_MODULE`: 设置配置文件（如 `apitest.settings.dev`）
   - `ENV`: 运行环境标识（如 `dev`、`pro`）

2. **Windows 环境启动示例**
   ```cmd
   set PYTHONUNBUFFERED=1
   set DJANGO_SETTINGS_MODULE=apitest.settings
   set ENV=pro
   ```

3. **访问管理后台**
   - 登录地址: `http://localhost:8000/admin/`
   - 使用创建的超级用户账号登录

4. **API 文档**
   - DRF 默认 API 端点可访问

#### 项目结构

```
apitest/                    # 主应用目录
├── settings/               # 配置文件
│   ├── base_settings.py   # 基础配置
│   ├── dev.py              # 开发环境配置
│   ├── pro.py              # 生产环境配置
│   └── debug.py            # 调试配置
├── testToolsClass/         # 测试工具类
│   ├── bugsStaticView.py   # Bug 统计视图
│   ├── findCarNo.py        # 车牌号查找工具
│   ├── parkScore.py        # 停车场评分工具
│   └── tasks.py            # Celery 异步任务
├── urls.py                 # URL 路由
└── views.py                # 通用视图

apitestengine/             # 测试执行引擎
├── core/
│   ├── cases.py           # 测试用例执行
│   ├── runner.py          # 测试运行器
│   ├── tools.py           # 工具函数
│   └── DBClient.py        # 数据库客户端

apps/                      # Django 应用
├── backendservice/        # 后端服务管理
├── bugs/                  # Bug 管理
├── parksystem/            # 停车场系统
├── projects/               # 项目管理
├── reports/               # 报告管理
├── testplans/             # 测试计划
├── testtools/             # 测试工具
├── toolscategories/       # 工具分类
└── users/                 # 用户管理
```

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

#### 许可证

本项目仅供内部学习使用。