Skip to content

DISTribuidas 2026-2

Curso práctico de sistemas distribuidos con microservicios, configuración centralizada, descubrimiento de servicios, Gateway, seguridad, resiliencia, mensajería asíncrona, consistencia distribuida, observabilidad e integración frontend.

pagatu es un entorno integrado para construir un sistema distribuido de comercio electrónico mediante laboratorios reproducibles basados en Docker y Spring Cloud. El proyecto unifica infraestructura, microservicios, cliente frontend, mensajería, observabilidad y documentación para que cada equipo pueda adaptar el sistema a su proyecto final.

Producto del curso

Producto del curso = Producto U3:

Sistema distribuido de microservicios end-to-end, configurable, escalable,
seguro, resiliente, consistente, observable, integrado con frontend y defendido
técnicamente.

Resultado esperado del curso:

Al finalizar el curso, el estudiante implementa, integra y sustenta un sistema distribuido basado en microservicios. La solución debe ejecutarse de forma reproducible en desarrollo y producción local, exponer evidencias de configuración, registro, enrutamiento, escalado, seguridad, comunicación entre servicios, mensajería asíncrona, consistencia distribuida, observabilidad, persistencia e integración frontend. El producto se presenta en equipo, pero cada estudiante evidencia y defiende su aporte individual.

Contenido

U1: Sistema distribuido base orientado a producción

Producto U1: sistema distribuido base funcional, configurable y preparado para múltiples instancias.

Resultado esperado U1: el estudiante construye un primer servicio REST funcional, externaliza configuración por ambientes, registra servicios dinámicamente, accede al sistema mediante un punto único de entrada y demuestra distribución de tráfico entre instancias.

Sesión Tema (sílabo) MS que se toca Trabajo principal
S1 Construcción de un servicio base para un sistema distribuido. catalogo-ms Servicio REST base, PostgreSQL, Swagger, Actuator.
S2 Gestión centralizada de configuración y ambientes. catalogo-ms Config Server + config-repo; pagatu-catalogo-ms migrado a Config Client en DEV (y, opcionalmente, en producción local). orden-ms y cliente-ms no se construyen en esta sesión — quedan como trabajo autónomo (ver Alcance por microservicio): un CRUD básico para orden-ms, y para cliente-ms además el autocompletado vía RENIEC/SUNAT; orden-ms referenciará su id_cliente sin llave foránea.
S3 Registro, descubrimiento y ejecución concurrente de servicios. catalogo-ms, orden-ms Eureka (pagatu-eureka); en clase, catalogo-ms se registra con múltiples instancias visibles en el dashboard. Como trabajo autónomo, orden-ms se migra a Config Client (pendiente desde S2) y se conecta a Eureka con el mismo patrón. De forma opcional (según recursos de cómputo del equipo), se levantan también Prometheus y Loki, descubriendo instancias vía Eureka.
S4 Punto único de acceso y distribución de tráfico. catalogo-ms, orden-ms Gateway enruta a ambos; balanceo de carga entre instancias. Se completan Prometheus y Loki (si el equipo no los levantó ya en S3, opcional) y se agrega Grafana con paneles básicos sobre esas métricas y logs.
S5 Integración del sistema distribuido base: servicios, configuración centralizada, descubrimiento, ejecución concurrente, Gateway y balanceo de carga. — Sustentación del sistema base, con evidencia de operación de los MS en los paneles de Grafana: instancias registradas en Eureka, balanceo de carga entre ellas y métricas/logs en vivo.

U2: Sistema distribuido robusto

Producto U2: sistema distribuido seguro, resiliente, consistente, observable e integrado con cliente frontend.

Resultado esperado U2: el estudiante implementa comunicación síncrona resiliente, seguridad distribuida, mensajería asíncrona, consistencia eventual en procesos de negocio, observabilidad operacional e integración frontend mediante el punto único de acceso.

Sesión Tema (sílabo) MS que se toca Trabajo principal
S6 Comunicación síncrona resiliente entre servicios. orden-ms → catalogo-ms Feign + Circuit Breaker: orden-ms valida catálogo antes de crear la orden.
S7 Seguridad distribuida y control de acceso. auth-ms (nuevo), cliente-ms JWT propio con Spring Security en clase, firmado con clave asimétrica y con claves públicas publicadas (JWKS), y con roles en tablas propias — diseñado con los mismos claims y el mismo modelo de OAuth2 que Keycloak, que lo reemplazará después sin cambiar el Gateway ni los microservicios (solo una propiedad); Gateway y orden-ms como Resource Server. orden-ms deja de aceptar id_cliente en el request y lo toma del JWT ya validado; pagatu-cliente-ms (construido en S2) queda protegido con los mismos roles.
S8 Mensajería asíncrona entre servicios. orden-ms → pago-ms (nuevo) orden-ms publica orden.creada (topic orden-eventos); pago-ms lo consume y publica pago.validado (topic pago-eventos); orden-ms consume pago-eventos y pasa la orden a PAGADA.
S9 Consistencia distribuida en procesos de negocio. orden-ms, pago-ms Idempotencia, compensación, manejo de eventos duplicados. Si el pago falla, pago-ms publica pago.fallido en pago-eventos y orden-ms lo consume para compensar la orden ya confirmada.
S10 Observabilidad y diagnóstico de sistemas distribuidos. todos, Keycloak Extiende Prometheus/Loki/Grafana (ya en pie desde S3-S4) a orden-ms, pago-ms y Keycloak (auth-ms ya fue retirado en S07b — Keycloak necesita un target estático de Prometheus, no se registra en Eureka); agrega paneles de diagnóstico y alertas sobre todo el sistema, no solo catalogo-ms.
S11 Integración con cliente frontend. Angular 22, Keycloak (reemplaza auth-ms) Cliente consumiendo por Gateway (catálogo, crear orden, ver pago) con login real Authorization Code + PKCE contra Keycloak; "Mis pedidos" refleja la consistencia eventual real (PENDIENTE_PAGO → PAGADA/CANCELADA) con polling, sin recargar la página.
S12 Integración del sistema distribuido robusto: comunicación resiliente, seguridad, mensajería, consistencia eventual, observabilidad e integración frontend. — Sustentación del sistema robusto.

U3: Validación y consolidación del producto del curso

Producto U3 / producto del curso: sistema distribuido de microservicios end-to-end, validado, documentado, estabilizado y defendido técnicamente.

Resultado esperado U3: el estudiante integra los componentes desarrollados en las unidades anteriores, valida flujos completos, estabiliza documentación y despliegue local, prepara evidencias técnicas y sustenta el producto final. La defensa es grupal, pero la nota es individual.

Sesión Tema (sílabo) MS que se toca Trabajo principal
S13 Validación end-to-end del producto del curso. todos Pruebas end-to-end del flujo completo: catálogo, orden, pago, seguridad, mensajería.
S14 Revisión técnica y estabilización del producto. todos Documentación, evidencias, configuración y despliegue local estabilizados.
S15 Integración y validación del sistema distribuido: arquitectura, seguridad, mensajería, consistencia, observabilidad, frontend y despliegue reproducible. todos Sustentación grupal del sistema completo.
S16 Integración de sistemas distribuidos: servicios, configuración, comunicación, resiliencia, seguridad, consistencia, observabilidad, pruebas y despliegue. todos Evaluación individual final: demostración y preguntas técnicas pendientes.

Arquitectura pagatu v2026

Nivel 1: Contexto del sistema (System Context - C4 nivel 1)

flowchart LR
    Usuario(["Usuario - estudiante o administrador"])
    Pagatu["pagatu - sistema distribuido de comercio electrónico"]
    PaymentGateway["Pasarela de pagos externa"]

    Usuario -->|"usa"| Pagatu
    Pagatu -->|"autoriza / confirma pago"| PaymentGateway

    classDef system fill:#eef6ff,stroke:#2b6cb0,stroke-width:2px,color:#111;
    classDef external fill:#fff3cd,stroke:#b7791f,stroke-width:2px,color:#5f370e;
    class Pagatu system;
    class PaymentGateway external;

pagatu se ve como una sola caja negra: sin microservicios, sin Gateway, sin Kafka por dentro. Solo importa quién lo usa (el usuario) y con qué sistema externo conversa (la pasarela de pagos). El detalle interno aparece recién en el nivel 2.

Nivel 2: Contenedores (Container diagram - C4 nivel 2)

%%{init: {"flowchart": {"nodeSpacing": 18, "rankSpacing": 28, "curve": "basis"}} }%%
flowchart LR
    subgraph Infra["infra"]
        Config["Config - D 18888 - P 28888"]
        Eureka["Eureka - D 18761 - P 28761"]
        Gateway["Gateway - D 18080 - P 28080"]
    end

    subgraph Runtime["microservicios"]
        subgraph Identity["identidad"]
            Auth["auth-ms (Spring Security en clase, Keycloak despues) - dinamico"]
            AuthDB[("auth_db - D 15431 - P 25431")]
            Auth --> AuthDB
            Cliente["cliente-ms - dinamico"]
            ClienteDB[("cliente_db - D 15433 - P 25433")]
            Cliente --> ClienteDB
        end

        subgraph Services["services"]
            Catalogo["catalogo-ms - dinamico"]
            CatalogoDB[("catálogo_db - D 15432 - P 25432")]
            Orden["orden-ms - dinamico"]
            OrdenDB[("orden_db - D 15434 - P 25434")]
            Pago["pago-ms - dinamico"]
            PagoDB[("pago_db - D 15435 - P 25435")]

            Catalogo --> CatalogoDB
            Orden --> OrdenDB
            Pago --> PagoDB
            Orden -->|"Feign: valida catálogo"| Catalogo
        end
    end

    subgraph Messaging["kafka"]
        Broker["Kafka broker - D 19092 - P 29092"]
        KafkaUI["Kafka UI - D 18085 - P 28085"]
        KafkaUI --> Broker
    end

    subgraph External["sistemas externos"]
        PaymentGateway["Pasarela de pagos externa"]
        ReniecSunat["RENIEC / SUNAT"]
    end

    Angular --> Gateway
    Gateway --> Auth
    Gateway --> Cliente
    Gateway --> Catalogo
    Gateway --> Orden
    Gateway --> Pago
    Cliente -->|"consulta DNI / RUC"| ReniecSunat

    Config -. "carga configuración" .-> Eureka
    Config -. "carga configuración" .-> Gateway
    Config -. "carga configuración - configserver" .-> Runtime
    Runtime -. "registra instancias" .-> Eureka
    Gateway -. "descubre servicios" .-> Eureka

    Orden -->|"orden-eventos"| Broker
    Broker -->|"orden-eventos"| Pago
    Pago -->|"pago-eventos"| Broker
    Broker -->|"pago-eventos"| Orden
    Pago -->|"autoriza / confirma pago"| PaymentGateway

    classDef external fill:#fff3cd,stroke:#b7791f,stroke-width:2px,color:#5f370e;
    class PaymentGateway,ReniecSunat external;

    subgraph Client["clients"]
        Angular["pagatu-ng (Angular 22) - D 4200"]
    end

    subgraph Obs["observabilidad"]
        Prometheus["Prometheus - D 19090 - P 29090"]
        Loki["Loki - D 13100 - P 23100"]
        Grafana["Grafana - D 13000 - P 23000"]
        Grafana --> Prometheus
        Grafana --> Loki
    end

    Angular ~~~ Prometheus

Convención del diagrama: las flechas continuas representan interacciones de negocio o consultas directas; las flechas punteadas representan dependencias de infraestructura, configuración o descubrimiento.

Flujo de trabajo

  1. El alumno construye primero un microservicio base en services/catalogo-ms y replica el patrón en otros servicios.
  2. La infraestructura en infra/ centraliza configuración, descubrimiento y acceso por Gateway; los microservicios importan configuración con optional:configserver:${CONFIG_SERVER_URL:http://localhost:18888}.
  3. Los microservicios se ejecutan en DEV con Maven y bases de datos en Docker; al cierre de cada sesión se valida producción local con Docker.
  4. Las pruebas de API se realizan con PowerShell o bash/curl, sin depender de Postman.
  5. Los flujos asincronos usan mensajería para coordinar ordenes y pagos.
  6. /actuator/health existe desde S1. El stack de observabilidad (Prometheus, Loki, Grafana) se levanta sobre catalogo-ms/orden-ms a más tardar en S4 (Prometheus/Loki son opcionales ya en S3, según recursos de cómputo), para tener evidencia visual de operación desde la sustentación de S5; en S10 se extiende a auth-ms, cliente-ms, orden-ms y pago-ms con paneles de diagnóstico y alertas sobre todo el sistema.
  7. pagatu-cliente-ms (autónomo, desde S2) guarda el perfil del cliente (DNI/RUC, nombre/razón social) y lo autocompleta consultando RENIEC (personas naturales) o SUNAT (personas jurídicas) por el número de documento — el sistema no vive aislado, se integra con servicios externos del Estado peruano igual que con la pasarela de pagos. Desde S7, orden-ms deja de confiar en el id_cliente que el request declara y lo toma del JWT ya validado.
  8. El frontend clients/pagatu-ng (Angular 22) consume el sistema mediante Gateway.
  9. El producto final se valida end-to-end, se estabiliza y se defiende técnicamente.

Enlaces