We use Google Java Style, when using IntelliJ it is recommended to download and activate the google-java-format plugin.
[RECOMMENDED] Set up a Github Personal Access Token (PAT) as mentioned here, then skip to step 3.
If you would like to build required DCSA packages individually, begin with step 1.
1) Build DCSA-Core as described in DCSA-Core/README.md, then
2) Build DCSA-Event-Core as described in DCSA-Event-Core/README.md , then
3) Clone DCSA-BKG (with --recurse-submodules
option.) and Build using, mvn package
4) Initialize your local postgresql database as described in datamodel/README.md \ or If you have docker installed, you may skip this step and use the docker-compose command mentioned below to set it up (This will initialize the application along with the database).
5) Run application,
mvn spring-boot:run [options]
options:
-Dspring-boot.run.arguments="--db_hostname=localhost:5432 --AUTH0_ENABLED=false --LOG_LEVEL=DEBUG"
OR using docker-compose
docker-compose up -d -V --build
6) Verify if the application is running,
curl http://localhost:9090/v2/actuator/health
master
is the main development branch.
pre-release
and release
are tagged and should be used as a stable version.
Development continues on master
and feature branches are created based on master
.
A typical development flow would look like:
1) Create a feature branch with master
as base, proceed to make changes to feature branch.
2) Raise PR against master
. When a PR is raised against master a CI is run to ensure everything is fine.
3) Merge with master
after approval by at least one verified code owner and successful CI run.
Note: If changes are required in the
DCSA-Event-Core
orDCSA-Core
, those changes should first be merged into their respectivemaster
branches before continuing development in this repository.
4) If development has been completed as per requirements for a given API version, master
must be tagged to
create a release
or pre-release
accordingly.
When bug fixes are required or changes in pre-release versions are needed, we branch off using the respective
tags and continue development on that branch. It is important to note that these changes must be cherry-picked
and included into master
.
Generated from resolved OAS Yaml file using: https://github.com/Abdiiir/openapi2schema
This will generate a tree of request/response JSON Schemas from the definitions in the OAS Yaml file.
To generate the JSON schemas follow the instructions listed in the project.
The OAS Yaml file can be downloaded at BKG OpenAPI specification.