mini-starter/docs/prd/epic-006-mini-test-setup.md

Mini小程序测试环境搭建 - Brownfield Epic

Epic Goal

为 /mnt/code/155-138-template-6/mini 目录搭建完整的测试环境，基于 mini-test-demo 中的测试配置和测试文件，建立独立的测试体系，确保小程序项目的代码质量和稳定性。

Epic Description

现有系统上下文

• mini项目现状：Taro小程序项目，包含组件、页面、工具类等代码，但完全没有测试配置和测试文件
• 参考模板：mini-test-demo 中有完整的 Jest 测试配置、mock 文件和测试用例
• 技术栈：Taro + React + TypeScript + Jest + Testing Library
• 项目结构：
  • 组件：src/components/
  • 页面：src/pages/
  • 工具类：src/utils/
  • API：src/api.ts
  • 类型定义：src/types/

测试环境搭建详情

• 测试框架：基于 Jest + Testing Library
• 测试配置：参考 mini-test-demo 中的 jest.config.js 和 setup.ts
• Mock 配置：Taro 组件 mock、环境变量 mock、浏览器 API mock
• 测试范围：组件测试、页面测试、工具类测试、API 测试

搭建优先级

1. 高优先级：测试环境配置和基础工具类测试
2. 中优先级：核心组件和页面测试
3. 低优先级：边缘组件和复杂交互测试

Stories

1. Story 006.001: 搭建 mini 项目完整测试环境
   • 在 mini/package.json 中添加测试脚本
   • 创建 mini/jest.config.js 配置文件
   • 建立 mini/tests 目录结构和 setup.ts
   • 配置 Taro 组件 mock 和测试依赖
   • 为工具类、组件、页面创建基础测试
   • 验证测试环境正常运行
   • 确保核心功能测试覆盖

兼容性要求

• 现有小程序功能保持不变
• 测试环境不影响开发环境
• 测试配置与项目技术栈兼容
• 测试运行不影响构建过程
• 测试结果可重现

风险缓解

• 主要风险：测试环境配置复杂，可能影响现有开发流程
• 缓解措施：逐步配置，保持与开发环境隔离
• 次要风险：Taro 组件 mock 不完整
• 缓解措施：基于 mini-test-demo 的成熟 mock 配置
• 回滚计划：删除测试配置和文件，恢复原有状态

完成定义

• Story 006.001完成且验收标准满足
• 测试环境配置完成且正常运行
• 核心功能测试覆盖率达到70%
• 测试通过率100%
• 测试脚本可正常运行

验证检查清单

范围验证

• Epic目标清晰可实现
• 故事范围适当
• 测试策略合理
• 集成复杂度可控

风险评估

• 对现有系统风险低
• 回滚计划可行
• 测试覆盖无遗漏
• 团队具备测试知识

完整性检查

• Epic目标清晰可实现
• 故事范围适当
• 成功标准可衡量
• 依赖项已识别