medware-t4med-integration¶
Documentazione tecnica del progetto di integrazione tra MEDWARE (cartella clinica di reparto) e T4MED (piattaforma di televisita), sviluppato per il reparto di Nefrologia e Dialisi dell'ASL VCO - Ospedale di Verbania.
Il middleware di integrazione si chiama gt4medServices.
Obiettivo del progetto¶
Realizzare il servizio gt4medServices con due responsabilità principali:
Gestione prenotazioni televisita (Flussi A/B/C):
Il CUP invia messaggi HL7 v2 OMG^O19 a un canale MIRTH. MIRTH scrive la prenotazione nella tabella di MEDWARE e chiama gt4medServices che replica l'operazione (inserimento / aggiornamento / cancellazione) su T4MED tramite API FHIR R4.
Gestione referto post-visita (Flussi D/E):
Al termine della televisita, il medico clicca "firma" in MEDWARE: gefidServices recupera il referto da T4MED e da MEDWARE tramite gt4medServices, li unisce e li firma digitalmente. Il servizio grepoServices, schedulato periodicamente, pubblica i referti firmati su REPO e FSE e chiama gt4medServices per l'upload su T4MED.
Sistemi coinvolti¶
| Sistema | Ruolo |
|---|---|
| CUP | Centro Unico di Prenotazione — genera messaggi HL7 v2 OMG^O19 |
| MIRTH | Integration engine — riceve OMG^O19 dal CUP, scrive in MEDWARE e chiama gt4medServices |
| MEDWARE | Cartella clinica di reparto (EHR) — sorgente prenotazioni e referti clinici |
| T4MED | Piattaforma di televisita — espone API FHIR R4 |
| gefidServices | Middleware di firma digitale SINED (gia' in esercizio) — innescato dal pulsante "firma" di MEDWARE |
| grepoServices | Servizio schedulato (ogni ~10 min) — pubblica referti firmati su REPO/FSE e chiama gt4medServices per upload su T4MED |
| REPO | Repository documentale aziendale |
| FSE | Fascicolo Sanitario Elettronico |
| gt4medServices | Il servizio da realizzare — espone API verso MIRTH (Flussi A/B/C) e verso grepoServices (Flusso E); chiama le API FHIR R4 di T4MED |
Struttura del repository¶
medware-t4med-integration/
│
├── docs/
│ ├── 01-overview.md — Contesto e obiettivi
│ ├── 02-architecture.md — Architettura e flussi dati
│ ├── 03-api-analysis.md — Analisi conformità API T4MED / FHIR R4
│ ├── 04-open-questions.md — Lacune e punti aperti con TESI
│ └── 05-vincoli-e-eccezioni.md — Vincoli, eccezioni e scenari di disallineamento
│
├── samples/
│ ├── flusso-a-nuova-prenotazione.md — POST Appointment (Flusso A)
│ ├── flusso-b-aggiorna-prenotazione.md — PUT Appointment (Flusso B)
│ ├── flusso-c-cancella-prenotazione.md — DELETE Appointment (Flusso C)
│ ├── flusso-d-download-referto.md — $generate-pdf (Flusso D)
│ └── flusso-e-upload-referto-firmato.md — Bundle Binary+DocRef (Flusso E)
│
├── diagrams/
│ └── sequence-diagram.md — Diagramma di sequenza Mermaid
│
└── changelog/
└── CHANGELOG.md
Avanzamento¶
| Fase | Stato |
|---|---|
| Analisi API T4MED | Completata |
| Messaggi FHIR R4 di esempio (Flussi A–E) | Completati |
| Punti aperti con TESI | Identificati — da chiarire |
| Implementazione gt4medServices | Da iniziare |
Autore: MGHI — Data: 2026-06-01