Las capacidades del proyecto están documentadas en los repositorios públicos enlazados. No se afirma su adopción en producción.
Gateway / flujo de solicitudes
GET /api/orders 200
ClienteGatewayServicio
autenticaciónlímite de solicitudescortacircuitos
El problema
Las aplicaciones que se comunican con varios servicios necesitan repetidamente enrutamiento, autenticación, límites de tráfico y gestión de fallos. Implementar estas políticas por separado puede generar comportamientos inconsistentes y trabajo duplicado.
Este proyecto explora un punto de entrada compartido con configuración tipada y validada, además de herramientas operativas.
El sistema
El gateway dirige solicitudes HTTP a los servicios de destino. Sus funciones documentadas incluyen autenticación y límites de solicitudes por ruta, cortacircuitos, balanceo de carga, tiempos de espera, políticas de reintentos, caché, proxy de WebSocket y métricas de Prometheus.
Un panel de Next.js permite configurar el sistema visualmente, mientras que una herramienta de línea de comandos permite gestionar la configuración e importar y exportar OpenAPI.
Decisiones y compromisos
La configuración como contrato. Las rutas se validan antes de registrarse, de modo que una configuración incorrecta se detecta explícitamente durante el arranque.
Políticas en un límite compartido. La autenticación, el control de tráfico y el seguimiento de solicitudes pueden aplicarse de forma consistente antes de llegar a los servicios de la aplicación.
El comportamiento operativo forma parte de la API. Un tiempo de espera agotado, un circuito abierto y un fallo de autenticación tienen significados distintos. Necesitan respuestas predecibles y registros útiles.
El estado distribuido necesita límites explícitos. El repositorio documenta tanto el estado local como los almacenes compartidos inyectables, incluidas las limitaciones de las instantáneas del cortacircuitos cuya última escritura prevalece. Compartir visibilidad no implica actualizaciones atómicas entre procesos.
Explorar la ruta de fallo
El ejemplo interactivo de esta página ilustra un circuito disponible y uno abierto. Es una simulación simplificada: no ejecuta el gateway ni modela sus umbrales de fallo o temporizadores de recuperación.
Evidencia y siguientes pasos
El repositorio público incluye documentación de arquitectura, ejemplos ejecutables y comandos de pruebas. Son el punto de partida para inspeccionar la implementación. Este portafolio no afirma cifras verificadas de forma independiente sobre capacidad de procesamiento, disponibilidad o adopción en producción.
API Gateway
Explora el sistema
Sigue tres rutas de fallo documentadas. Son trazas ilustrativas basadas en ejemplos del repositorio; no son solicitudes a un gateway en ejecución.
Recorrido de la solicitud
01Cliente
02Políticas de la ruta
03Servicio de destino
04Respuesta al cliente
La ruta seleccionada aplica sus políticas antes de reenviar. La autenticación puede detener la solicitud en el límite; un tiempo de espera puede cancelar una solicitud al servicio; un circuito abierto evita llamar al servicio que falla.
Fallo de autenticación401+
Traza ilustrativa
GET /reports sin el encabezado x-api-key.
La ruta exige una clave de API; se rechaza la solicitud.
No se llama al servicio de destino. El cliente recibe 401.
Un contrato de rutas tipado centraliza las políticas. La alternativa es escribir middleware en cada servicio, lo que ofrece flexibilidad pero duplica validaciones y conexiones entre políticas. La configuración también requiere revisión y pruebas.
Controles de fallo separados
Los tiempos de espera limitan la espera; los cortacircuitos detienen llamadas repetidas a una dependencia con fallos. Los reintentos son otra decisión: habilitarlos indiscriminadamente puede amplificar la carga o duplicar escrituras.
Ejecución local registrada
Del fallo a la recuperación
Respuestas HTTP capturadas ejecutando el gateway con un servicio de prueba local. El umbral es de tres fallos y la espera de recuperación es de un segundo. La reproducción resume los pasos; no representa su duración real.