Your Name 2f2f7e0f61 docs: 完善文档体系与一致性修复
- 新增 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>
2026-02-03 15:49:57 +08:00

51 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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