# QuanYiXiaoZhuShou 测试项目

## 项目概述

本项目是一个**后端测试项目**，主要用于对后端 SDK API 进行自动化测试、微信小程序交互黑盒测试以及 Web 端管理后台的自动化测试。

## 项目结构

```
test/
├── .trae/
│   └── skills/
│       └── bugpack-deploy/       # BugPack 部署 Skill
├── BugPack-main/                 # BugPack Bug 管理工具（已部署）
│   ├── src/
│   │   ├── client/               # 前端 React 应用
│   │   ├── server/               # 后端 Express API
│   │   └── mcp/                  # MCP Server 实现
│   ├── dist/                     # 构建产物
│   ├── start-bugpack.bat         # 一键启动脚本
│   └── package.json
├── BugPack.zip                   # BugPack 源码包
├── msys2-base.tar.xz             # MSYS2 基础包
├── msys2-installer.exe           # MSYS2 安装程序
└── node.zip                      # Node.js 便携包
```

## 当前状态

**阶段：项目初始化 - 尚未开始开发**

本项目目前处于初始化阶段，主要完成了以下准备工作：
- ✅ BugPack 工具部署（用于 Bug 管理）
- ✅ MSYS2 环境配置
- ✅ Node.js 环境配置
- ⬜ 后端 SDK API 测试用例编写
- ⬜ 微信小程序测试用例编写
- ⬜ Web 管理后台测试用例编写

## 开发里程碑

| 里程碑 | 阶段 | 状态 | 计划完成时间 | 实际完成时间 | 备注 |
|--------|------|------|-------------|-------------|------|
| M1 | 项目初始化与环境搭建 | 🟢 已完成 | 2026-05-01 | 2026-05-01 | BugPack部署、MSYS2配置 |
| M2 | 后端 SDK API 测试框架搭建 | ⬜ 未开始 | - | - | 等待 API 文档 |
| M3 | 后端 SDK API 测试用例编写 | ⬜ 未开始 | - | - | 等待 API 文档 |
| M4 | 微信小程序测试用例编写 | ⬜ 未开始 | - | - | 等待交互设计文档 |
| M5 | Web 管理后台自动化测试 | ⬜ 未开始 | - | - | 等待交互设计文档 |
| M6 | 测试执行与 Bug 上报 | ⬜ 未开始 | - | - | 依赖 M2-M5 |
| M7 | 测试报告生成与归档 | ⬜ 未开始 | - | - | 项目收尾 |

## 技术栈

| 类别 | 技术 |
|------|------|
| Bug 管理 | BugPack (React + Express + SQLite) |
| 测试框架 | Playwright (Web 自动化测试) |
| 脚本环境 | MSYS2 + Node.js |
| 包管理 | npm |

## 强制要求

1. **上下文加载**：每次会话开始时，必须在上下文中加载 `project.md` 文件，了解项目当前状态和里程碑进度。

2. **意图确认**：每次接收到任务后，必须仔细分析用户意图。如有不理解或认为意图模糊时，**必须反问用户**，确认好意图后再执行。

3. **Agent 协同**：执行任务时，应在当前合适的 Agent 配置中选取 Agent 调用。如果能同时协同多个 Agent，则协同调用多个 Agent 完成任务，提升任务效率。

4. **Bug 管理**：**强制使用 BugPack MCP 服务**来维护 BUG 信息。所有发现的 Bug 必须通过 BugPack 记录和跟踪。

## 核心原则

> **你只负责根据用户提供的 API 文档、交互设计文档，编写测试用例，不涉及任何问题分析和业务代码修改。**

### 测试范围界定

| 测试类型 | 职责 | 输出物 |
|---------|------|--------|
| **后端 SDK API 测试** | 编写测试用例及相关测试代码，完成测试并上报 BUG | 测试代码 + BugPack Bug 记录 |
| **微信小程序黑盒测试** | 根据交互文档编写测试用例，告知用户执行即可 | 测试用例文档 |
| **Web 端管理后台测试** | 使用 Playwright MCP 服务自主进行测试，完成 Bug 上报 | 自动化测试脚本 + BugPack Bug 记录 |

### 禁止事项

- ❌ 不允许修改业务代码
- ❌ 不允许进行问题根因分析（只记录现象）
- ❌ 不允许超出测试用例范围的代码编写
- ❌ 不允许手动执行微信小程序测试（仅提供用例）

## BugPack 服务信息

- **服务地址**：http://localhost:3459
- **项目名**：QuanYiXiaoZhuShou
- **启动方式**：双击 `BugPack-main/start-bugpack.bat`

## 待办事项

- [ ] 获取后端 SDK API 文档
- [ ] 获取微信小程序交互设计文档
- [ ] 获取 Web 管理后台交互设计文档
- [ ] 搭建 API 测试框架
- [ ] 编写第一批测试用例