Report-Processing-Service

Table of Contents

1. About The Project
   • Quality Gate
   • Release Notes
2. Getting Started
   • Prerequisites
   • Installation
   • Local
3. Usage
   • Endpoints
4. Security Policy
5. Contributing
6. License
7. Contact

About The Project

This service serves as a central processing point for report notifications to the DEMIS core. As a central interface, other services such as the validation service are addressed, the results are bundled and transferred to the FHIR-storage-writer. When errors occur, they must be processed and bundled and output to the user in such a way that no safety-critical information about the system becomes known

Quality Gate

Release Notes

See ReleaseNotes for all information regarding the (newest) releases.

Getting Started

Prerequisites

Hint:

For usage or perform the tests, create a local profile:

cp src/main/resources/application.properties src/main/resources/application-local.properties

Afterwards start the application with the local profile.

Installation

Hint: there is 2 test ik numbers in hospital-location-service: 987654321 & 098765432. The ik number will be extracted from the jwt, you can adjust the ik-attribute in keycloak to use one of the test numbers

mvn clean verify

The Project can be built with the following command:

mvn clean install

build with docker image:

docker build -t report-processing-service:latest .

The Docker Image associated to the service can be built alternatively with the extra profile docker:

mvn clean install -Pdocker

Local

Run from IntelliJ as SpringBoot Application

Usage

The application can be executed from a mvn command file or a Docker Image:

# using a mvn command
mvn clean spring-boot:run`
Check the server with: `curl -v localhost:8080/status`
# As Docker Image
docker run -p 8081:8081 -dt --name rps-container report-processing-service:latest` or add to a yaml file from e.g. [this project](https://gitlab.prod.ccs.gematik.solutions/git/demis/demis

Endpoints

Endpoint	Description
/$process-report	POST endpoint for report notifications.
/actuator/health/	Standard endpoint from Actuator.
/actuator/health/liveness	Standard endpoint from Actuatorr
/actuator/health/readiness	Standard endpoint from Actuator.
/swagger-ui/index.html	Swagger UI documentation endpoint. Provides a user interface to interact with endpoints. Lists endpoints, headers, and the format of requests and responses.

Listed are endpoints, headers, and format of requests and responses.

Security Policy

If you want to see the security policy, please check our SECURITY.md.

Contributing

If you want to contribute, please check our CONTRIBUTING.md.

License

Copyright 2022-2025 gematik GmbH

EUROPEAN UNION PUBLIC LICENCE v. 1.2

EUPL © the European Union 2007, 2016

See the LICENSE for the specific language governing permissions and limitations under the License

Additional Notes and Disclaimer from gematik GmbH

1. Copyright notice: Each published work result is accompanied by an explicit statement of the license conditions for use. These are regularly typical conditions in connection with open source or free software. Programs described/provided/linked here are free software, unless otherwise stated.
2. Permission notice: Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
   1. The copyright notice (Item 1) and the permission notice (Item 2) shall be included in all copies or substantial portions of the Software.
   2. The software is provided "as is" without warranty of any kind, either express or implied, including, but not limited to, the warranties of fitness for a particular purpose, merchantability, and/or non-infringement. The authors or copyright holders shall not be liable in any manner whatsoever for any damages or other claims arising from, out of or in connection with the software or the use or other dealings with the software, whether in an action of contract, tort, or otherwise.
   3. We take open source license compliance very seriously. We are always striving to achieve compliance at all times and to improve our processes. If you find any issues or have any suggestions or comments, or if you see any other ways in which we can improve, please reach out to: ospo@gematik.de
3. Please note: Parts of this code may have been generated using AI-supported technology. Please take this into account, especially when troubleshooting, for security analyses and possible adjustments.

Contact

E-Mail to DEMIS Entwicklung