Einleitung

Das Ziel des zentralisierten Visualisierungsmoduls ist die einheitliche Darstellung von E-Rezepten. Der Dienst erstellt aus einem E-Rezept Datensatz gemäss CHMED16A (prescription revision 2) ein standardisiertes PDF-Dokument nach Vorgaben der Initiative E-Rezept Schweiz.

Installation

Lokale Installation als Standalone-App (Windows, MacOS X und Linux)

Der Service-Endpunkt wird von einer Standalone-Applikation (Electron Application|https://www.electronjs.org/) zur Verfügung gestellt, die geladen und lokal installiert wird. Die Applikation fragt in regelmässigen Abständen das Repository an, ob eine Aktualisierung vorhanden ist. Ist dies der Fall, wird die bereitgestellte Version heruntergeladen und installiert. Dieses Vorgehen bietet den Vorteil, immer die aktuellste Version zu haben und dass somit die Erstellung des E-Rezepts nach aktuellsten Vorgaben erfolgt.

Nach der Installation wird die Applikation gestartet und ein REST Endpunkt wird unter der Portnummer 3000 exponiert: http://localhost:3000/health

Installation auf Desktop

1. MacOS

• Aktuellste Version laden von hier
• Image Mac Arm entpacken, Applikation in den Applikations-Ordner verschieben
• Applikation starten
• Da die Applikation nicht aus dem AppStore geladen wurde, muss dieses Pop-up bejaht werden:
• Die Applikation läuft nun im Hintergrund, es wird kein UI angezeigt.
• Um die Funktion zu prüfen, navigiere mit dem Browser auf folgende Url: http://localhost:3000/health

2. Windows

• Aktuellste Version laden von hier
• Image Windows Installer entpacken, Applikation starten
• Um die Funktion zu prüfen, navigiere mit dem Browser auf folgende Url: http://localhost:3000/health

3. Linux Desktop

• Aktuellste Version laden von hier
• Image Linux AppImage mit Doppelklick installieren
• Applikation starten
• Um die Funktion zu prüfen, navigiere mit dem Browser auf folgende Url: http://localhost:3000/health

3.1 Linux Server

• Aktuellste Version laden von here
• Kopiere this script auf den Server (abhängig vom eingesetzten Package manager, Version entsprechend selektieren)
• Change permissions ausführen chmod +x erx-appimage-installer.sh
• Script bearbeiten mit der korrekten Versionto -APP_VERSION im Kopfbereich.
• Script ausführen mit ./erx-appimage-installer.sh

Das Script wird alle notwendigen Abhängigkeiten laden und lädt die entsprechende Version der Applikation herunter.

Einsatz des Container-Image

Für containerisierte Umgebungen, wo eine Aktualisierung der laufenden Applikation nicht funktioniert, wird ein Image bereitgestellt, das auf Docker Hub publiziert wird.

Die neuste Version laden:

docker pull healthinfonetag/erx-app:latest

Oder eine bestimmte Version:

docker pull healthinfonetag/erx-app:v1.12.5

Docker image starten

docker run --rm -p 3000:3000 healthinfonetag/erx-app:latest

Der Service ist unter http://localhost:3000 verfügbar. erx-app akzeptiert als Umgebungsvariable LOG_LEVEL (default: info).

Verfügbare Level:

Level	Description
error	Only errors
warn	Errors and warnings
info	General information (default)
http	HTTP request logging
verbose	More detailed information
debug	Debug-level details
silly	Everything

Kompatibilität

Neben aktuellen MacOS X und Windows Version werden die folgenden Linux Distributionen unterstützt: Debian, Ubuntu,Rocky 10, Rocky 9, Open SUSE Leap,Alma Linux 10, CentOS Stream 10, Fedora 42. Unterstützte Umgebungen für das Docker-Image: 20.x+

Upgrade-Vorgang (nur Standalone-App)

Sofern die Applikation aktiv läuft, wird im Hintergrund regelmässig die Aktualität geprüft. Der Download geschieht im Hintergrund. Die Installation bedingt einen Neustart der Applikation, wodurch der Service für wenigen Sekunden nicht verfügbar ist