Musteronlinedienst

Der Musteronlinedienst ist eine DEMO Applikation für die Anbindung an FIT-Connect. Hier werden alle nötigen Systeme und Module verwendet um eine Einreichung (Submission) an FIT-Connect senden zu können.

ACHTUNG - DEMO ONLY

Diese Software ist NICHT für den produktiven Einsatz geeignet! Es handelt sich hierbei um eine DEMO Version zur Darstellung einer möglichen Anbindung an FIT-Connect.

Take away

Wie kann mir das Frontend helfen?

Sie können den Musteronlinedienst verwenden, um die Übertragung Ihrer Submissions zum Zustelldienst zu prüfen oder auch Code aus dem Musteronlinedienst kopieren um diesen dann in Ihrer Anwendung zu verwenden. Betrachten Sie den Musteronlinedienst als Code-Sammlung und Toolkit.

Known Problems

1. JavaScript SDK kann nicht automatisch installiert werden, da das Paket noch nicht auf NPM published wurde

Aufbau

Der Musteronlinedienst setzt alle aktuelle SDKs ein. Im Frontend setzt der Onlinedienst auf das JavaScript SDK. Das Backend des Onlinedienstes ist in .NET umgesetzt und verwendet das .NET-Package von NuGet. Zum Abrufen der Submissions wird das Java-SDK in einem Docker-Container verwendet. Um die Submission abzurufen, kann in der Konsole docker compose up subscriber aufgerufen werden. Die abgerufenen Daten werden in das Verzeichnis ./downloads geladen und können dort untersucht werden.

Der Aufbau stellt sich also wie folgt dar:

flowchart LR
    browser((Browser))
    js(JavaScript SDK)
    dotnet(Backend<br>.NET SDK)
    online[(Zustelldienst<br>FIT-Connect)]
    java((Subscriber<br>Java SDK))
    browser-->js-->dotnet-->online-->java

Voraussetzungen

Credentials

Zur Inbetriebnahme des Projektes sind die Credentials in folgender Datei zu hinterlegen:

.env

Hinweise zum Aufbau des .env Files können dem template.env entnommen werden.

Docker

Der komplette Stack kann mithilfe von Docker gestartet werden. docker compose up startet das Backend das Frontend und __einen __ Abruf des Subscribers mithilfe des Java-CLI-Tools.

Frontend, Javascript-SDK

Das Frontend nutzt das JavaScript-SDK für die Verschlüsselung und Vorbereitung der Daten um diese an FIT-Connect zu senden. Damit ist eine E2E Verschlüsselung vom Sender bis zum Empfänger der Einreichung gewährleistet. Genauere Informationen zum Frontend können der Readme des SDKs entnommen werden.

Backend .NET-SDK

Das Backend nutzt das .NET SDK um die Submission an FIT-Connect zu senden.

Subscriber Java-CLI

Zum Abrufen der Einreichung vom FIT-Connect Zustelldienst wir der Java CLI Client