# Registry Webhook Handlers (Docker/Harbor)

## Module
Integrations

## Status
IMPLEMENTED

## Description
Webhook handlers for Docker Registry v2 and Harbor image-push events that trigger async gate evaluation. Accepts webhook payloads at `/api/v1/webhooks/registry/*` and queues gate evaluation jobs via an in-memory Channel-based queue with a background worker.

## Implementation Details
- **API endpoints**: `src/Integrations/StellaOps.Integrations.WebService/IntegrationEndpoints.cs` -- webhook receiver at `/api/v1/webhooks/registry/*`
- **Integration service**: `src/Integrations/StellaOps.Integrations.WebService/IntegrationService.cs` -- processes webhook payloads and queues gate evaluation
- **Harbor plugin**: `src/Integrations/__Plugins/StellaOps.Integrations.Plugin.Harbor/HarborConnectorPlugin.cs` -- Harbor-specific webhook handling
- **GitHub App plugin**: `src/Integrations/__Plugins/StellaOps.Integrations.Plugin.GitHubApp/GitHubAppConnectorPlugin.cs` -- GitHub webhook processing
- **Integration DTOs**: `src/Integrations/__Libraries/StellaOps.Integrations.Contracts/IntegrationDtos.cs` -- webhook payload models
- **WebService program**: `src/Integrations/StellaOps.Integrations.WebService/Program.cs` -- webhook endpoint registration
- **Source**: SPRINT_20251226_001_BE_cicd_gate_integration.md

## E2E Test Plan
- [ ] Verify Docker Registry v2 webhook payloads are accepted
- [ ] Test Harbor image-push webhook triggers gate evaluation
- [ ] Verify Channel-based queue processes jobs asynchronously
- [ ] Test webhook authentication validates payload signatures
- [ ] Verify gate evaluation job queuing under load