Release v0.1.0: 小程序使用建议跳转腾讯文档 + 配置导入导出功能
This commit is contained in:
+102
@@ -0,0 +1,102 @@
|
||||
# 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 测试框架
|
||||
- [ ] 编写第一批测试用例
|
||||
Reference in New Issue
Block a user