Sistema distribuido · 2026
Relay — entrega confiable de webhooks
Una plataforma que entrega eventos a sistemas externos y garantiza que ninguno se pierda, incluso cuando el destino falla.
Mi aporte
Diseñé y construí una plataforma de entrega de eventos con reintentos acotados, firma criptográfica de cada solicitud y trazabilidad completa de todos los intentos.
Proyecto propio. El repositorio es público y la demostración se ejecuta localmente con Docker Compose; todavía no hay una instancia desplegada.
Tecnologías
- Go
- Next.js
- PostgreSQL
- Redis
- OpenTelemetry
- Docker
El contexto
Cuando una aplicación avisa a un sistema externo —un pago aprobado, un pedido creado— ese aviso puede perderse: el destino está caído, responde tarde o falla de forma intermitente. Reintentar sin control genera duplicados; no reintentar pierde información de negocio.
La solución
La aceptación y el trabajo de entrega se guardan en una sola transacción de base de datos, de modo que un evento aceptado nunca desaparece aunque el resto del sistema falle. Los intentos ocurren en segundo plano con esperas crecientes, y lo que agota su presupuesto queda en una cola de no entregables para inspección y reenvío manual, sin perder el historial. Cada solicitud se firma para que el receptor pueda verificar su origen y detectar manipulación.
Qué incluye
- Aceptación durable con clave de idempotencia: repetir una publicación no duplica entregas.
- Reintentos con espera creciente, cola de no entregables y reenvío que conserva el historial completo.
- Firma HMAC por solicitud y trazabilidad de cada intento con OpenTelemetry.
¿Te interesa resolver un desafío similar?
Conversemos Ver repositorio