Skip to content

About

Microservicio(Event-Driven Architecture, EDA) de pagos hecho con Spring Boot, Java 17, MySQL y Kafka. Consume eventos de ec-orden-ms

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ec-pago-ms

Microservicio de pagos hecho con Spring Boot, Java 17, MySQL y Kafka.

Su trabajo es escuchar eventos de orden-eventos, procesar un pago simulado, guardar el resultado en la tabla pagos y publicar un nuevo evento en pago-eventos.

Que hace este proyecto

Cuando ec-orden-ms publica un mensaje como este:

{
  "tipoEvento": "orden.creada",
  "ordenId": 1,
  "total": 150.0,
  "estado": "PENDIENTE"
}

ec-pago-ms hace lo siguiente:

  1. consume el evento desde Kafka
  2. valida que el evento sea orden.creada
  3. simula el pago
  4. guarda el pago en MySQL
  5. publica un nuevo evento a Kafka

Si el pago sale aprobado:

{
  "tipoEvento": "pago.aprobado",
  "ordenId": 1,
  "monto": 150.0,
  "estado": "APROBADO"
}

Si el pago sale rechazado:

{
  "tipoEvento": "pago.rechazado",
  "ordenId": 1,
  "monto": 150.0,
  "estado": "RECHAZADO"
}

Tecnologias usadas

  • Java 17
  • Spring Boot 3.5.13
  • Spring Web
  • Spring Data JPA
  • MySQL
  • Spring for Apache Kafka
  • Lombok
  • Maven Wrapper

Estructura basica

src/main/java/com/upeu/ec/pagoms
|-- configuracion
|-- controlador
|-- entidad
|-- evento
|-- repositorio
`-- servicio

Clases principales:

  • Pago: entidad que se guarda en base de datos
  • EventoOrden: clase usada para recibir el evento publicado por ec-orden-ms
  • EventoPago: clase usada para publicar el resultado del pago
  • ConsumidorPago: escucha orden-eventos y procesa el flujo
  • ProductorPago: publica en pago-eventos
  • PagoControlador: endpoint simple de prueba

Requisitos

Para levantar el proyecto en desarrollo necesitas:

  • JDK 17 instalado
  • Docker Desktop o Docker Engine
  • Kafka corriendo en localhost:49092
  • MySQL corriendo en localhost:19030

No necesitas instalar Maven manualmente porque el proyecto ya incluye mvnw y mvnw.cmd.

Configuracion dev

El perfil dev usa esta configuracion en application-dev.yml:

  • app: 19031
  • mysql: localhost:19030
  • base de datos: db_ec_pago_ms
  • kafka: localhost:49092

Configuracion prod

El perfil prod usa esta configuracion base en application-prod.yml:

  • app: 9031 dentro del contenedor
  • exposicion externa por Docker: localhost:29031
  • mysql externo del stack: localhost:29030
  • kafka: configurado por EC_KAFKA_BOOTSTRAP_SERVERS
  • red Docker de Kafka en prod: ec-kafka-prod-net

Paso a paso para ponerlo a andar

1. Levantar MySQL de desarrollo

Este proyecto ya trae un docker-compose-dev.yml que solo levanta MySQL.

docker compose -f docker-compose-dev.yml up -d

Si todo va bien, MySQL quedara disponible en:

  • host: localhost
  • puerto: 19030
  • usuario: root
  • clave: root
  • base de datos: db_ec_pago_ms

2. Asegurarte de que Kafka este arriba

ec-pago-ms no levanta Kafka por si solo. Debes tener un broker escuchando en:

localhost:49092

Si en tu entorno Kafka vive en otro proyecto, como ec-kafka, primero levanta ese proyecto.

3. Compilar el proyecto

En Windows:

.\mvnw.cmd clean compile

En Linux o macOS:

./mvnw clean compile

4. Ejecutar la aplicacion

En Windows:

.\mvnw.cmd spring-boot:run

En Linux o macOS:

./mvnw spring-boot:run

La aplicacion arrancara en:

http://localhost:19031

Produccion

1. Verificar prerequisitos de prod

Antes de levantar prod, asegúrate de que:

  • la red Docker ec-kafka-prod-net exista
  • las variables de entorno requeridas esten definidas
  • el proyecto ec-kafka de prod este disponible si dependes de Kafka en esa red

2. Levantar el stack PROD

Ubicarse en:

cd C:\261bigdata\ec-pago-ms

Levantar el stack:

docker compose up -d

Verificar contenedores:

docker compose ps

Accesos esperados en prod:

  • App: http://localhost:29031
  • MySQL: localhost:29030
  • Red de aplicacion: ec-pago-ms-net
  • Red Kafka externa: ec-kafka-prod-net

3. Variables de entorno usadas en PROD

El docker-compose.yml de prod usa estas variables:

  • SPRING_PROFILES_ACTIVE
  • EC_KAFKA_BOOTSTRAP_SERVERS
  • EC_PAGO_MS_DB_HOST
  • EC_PAGO_MS_DB_PORT
  • EC_PAGO_MS_DB_NAME
  • EC_PAGO_MS_DB_USERNAME
  • EC_PAGO_MS_DB_PASSWORD
  • EC_PAGO_MS_MYSQL_ROOT_PASSWORD
  • EC_PAGO_MS_MYSQL_DATABASE

Como comprobar que esta vivo

Prueba este endpoint:

GET http://localhost:19031/pagos/saludo

Respuesta esperada:

ec-pago-ms activo

Si quieres probar rapido desde navegador o Postman, con eso basta para confirmar que la app levanto bien.

Como funciona con ec-orden-ms

La integracion es asi:

  1. ec-orden-ms publica un evento en orden-eventos
  2. ec-pago-ms lo consume
  3. ec-pago-ms guarda el pago en MySQL
  4. ec-pago-ms publica un nuevo evento en pago-eventos

Importante:

  • EventoOrden existe tambien en ec-pago-ms porque este microservicio necesita una clase propia para deserializar el JSON que llega desde Kafka
  • no es una tabla ni una entidad
  • es solo la estructura del mensaje que viaja entre microservicios

Como saber si proceso un pago

Cuando llegue un evento valido, deberias ver en consola algo parecido a esto:

Pago procesado para orden 1: APROBADO

o:

Pago procesado para orden 1: RECHAZADO

Ademas:

  • se insertara un registro en la tabla pagos
  • se publicara un evento en el topic pago-eventos

Tabla que crea este microservicio

La entidad Pago genera la tabla pagos con estos campos:

  • id
  • ordenId
  • monto
  • estado

Como en dev se usa spring.jpa.hibernate.ddl-auto=update, la tabla se crea automaticamente si no existe.

Comandos utiles

Ejecutar pruebas:

.\mvnw.cmd test

Empaquetar el proyecto:

.\mvnw.cmd clean package

Apagar MySQL dev:

docker compose -f docker-compose-dev.yml down

Problemas comunes

La aplicacion no conecta a MySQL

Revisa que el contenedor este arriba:

docker ps

Y confirma que el puerto 19030 este libre y expuesto.

La aplicacion no conecta a Kafka

Revisa que Kafka realmente este escuchando en:

localhost:49092

Si Kafka no esta levantado, la app arrancara pero fallara al momento de conectarse al broker.

No se procesa ningun pago

Eso suele pasar cuando:

  • ec-orden-ms no publico nada en orden-eventos
  • el evento no tiene tipoEvento = "orden.creada"
  • Kafka no esta arriba

Archivos importantes

Resumen rapido

Si quieres la version corta para arrancar:

  1. levanta MySQL con docker compose -f docker-compose-dev.yml up -d
  2. asegurate de tener Kafka en localhost:49092
  3. ejecuta ./mvnw spring-boot:run en Linux/macOS o .\mvnw.cmd spring-boot:run en Windows
  4. prueba http://localhost:19031/pagos/saludo
  5. publica una orden desde ec-orden-ms

About

Microservicio(Event-Driven Architecture, EDA) de pagos hecho con Spring Boot, Java 17, MySQL y Kafka. Consume eventos de ec-orden-ms

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages