This is the code for the user interface of Government Commercial Agency's (GCA) Tenders API, used by the Contract Award Service (CAS).
The specification for the API can be found in the Open API Specification.
The project is implemented as a Spring Boot 3 web application, implemented using Maven.
The core technologies for the project are:
- Java 23
- Spring Boot
- Spring Security
- Ehcache for caching
- JUnit for unit testing
To run the application locally, you simply need to run the core ccs-scale-cat-service module.
In order to generate required classes for the application, you need to use Maven to Generate Sources and Update Folders.
You will need to be supplied with a local secrets file (resources/application-local.yml) to enable the project to run, which can be supplied by any member of the development team.
You will also need to be supplied with a local SQL file (resources/data.sql) to enable the project to spool up the necessary local database for you at runtime, which can again be supplied by any member of the development team.
Once the application has started it can be accessed via Postman using the URL http://localhost:8080/.
When picking up tickets, branches should be created using the feature/* format.
When completed, these branches should be pull requested against develop for review and approval. develop is then built out onto the Development environment.
The UAT and Pre-Production environments are controlled via means of release and hotfix branches.
Release branches should be created from develop using the release/* format, whilst hotfixes should be created from main using the hotfix/* format. These branches can then be built out to UAT and Pre-Production as appropriate.
When releases/hotfixes are ready for deployment to Production, the release/* or hotfix/* branch in question should be pull requested against the main branch for review and approval. This branch should then be built out to Production.
Once a release/hotfix has been completed you should be sure to merge main back down into develop.