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