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¶
- El alumno construye primero un microservicio base en
services/catalogo-msy replica el patrón en otros servicios. - La infraestructura en
infra/centraliza configuración, descubrimiento y acceso por Gateway; los microservicios importan configuración conoptional:configserver:${CONFIG_SERVER_URL:http://localhost:18888}. - 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.
- Las pruebas de API se realizan con PowerShell o bash/curl, sin depender de Postman.
- Los flujos asincronos usan mensajería para coordinar ordenes y pagos.
/actuator/healthexiste desde S1. El stack de observabilidad (Prometheus, Loki, Grafana) se levanta sobrecatalogo-ms/orden-msa 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 aauth-ms,cliente-ms,orden-msypago-mscon paneles de diagnóstico y alertas sobre todo el sistema.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-msdeja de confiar en elid_clienteque el request declara y lo toma del JWT ya validado.- El frontend
clients/pagatu-ng(Angular 22) consume el sistema mediante Gateway. - El producto final se valida end-to-end, se estabiliza y se defiende técnicamente.
Enlaces¶
- Sílabo 2026-2
- S1 - Construcción de un servicio base
- S2 - Gestión centralizada de configuración y ambientes
- S3 - Registro, descubrimiento y ejecución concurrente de servicios
- S4 - Punto único de acceso y distribución de tráfico
- S5 - Evaluación de la Unidad I
- S6 - Comunicación síncrona resiliente entre servicios
- S7 - Seguridad distribuida y control de acceso
- Guía de Proyecto Sello