Employment Tribunals CCD Callbacks Service

This application is responsible for handling all CCD callback requests for Employment Tribunal cases.

Supported Versions

Component	Version	Status
Java	21	✅ Supported
Spring Boot	3.3.0	✅ Current
Spring Security	6.x	✅ Current
Node.js	18+	✅ Supported
Gradle	Wrapper	✅ Current

⚠️ Breaking Change: Java 21 is now required. Java 17 and earlier versions are no longer supported.

Getting started

Prerequisites

• JDK 21

Building

The project uses Gradle as a build tool but you don't have to install it locally since there is a ./gradlew wrapper script.

To build project please execute the following command:

    ./gradlew build

To get the project to build in IntelliJ IDEA, you have to:

• Install the Lombok plugin: Preferences -> Plugins
• Enable Annotation Processing: Preferences -> Build, Execution, Deployment -> Compiler -> Annotation Processors

Running

You can run the application by executing following command:

    ./gradlew bootRun

The application will start locally on http://localhost:8081

Database migrations (Flyway)

Flyway migrations are stored in src/main/resources/db/migration.

If you already have an existing ethos schema (prod-like, no Flyway history yet), run migration first:

FLYWAY_URL=jdbc:postgresql://localhost:5050/ethos \
FLYWAY_USER=ethos \
FLYWAY_PASSWORD=ethos \
./gradlew migratePostgresDatabase

Then start the app without startup migration:

RUN_DB_MIGRATION_ON_STARTUP=false ./gradlew bootRun

If your database is fresh/empty (but database/user already exist), you can start directly:

./gradlew bootRun

bootRun (default RUN_DB_MIGRATION_ON_STARTUP=true) will apply Flyway migrations on startup for empty databases.

API documentation

API documentation is provided with Swagger: UI to interact with the API resources

    http://localhost:8081/swagger-ui.html

Docker container

Authenticating to ACR

Login to Azure CLI

    az login

Login to ACR

    az acr login --name hmctspublic

Docker image

Build the docker image

    docker build . -t hmcts/ethos-repl-docmosis-service:latest

Docker compose

Run the service with all its dependencies

    docker-compose -f docker/app.yml up -d

To stop the service

    docker-compose -f docker/app.yml down

Developing

Unit tests

To run all unit tests please execute following command:

    ./gradlew test

Coding style tests

To run all checks (including unit tests) please execute following command:

    ./gradlew check

License

This project is licensed under the MIT License - see the LICENSE.md file for details.