# 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目标清晰可实现 - [ ] 故事范围适当 - [ ] 成功标准可衡量 - [ ] 依赖项已识别