Integración entre sistemas
Esta ficha documenta el caso técnico. La demo real se prueba en directo, con datos ficticios, en unos minutos.
El problema
Cuando dos sistemas no se hablan entre sí, alguien acaba siendo el puente: exporta de uno, transforma los datos a mano e importa en el otro. Cada exportación manual es una oportunidad para duplicar, perder o desincronizar algo.
Proceso anterior
Pedido en un sistema → exportar a una hoja de cálculo → transformar los campos a mano (los nombres casi nunca coinciden entre plataformas) → importar en el otro sistema → confiar en que nadie se ha equivocado ni ha repetido el envío.
La solución
Dos sistemas independientes — una Tienda y un Almacén/ERP — conectados por una capa de integración real: un webhook firmado dispara el proceso, la capa valida y transforma el contrato de un sistema al del otro, y llama a la API del segundo sistema. Cada paso queda registrado con su duración real.
Cómo funciona
Al crear un pedido en la Tienda (Sistema A), esta persiste el pedido y emite un evento firmado con HMAC-SHA256 hacia un endpoint de webhook independiente. La capa de integración verifica la firma y el timestamp, comprueba si ese evento ya se había recibido antes (idempotencia), valida el contrato, lo transforma a los nombres de campo que espera el Almacén (Sistema B) y llama a su API. Sistema B es quien decide si el SKU recibido existe en su propio catálogo — si no existe, rechaza el documento; si existe, lo crea y descuenta el stock en una única operación atómica. Un error de conexión temporal se marca como reintentable y puede reintentarse manualmente hasta 3 veces; un error de datos, no.
Decisiones técnicas
- Tres bases de datos físicamente separadas (Sistema A, motor de integración, Sistema B) — nunca tablas compartidas con un simple campo que las distinga. Ninguno de los tres puede leer las tablas de otro aunque quisiera, igual que pasaría si mañana Sistema B fuera un ERP de un proveedor externo.
- La llamada entre sistemas es siempre HTTP real (webhook firmado, API con Bearer token) — nunca una llamada de función interna disfrazada de integración.
- Idempotencia como restricción de base de datos (UNIQUE), no solo una comprobación en código — el mismo evento enviado varias veces produce, de forma garantizada, un único efecto.
- Es Sistema B quien valida si un SKU existe, porque es el propietario real de ese catálogo — decisión tomada durante la implementación cuando quedó claro que forzar esa validación en otra capa habría sido menos honesto que dejar que cada sistema valide lo que realmente le pertenece.
- Reintento manual, con un límite de 3 intentos, en vez de reintento automático en segundo plano — evita depender de colas o tareas programadas adicionales para una demo pública de bajo volumen.
- Cero datos personales: clientes y catálogo son perfiles ficticios preconfigurados (dominio .invalid, reservado por IANA), nunca introducidos por quien prueba la demo.
Caso ficticio, implementación real — mismo principio que el resto del Lab: ningún paso que la interfaz muestra como completado (firma verificada, transformación, sincronización) es una animación; ha ocurrido de verdad en el servidor antes de mostrarse.
Estado actual
Funcional de extremo a extremo y verificado en producción: creación de pedidos en Sistema A, webhook firmado, motor de integración con idempotencia real, transformación de contrato, sincronización con Sistema B (documento + descuento de stock atómico), reintento manual y reenvío de evento — los cuatro escenarios (normal, SKU inexistente, webhook duplicado, Sistema B no disponible) probados en vivo, no solo en local.
Evolución
Primera versión publicada: Sistema A, motor de integración (firma, idempotencia, transformación, máquina de estados, reintentos) y Sistema B, con 54 tests nuevos (91 en total en el proyecto) y verificación manual de los cuatro escenarios tanto en navegador como en producción.
Concepto definido: contrato de sincronización entre ambos sistemas. Todavía sin código.
Evidencia técnica (arquitectura y stack)
Arquitectura
Cloudflare Pages Functions bajo tres espacios de nombres (/system-a, /webhooks, /system-b, /motor), cada uno con su propia base de datos Cloudflare D1 dedicada. El webhook usa HMAC-SHA256 con el timestamp incluido en el material firmado (protección anti-repetición). La llamada de la capa de integración a Sistema B usa una API key interna en cabecera Bearer, generada exclusivamente para esta demo. Sin Cloudflare Queues, Durable Objects ni Cron Trigger adicionales — ninguno resolvía un problema real a esta escala; la limpieza de datos públicos a las 24 horas usa el mismo patrón de purga diferida que ya prueba la demo de Automatización de solicitudes, sin recursos nuevos.
Stack real
- Cloudflare Pages Functions
- Cloudflare D1 (×3, aisladas)
- HMAC-SHA256
- Astro (frontend estático)