47 lines
1.4 KiB
Markdown
47 lines
1.4 KiB
Markdown
# 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.
|