Repository files navigation

Collection of aam-digital services and tools

A modularize Spring Boot application that contains API modules forAam Digital's case management platform.

• Reporting: Calculate aggregated reports and run queries on all data, accessible for external services for API integrations of systems
• Export: Template based file export API. Usescarbone.io as templating engine.
• Skill: Integration with external system (SkillLab) to link and pull data into Aam Digital.
• Notification: Push Notification system, triggering events based on custom rules for each user.
• Third-Party-Authentication: "Single-Sign-On" integration with other platforms.

Modules have to be enabled via a feature flag in the environment config and may need additional environment variables as described in their module docs.

This API is part of the larger Aam Digital platform and usually deployed together with additional services via docker.See thendb-setup repository for tools and guidance how to run this in a production environment.

For instructions to enable the backend in an overall system:ndb-setup README

The individual modules like "Reporting" require some setup and environment variables.Please refer to the respective READMEs in the "API Modules" list above for instructions about each API Module.

To run the system locally for development, refer to thedocs/developer/README.md and sample docker files there.These allow you to run required additional services like databases and queues on your machine.

The developer README provides detailed instructions how to set up a local testing environment:docs/developer/README.md

This backend is developed as independent modules that share some common services (e.g. for database access).

• Spring + Kotlin
• Spring Boot (see intro)
• Gradle (see intro)
• RabbitMQ (AMQP) for message queues (see Tutorial)

Each feature module is separated into its own package.Additionally, there is acommon package that contains shared code.This includes services to work with the CouchDB, get a feed of DB changes and other common functionality.The "common" package also holds base functionality for authentication and security.

Using Spring Boot's systemour configurable values are represented in theapplication.yaml.

We define environment variables to set / overwrite the configuration to real values for production or testing.Variables in the yaml hierarchy can be set in env variables using "snake case" variable names(refer to the documentation of Spring Boot'sExternalized Configuration docs).

Modules (usually) have to be explicitly enabled through a feature flag configuration. For example,FEATURES_EXPORTAPI_ENABLED=true in .env can toggle the feature flag

@ConditionalOnProperty(    prefix = "features.export-api",    name = ["enabled"],    havingValue = "true",    matchIfMissing = false)

Most modules use RabbitMQ to decouple processing and allow for asynchronous processing of tasks.Refer to the official documentation (the tutorials are quite good) if you are not familiar with the concept or the framework specifically.