# agiledancers

To map dance groups to performance days. The backend runs on Quarkus with Java 25.

Requires JDK 25 and Maven 3.9.0 or newer. Set `JAVA_HOME` to your JDK 25 installation.

Build and run all tests (including `*Sit` tests) from the repository root:

```sh
mvn clean verify
```

Start development mode with live reload from the repository root:

```sh
mvn -pl agiledancers-be quarkus:dev
```

Run the packaged application after building:

```sh
java -jar agiledancers-be/target/quarkus-app/quarkus-run.jar
```

Build and run a Docker container from the repository root (only Docker is required):

```sh
docker build -t agiledancers .
docker run --rm --name agiledancers -p 8080:8080 agiledancers
```

The Docker build compiles the application and runs the tests in a Maven build stage,
then copies the Quarkus application into a Java 25 runtime image running as a non-root user.

Check readiness at <http://localhost:8080/q/health/ready> or overall health at
<http://localhost:8080/q/health>. For example:

```sh
curl --fail http://localhost:8080/q/health/ready
```

Quarkus configuration can be overridden with environment variables, for example
`docker run --rm -e QUARKUS_HTTP_PORT=9090 -p 9090:9090 agiledancers`.

The domain services and repositories retain their existing in-memory behavior;
data is lost when the process stops. Business REST endpoints have not yet been added.