rckrdmrd/template-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
master
template-saas/docs/architecture/adr/ADR-008-webhook-retry-strategy.md
rckrdmrd 50a821a415
Some checks failed
CI / Backend CI (push) Has been cancelled
Details
CI / Frontend CI (push) Has been cancelled
Details
CI / Security Scan (push) Has been cancelled
Details
CI / CI Summary (push) Has been cancelled
Details
[SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Actualizaciones de configuracion

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:08 -06:00

1.2 KiB
Raw Permalink Blame History

id title type status priority supersedes superseded_by version created_date updated_date
ADR-008 Webhook Retry Strategy ADR Accepted P0 N/A N/A 1.0.0 2026-01-10 2026-01-10

ADR-008: Webhook Retry Strategy

Metadata

Campo Valor
ID ADR-008
Estado Accepted
Fecha 2026-01-10
Supersede N/A

Contexto

Los webhooks outbound pueden fallar por multiples razones y se necesita una estrategia robusta de reintentos para garantizar entrega eventual.

Decision

Implementar BullMQ con exponential backoff y Dead Letter Queue para webhooks fallidos.

Implementacion

{
  attempts: 5,
  backoff: {
    type: 'exponential',
    delay: 60000  // 1min, 2min, 4min, 8min, 16min
  }
}

Estrategia de Reintentos

Intento Delay
1 Inmediato
2 1 minuto
3 2 minutos
4 4 minutos
5 8 minutos
DLQ Despues de 5 fallos

Consecuencias

Positivas

  • Alta tasa de entrega eventual (>99.9%)
  • No sobrecarga destinos problematicos

Negativas

  • Delay maximo de entrega: ~15 minutos
  • Complejidad de DLQ

Fecha decision: 2026-01-10 Autores: Claude Code (Arquitectura)