Skip to content
262distPublic

About

Proyecto de microservicios para pagos y comercio institucional para la actividad práctica del curso de DIST 2026-2

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

pagatu

Sistema distribuido de comercio electrónico — proyecto del curso Desarrollo de Aplicaciones Distribuidas (DIST), UPeU 2026-2.

Documentación

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:

262dist.github.io/pagatu

Estructura del repositorio

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)

Requisitos

  • 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)

Arranque rápido en DEV

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:run
cd infra/pagatu-eureka
.\mvnw.cmd spring-boot:run
cd infra/pagatu-gateway
.\mvnw.cmd spring-boot:run

2. 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 -d

Verifica 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 -d

Verifica 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:run
cd services/pagatu-orden-ms
docker compose -f compose-dev.yml up -d
.\mvnw.cmd spring-boot:run
cd services/pagatu-pago-ms
docker compose -f compose-dev.yml up -d
.\mvnw.cmd spring-boot:run

pagatu-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 -d

Detener

Ctrl+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.

Puertos en DEV

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).

Arquitectura

Diagramas C4 (contexto y contenedores) en docs/index.md.

Tecnologías

  • 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)

About

Proyecto de microservicios para pagos y comercio institucional para la actividad práctica del curso de DIST 2026-2

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages