Backend Coverage Integration (PHPUnit/Pest + Codecov)

[kevalyq]

Parent Epic: #189

🎯 Goal

Configure PHPUnit/Pest code coverage reporting and integrate Codecov into the api repository CI pipeline.

📝 Tasks

• Update phpunit.xml to include coverage configuration
• Modify .github/workflows/php-ci.yml to generate coverage with Xdebug
• Add Codecov upload step to CI workflow
• Add coverage badge to api/README.md
• Verify coverage reports appear in Codecov dashboard
• Test coverage on sample PR

✅ Acceptance Criteria

• PHPUnit generates Clover XML coverage report
• CI workflow uploads coverage to Codecov
• Coverage badge displays in README
• All existing tests pass (no regressions)
• Coverage visible in Codecov dashboard
• Preflight checks pass

🔧 Technical Details

Files to modify:

• api/phpunit.xml - Add coverage source paths (already has <source> element)
• api/.github/workflows/php-ci.yml - Add coverage generation and upload
• api/README.md - Add Codecov badge

Dependencies:

• Codecov GitHub App (organization-level)
• Xdebug (already configured in CI)

📚 References

• PHPUnit Coverage Documentation
• Codecov PHP Integration

🔗 Related

• Parent: Sub-Issue 182.3: Integration Tests + SecretAttachmentPolicy Update #189
• Blocks: Sub-Issue chore(deps): add dependabot config with daily updates #3 (org-level config)

---

Estimated Effort: 1-2 hours
Priority: High

[github-actions]

✅ This issue has been added to the SecPal Feature Roadmap with status: 💡 Ideas

New idea - needs discussion and evaluation

Status Flow:
💡 Ideas → 💬 Discussion → 📥 Backlog → 📋 Planned → 🚧 In Progress → 👀 In Review → ✅ Done

Note: Ideas that won't be implemented should be moved to 🚫 Won't Do with a reason.

[kevalyq]

✅ All Tasks Completed

Backend coverage integration has been successfully implemented via PR #171.

Implemented Features

1. ✅ PHPUnit Coverage Configuration

   • phpunit.xml already had <source> element configured
   • Coverage generation uses Xdebug in CI

2. ✅ CI Workflow Integration

   • Modified .github/workflows/php-ci.yml
   • Added coverage generation step with XDEBUG_MODE=coverage
   • Generates Clover XML format: coverage.xml
   • Uploads to Codecov with backend flag
   • Set fail_ci_if_error: true for strict validation

3. ✅ Documentation

   • Codecov badge added to README.md
   • CHANGELOG updated with integration details

4. ✅ Testing

   • All 279 tests pass
   • Preflight checks pass
   • PHPStan (level max) passes
   • REUSE compliance maintained

Verification

All acceptance criteria met:

• ✅ PHPUnit generates Clover XML coverage report
• ✅ CI workflow uploads coverage to Codecov
• ✅ Coverage badge displays in README
• ✅ All existing tests pass (no regressions)
• ✅ Coverage visible in Codecov dashboard
• ✅ Preflight checks pass

Merged: PR #171 merged on 2025-11-15 at 14:26:11 UTC

Closing as completed. 🎉