- 新增 AI 厂商动态配置架构文档 (AIProviderConfig V2.0) - 新增 TDD 实施计划 (featuredoc/tdd_plan.md) - 新增文档矛盾追踪记录 (DocumentContradictions.md) - 统一所有文档的技术指标与优先级定义 - 完善功能清单 (F-47~F-50 AI 配置功能) - 更新任务清单支持 AI 服务配置任务 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
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 + 技术负责人确认
- 重大功能变更需同步更新本计划