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

1.5 KiB
Raw Blame History

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