Quickstart

Get the ConformaESG Integration Service running locally in under 5 minutes.

Prerequisites

ToolMinimum Version
Java (JDK)21
Apache Maven3.9+ (or use ./mvnw)
Docker24+ (for PostgreSQL Dev Services)

1. Clone & Start

Shell
git clone https://github.com/conformaesg/integration-service.git
cd integration-service
./mvnw quarkus:dev

Quarkus will automatically spin up a PostgreSQL container and apply the schema. The service starts at http://localhost:8080.

Tip

Press d in the terminal to open the Quarkus Dev UI at http://localhost:8080/q/dev/ with live Swagger UI and database viewer.

2. Verify

Shell
curl http://localhost:8080/hello

3. Create Your First Supplier

Shell
curl -X POST http://localhost:8080/api/suppliers \
  -H "Content-Type: application/json" \
  -H "X-User-Id: 1" \
  -H "X-API-Key: dev-key" \
  -d '{
    "name": "Acme Textiles Ltd",
    "country": "IT",
    "category": "TEXTILES",
    "reach_compliant": true
  }'

4. Run Tests

Shell
./mvnw test               # all modules (H2 in-memory, no Docker needed)
./mvnw test -pl supplier  # single module

Next Steps