JUG Registration App

Quarkus-based application.

Usage / Integration Configuration

A detailed handbook for JUG orga teams — embedding into your own website, events file, e-mails and admin area — is available (in German) in docs/handbuch.adoc.

Development

Prerequisites

• JDK 21+

• IDE

• Maven 3.9+ (Maven wrapper is included)

• Docker (for local development using the Quarkus DevServices)

Development with default dev profile

For local development, simply power up the Quarkus application

• either by using the provided IntelliJ run configuration

• or by executing Quarkus Development Mode on the command line (terminal): mvn compile quarkus:dev

This starts Quarkus in dev profile mode and also starts up all required external systems as devservices, like the PostgreSQL database, Mailpit smtp dev server, Keycloak for authentication.

• (Optional) Build application: mvn clean package

Tip	You can now change classes, configurations and other resources on the fly, and Quarkus will automatically reload on the next call.

Run HTTP requests to test registration

• Registration: http://localhost:8080/registration/test?eventId=2026-12-31&opensBeforeInMonths=8

• Admin: http://localhost:8080/admin/test/events (User: alice/alice)

• Mailpit: http://localhost:8080/q/dev-ui/quarkus-mailpit/mailpit-ui

For runnint http requests manually, see here.

Build

There is a GH action to build and push a (multi-platform arm64/amd64) Docker image to ghcr.io/ijug-ev/registration:<version>.

This action runs either

• on pushs to main branch, then the image version tag will be latest

• on git tag pushes in format v.1.2.3, then the image version tag will be 1.2.3

Deployment

An example Docker Compose file is provided here:

link:docker-compose.yml[role=include]

Tip	The production app should be available directly under https://registration.ijug.eu