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/

测试环境搭建详情

• 迁移策略：仅迁移 mini-test-demo 中现成的、可直接使用的测试配置和基础测试
• 测试框架：基于 Jest + Testing Library（直接复用配置）
• 测试配置：复用 mini-test-demo 中的 jest.config.js 和 setup.ts
• Mock 配置：复用完整的 Taro 组件 mock 配置
• 测试范围：基础示例测试，不创建新的组件/页面测试（当前 mini 为 starter 项目）

搭建优先级

1. 高优先级：迁移现成的测试配置和基础示例
2. 中优先级：验证测试环境正常运行
3. 低优先级：不创建新的测试（当前为 starter 项目）

Stories

1. Story 006.001: 迁移 mini-test-demo 中现成的测试环境
   • 在 mini/package.json 中添加测试脚本
   • 复制 mini-test-demo 中的 jest.config.js 配置文件
   • 复制 mini-test-demo 中的 tests 目录结构和 setup.ts
   • 复制 Taro 组件 mock 和测试依赖配置
   • 复制基础示例测试文件
   • 验证测试环境正常运行
   • 不创建新的组件/页面测试（当前为 starter 项目）

兼容性要求

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

风险缓解

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

完成定义

• Story 006.001完成且验收标准满足
• 测试环境配置完成且正常运行
• 基础示例测试通过率100%
• 测试脚本可正常运行
• 不创建新的测试用例（仅迁移现有配置）

验证检查清单

范围验证

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

风险评估

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

完整性检查

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