Datenflussdiagramme
Visuelle Darstellungen der wichtigsten Datenflüsse in der Tietai. Nutzen Sie diese, um Kollegen die Plattform zu erklären oder die Fehlerursache zu ermitteln. Jedes Diagramm zeigt die aktuelle Funktionsweise des Codes, einschließlich der nicht miteinander verbundenen Schritte.
1. Krankenhausnachricht an FHIR
Ein Connect-Kanal empfängt HL7 v2 über MLLP. Vor der Zustellung kann er ein Vorverarbeitungsskript, optional einen Workflow-Prozessor, die HL7-zu-FHIR-Transformation und ein Nachverarbeitungsskript ausführen. Die FHIR-Transformation wird nur ausgeführt, wenn die Eigenschaft transform_to_fhir des Kanals auf „true“ gesetzt ist. Bei der standardmäßigen Transformation HL7_TO_FHIR wird im Fehlerfall kein Fehler ausgelöst: Die Engine leitet den ursprünglichen HL7-Inhalt unverändert an die Ziele weiter. Prüfen Sie daher, was das Ziel empfangen hat. Die reihenfolgeabhängige ORU^R01-Transformation (Kanaleigenschaft transformer_type = HL7_ORU_TO_FHIR) schlägt stattdessen mit „geschlossen“ fehl: Die Nachricht erhält den Status ERROR, und unformatiertes HL7 wird nicht weitergeleitet, als wäre es konvertiert worden. Bei aktiviertem FHIR-Batching zeigt eine Nachricht den Status QUEUED an, bis der FHIR-Server antwortet, danach SENT oder ERROR. Zu den Zielen gehören ein HTTP-Endpunkt, Kafka und Parquet-Dateien.
- ADT A01/A03/A08 und ORU R01 sind allgemein verfügbare Eingaben. ORM-, SIU-, VXU-, BAR- und Apothekennachrichten verfügen über Builder und sind ebenfalls allgemein verfügbar (
tietai-connect/docs/CAPABILITY_MATRIX.md). - Der Kanal führt keine Patientenzuordnung durch. Falls Sie eine Zuordnung benötigen, fügen Sie den Workflow-Knoten
empiin einen Workflow ein. - Eine Nachricht erhält den Status
ERRORwenn die Zustellung an alle Ziele fehlgeschlagen ist. Wurde die Nachricht von mindestens einem Ziel angenommen, behält sie ihren Zustellungsstatus, und die Fehler werden im Nachrichtentext vermerkt. Sie finden diese unter Tiet · Connect → Network → Messages & DLQ. Die Funktionen „Wiederholen“ und „Verwerfen“ sind nur verfügbar, wenn Connect im Hub-Modus ausgeführt wird; im Standalone-Modus ist der Nachrichtenbereich schreibgeschützt.
2. Hub-and-Spoke-Routing
Im Hub-Modus wählt der Hub einen Spoke mit einer von sieben Strategien aus: round_robin, least_loaded, affinity, broadcast, capability, direct und random. Nachrichten werden über NATS auf tietai.<channel>.hub-to-spoke übertragen, und Spokes antworten auf tietai.<channel>.spoke-to-hub. Eine Nachricht, deren Zustellungsversuche ausgeschöpft sind, wird in der Postgres-Warteschlange für unzustellbare Nachrichten gespeichert.
Sie finden es unter Tiet · Connect → Network → Mesh, Pipes und Messages & DLQ. Die Spoke-Authentifizierung verwendet ein Service-Token. Gegenseitiges TLS zwischen Connect-Hub und Spoke ist geplant. Das eigene Mesh der Workflow-Engine (siehe „Auf Mesh ausführen “) ist ein anderer Mechanismus, der Connect als Transportprotokoll nutzt.
3. Wearable-Daten
Der Wearables-Dienst ruft Daten von der Cloud-API des Anbieters ab, nachdem der Patient den Zugriff über einen Einladungslink autorisiert hat. Die Daten werden normalisiert, in der Tabelle vital_readings gespeichert und über MQTT veröffentlicht, sobald ein Broker konfiguriert ist. Die Vitals-API und der Workflow-Knoten device-data-source lesen Daten der Tabelle vital_readings. Nur Fitbit und WHOOP werden vom laufenden Dienst erfasst (WHOOP zusätzlich über einen signierten Webhook). Garmin, Oura, Polar, Suunto, Samsung Health und Apple Health verfügen über Code im Repository, der nicht mit dem Server verbunden ist. MQTT-Nachrichten enthalten die Tabellen clinical_grade: false und source_type: consumer_wearable.
Die Verbindung von den MQTT-Themen der Wearables zu Connect und von dort zu FHIR-Beobachtungen und HL7-v2.6-Gerätenachrichten ist nicht verifiziert: Die FHIR- und HL7-Gerätezuordnung von Connect überwacht ihre eigenen tietai/v1/<org>/devices/... Themen, und es wurde kein Abonnent für die wearables/... Themen gefunden. Gehen Sie nicht davon aus, dass die Messwerte der Wearables den FHIR-Speicher erreichen. Siehe Wearables & IoT-Geräte.
Geräte unter Tiet · Connect → Device Fleet verwalten.
4. Medizinische Bildgebung
Die Bilder fließen vom PACS zum Bildverarbeitungsdienst und von dort zum Betrachter. Der Bildverarbeitungsdienst fungiert als DICOMweb-Proxy (QIDO-RS und WADO-RS), speichert klinische Annotationen sowie KO-, PR- und SEG-Objekte als Bildgebungsstatus und startet die KI-Analyse. Antwort POST .../ai/analyze gibt den Statuscode 202 mit einer Job-ID und den Befunden als Stream über Server-Sent Events zurück. Eine Speicheranfrage (STOW-RS, POST /studies) schreibt in das vorgelagerte PACS. Der Dienst bietet außerdem Funktionen zum Indizieren von RT-Objekten, zum Exportieren eines SR-Objekts nach FHIR (.../sr/{sop}/to-fhir), zum automatischen Ausführen von KI auf einer Studie (.../ai/auto-run) und zum Erstellen von Volumen-Jobs.
Öffnen Sie Tiet · Govern → Records Viewer für DICOM-Studien.
5. Veröffentlichung und Zugriff auf den EHDS-Datensatz
Für die Veröffentlichung ist eine genehmigte Revision mit erfolgreicher Validierung gemäß HealthDCAT-AP Release 6 erforderlich. Die Person, die die Veröffentlichung vornimmt, darf nicht dieselbe sein, die sie genehmigt hat. Informationen zu den Rollen und den genauen Fehlermeldungen finden Sie in EHDS Studio. Der Datenzugriff erfolgt über einen separaten Pfad: Der Datenbereichskonnektor verhandelt einen Vertrag (OFFERED, AGREED, FINALIZED) und initiiert eine Übertragung. Der Nutzer ruft die Daten über eine Connect- oder Workflow-Engine-Datenebene mit einem Übertragungstoken ab. Arbeiten Sie in Tiet · Govern → EHDS Studio; für den öffentlichen Katalog ist keine Anmeldung erforderlich.
6. Ansprüche (US-Kostenträger)
Der X12-Dienst analysiert, validiert, generiert und konvertiert X12-Transaktionen (837P, 837I, 835, 270, 271, 276, 277, 278, 834, 820) und konvertiert diese in und aus FHIR R4. POST /api/v1/claims/submit erfasst den Leistungsantrag und eine ausgehende Transaktion mit Status created. Es werden keine Daten übertragen: Der Code kennzeichnet die Übermittlung an die Clearingstelle, die erneute Übermittlung sowie die Anfragen 276 und 270 als noch nicht implementiert. Clearingstellen-Konnektoren für SFTP, AS2 und REST sind als Bibliothek verfügbar. Dieser Ablauf dient der Leistungsantragsvorbereitung und -verwaltung, nicht der Anbindung an den Kostenträger.
7. FHIR für die Forschung (OMOP)
tietai-fhir2omop ist ein Befehlszeilen-Workflow, der pro Projekt ausgeführt wird, z. B. Schritt ./scripts/tietai-omop-code.sh --project example-img --command "/run all". Er liest FHIR-NDJSON-Dateien aus dem Projektordner input und lädt sie in DuckDB. Anschließend verfeinern Pipeline-Stufen die Tabellen in nummerierten Schritten. /publish schreibt die finalen OMOP-Tabellen und die vereinfachten Quelltabellen als CSV- oder Parquet-Dateien unter output/<format>/final und output/<format>/plain-input. /metadata schreibt record_traceability.csv, den Quell-zu-OMOP-Trace. Die Veröffentlichung schreibt Dateien; sie erfolgt nicht auf einem Forschungsportal.
Verwandt
Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..