Skip to content

README.md

Latest commit

 

History

History
218 lines (164 loc) · 4.37 KB

README.md

File metadata and controls

218 lines (164 loc) · 4.37 KB

Transaction Service – Yape Code Challenge

Este proyecto implementa un microservicio de transacciones desarrollado con Spring Boot 3, siguiendo el enfoque de Arquitectura Hexagonal (Ports & Adapters) y un flujo event-driven con Kafka.

Todos los endpoints intercambian datos en JSON y el sistema está preparado para ejecutarse localmente con Docker Compose.

Problem

Every time a financial transaction is created it must be validated by our anti-fraud microservice and then the same service sends a message back to update the transaction status. For now, we have only three transaction statuses:

  1. pending
  2. approved
  3. rejected

Every transaction with a value greater than 1000 should be rejected.

  flowchart LR
    Transaction -- Save Transaction with pending Status --> transactionDatabase[(Database)]
    Transaction --Send transaction Created event--> Anti-Fraud
    Anti-Fraud -- Send transaction Status Approved event--> Transaction
    Anti-Fraud -- Send transaction Status Rejected event--> Transaction
    Transaction -- Update transaction Status event--> transactionDatabase[(Database)]
Loading

Arquitectura

El proyecto sigue Arquitectura Hexagonal, separando claramente responsabilidades:

├── application
│   ├── dto
│   ├── service
│   └── usecase
├── domain
│   ├── model
│   └── port
├── infrastructure
│   ├── inbound
│   │   ├── rest
│   │   └── kafka
│   ├── outbound
│   │   ├── persistence
│   │   └── kafka
│   └── config

Ejecución local (sin Docker)

Requisitos

  • Java 17
  • Maven 3.9+
  • PostgreSQL
  • Kafka + Zookeeper

Compilar y ejecutar tests

mvn clean compile
mvn test
mvn verify

Reporte JaCoCo:

target/site/jacoco/index.html

Docker Compose (PostgreSQL + Kafka + Transaction Service + Antifraud)

Requisitos

  • Docker y Docker Compose

1) Construir el .jar

Desde la raíz del proyecto (donde está el pom.xml):

mvn clean package

El ejecutable jar se genera en:

target/transaction-service-0.0.1.jar

empaquetar mas pruebas unitarias & cobertura:

mvn clean verify

Antifraud Service

El servicio de Antifraud se encuentra implementado en un repositorio independiente y se integra con este microservicio mediante eventos Kafka.

Repositorio: https://github.com/alessandrojre/antifraud-service

En el entorno local, el docker-compose levanta automáticamente este servicio para simular el flujo completo: Transaction Service → Kafka → Antifraud Service → Kafka → Transaction Service.

Levantar el ecosistema con Docker Compose

Ubícate en la carpeta devops (donde está el docker-compose.yml) y ejecuta:

  cd devops
  docker compose up --build

Para ejecutar en segundo plano:

  docker compose up -d --build

Ver contenedores activos:

  docker ps

Para ver logs:

  docker compose logs -f

Para detener y eliminar contenedores:

  docker compose down

Para eliminar también el volumen de Postgres:

  docker compose down -v

Probar endpoints REST

Crear transacción

curl --location --request POST 'http://localhost:8080/transactions' \
--header 'Content-Type: application/json' \
--data-raw '{
  "accountExternalIdDebit": "11111111-1111-1111-1111-111111111111",
  "accountExternalIdCredit": "22222222-2222-2222-2222-222222222222",
  "tranferTypeId": 1,
  "value": 150.75
}'

Response:

{
  "transactionExternalId": "83a3d905-ee35-4201-9958-0fde4d7267b8"
}

Obtener transacción por ID

curl --location --request GET \
'http://localhost:8080/transactions/{transactionExternalId}'

Response:

{
  "transactionExternalId": "83a3d905-ee35-4201-9958-0fde4d7267b8",
  "transactionType": {
    "name": "TRANSFER"
  },
  "transactionStatus": {
    "name": "APPROVED"
  },
  "value": 150.75,
  "createdAt": "2025-12-29T00:00:00Z"
}

Docker Compose

Levantar todo el entorno:

docker-compose up --build

Servicios:

  • Transaction Service → 8080
  • Antifraud Service → 8081
  • PostgreSQL → 5432
  • Kafka → 9092

Stack Tecnológico

  • Java 17
  • Spring Boot 3.5
  • PostgreSQL
  • Kafka
  • Docker
  • JUnit 5 + Mockito + AssertJ + JaCoCo