Backend of the MoneyTracker project

---

Todo:

• Docs (wiki, see Notion)
• Swagger
• Security (Zitadel or Keycloak)
• TLS/SSL
• Nginx (docker)

---

IMPORTANT!

Before starting work, you need to:

1. Create a .env file and specify the necessary environment variables in it (see config/env/template.env)
2. Optionally, generate self-signed certificates (see config/certs/generate_certs.sh)

Generation of the test coverage report

mvn clean test jacoco:report

The minimum test coverage requirement for the project is 50%.

Docker

Two compose scripts are used, each with its own profile: backend and idp.
This needs to be taken into account!

Run in Docker

mvn clean install

# Run backend along with the IdP
docker compose --profile "*" up -d --build

# e.g. see backend logs
docker logs -f backend

---

Getting Started

Reference Documentation

For further reference, please consider the following sections:

• Official Apache Maven documentation
• Spring Boot Maven Plugin Reference Guide
• Create an OCI image
• Spring Boot Testcontainers support
• Testcontainers Postgres Module Reference Guide
• Liquibase Migration
• Spring Web
• JOOQ Access Layer
• Testcontainers

Guides

The following guides illustrate how to use some features concretely:

• Building a RESTful Web Service
• Serving Web Content with Spring MVC
• Building REST services with Spring

Testcontainers support

This project uses Testcontainers at development time.

Testcontainers has been configured to use the following Docker images:

• postgres:latest

Please review the tags of the used images and set them to the same as you're running in production.