Document Management Store App

Document Management is a backend service to store and retrieve documents.

Tech

It uses:

• Java
• Spring boot
• Junit, Mockito and SpringBootTest and Powermockito
• Gradle
• lombok project - Lombok project

Plugins

• lombok plugin - Lombok IDEA plugin

Environment variables

The following environment variables are required:

Note: The MAX_FILE_SIZE enforces limit on the document upload in the document management backend service. Additionally, the max request content length (including file sizes) need to be configured for the IIS web server (on Azure) via maxAllowedContentLength property for request filter in web.config (config file within source repository).

Setup

# Cloning repo and running though docker
git clone https://github.com/hmcts/document-management-store-app.git
cd document-management-store-app/

Clean and build the application:

./gradlew clean
./gradlew build

To run just the unit tests:

./gradlew test

To run the integration tests:

Requires docker desktop running

./gradlew integration

To run the application:

Requires docker desktop running You need to be logged in to Azure and have access to the ACR registry to pull the necessary containers for the application to run. If you are not logged in, you can do so by running az login in your terminal. Followed by az acr login --name hmctsprod to log in to the ACR registry

docker-compose -f docker-compose-dev.yml pull
docker-compose -f docker-compose-dev.yml up -d

# Run application
./gradlew bootRun```

Integration

There is currently a Java Client available here: https://github.com/hmcts/document-management-client

Swagger UI

To view our REST API go to http://{HOST}/swagger-ui/index.html On local machine with server up and running, link to swagger is as below

http://localhost:4603/swagger-ui/index.html if running on AAT, replace localhost with ingressHost data inside values.yaml class in the necessary component, making sure port number is also removed.

API Endpoints

A list of our endpoints can be found here

https://hmcts.github.io/cnp-api-docs/swagger.html?url=https://hmcts.github.io/cnp-api-docs/specs/document-management-store-app.json

Contract Tests (Pact)

For executing the pact consumer test run

./gradlew contract

The results of the consumer test will be published to the pact folder in the root directory of the project.

To run the provider pact tests, first comment the broker configuration in the BaseProviderTest and StoredDocumentMultipartProviderTest classes and uncomment the pact folder configuration, then run the below command to execute the provider pact tests locally.

./gradlew providerContractTests