Value Added Service - Country Risk Alert

Table of content:

• Description
• Running environments
• Getting started
  • Prerequisites
  • Profile Configurations
  • How to run
  • Database Connection Configuration
• Project Structure
• API sample endpoints

Description

This project in mainly used as a microservice for the Value Added Service Frontend project. It feeds information from an database and also from other CatenaX microservices

Running environments

Environment	Link
Dev	https://vas-country-risk-backend.dev.demo.catena-x.net/
Int	https://vas-country-risk-backend.int.demo.catena-x.net/

Getting started

Prerequisites

• JDK 11
• Maven

Profile Configurations

In this project there is a variety of different profiles. They can be accessed in the resources folder of the project. The available profiles are:

• Default - When no environment specified (application.yml)
• Dev - Used in the remote dev environment (application-dev.yml)
• Int - Used in remote int environment (application-int.yml)
• Local - Profile to use on local machine (application-local.yml)
• Prod - application-prd.yml

How to run

To run the project locally, it must be changed which profile will be used, in this case the profile will be the local. For that, run the project with the following Environment variable: spring.profiles.active=local

The project can be run locally with the following command: mvn clean spring-boot:run -Dspring.profiles.active=local

Database Connection Configuration

The project is mainly configured to use Postgres as a Database. For this, you need to open an terminal in the project main
directory and run the following command docker compose up. This will mount the database using the docker compose file in the project. The connection configurations for this database are in the application-local.yml.

This project also can be run using liquibase. For this it is needed to uncoment the commented lines in the application-local.yml. When you run the project, this database will create multiple test data for usage and the data will persist when the project is closed. You can delete all the data andre-create the database by simply doing the following command mvn clean install and run the program again with the earlier presented command mvn clean spring-boot:run -Dspring.profiles.active=local. To access the UI for the database, use the following URL: http://localhost:8080/h2-console/login.jsp

Also, it is possible to use Postgres as a Database. To do this, the postgres configuration in the application-local.yml needs to be uncommented, and the username, URL and password should be changed according the installed postgres DB. Also, the liquibase configuration in the same yml should be commented.

Project Structure

The root of this project contains mainly Maven Project Files (pom.xml) and some repository configurations. Also there are at root level some folders containing the Helm Charts configurations.

Once inside the "main" folder, there are two folders. One for the Java files, and a resources folder, which contains the database changelogs and fake data which populates the liquibase and also the profiles configurations yml's.

Inside the java folder, there is the source code for the project, which is divided in multiple folders to facilitate the development and follows the mainly used project structure in most Spring Boot projects.

       └───catenax
           └───valueaddedservice
               ├───config
               ├───constants
               ├───domain
               │   └───enumeration
               ├───dto
               ├───interceptors
               ├───repository
               ├───service
               │   ├───csv
               │   ├───logic
               │   └───mapper
               ├───utils
               └───web
                   └───rest

API sample endpoints

• Swagger UI: http://localhost:8080/swagger-ui/index.html#/