Sistema distribuido de comercio electrónico — proyecto del curso Desarrollo de Aplicaciones Distribuidas (DIST), UPeU 2026-2.
La documentación completa del curso (sílabo, guías de sesión paso a paso, arquitectura del sistema) vive en docs/ y se publica como sitio con MkDocs:
pagatu/
├── docs/ # Documentación del curso (MkDocs)
│ ├── sesiones/ # Guías paso a paso (S01, S02, ...)
│ └── silabo_dist_2026_2.md # Sílabo vigente
├── infra/ # Infraestructura que los microservicios necesitan para funcionar
│ ├── pagatu-config/ # Config Server (S2)
│ ├── pagatu-eureka/ # Registro y descubrimiento de servicios (S3)
│ └── pagatu-gateway/ # Punto único de acceso y balanceo de carga (S4)
├── services/ # Microservicios de negocio
│ ├── pagatu-catalogo-ms/ # Categorías y productos (S1)
│ ├── pagatu-orden-ms/ # Órdenes de compra (S2 base autónoma, S6 Feign + Circuit Breaker)
│ ├── pagatu-cliente-ms/ # Perfil de cliente + RENIEC/SUNAT (S2, trabajo autónomo)
│ ├── pagatu-auth-ms/ # Autenticación y emisión de JWT (S7) — retirado en S07b, código conservado como referencia, ya no arranca en el día a día
│ └── pagatu-pago-ms/ # Pagos; consume orden.creada y publica pago.validado (S8)
├── obs/ # Prometheus + Loki + Promtail + Grafana (S3-S4) — observa infra/, services/ y Keycloak desde afuera, no es una dependencia de arranque
├── kafka/ # Kafka y Kafka UI (S8)
├── keycloak/ # Keycloak + su Postgres (S07b) — sustituye a pagatu-auth-ms como servidor de autorización
└── clients/ # Frontends que consumen la API — uno por carpeta (pagatu-frontend/, Angular con login PKCE contra Keycloak, S11; espacio reservado para futuros clientes, p. ej. móvil)
- JDK 21
- Docker Desktop (en DEV solo para PostgreSQL y la observabilidad)
- Git
- No hace falta instalar Maven: cada proyecto trae Maven Wrapper (
mvnw/mvnw.cmd)
El orden importa: primero la infraestructura, después los servicios. Cada aplicación corre en su propia terminal, parada en la carpeta indicada. Los comandos son de PowerShell; en macOS/Linux, .\mvnw.cmd es ./mvnw.
1. Infraestructura (detalle en infra/README.md)
cd infra/pagatu-config
.\mvnw.cmd spring-boot:runcd infra/pagatu-eureka
.\mvnw.cmd spring-boot:runcd infra/pagatu-gateway
.\mvnw.cmd spring-boot:run2. Kafka (detalle en kafka/README.md) — en DEV, pagatu-orden-ms y pagatu-pago-ms corren en el host y se conectan por el puerto externo (localhost:19092), así que técnicamente tolerarían arrancar antes que Kafka. En PROD local no: ahí corren como contenedores en la misma red Docker y se conectan por el puerto interno (pagatu-kafka:9092) — si Kafka no está arriba, el contenedor del servicio ni siquiera arranca. Se levanta primero en los dos ambientes, para que el orden sea siempre el mismo:
cd kafka
docker compose -f compose-dev.yml up -dVerifica en http://localhost:18085 (Kafka UI) que el clúster pagatu-dev aparece conectado.
3. Keycloak (detalle en docs/sesiones/S07b_Seguridad_Distribuida_Keycloak.md) — reemplaza a pagatu-auth-ms como servidor de autorización desde S07b:
cd keycloak
docker compose -f compose-dev.yml up -dVerifica en http://localhost:18180 que la consola de administración de Keycloak responde (admin/admin123).
4. Servicios (detalle en services/README.md) — la base de datos primero, después la aplicación:
cd services/pagatu-catalogo-ms
docker compose -f compose-dev.yml up -d
.\mvnw.cmd spring-boot:runcd services/pagatu-orden-ms
docker compose -f compose-dev.yml up -d
.\mvnw.cmd spring-boot:runcd services/pagatu-pago-ms
docker compose -f compose-dev.yml up -d
.\mvnw.cmd spring-boot:runpagatu-cliente-ms es el ejercicio autónomo de cada equipo (S2): no existe en este repositorio de referencia, así que no hay nada que levantar; si tu equipo lo construyó, súbelo igual que los demás. pagatu-pago-ms sí necesita Kafka arriba (paso 2). pagatu-auth-ms ya no se levanta en el día a día (retirado en S07b, paso 3 de este arranque) — sigue en el repositorio solo como referencia. Detalle de cada uno, con Swagger/health/endpoints, en services/README.md.
5. Verificar
- Dashboard de Eureka:
http://localhost:18761. Deben aparecer los servicios registrados. - Una llamada a través del Gateway:
Invoke-RestMethod -Method Get -Uri "http://localhost:18080/api/v1/categorias"6. Observabilidad (opcional) (detalle en obs/README.md) — solo hace falta para S3-S4, S6 y S10 (la sesión dedicada a observabilidad); para el resto, incluida S11 (cliente Angular), no necesitas tenerlo corriendo. Si Docker ya te va lento, es el primer stack que puedes dejar abajo:
cd obs
docker compose -f compose-dev.yml up -dCtrl+C detiene cada microservicio en su propia terminal. Para los
contenedores, cada carpeta con su propio compose-dev.yml (kafka/,
keycloak/, cada services/pagatu-*-ms/, obs/) baja solo los suyos con
docker compose -f compose-dev.yml down.
Todos los contenedores de pagatu se nombran con el prefijo pagatu-
(pagatu-kafka-dev, pagatu-postgres-orden-dev, pagatu-grafana-dev...) —
para pararlos todos juntos sin entrar carpeta por carpeta:
docker stop (docker ps --filter "name=pagatu-" -q)docker stop $(docker ps --filter "name=pagatu-" -q)Si tienes otros cursos corriendo en paralelo (lambda26, bomerp) y necesitas liberar memoria de verdad, para absolutamente todo lo que esté corriendo en Docker, sin filtrar por nombre:
docker stop (docker ps -q)docker stop $(docker ps -q)docker stop (no down): deja los contenedores creados, listos para un
docker start (docker ps -a --filter "name=pagatu-" -q) rápido la próxima
vez, en vez de recrearlos desde cero con compose up.
| Componente | Puerto (host) |
|---|---|
pagatu-config |
18888 |
pagatu-eureka |
18761 |
pagatu-gateway |
18080 |
pagatu-catalogo-ms |
8080 (2.ª instancia: 8081) |
pagatu-orden-ms |
8082 (2.ª instancia: 8083) |
pagatu-cliente-ms |
8084 |
pagatu-auth-ms |
8085 (retirado en S07b, ya no arranca) |
pagatu-pago-ms |
8086 |
| Keycloak HTTP / management (métricas, S07b) | 18180 / 19000 |
| PostgreSQL: auth / catálogo / cliente / orden / pago / Keycloak | 15431 / 15432 / 15433 / 15434 / 15435 / 15436 |
| Prometheus / Loki / Grafana | 19090 / 13100 / 13000 |
| Kafka broker / Kafka UI (S8) | 19092 / 18085 (PROD local: 29092 / 28085) |
| Angular (S11) | 4200 |
En producción local, los puertos de la infraestructura y de las bases de datos usan el rango 2xxxx (por ejemplo, pagatu-config en 28888).
Diagramas C4 (contexto y contenedores) en docs/index.md.
- Java 21, Spring Boot 4.x
- Spring Cloud: Config, Eureka y Gateway; Feign y Resilience4j (S6)
- Spring Security con JWT (S7) y con Keycloak/OIDC (S07b)
- PostgreSQL, Flyway (migraciones versionadas), MapStruct
- Kafka (S8)
- Prometheus, Loki, Grafana y Keycloak (S07b, S10)
- Docker / Docker Compose
- Angular 22 con login PKCE contra Keycloak (S11)