Curaki

Datenmodell einer Konsultation

Konzeptionelle Beschreibung, woraus eine Konsultation in Curaki besteht, für zukünftige Integrationen.

Auch ohne eine aktuell verfügbare öffentliche API (siehe „API-Übersicht") ist es sinnvoll, das konzeptionelle Datenmodell einer Konsultation zu verstehen — sowohl für das eigene Verständnis des Produkts als auch als Grundlage für eine mögliche zukünftige Integration.

Die Konsultation als zentrale Einheit

Eine Konsultation ist die zentrale Einheit in Curaki. Sie repräsentiert einen einzelnen Patientenkontakt, von der Aufnahme bis zur freigegebenen Dokumentation. Konzeptionell besteht eine Konsultation aus folgenden Bestandteilen:

  • Interne Patientenkennung — vom Arzt frei vergebenes Kürzel, keine Klarnamen (siehe „Patientenkennungen statt Klarnamen")
  • Aufnahmemodus — Live-Aufnahme oder Diktat
  • Audiodatei — zeitlich begrenzt gespeichert, siehe „Aufbewahrung und Löschung"
  • Transkript — das Ergebnis der Spracherkennung
  • Notiz — die strukturierte SOAP-Dokumentation (Anamnese, Befund, Diagnose, Therapie)
  • Status — der aktuelle Verarbeitungsstand
  • Zugehörige Organisation — die Praxis, der die Konsultation zugeordnet ist
  • Zuständiger Arzt — das Mitglied der Organisation, das die Konsultation angelegt bzw. bearbeitet hat

Der Status-Lebenszyklus

Eine Konsultation durchläuft konzeptionell die folgenden Stationen:

  1. recording — die Aufnahme läuft
  2. uploaded — die Audiodatei wurde erfolgreich hochgeladen
  3. transcribing — die Spracherkennung läuft
  4. transcribed — das Transkript liegt vor
  5. generating_note — die Notiz-Generierung läuft
  6. note_ready — die Notiz liegt zur Prüfung bereit
  7. approved — die Notiz wurde vom Arzt geprüft und freigegeben

Zusätzlich existiert der Status failed, der an mehreren Stellen im Ablauf eintreten kann, wenn ein Verarbeitungsschritt nicht erfolgreich abgeschlossen wird. Details dazu finden Sie unter „Fehlerbehandlung bei Transkription und Notiz-Generierung".

Dieser Lebenszyklus ist linear gedacht, mit der Ausnahme, dass ein Fehlerfall über die Retry-Funktion zum vorherigen erfolgreichen Schritt zurückführen kann, statt die Konsultation komplett neu beginnen zu müssen.

Die Notiz im Detail

Die Notiz folgt durchgehend dem SOAP-Schema mit den vier Abschnitten Anamnese, Befund, Diagnose und Therapie. Bis zur Freigabe gilt eine Notiz als Entwurf; erst der Status approved markiert sie als abgeschlossen.

Dieses Datenmodell beschreibt den konzeptionellen Aufbau, wie er sich in der Weboberfläche darstellt — es handelt sich nicht um eine formale, versionierte API-Spezifikation, da eine öffentliche API aktuell nicht existiert.