# AITestingAssistant

**Repository Path**: peter-hill/aitesting-assistant

## Basic Information

- **Project Name**: AITestingAssistant
- **Description**: 测试工程师的利刃，AI赋能测试流程，提高测试效率，解放双手
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-07-30
- **Last Updated**: 2025-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI测试助手 2.0

基于 **Vue3 + FastAPI + MySQL** 的现代化AI测试与需求分析系统

## 🚀 技术栈

### 前端
- **Vue 3** - 渐进式JavaScript框架
- **Element Plus** - Vue 3 UI组件库
- **Pinia** - Vue 3状态管理
- **Vue Router 4** - 路由管理
- **Axios** - HTTP客户端
- **Vite** - 构建工具

### 后端
- **FastAPI** - 现代Python Web框架
- **SQLAlchemy** - Python ORM
- **Pydantic** - 数据验证
- **JWT** - 身份认证
- **Uvicorn** - ASGI服务器

### 数据库
- **MySQL 5.7** - 关系型数据库

### 部署
- **Docker** - 容器化
- **Docker Compose** - 多容器编排
- **Nginx** - 反向代理

## 📁 项目结构

```
AITestingAssistant/
├── backend/                    # FastAPI后端
│   ├── app/
│   │   ├── api/               # API路由
│   │   ├── core/              # 核心配置
│   │   ├── models/            # 数据模型
│   │   ├── schemas/           # 数据模式
│   │   └── services/          # 业务逻辑
│   ├── main.py                # 应用入口
│   ├── requirements.txt       # Python依赖
│   └── Dockerfile            # 后端镜像
├── frontend/                  # Vue3前端
│   ├── src/
│   │   ├── api/              # API请求
│   │   ├── components/       # 组件
│   │   ├── layout/           # 布局
│   │   ├── router/           # 路由
│   │   ├── stores/           # 状态管理
│   │   ├── styles/           # 样式
│   │   ├── utils/            # 工具函数
│   │   └── views/            # 页面
│   ├── package.json          # 前端依赖
│   ├── vite.config.js        # Vite配置
│   └── Dockerfile           # 前端镜像
├── nginx/                    # Nginx配置
├── sql/                      # 数据库脚本
├── docker-compose.yml        # Docker编排
└── README_NEW.md            # 项目说明
```

## 🛠️ 开发环境搭建

### 1. 环境要求

- **Node.js** >= 16.0.0
- **Python** >= 3.8
- **MySQL** >= 8.0
- **Docker** & **Docker Compose** (可选)

### 2. 本地开发

#### 后端启动

```bash
# 进入后端目录
cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r backend_requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置数据库连接等

# 启动后端服务
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
```

#### 前端启动

```bash
# 进入前端目录
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

### 3. Docker部署

```bash
# 构建并启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down
```

## 🔧 配置说明

### 后端配置 (.env)

```env
# 数据库配置
DATABASE_URL=mysql+pymysql://user:password@localhost:3306/ai_testing_assistant

# 安全配置
SECRET_KEY=your-secret-key-here
ACCESS_TOKEN_EXPIRE_MINUTES=43200

# AI配置
OPENAI_API_KEY=your-openai-api-key
OPENAI_BASE_URL=https://api.openai.com/v1

# 文件上传
UPLOAD_DIR=uploads
MAX_FILE_SIZE=52428800
```

### 前端配置 (.env)

```env
# API地址
VITE_API_BASE_URL=http://localhost:8000

# 应用配置
VITE_APP_TITLE=AI测试助手
```

## 📊 主要功能

### 1. 用户认证系统
- 用户注册/登录
- JWT Token认证
- 权限管理

### 2. 需求管理
- 需求创建/编辑/删除
- 需求分类和标签
- 需求内容管理

### 3. 测试用例管理
- 测试用例创建/编辑
- Markdown格式支持
- 测试用例执行记录

### 4. AI分析功能
- 需求文档分析
- 测试用例自动生成
- 文档内容解析

### 5. 文件管理
- 文档上传
- 多格式支持 (PDF, Word, Excel等)
- 文件内容提取

## 🚀 部署指南

### 1. 生产环境部署

```bash
# 克隆项目
git clone <repository-url>
cd AITestingAssistant

# 配置环境变量
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env

# 启动服务
docker-compose -f docker-compose.prod.yml up -d
```

### 2. 数据库初始化

```bash
# 执行数据库迁移
docker-compose exec backend python -c "
from app.core.database import engine, Base
from app.models import *
Base.metadata.create_all(bind=engine)
"

# 创建管理员用户
docker-compose exec backend python -c "
from app.core.database import SessionLocal
from app.models.user import User
from app.core.security import get_password_hash

db = SessionLocal()
admin_user = User(
    username='admin',
    email='admin@example.com',
    hashed_password=get_password_hash('admin123'),
    is_admin=True
)
db.add(admin_user)
db.commit()
"
```

## 🧪 测试

### 后端测试

```bash
cd backend
pytest tests/
```

### 前端测试

```bash
cd frontend
npm run test
```

## 📝 API文档

启动后端服务后，访问以下地址查看API文档：

- **Swagger UI**: http://localhost:8000/docs
- **ReDoc**: http://localhost:8000/redoc

## 🤝 贡献指南

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

## 📄 许可证

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

## 🆘 问题反馈

如果您遇到任何问题，请通过以下方式联系：

- 提交 [Issue](https://github.com/your-repo/issues)
- 发送邮件至: your-email@example.com

## 🎯 路线图

- [ ] 集成更多AI模型
- [ ] 添加测试报告生成
- [ ] 支持团队协作功能
- [ ] 移动端适配
- [ ] 国际化支持

---
  # 安装前端依赖
   cd frontend && npm install
   
   # 安装后端依赖
   cd backend && pip install -r backend_requirements.txt
   
   # 启动后端 (需要配置MySQL数据库)
   cd backend && uvicorn main:app --reload --host 0.0.0.0
   
   # 启动前端
   cd frontend && npm run dev
**AI测试助手 2.0** - 让测试更智能，让开发更高效！