turned into a quarkus application

README.md

@@ -1,6 +1,6 @@
 # agiledancers
 
-To map dance groups to performance days.
+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.
 
@@ -9,3 +9,38 @@ 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.