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
make 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/q/health

3. Create Your First Supplier

Shell
curl -X POST http://localhost:8080/api/v1/suppliers \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Textiles Ltd",
    "category": "TEXTILES",
    "country": "IT",
    "city": "Milano",
    "reach_compliant": true
  }'

4. Run Tests

Shell
make test                        # all modules (H2 in-memory, no Docker needed)
make test-module MODULE=supplier # single module
make lint                        # architectural tests (ArchUnit)

Available Make Targets

Shell
make dev          # Dev mode with hot reload
make build        # Full build
make test         # All tests
make lint         # Architectural enforcement tests
make help         # All available targets

Next Steps