## Por qué webhook-first

El provider externo (Stripe) es la fuente de verdad de eventos críticos. Beacon prioriza ingestión rápida y validación mínima en entrada para reducir timeouts y pérdida de eventos.

## Flujo de procesamiento

<Steps>
  <Step title="1) Ingestión">Recibir webhook, validar firma y persistir el evento.</Step>
  <Step title="2) Ack rápido">Responder `2xx` lo antes posible tras persistencia segura.</Step>
  <Step title="3) Ejecución asíncrona">Procesar lógica de negocio en workers con retries controlados.</Step>
  <Step title="4) Observabilidad">Publicar estado final y métricas de cola, latencia y fallos.</Step>
</Steps>

## Garantías operacionales

- Deduplicación por `event.id` en reentregas del provider.
- Reproceso seguro con idempotencia funcional.
- Aislamiento de fallos por tipo de evento y organización.

## Métricas mínimas

| Métrica | Objetivo |
| --- | --- |
| Latencia de ack webhook | mantener baja y estable |
| Profundidad de cola | detectar backlog temprano |
| Tasa de retries | identificar degradación de dependencias |
| Tiempo hasta estado final | medir impacto operacional real |

<Tip title="Beneficio">Este modelo reduce riesgo de timeout del provider y mejora previsibilidad de replay/recuperación.</Tip>