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 |
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
Flujo de trabajo
- Construir microservicios en
services/(ms-rubro,ms-articulo,ms-venta,ms-pago). - Centralizar configuración en
infra/config-repo. - Registrar servicios en Eureka y acceder vía Gateway.
- Autenticar con Keycloak (realm
novamarket). - Procesar ventas en Angular POS con eventos Kafka.
- Monitorear con Grafana.
- Validar end-to-end y defender el producto.
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