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.
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:
- consume el evento desde Kafka
- valida que el evento sea
orden.creada - simula el pago
- guarda el pago en MySQL
- 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"
}- Java 17
- Spring Boot 3.5.13
- Spring Web
- Spring Data JPA
- MySQL
- Spring for Apache Kafka
- Lombok
- Maven Wrapper
src/main/java/com/upeu/ec/pagoms
|-- configuracion
|-- controlador
|-- entidad
|-- evento
|-- repositorio
`-- servicio
Clases principales:
Pago: entidad que se guarda en base de datosEventoOrden: clase usada para recibir el evento publicado porec-orden-msEventoPago: clase usada para publicar el resultado del pagoConsumidorPago: escuchaorden-eventosy procesa el flujoProductorPago: publica enpago-eventosPagoControlador: endpoint simple de prueba
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.
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
El perfil prod usa esta configuracion base en application-prod.yml:
- app:
9031dentro 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
Este proyecto ya trae un docker-compose-dev.yml que solo levanta MySQL.
docker compose -f docker-compose-dev.yml up -dSi todo va bien, MySQL quedara disponible en:
- host:
localhost - puerto:
19030 - usuario:
root - clave:
root - base de datos:
db_ec_pago_ms
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.
En Windows:
.\mvnw.cmd clean compileEn Linux o macOS:
./mvnw clean compileEn Windows:
.\mvnw.cmd spring-boot:runEn Linux o macOS:
./mvnw spring-boot:runLa aplicacion arrancara en:
http://localhost:19031
Antes de levantar prod, asegúrate de que:
- la red Docker
ec-kafka-prod-netexista - las variables de entorno requeridas esten definidas
- el proyecto
ec-kafkadeprodeste disponible si dependes de Kafka en esa red
Ubicarse en:
cd C:\261bigdata\ec-pago-msLevantar el stack:
docker compose up -dVerificar contenedores:
docker compose psAccesos esperados en prod:
- App:
http://localhost:29031 - MySQL:
localhost:29030 - Red de aplicacion:
ec-pago-ms-net - Red Kafka externa:
ec-kafka-prod-net
El docker-compose.yml de prod usa estas variables:
SPRING_PROFILES_ACTIVEEC_KAFKA_BOOTSTRAP_SERVERSEC_PAGO_MS_DB_HOSTEC_PAGO_MS_DB_PORTEC_PAGO_MS_DB_NAMEEC_PAGO_MS_DB_USERNAMEEC_PAGO_MS_DB_PASSWORDEC_PAGO_MS_MYSQL_ROOT_PASSWORDEC_PAGO_MS_MYSQL_DATABASE
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.
La integracion es asi:
ec-orden-mspublica un evento enorden-eventosec-pago-mslo consumeec-pago-msguarda el pago en MySQLec-pago-mspublica un nuevo evento enpago-eventos
Importante:
EventoOrdenexiste tambien enec-pago-msporque 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
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
La entidad Pago genera la tabla pagos con estos campos:
idordenIdmontoestado
Como en dev se usa spring.jpa.hibernate.ddl-auto=update, la tabla se crea automaticamente si no existe.
Ejecutar pruebas:
.\mvnw.cmd testEmpaquetar el proyecto:
.\mvnw.cmd clean packageApagar MySQL dev:
docker compose -f docker-compose-dev.yml downRevisa que el contenedor este arriba:
docker psY confirma que el puerto 19030 este libre y expuesto.
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.
Eso suele pasar cuando:
ec-orden-msno publico nada enorden-eventos- el evento no tiene
tipoEvento = "orden.creada" - Kafka no esta arriba
- README.md
- application.yml
- application-dev.yml
- application-prod.yml
- docker-compose-dev.yml
- docker-compose.yml
Si quieres la version corta para arrancar:
- levanta MySQL con
docker compose -f docker-compose-dev.yml up -d - asegurate de tener Kafka en
localhost:49092 - ejecuta
./mvnw spring-boot:runen Linux/macOS o.\mvnw.cmd spring-boot:runen Windows - prueba
http://localhost:19031/pagos/saludo - publica una orden desde
ec-orden-ms