Customer V1 API

• Java 21, Spring Boot 3 (WebFlux)
• OpenAPI Generator (delegate pattern)
• R2DBC + H2 (sin consola H2 en WebFlux)

Microservice Diagram

flowchart LR
  Client["Client / Swagger UI"] -->|"HTTP \(JSON\)"| API["WebFlux REST<br/>CustomersApiDelegateImpl"]
  API -->|calls| UC["Application Use Cases<br/>- RegisterCustomerUseCase<br/>- GetCustomerUseCase<br/>- UpdateCustomerUseCase<br/>- DeleteCustomerUseCase"]
  UC -->|port| Port["Domain Port<br/>CustomerRepository"]
  Port -->|adapter| Adapter["R2DBC Adapter<br/>R2dbcCrudCustomerRepository"]
  Adapter -->|R2DBC| H2[(H2 Database)]

  subgraph Config
    Schema["R2dbcInitConfig<br/>schema-h2.sql"]
  end
  Schema --> H2

Loading

Run it (Docker Compose)

• Clonar el repositorio y entrar en la carpeta

  git clone https://github.com/vito-ivan/customer-v1.git
  cd customer-v1

• Compilar el proyecto (opcional si vas a construir la imagen; recomendado para verificar que compile)

  .\mvnw.cmd -DskipTests clean package

• Construir y levantar

  docker compose up --build

• Ver logs y seguir

  docker compose logs -f --tail=120

• Parar

  docker compose down

API endpoints

OpenAPI

• Spec: src/main/resources/openapi/api.yaml
• UI: http://localhost:8080/webjars/swagger-ui/index.html

Health

• http://localhost:8080/actuator/health

Try it with curl

Import in postman and prove

Customer V1 API.postman_collection.json

Testing

.\mvnw.cmd -DskipTests=false test