Service Invoice

Handles Invoice generation

Running

Local

The application depends on a dedicated database and redis instance. To spin up the local database and redis instance, just run from the root directory:

./localnet.sh up

To check that the database is available, just run the following command and look for a container called postgres-local-invoice.

docker ps

After verifying your database is up, just boot the app. It runs on port 13459.

./gradlew bootRun

To communicate with onboarding api, you have two options:

1. Simulate the service (before running the app, enable simulation in the terminal):

export USE_SIMULATED_ASSET_ONBOARDING=true

2. Add an api key to requests (before running the app, export the api key in the terminal):

export ONBOARDING_API_KEY=acesss-to-this-app-must-be-requested

The app also has an automatic event stream to listen for changes in a provenance blockchain environment. To boot a local version of provenance blockchain, clone the repository from: https://github.com/provenance-io/provenance

The documentation in the provenance repository is very useful and informative. I recommend that anyone trying to run it locally read through it beforehand. However, to just get up and running, just navigate to the root folder of that cloned repository and run:

make localnet-start

Deployment

This project is built via the release manager on GitHub. It provides the entire Spring Boot application in a downloadable docker container that can be accessed on GHCR.

The deployed application currently lives here: https://github.com/hyperschwartz/service-invoice