miniapp-api/test/project.md

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 测试框架
• 编写第一批测试用例