Ergobefund

Desktop-App (macOS, Windows) für Befunde der Ergometrie (Belastungs-EKG) – Schwesterprogramm von Echobefund und Abdomenbefund: Messwerte eintragen und Befunde anklicken → Befundtext und Diagnosen entstehen automatisch → Zwischenablage, PDF, Druck oder per GDT direkt in die Kartei (z. B. MCW EOSWIN).

Funktionen

• Karten: Untersuchung (Protokoll, frequenzwirksame Medikation), Belastung, Herzfrequenz, Blutdruck, Symptome, EKG (Ruhe-EKG, ST-Strecke mit Ableitungen, Rhythmus), Gesamtbeurteilung, Empfehlungen
• Berechnet automatisch: Soll-Herzfrequenz und Anteil, Chronotropie-Index, Herzfrequenzabfall in der 1. Erholungsminute, systolischer Blutdruckanstieg, Doppelprodukt, Leistung pro kg und geschätzte MET
• Automatische Bewertung mit editierbaren Grenzwerten: Ausbelastung, Herzfrequenzanstieg und -erholung, Ruhe- und Belastungsblutdruck (Schwellen für Männer und Frauen getrennt), Leistungsfähigkeit
• ✓ Alles normal füllt nur noch leere Felder; die Gesamtbeurteilung bleibt bewusst dem Arzt vorbehalten
• Befundtext wird bei jeder Auswahl live aktualisiert; nach Änderungen von Hand bleibt der Text erhalten
• Zu jeder Auswahl zwei editierbare Bausteine: Satz im Befund und Kurzform für die Diagnosen
• Vorbefund-Vergleich, Vorlagen (z. B. „Unauffällige Ergometrie“), Empfehlungen
• GDT-Anbindung mit Verbindungsampel, verschlüsseltes Archiv, gemeinsames Profil für mehrere Arbeitsplätze

Webseite: https://fmatsch.github.io/ergobefund/

Download

System	Datei
macOS (Intel & Apple Silicon)	Ergobefund-mac-universal.zip
Windows (64 Bit, ohne Installation)	Ergobefund-windows-portable.exe

Alle Versionen: Releases

Medizinischer Hinweis: Die Grenzwerte (u. a. Ausbelastung ab 85 % der Soll-HF, MET-Schätzung nach ACSM) sind gebräuchliche Richtwerte und größtenteils Vorschläge (in den Einstellungen gekennzeichnet). Grenzwerte und Textbausteine müssen vor dem klinischen Einsatz vom verantwortlichen Arzt geprüft werden. Die App ist kein Medizinprodukt.

Entwicklung

npm install
npm start      # App starten
npm test       # Tests für Befundtext, Bewertung, Berechnungen, GDT und Archiv

Programme bauen

npm run dist       # beides (auf dem Mac, kein Wine nötig)
npm run dist:mac   # dist/Ergobefund-mac-universal.zip
npm run dist:win   # dist/Ergobefund-windows-portable.exe
npm run icon       # build/icon.png aus build/icon.svg neu erzeugen (danach nach src/assets/ kopieren)

Die Programme sind nicht signiert:

• macOS: ZIP entpacken, Ergobefund.app nach „Programme“ ziehen, beim ersten Start Rechtsklick → „Öffnen“. Falls „beschädigt“ gemeldet wird: xattr -cr /Applications/Ergobefund.app
• Windows: SmartScreen → „Weitere Informationen“ → „Trotzdem ausführen“.

Anbindung an EOSWIN (GDT 2.1)

Die Einrichtung entspricht der von Echobefund (siehe https://fmatsch.github.io/echobefund/anleitung/) – nur mit eigenen Kennungen, damit beide Programme denselben Austauschordner nutzen können:

1. Ergobefund: Einstellungen → „Praxissoftware (GDT)“ → Anbindung aktivieren, Austauschordner wählen → „Testen“
2. EOSWIN: ein weiteres GDT-Gerät anlegen (z. B. „Ergometrie“) mit
   • demselben Austauschordner
   • Exportdatei (EOSWIN → Ergobefund): ERGOEOSW.GDT
   • Importdatei (Ergobefund → EOSWIN): EOSWERGO.GDT
   • GDT-IDs: ERGOBEF (Gerät) / EOSWIN (Praxissoftware)
   • Programmaufruf: Pfad zu Ergobefund-windows-portable.exe
   • Satzart für den Aufruf: 6302 (Neue Untersuchung) oder 6301 (Stammdaten)
3. Ablauf: Gerät in der Kartei aufrufen → Patient erscheint → Befunde anklicken → „An EOSWIN senden“.

Die genauen Menüpunkte in EOSWIN können abweichen – im Zweifel den MCW-Support nach „GDT-Geräteanbindung“ fragen.

Neue Version veröffentlichen

1. Version in package.json erhöhen, committen und pushen.
2. GitHub → Actions → Release bauen und veröffentlichen → Run workflow.
3. Tag eintragen (v + Version, z. B. v0.2.0) und kurz beschreiben, was neu ist.

Der Workflow führt die Tests aus, baut macOS-App und Windows-EXE, erzeugt SHA256SUMS.txt und veröffentlicht das Release.

Aufbau

Pfad	Inhalt
src/shared/schema.js	Karten, Messwerte, Auswahlmöglichkeiten mit Standard-Textbausteinen
src/shared/defaults.js	Normwerte und Standard-Einstellungen
src/shared/calc.js	Soll-HF, Chronotropie-Index, Blutdruckanstieg, MET-Schätzung, Alter
src/shared/report.js	Automatische Bewertung, Befundtext, Zusammenfassung, Diagnosen, Verlaufsvergleich
src/main/gdt.js	GDT 2.1: Zeichensätze, Sätze, Dateinamen, Verbindungsstatus
src/main/archive-store.js	Befundarchiv mit Verschlüsselung, Passwort und Wiederherstellungscode
src/renderer/	Oberfläche

Daten

• Einstellungen: settings.json im App-Datenordner (macOS ~/Library/Application Support/Ergobefund, Windows %APPDATA%\Ergobefund).
• Archiv: ein JSON pro Befund in archiv/ (optional AES-256-GCM-verschlüsselt, Einstellungen → Allgemein → Archiv).
• Nicht verschlüsselt: Einstellungen, PDFs, GDT-Austauschdateien. FileVault/BitLocker bleibt empfohlen (DSGVO).
• Keine Netzwerkzugriffe, keine automatische Update-Prüfung.

Tastenkürzel

• ⌘/Strg + Enter: Befundtext kopieren
• ⌘/Strg + S: Befund speichern