<!-- 由 BMAD™ Core 驱动 -->

# 测试级别框架

用于确定不同场景下适当测试级别（单元、集成、端到端）的综合指南。

## 测试级别决策矩阵

### 单元测试

**何时使用：**

-   测试纯函数和业务逻辑
-   算法正确性
-   输入验证和数据转换
-   隔离组件中的错误处理
-   复杂计算或状态机

**特点：**

-   执行速度快（即时反馈）
-   无外部依赖（数据库、API、文件系统）
-   高度可维护和稳定
-   易于调试失败

**示例场景：**

```yaml
unit_test:
  component: 'PriceCalculator'
  scenario: '使用多条规则计算折扣'
  justification: '具有多个分支的复杂业务逻辑'
  mock_requirements: '无 - 纯函数'
```

### 集成测试

**何时使用：**

-   组件交互验证
-   数据库操作和事务
-   API 端点合约
-   服务间通信
-   中间件和拦截器行为

**特点：**

-   执行时间适中
-   测试组件边界
-   可能使用测试数据库或容器
-   验证系统集成点

**示例场景：**

```yaml
integration_test:
  components: ['UserService', 'AuthRepository']
  scenario: '创建具有角色分配的用户'
  justification: '服务与持久化之间的关键数据流'
  test_environment: '内存数据库'
```

### 端到端测试

**何时使用：**

-   关键用户旅程
-   跨系统工作流
-   可视化回归测试
-   合规性和法规要求
-   发布前最终验证

**特点：**

-   执行速度较慢
-   测试完整工作流
-   需要完整的环境设置
-   最真实但最脆弱

**示例场景：**

```yaml
e2e_test:
  journey: '完成结账流程'
  scenario: '用户使用已保存的支付方式购买'
  justification: '需要全面验证的收入关键路径'
  environment: '带有测试支付网关的预发环境'
```

## 测试级别选择规则

### 何时倾向于单元测试：

-   逻辑可以被隔离
-   不涉及副作用
-   需要快速反馈
-   圈复杂度高

### 何时倾向于集成测试：

-   测试持久层
-   验证服务合约
-   测试中间件/拦截器
-   组件边界至关重要

### 何时倾向于端到端测试：

-   面向用户的关键路径
-   多系统交互
-   法规遵从性场景
-   可视化回归很重要

## 要避免的反模式

-   使用端到端测试进行业务逻辑验证
-   单元测试框架行为
-   集成测试第三方库
-   跨级别的重复覆盖

## 重复覆盖防护

**在添加任何测试之前，请检查：**

1.  这是否已经在较低级别进行了测试？
2.  单元测试能否代替集成测试覆盖此项？
3.  集成测试能否代替端到端测试覆盖此项？

**仅在以下情况下，覆盖范围重叠是可接受的：**

-   测试不同方面（单元：逻辑，集成：交互，端到端：用户体验）
-   需要深度防御的关键路径
-   防止先前已损坏功能的回归

## 测试命名约定

-   单元：`test_{component}_{scenario}`
-   集成：`test_{flow}_{interaction}`
-   端到端：`test_{journey}_{outcome}`

## 测试ID格式

`{EPIC}.{STORY}-{LEVEL}-{SEQ}`

**示例：**

-   `1.3-UNIT-001`
-   `1.3-INT-002`
-   `1.3-E2E-001`