This repository contains the backend services for the agridata.ch platform, built with Quarkus. It provides APIs, authentication integration, and data persistence capabilities.

Local development is powered by Quarkus DevServices, which automatically starts required services like PostgreSQL and Keycloak in Docker containers.

To launch the application in development mode:

mvn quarkus:dev -Dquarkus.profile=local

This will automatically spin up:

• A PostgreSQL database
• A Keycloak instance with the agate_realm.json imported

Access the Quarkus Developer UI here:

http://localhost:8060/q/dev-ui

git config --local core.hooksPath hooks && chmod +x hooks/*

• Database Name: agridata
• Username: admin
• Password: secret
• Data Persistence Path: .local-dev/postgres-volume

• Realm: agate
• Initial Import: agate_realm.json
• Admin Credentials:
  • Username: admin
  • Password: admin
• Client:
  • Id: agridata-ui
  • Password: secret

These are predefined users in the local agate realm:

User data cannot easily be exported from the Docker container, so manual steps are required to preserve and update user configuration:

• Backup the userssection in agate_realm.json.
• Log into the Keycloak admin console.
• Go to Realm Settings > Action > Partial Export.
• Replace agridata-ui.secret in the exported file with secret.
• Re-add the users section from your backup.
• Replace the original agate_realm.json with the updated version.