Saltar al contenido principal

Diagramas de flujo de datos

Referencias visuales de las principales vías de flujo de datos Tietai. Úselas para explicar la plataforma a sus compañeros o para determinar la ubicación de un problema. Cada diagrama muestra la función actual del código, incluyendo los pasos que no están conectados.

1. Mensaje del hospital a FHIR​

Mensaje HL7 del hospital a FHIR a través de un canal Connect

Un canal Connect recibe HL7 v2 a través de MLLP. Antes de la entrega, puede ejecutar un script de preprocesamiento, un procesador de flujo de trabajo opcional, la transformación de HL7 a FHIR y un script de posprocesamiento. La transformación FHIR se ejecuta solo cuando la propiedad transform_to_fhir del canal es verdadera. Con la transformación HL7_TO_FHIR predeterminada, un fallo no genera un error: el motor pasa el contenido HL7 original a los destinos sin cambios, por lo que debe verificar lo que recibió el destino. El transformador ORU^R01 consciente del orden (propiedad del canal transformer_type = HL7_ORU_TO_FHIR) falla cerrado en su lugar: el mensaje obtiene el estado ERROR y el HL7 sin procesar nunca se reenvía como si se hubiera convertido. Con el procesamiento por lotes de FHIR activado, un mensaje muestra QUEUED hasta que el servidor FHIR responde, luego SENT o ERROR. Los destinos incluyen un punto final HTTP, Kafka y archivos Parquet.

  • ADT A01/A03/A08 y ORU R01 son entradas generalmente disponibles. ORM, SIU, VXU, BAR y los mensajes de farmacia tienen constructores y también están generalmente disponibles (tietai-connect/docs/CAPABILITY_MATRIX.md).
  • El canal no realiza la comparación de pacientes. Si necesita esta función, añada el nodo de flujo de trabajo empi al flujo de trabajo.
  • Un mensaje tiene el estado ERROR cuando todos los destinos fallan. Si al menos un destino lo acepta, el mensaje conserva su estado de entregado y los fallos se registran en su texto. Puede encontrarlos en el apartado Tiet · Connect → Network → Messages & DLQ. Las opciones de reproducción y descarte solo están disponibles cuando Connect se ejecuta en modo hub; en modo independiente, el cajón es de solo lectura.

2. Enrutamiento tipo hub-and-spoke​

Modo concentrador: enrutador concentrador, red troncal NATS, nodos secundarios, cola de mensajes no entregados y reproducción.

En el modo hub, el hub selecciona un nodo con una de siete estrategias: round_robin, least_loaded, affinity, broadcast, capability, direct y random. Los mensajes viajan a través de NATS en la tietai.<channel>.hub-to-spoke, y los nodos responden en la tietai.<channel>.spoke-to-hub. Un mensaje que agota sus intentos de entrega se almacena en la cola de mensajes no entregados de Postgres.

Encuéntralo en Tiet · Connect → Network → Mesh, Pipes y Messages & DLQ. La autenticación de los nodos secundarios utiliza un token de servicio. La autenticación TLS mutua entre el hub y los nodos secundarios de Connect está prevista. La malla propia del motor de flujo de trabajo (ver Ejecutar en malla) es un mecanismo diferente que utiliza Connect como transporte.

3. Datos de dispositivos portátiles​

Dispositivos portátiles: proveedor OAuth o importación de Apple Health, servicio de dispositivos portátiles, MQTT, Connect, salidas FHIR y HL7.

El servicio de wearables obtiene datos de la API en la nube del proveedor después de que el paciente autoriza el acceso a través de un enlace de invitación, los normaliza, los almacena en la tabla vital_readings y los publica a través de MQTT cuando se configura un broker. La API de Vitals y el nodo de flujo de trabajo device-data-source leen vital_readings. Solo Fitbit y WHOOP son recopilados por el servicio en ejecución (WHOOP también mediante webhook firmado). Garmin, Oura, Polar, Suunto, Samsung Health y Apple Health tienen código en el repositorio que no está conectado al servidor. Los mensajes MQTT transportan clinical_grade: false y source_type: consumer_wearable.

El salto desde los temas MQTT de los dispositivos portátiles a Connect, y desde allí a las observaciones FHIR y los mensajes de dispositivos HL7 v2.6, no está verificado: el mapeo de dispositivos FHIR y HL7 de Connect escucha sus propios tietai/v1/<org>/devices/... temas, y no se encontró ningún suscriptor para los wearables/... temas. No asuma que las lecturas de los dispositivos portátiles llegan al almacenamiento FHIR. Consulte Dispositivos portátiles y dispositivos IoT.

Administrar dispositivos menores de Tiet · Connect → Device Fleet.

4. Imágenes médicas​

Secuencia de imágenes: Visor de registros, servicio de imágenes, PACS y modelo de visión.

Las imágenes fluyen desde PACS al servicio de imágenes y luego al visor. El servicio de imágenes es un proxy DICOMweb (QIDO-RS y WADO-RS), almacena anotaciones del médico y objetos KO, PR y SEG como estado de imagen, e inicia el análisis de IA. POST .../ai/analyze devuelve 202 con un ID de trabajo y los hallazgos fluyen a través de eventos enviados por el servidor. Una solicitud de almacenamiento (STOW-RS, POST /studies) escribe en el PACS ascendente. El servicio también tiene rutas para indexar objetos RT, exportar un objeto SR a FHIR (.../sr/{sop}/to-fhir), ejecutar IA automáticamente en un estudio (.../ai/auto-run) y crear trabajos de volumen.

Abrir Tiet · Govern → Records Viewer para estudios DICOM.

5. Publicación y acceso al conjunto de datos EHDS​

Publicación de EHDS en el proveedor de servicios, y negociación y transferencia de contratos en el conector del espacio de datos.

La publicación requiere una revisión aprobada con una validación oficial exitosa de HealthDCAT-AP Release 6, y la persona que publica no puede ser la misma que aprobó. Consulte EHDS Studio para conocer los roles y los errores exactos. El acceso a los datos es una ruta independiente: el conector del espacio de datos negocia un contrato (OFFERED, AGREED, FINALIZED) e inicia una transferencia, y el consumidor obtiene los datos a través de Connect o del plano de datos del motor de flujo de trabajo con un token de transferencia. Trabaje en Tiet · Govern → EHDS Studio; el catálogo público no requiere inicio de sesión.

6. Reclamaciones (pagadores estadounidenses)​

Reclamaciones: El servicio X12 genera y registra reclamaciones; el paso al pagador no está conectado.

El servicio X12 analiza, valida, genera y convierte transacciones X12 (837P, 837I, 835, 270, 271, 276, 277, 278, 834, 820) y convierte a y desde FHIR R4. POST /api/v1/claims/submit registra la reclamación y una transacción saliente con estado created. No transmite nada: el código marca el envío a la cámara de compensación, el reenvío y las solicitudes 276 y 270 como aún no implementadas. Los conectores de la cámara de compensación para SFTP, AS2 y REST existen como una biblioteca. Trate este flujo como preparación de reclamaciones y mantenimiento de registros, no como conectividad de pagadores.

7. Investigación FHIR (OMOP)​

De FHIR a OMOP: carga, ejecución, publicación, metadatos y prueba.

tietai-fhir2omop es un flujo de trabajo de línea de comandos que se ejecuta por proyecto, por ejemplo ./scripts/tietai-omop-code.sh --project example-img --command "/run all". Lee FHIR NDJSON de la carpeta input del proyecto y lo carga en DuckDB. Las etapas de la canalización luego refinan las tablas en pasos numerados. /publish escribe las tablas OMOP finales y las tablas de origen aplanadas como CSV o Parquet en output/<format>/final y output/<format>/plain-input. /metadata escribe record_traceability.csv, el rastreo de origen a OMOP. La publicación escribe archivos; no los entrega a un portal de investigación.

¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..