Aller au contenu principal

Diagrammes de flux de données

Des représentations visuelles des principaux flux de données au sein de la Tietai. Utilisez-les pour expliquer la plateforme à vos collègues ou pour identifier l'origine d'un problème. Chaque diagramme illustre le fonctionnement actuel du code, y compris les étapes non connectées.

1. Message de l'hôpital à FHIR​

Message HL7 de l'hôpital vers FHIR via un canal Connect

Un canal Connect reçoit des données HL7 v2 via MLLP. Avant la distribution, il peut exécuter un script de prétraitement, un processeur de flux de travail optionnel, la transformation HL7 vers FHIR et un script de post-traitement. La transformation FHIR s'exécute uniquement si la propriété transform_to_fhir du canal est activée. Avec la transformation par défaut (valeur HL7_TO_FHIR, une erreur n'est pas signalée : le moteur transmet le contenu HL7 original aux destinations sans modification. Il est donc important de vérifier le contenu reçu par la destination. Le transformateur ORU^R01 prenant en compte l'ordre des messages (propriété transformer_type du canal = HL7_ORU_TO_FHIR) signale une erreur de type « fermé » : le message reçoit le statut ERROR et les données HL7 brutes ne sont jamais transmises comme si elles avaient été converties. Lorsque le traitement par lots FHIR est activé, un message affiche le QUEUED jusqu'à la réponse du serveur FHIR, puis SENT ou ERROR. Les destinations incluent un point de terminaison HTTP, Kafka et les fichiers Parquet.

  • Les entrées ADT A01/A03/A08 et ORU R01 sont généralement disponibles. Les messages ORM, SIU, VXU, BAR et de pharmacie ont des générateurs et sont également généralement disponibles (tietai-connect/docs/CAPABILITY_MATRIX.md).
  • Ce canal ne prend pas en charge la mise en correspondance des patients. Si une mise en correspondance est nécessaire, ajoutez le nœud de flux de travail empi à un flux de travail.
  • Un message a le statut ERROR lorsque toutes les destinations ont échoué. Si au moins une destination l'a accepté, le message conserve son statut « Distribué » et les échecs sont consignés dans son texte. Vous les trouverez sous la Tiet · Connect → Network → Messages & DLQ. Les fonctions « Rejouer » et « Supprimer » sont disponibles uniquement lorsque Connect fonctionne en mode concentrateur ; en mode autonome, le panneau est en lecture seule.

2. Routage en étoile​

Mode hub : routeur central, dorsale NATS, réseau spoke, file d’attente des messages non distribuables et relecture

En mode hub, le hub choisit un spoke avec l'une des sept stratégies : round_robin, least_loaded, affinity, broadcast, capability, direct et random. Les messages transitent par NATS sur tietai.<channel>.hub-to-spoke et les spokes répondent sur tietai.<channel>.spoke-to-hub. Un message qui épuise ses tentatives de livraison est stocké dans la file d'attente des messages non distribués de Postgres.

Vous le trouverez sous Tiet · Connect → Network → Mesh, Pipes et Messages & DLQ. L'authentification des sites distants utilise un jeton de service. L'authentification TLS mutuelle entre le hub Connect et les sites distants est prévue. Le maillage propre au moteur de workflow (voir « Exécuter sur un maillage ») est un mécanisme différent qui utilise Connect comme transport.

3. Données portables​

Objets connectés : importation via OAuth ou Apple Health, service pour objets connectés, sorties MQTT, Connect, FHIR et HL7

Le service pour objets connectés récupère les données de l'API cloud du fournisseur après que le patient a autorisé l'accès via un lien d'invitation, les normalise, les stocke dans la table vital_readings et les publie via MQTT lorsqu'un broker est configuré. L'API Vitals et le nœud de workflow device-data-source lisent vital_readings. Seuls Fitbit et WHOOP sont collectés par le service en cours d'exécution (WHOOP également par webhook signé). Garmin, Oura, Polar, Suunto, Samsung Health et Apple Health disposent de code dans le dépôt qui n'est pas intégré au serveur. Les messages MQTT transportent clinical_grade: false et source_type: consumer_wearable.

Le transfert des données des objets connectés vers Connect, puis vers les observations FHIR et les messages HL7 v2.6, n'est pas vérifié : le mappage des appareils FHIR et HL7 de Connect n'écoute tietai/v1/<org>/devices/... sujet, et aucun abonné n'a été trouvé pour les sujets wearables/... Ne présumez pas que les données des objets connectés parviennent au référentiel FHIR. Voir Objets connectés et appareils IoT.

Gérer les appareils sous Tiet · Connect → Device Fleet.

4. Imagerie médicale​

Séquence d&#39;imagerie : Visionneuse d&#39;enregistrements, service d&#39;imagerie, PACS et modèle de vision

Les images transitent du PACS vers le service d'imagerie, puis vers le visualiseur. Ce service, un proxy DICOMweb (QIDO-RS et WADO-RS), stocke les annotations cliniques ainsi que les objets KO, PR et SEG en tant qu'état d'imagerie, et lance l'analyse par IA. Une requête POST .../ai/analyze renvoie le code 202 avec un identifiant de tâche et les résultats sont transmis via des événements envoyés par le serveur. Une requête d'enregistrement (STOW-RS, POST /studies) écrit dans le PACS en amont. Le service propose également des routes pour indexer les objets RT, exporter un objet SR au format FHIR (.../sr/{sop}/to-fhir), exécuter automatiquement l'IA sur une étude (.../ai/auto-run) et créer des tâches de traitement de volume.

Ouvert Tiet · Govern → Records Viewer pour les études DICOM.

5. Publication et accès aux données EHDS​

Publication EHDS chez le fournisseur de services, et négociation et transfert de contrat dans le connecteur d&#39;espace de données

La publication nécessite une révision approuvée et une validation officielle réussie de la version 6 de HealthDCAT-AP. La personne qui publie ne peut pas être celle qui a approuvé la publication. Consultez EHDS Studio pour connaître les rôles et les erreurs exactes. L'accès aux données emprunte une voie distincte : le connecteur d'espace de données négocie un contrat (OFFERED, AGREED, FINALIZED) et initie un transfert, puis le consommateur récupère les données via Connect ou le plan de données du moteur de flux de travail à l'aide d'un jeton de transfert. Consultez la section Tiet · Govern → EHDS Studio ; le catalogue public ne nécessite aucune authentification.

6. Réclamations (payeurs américains)​

Demandes de remboursement : le service X12 génère et enregistre les demandes de remboursement ; la transmission au payeur n’est pas effectuée.

Le service X12 analyse, valide, génère et convertit les transactions X12 (837P, 837I, 835, 270, 271, 276, 277, 278, 834, 820) et assure la conversion entre FHIR R4.0 et le système. POST /api/v1/claims/submit enregistre la demande de remboursement et une transaction sortante de statut created. Aucune donnée n'est transmise : le code indique que la soumission à la chambre de compensation, la nouvelle soumission et les requêtes 276 et 270 ne sont pas encore implémentées. Les connecteurs de chambre de compensation pour SFTP, AS2 et REST sont disponibles sous forme de bibliothèque. Ce flux doit être considéré comme une procédure de préparation et d'archivage des demandes de remboursement, et non comme une connexion avec l'organisme payeur.

7. FHIR pour la recherche (OMOP)​

FHIR vers OMOP : chargement, exécution, publication, métadonnées et tests

L' tietai-fhir2omop correspond à un flux de travail en ligne de commande exécuté pour chaque projet, par exemple ./scripts/tietai-omop-code.sh --project example-img --command "/run all". Il lit les données FHIR NDJSON du dossier input du projet et les charge dans DuckDB. Les étapes du pipeline affinent ensuite les tables en plusieurs étapes numérotées. /publish écrit les tables OMOP finales et les tables sources aplaties au format CSV ou Parquet sous les output/<format>/final et output/<format>/plain-input. /metadata écrit l' record_traceability.csv, la trace source vers OMOP. La publication génère des fichiers ; elle ne les dépose pas sur un portail de recherche.

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.