# manual-case-platform

**Repository Path**: aiagentdemo/manual-case-platform

## Basic Information

- **Project Name**: manual-case-platform
- **Description**: 输入需求文档，经 **功能点确认 → 智能生成手工用例 → 第二个大模型评审 → 不合格用例重生成**，最终以 **XMind 思维导图**展示并支持下载。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 手工测试用例智能生成平台（TestCaseMind）

输入需求文档，经 **功能点确认 → 智能生成手工用例 → 第二个大模型评审 → 不合格用例重生成**，最终以 **XMind 思维导图**展示并支持下载。

- 后端：Python 3.10+ / FastAPI / SQLAlchemy / MySQL（可切 SQLite）
- 前端：Vue3 / Vite / Element Plus，蓝白科技风
- 大模型：OpenAI 兼容协议（火山方舟 ARK、DeepSeek、OpenAI、通义、vLLM/Ollama 等均可），生成模型与评审模型分别配置；未配置 Key 时自动 **Mock 离线模式**

## 工作流

1. **导入需求**：需求文档 URL 下载（.docx/.md/.txt）、本地上传、或直接粘贴内容。
2. **功能点确认**：AI 过滤提炼功能点，用户可增删改、勾选参与生成的功能点。
3. **生成用例**：按功能点拆分需求内容，生成标准手工用例（标题 / 优先级 P0-P3 / 类型 / 前置条件 / 操作步骤 / 预期结果）。
4. **评审修正**：第二个大模型独立打分（<75 分判不合格），用户勾选不合格用例可重新生成并自动复审。
5. **XMind 导出**：思维导图在线预览，一键下载 `.xmind`（XMind Zen 格式）。

## 目录结构

```
manual-case-platform/
├── backend/
│   ├── app/
│   │   ├── main.py            # FastAPI 入口（端口 8086）
│   │   ├── config.py          # 配置（.env）
│   │   ├── database.py / models.py / schemas.py
│   │   ├── routers/           # requirements / features / cases / llm_config
│   │   └── services/          # 文档解析 / LLM / 用例编排 / XMind 导出 / prompts
│   ├── tests/e2e_test.py      # 全链路端到端测试
│   ├── requirements.txt
│   └── .env.example
├── frontend/                  # Vue3（端口 5186，/api 代理到 8086）
└── sql/init.sql               # MySQL 建库脚本（应用也会自动建表）
```

## 快速开始

### 1. 后端

```bash
cd backend
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt

cp .env.example .env           # 按实际修改 MySQL 连接串与模型 Key
# 不想装 MySQL 也可离线体验：在 .env 中设
# DATABASE_URL=sqlite:///./data/app.db

python3 -m uvicorn app.main:app --host 0.0.0.0 --port 8086
```

接口文档：http://127.0.0.1:8086/docs

### 2. 前端

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

打开 http://127.0.0.1:5186

### 3. 端到端自检（SQLite + Mock，无需 MySQL / Key / 网络）

```bash
cd backend
DATABASE_URL=sqlite:///./data/test_e2e.db python3 tests/e2e_test.py
```

## 配置大模型

在「大模型配置」页分别填写生成模型与评审模型的 Base URL / API Key / Model 名称并保存，可做连通测试。数据库配置优先于 `.env`；两模型可相同也可不同厂商。未配置时平台自动进入 Mock 模式，全流程可离线演示。