Arquitetura webhook-first

Porque webhook-first

O provider externo (Stripe) é a fonte de verdade para eventos críticos. O Beacon prioriza ingestão rápida e validação mínima na entrada para evitar timeouts e perda de eventos.

Fluxo de processamento

1. 11) Ingestão

   Receber webhook, validar assinatura e persistir o evento.

2. 22) Ack rápido

   Responder 2xx o mais cedo possível após persistência segura.

3. 33) Processamento assíncrono

   Executar lógica de negócio por worker com controlo de retries.

4. 44) Observabilidade

   Publicar estado final e métricas de fila, latência e falhas.

Garantias operacionais

• Deduplicação por event.id para reentregas.
• Reprocessamento seguro com idempotência funcional.
• Isolamento de falhas por tipo de evento e organização.

Métricas mínimas