Saltar a contenido

NovaMarket — Sistemas Distribuidos

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.

NovaMarket es una plataforma distribuida para la gestión de operaciones comerciales a gran escala, desarrollada con una arquitectura de microservicios. Diseñada para soportar múltiples puntos de venta, operaciones concurrentes y crecimiento horizontal, integra autenticación centralizada, administración de catálogo, inventario, ventas y pagos.

Entorno integrado para construir ese sistema mediante laboratorios reproducibles con Docker y Spring Cloud: infraestructura, microservicios escalables, cliente Angular, mensajería, observabilidad e identidad con Keycloak.

Alcance del producto

No es un POS para un pequeño establecimiento aislado. La arquitectura de microservicios responde a varias cajas, varias tiendas, muchos usuarios y alto volumen de transacciones — escenario donde un monolito deja de ser viable.


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.

Ver definición completa del producto →


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.

Sesión Tema Producto de sesión
S1 Servicio base REST ms-rubro — CRUD, PostgreSQL, Swagger, Actuator
S2 Configuración centralizada Config Server + config-repo dev/prod
S3 Registro y descubrimiento Eureka + instancias registradas
S4 Gateway y balanceo Punto único :18080
S5 Evaluación U1 Sistema base integrado

U2 — Sistema distribuido robusto

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

Sesión Tema Producto de sesión
S6 Comunicación resiliente Circuit Breaker ms-articulo → ms-rubro
S7 Seguridad distribuida Keycloak + JWT + roles
S8 Mensajería asíncrona Kafka orden-eventos
S9 Consistencia distribuida Venta + pago + stock
S10 Observabilidad Prometheus, Loki, Grafana
S11 Frontend Angular POS (market-ng)
S12 Evaluación U2 Sistema robusto validado

U3 — Validación y consolidación

Producto U3: NovaMarket end-to-end, documentado y defendido.

Sesión Tema
S13 Validación end-to-end
S14 Revisión y estabilización
S15 Defensa técnica
S16 Evaluación final

Índice completo de sesiones →


Arquitectura NovaMarket

flowchart TB
    subgraph Cliente
        NG[market-ng :4200]
    end
    subgraph Identidad
        KC[Keycloak :41880]
    end
    subgraph Infra
        GW[Gateway :18080]
        EU[Eureka :18761]
        CFG[Config :18888]
    end
    subgraph Negocio
        RUB[ms-rubro]
        ART[ms-articulo]
        VEN[ms-venta]
        PAG[ms-pago]
    end
    subgraph Mensajeria
        KF[Kafka]
    end
    subgraph Observabilidad
        GF[Grafana :13000]
    end
    NG -->|OIDC| KC
    NG -->|Bearer JWT| GW
    GW --> RUB & ART & VEN & PAG
    VEN --> ART & PAG
    VEN --> KF --> PAG
    GW --> GF

Diagrama y detalle →


Flujo de trabajo

  1. Construir microservicios en services/ (ms-rubro, ms-articulo, ms-venta, ms-pago).
  2. Centralizar configuración en infra/config-repo.
  3. Registrar servicios en Eureka y acceder vía Gateway.
  4. Autenticar con Keycloak (realm novamarket).
  5. Procesar ventas en Angular POS con eventos Kafka.
  6. Monitorear con Grafana.
  7. Validar end-to-end y defender el producto.

Guía de arranque DEV →


Enlaces rápidos

Recurso Enlace
Manual de usuario Manual de usuario
Manual de funcionamiento Manual de funcionamiento
Frontend funcionalidad Funcionalidad Angular
Publicar docs (GitHub Pages) Guía GitHub Pages
Arranque local Desarrollo (DEV)
Producción Docker Producción (PROD)
Keycloak y roles Seguridad
Puertos DEV/PROD Referencia de puertos
Negocio retail Dominio de negocio
Kafka Eventos
Grafana Observabilidad
Sustentación equipo Equipo 3 personas
Informes Plantilla · Rúbrica

Accesos DEV (referencia)

Servicio URL
App Angular http://localhost:4200
Gateway http://localhost:18080
Keycloak admin http://localhost:41880/admin
Eureka http://localhost:18761
Grafana http://localhost:13000
Kafka UI http://localhost:41085

Login app: cajero / cajero123 · admin / admin123 · supervisor / supervisor123