# tdd_plan.md - TDD 实施计划

本计划作为 `tasks.md` 的配套说明，用于统一项目的测试驱动开发（TDD）实践与验收口径。

---

## 1. 目标与范围

- 所有功能代码遵循「红-绿-重构」循环
- 覆盖后端 API、核心业务逻辑、前端组件与关键流程
- 与 CI/CD 强绑定，未通过测试不得合并

---

## 2. 测试分层与覆盖要求

| 层级 | 目标 | 工具 | 覆盖要求 |
| --- | --- | --- | --- |
| 单元测试 | 业务逻辑与边界条件 | pytest / Vitest | 后端 ≥ 80%，前端 ≥ 70% |
| 接口测试 | API 契约与错误处理 | pytest + httpx | 关键接口 100% 覆盖 |
| 组件测试 | 关键交互与渲染 | Vitest + RTL | 关键组件覆盖 |
| E2E | 核心用户路径 | Playwright | 关键路径覆盖 |
| AI 模型测试 | 模型封装与关键规则验证 | pytest + 标注集 | P0 规则样本覆盖 ≥ 90%，P1 ≥ 70%，回归集 100% |

---

## 3. 统一约定

- 每个任务必须包含：
  - 至少 1 个失败测试用例（先写）
  - 核心成功路径测试
  - 关键异常路径测试
- 合并前需满足：
  - 测试全部通过
  - 覆盖率达标
  - 关键路径无回归

---

## 4. 任务验收基线

- 任务完成即具备可运行测试与最小化覆盖
- 关键功能（如审核台、AI 配置、上传链路）必须包含 E2E 测试

---

## 5. 变更与维护

- 覆盖率阈值调整需经过 PM + 技术负责人确认
- 重大功能变更需同步更新本计划