# test-gen-tool

**Repository Path**: dragondjf/test-gen-tool

## Basic Information

- **Project Name**: test-gen-tool
- **Description**: 测试工具生成
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-12
- **Last Updated**: 2026-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CaseRunner

基于 AI 的智能测试用例生成与执行平台。上传需求文档和 API 设计文档，自动完成拆分、AI 生成功能说明书与 API 规范、生成测试用例、执行测试并导出报告。

---

## Docker 一键启动（推荐）

仅需 Docker，无需安装任何开发环境：

```bash
docker compose up -d
```

首次启动会自动构建镜像并初始化数据库，等待约 2～3 分钟即可访问。

| 服务 | 访问地址 | 容器端口 → 宿主机端口 |
|------|---------|---------------------|
| 前端页面 | http://localhost:3001 | 80 → **3001** |
| 后端 API | http://localhost:8081 | 8000 → **8081** |
| MySQL | localhost:33061 | 3306 → **33061** |

> 端口已选用非常规端口，避免与本机已有服务冲突。

查看日志：

```bash
docker compose logs -f
```

停止：

```bash
docker compose down
```

---

## 环境要求（手动开发）

| 组件 | 要求 |
|------|------|
| JDK | 17+ |
| Node.js | 18+ |
| MySQL | 8.0+ |
| Maven | 3.8+ |

---

## 快速启动（手动开发模式）

### 1. 创建数据库

```bash
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS caserunner DEFAULT CHARSET utf8mb4;"
```

默认连接 `localhost:3306`，用户名 `root`，密码 `admin123`。如需修改，编辑 [`backend/src/main/resources/application.yml`](backend/src/main/resources/application.yml) 中的 `spring.datasource` 配置。

> 首次启动时，系统自动执行 [`backend/src/main/resources/schema.sql`](backend/src/main/resources/schema.sql) 创建所有表。

### 2. 启动后端

```bash
cd backend
mvn spring-boot:run
```

服务启动在 `http://localhost:8000`。

### 3. 启动前端

```bash
cd frontend
npm install
npm run dev
```

访问 `http://localhost:5173`。开发环境下，`/api` 请求自动代理到后端 8000 端口。

---

## 样本数据

[`data/`](data/) 目录存放了测试用的样本文档和数据库备份，可直接上传到系统试用：

| 文件 | 用途 |
|------|------|
| `data/anno-tool需规文档.docx` | 需求规格说明书样本，在「文档分块管理」上传拆分 |
| `data/anno-tool接口文档.docx` | API 接口设计文档样本，在「API 接口管理」上传解析 |
| `data/测试用例设计策略.docx` | 测试用例设计策略配置（后端自动加载） |
| `data/testcase.db` | SQLite 参考数据库 |

使用方式：创建工程后，在「快速开始」或「文档分块管理」「API 接口管理」中上传对应的 .docx 文件即可。

---

## 生产构建

```bash
cd frontend && npm run build    # 输出到 frontend/dist/
```

将 `dist/` 的静态文件放入 `backend/src/main/resources/static/`，打包后端启动即可前后端一体访问。

---

## 使用流程

```
注册 → 添加 AI 配置 → 创建工程 → 上传文档 → AI 生成 → 执行测试 → 导出报告
```

1. **注册账号** → 登录系统
2. **添加 AI 配置** → 填入 API Key、Base URL、模型名称
3. **创建工程** → 绑定 AI 配置、配置成功状态码
4. **上传文档** → 需规 .docx + API 设计文档 .docx（可使用 `data/` 下样本）
5. **AI 自动生成** → 功能说明书、API 接口、测试用例
6. **执行测试** → 查看详细执行结果
7. **导出报告** → HTML 或 Word 格式

每一步的详细操作，参见前端页面右上角的 **帮助文档** 按钮。