权益小助手开发
103 lines
4.3 KiB
Markdown
103 lines
4.3 KiB
Markdown
# 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 测试框架
|
||
- [ ] 编写第一批测试用例
|