Plataforma de Integración API Unificada
Node.jsTypeScriptRabbitMQPostgreSQLOpenAPI

Plataforma de Integración API Unificada

Middleware para conectar ERPs, CRMs y e-commerces con cola de mensajes y retry automático.

El Problema

Empresa con 5+ sistemas desconectados (ERP, CRM, Shopify, MercadoLibre, facturación) necesitaba sincronización bidireccional confiable.

El Enfoque

Middleware Node.js + TypeScript + RabbitMQ para cola de mensajes + PostgreSQL para estado + OpenAPI spec generation. Circuit breaker + retry exponencial + dead letter queue.

// STACK TECNOLÓGICO

Tecnologías elegidas con criterio

Cada tecnología se elige por una razón técnica concreta, no por moda.

Node.jsTypeScriptRabbitMQPostgreSQLPrismaOpenAPI 3.1DockerKubernetes

// DECISIONES CLAVE

Decisiones de arquitectura con trade-offs reales

Cada decisión técnica tiene un costo. Aquí documentamos el porqué y el trade-off.

RabbitMQ vs Kafka

Contexto

Volumen moderado (<100k msgs/día), necesidad de routing complejo y dead letter.

Decisión

RabbitMQ por routing flexible, TTL, DLX nativo y management UI.

Trade-offs

Kafka mejor para alto throughput, pero overkill para este volumen.

OpenAPI Code Generation vs Manual Clients

Contexto

5+ APIs externas con specs cambiantes.

Decisión

Orval para generar clientes TypeScript + Zod schemas desde OpenAPI specs.

Trade-offs

Setup inicial vs cero drift entre spec y cliente, regeneración automática en CI.

// RESULTADOS

Resultados medibles

Métricas reales, no vanidad. Lo que importa al negocio.

99.97%

Uptime

Últimos 12 meses

< 30s

Tiempo sync

End-to-end promedio

-95%

Errores manuales

vs procesos manuales previos

Arquitectura robusta para integración de múltiples sistemas.
Concepto — Integración Empresarial