- 新增 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>
51 lines
1.5 KiB
Markdown
51 lines
1.5 KiB
Markdown
# 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 + 技术负责人确认
|
||
- 重大功能变更需同步更新本计划
|