MBE 文档中心

🎯 CI/CD覆盖率要求与实施计划

❓ 问题：200-400个API测试用例能达到CI/CD要求吗？

📊 当前CI/CD配置分析

1. 覆盖率要求（pyproject.toml）

"--cov-fail-under=0",  # 临时降低覆盖率要求（待提高测试覆盖率后恢复）

当前状态:

  • ✅ CI/CD不会因为覆盖率低而失败
  • ⚠️ 目标覆盖率: 70%（已注释）
  • 📝 临时设置: 0%（允许任何覆盖率通过）

2. CI/CD工作流（complete-cicd.yml）

测试阶段:

  • ✅ 运行单元测试、集成测试、E2E测试
  • ✅ 上传覆盖率报告到Codecov
  • ✅ 不检查覆盖率阈值（因为设置为0）

当前行为:

  • CI/CD会运行测试
  • CI/CD会上传覆盖率报告
  • CI/CD不会因为覆盖率低而失败

🎯 实施计划：逐步提高覆盖率要求

阶段1: API端点测试（当前目标）

目标: 10-15%覆盖率 测试用例: 200-400个API端点测试 时间: 1周内

CI/CD配置调整:

"--cov-fail-under=10",  # 最低覆盖率10%

预期结果:

  • ✅ 200-400个API测试用例
  • ✅ 覆盖率提升到10-15%
  • ✅ CI/CD通过（10%阈值）

风险评估:

  • ⚠️ 风险低: 10%是合理的最低要求
  • ✅ 可执行: 200-400个测试用例可以覆盖大量API代码

阶段2: 服务类测试（短期）

目标: 20-25%覆盖率 测试用例: +150-300个服务类测试 时间: 2-3周内

CI/CD配置调整:

"--cov-fail-under=20",  # 最低覆盖率20%

预期结果:

  • ✅ 总计350-700个测试用例
  • ✅ 覆盖率提升到20-25%
  • ✅ CI/CD通过（20%阈值）

阶段3: 平台模块测试（中期）

目标: 30-40%覆盖率 测试用例: +200-400个平台模块测试 时间: 1个月内

CI/CD配置调整:

"--cov-fail-under=30",  # 最低覆盖率30%

预期结果:

  • ✅ 总计550-1,100个测试用例
  • ✅ 覆盖率提升到30-40%
  • ✅ CI/CD通过（30%阈值）

阶段4: 全面覆盖（长期）

目标: 50-70%覆盖率 测试用例: +500-1,000个全面测试 时间: 3个月内

CI/CD配置调整:

"--cov-fail-under=50",  # 最低覆盖率50%（逐步提高到70%）

最终目标:

"--cov-fail-under=70",  # 目标覆盖率70%

📈 详细评估：200-400个API测试用例

代码库分析

API模块代码量:

  • 文件数: ~69个API文件
  • 估计代码行数: ~15,000-20,000行
  • 函数/端点数: ~500+个端点

覆盖率计算

假设:

  • 每个API测试用例平均覆盖: 20-40行代码
  • 200个测试用例: 4,000-8,000行代码
  • 400个测试用例: 8,000-16,000行代码

总代码库: 76,294行

覆盖率计算:

  • 200个测试用例: 4,000-8,000行 / 76,294行 = 5-10%
  • 400个测试用例: 8,000-16,000行 / 76,294行 = 10-21%

结论:

  • ✅ 200-400个API测试用例可以达到10-15%覆盖率
  • ✅ 可以满足阶段1的CI/CD要求（10%）

✅ CI/CD兼容性分析

当前CI/CD行为

  1. 测试运行: ✅ 会运行所有测试
  2. 覆盖率报告: ✅ 会上传覆盖率报告
  3. 覆盖率检查: ⚠️ 当前不检查（设置为0）

实施后的CI/CD行为

阶段1（10%阈值）:

"--cov-fail-under=10",

行为:

  • ✅ 如果覆盖率 ≥ 10%: CI/CD通过
  • ❌ 如果覆盖率 < 10%: CI/CD失败

预期:

  • ✅ 200-400个API测试用例 → 10-15%覆盖率
  • ✅ CI/CD会通过

🚀 实施步骤

步骤1: 立即开始（今天）

  1. 保持当前配置（--cov-fail-under=0）

    • 允许CI/CD通过
    • 开始添加API测试用例

  2. 添加API测试用例

    • 为所有API文件添加基础测试
    • 目标: 200-400个测试用例
    • 时间: 1周内

步骤2: 第一周结束时

  1. 运行覆盖率报告

    pytest tests/ --cov=shared/src --cov=private/core/src --cov=private/platform/src --cov-report=term

  2. 验证覆盖率

    • 如果达到10%+: 更新配置
    • 如果未达到10%: 继续添加测试用例

  3. 更新CI/CD配置

    "--cov-fail-under=10",  # 最低覆盖率10%

  4. 提交并验证

    • 提交代码
    • 验证CI/CD通过

步骤3: 持续改进

每周检查:

  • 运行覆盖率报告
  • 评估是否需要调整阈值
  • 继续添加测试用例

每月调整:

  • 根据实际覆盖率调整阈值
  • 逐步提高要求（10% → 20% → 30% → 50% → 70%）

📋 风险与应对

风险1: 覆盖率未达到10%

可能性: 中等 原因:

  • API测试用例覆盖的代码量可能少于预期
  • 某些API文件代码量较小

应对:

  • 继续添加更多API测试用例
  • 添加服务类测试用例
  • 临时保持--cov-fail-under=0直到达到10%

风险2: CI/CD失败

可能性: 低（如果按计划实施） 原因:

  • 覆盖率突然提高到10%阈值
  • 某些测试失败

应对:

  • 先验证本地覆盖率
  • 确保所有测试通过
  • 逐步提高阈值（5% → 8% → 10%）

风险3: 测试用例质量

可能性: 中等 原因:

  • 快速添加的测试用例可能质量不高
  • 主要覆盖表面，不覆盖深层逻辑

应对:

  • 确保测试用例覆盖主要路径
  • 后续添加服务类测试提高质量
  • 定期审查测试用例

✅ 结论

回答您的问题

Q: 200-400个API测试用例能达到CI/CD要求吗？

A: 是的，可以达到！

详细分析:

  1. ✅ 当前CI/CD要求: 0%（不会失败）
  2. ✅ 阶段1目标: 10%覆盖率
  3. ✅ 200-400个API测试用例: 预计10-15%覆盖率
  4. ✅ CI/CD兼容: 可以设置--cov-fail-under=10

实施建议:

  1. 立即开始: 添加API测试用例（保持--cov-fail-under=0）
  2. 第一周: 完成200-400个API测试用例
  3. 第一周末: 验证覆盖率，更新为--cov-fail-under=10
  4. 持续改进: 逐步提高阈值（10% → 20% → 30% → 50% → 70%）

关键点:

  • ✅ 可以满足CI/CD要求（逐步提高阈值）
  • ✅ 风险可控（先验证再提高）
  • ✅ 可持续（持续添加测试用例）

📊 实施时间表

阶段 时间 测试用例 覆盖率目标 CI/CD阈值
阶段1 第1周 200-400个API 10-15% 10%
阶段2 第2-3周 +150-300个服务类 20-25% 20%
阶段3 第1个月 +200-400个平台模块 30-40% 30%
阶段4 第3个月 +500-1,000个全面 50-70% 50-70%

总结: 200-400个API测试用例可以满足CI/CD要求，建议采用逐步提高阈值的策略，确保CI/CD稳定通过。