Operations

Deployments

• Build from services/webhooks/Dockerfile.
• The container runs granian against services.webhooks.main:app.
• Default listen port is 8080 and honors the PORT environment variable.

Startup behavior

• Loads WEBHOOKS_API_KEY and optional WEBHOOKS_SENTRY_DSN from Secret Manager.
• Validates required Cloud Tasks settings at startup.

Monitoring and alerts

• Sentry is enabled when WEBHOOKS_SENTRY_DSN is available.
• Validation errors are logged with request context (payload omitted unless DEBUG).

SLOs and SLIs

• TBD. Define availability and latency targets for webhook ingestion.

Scaling and performance

• Stateless service with Cloud Tasks backpressure.
• Payload size capped at 750 KiB; invoices per request capped at 100.