05 — Vincoli, eccezioni e scenari di disallineamento¶
Assenza di modifiche a MEDWARE¶
Il flusso di integrazione, nella prima fase di rilascio, non richiede alcun intervento manuale dal lato cartella clinica MEDWARE.
In virtù di questo vincolo, MEDWARE non subirà nessuna modifica in relazione all'integrazione con T4MED.
Di conseguenza, gli operatori che lavorano su MEDWARE non potranno:
- Verificare se esiste un allineamento tra le televisite prenotate al CUP — visibili in MEDWARE — e le prenotazioni effettivamente spedite a T4MED.
- Intervenire manualmente in MEDWARE per correggere un eventuale disallineamento tra le prenotazioni presenti su MEDWARE e quelle registrate su T4MED.
- Sanare un disallineamento tra quanto firmato e pubblicato da MEDWARE sul REPOSITORY rispetto a quanto pubblicato da MEDWARE su T4MED.
- Visualizzare il referto complessivo — frutto dell'unione tra il referto clinico di MEDWARE e il referto ottenuto da T4MED — prima della firma digitale. Il medico può verificare il risultato finale solo dopo aver completato la firma e, se riscontra un problema, dispone di circa 10 minuti per richiedere l'annullamento.
Possibile mitigazione: schedulare la pubblicazione dei referti solo a partire da una certa ora (ad esempio le 22:00). In questo modo, se il medico firma il referto nel corso della giornata (es. alle 16:00), dispone di un ampio margine di tempo — fino alle 22:00 — per richiedere l'annullamento prima che il documento venga effettivamente pubblicato su REPOSITORY e FSE.
Scenari eccezionali (deviazioni dal flusso nominale)¶
I casi seguenti costituiscono eccezioni al flusso normale e descrivono le possibili situazioni di disallineamento tra i sistemi.
Eccezione A1 — MEDWARE non recepisce la prenotazione dal CUP¶
Scenario: il CUP spedisce a MEDWARE una nuova prenotazione; MEDWARE non la recepisce, quindi non viene pubblicata nemmeno su T4MED.
Il medico esegue comunque la visita aprendo una sessione sia in MEDWARE che sulla piattaforma T4MED.
Conseguenza: poiché la visita non è agganciata al CUP, il referto non verrà pubblicato sul FSE.
Eccezione A2 — gt4medServices non riesce a pubblicare la prenotazione su T4MED¶
Scenario: il CUP spedisce a MEDWARE una nuova prenotazione; MEDWARE la recepisce correttamente, ma gt4medServices non riesce a pubblicarla su T4MED (esauriti i tentativi di retry).
Il medico apre la visita prenotata su MEDWARE senza sapere che non è registrata su T4MED. Ci si aspetta che la piattaforma di televisita funzioni comunque.
Conseguenza: non verrà recuperato il referto da T4MED né pubblicato il referto complessivo firmato su T4MED.
Eccezione B1 — Variazione di orario/data non pubblicata su T4MED¶
Scenario: il CUP spedisce a MEDWARE una variazione di orario o data di una visita precedentemente registrata. Questa variazione non viene pubblicata su T4MED.
Il medico apre la visita su MEDWARE in un orario o in una data che non è conforme a quanto registrato su T4MED. Il medico effettua comunque la televisita.
Conseguenza: il giro di refertazione si chiude correttamente nonostante la difformità di orario/data.
Eccezione C1 — Annullamento non pubblicato su T4MED¶
Scenario: il CUP spedisce a MEDWARE un annullamento di una visita precedentemente registrata. Questo annullamento, per qualche motivo, non viene pubblicato su T4MED.
Conseguenza: su T4MED rimarrà una prenotazione che non verrà mai chiusa con una refertazione.
Eccezione D1 — Referto non firmato dal medico¶
Scenario: il flusso CUP funziona correttamente sia su MEDWARE che su T4MED, ma il referto non viene correttamente firmato dal medico (PIN dimenticato, rete non disponibile). Il medico potrebbe firmare in un secondo momento ma non lo fa.
Conseguenza: su MEDWARE sarà presente un referto valido ma mai firmato. Su T4MED non saranno presenti referti associati a quella visita prenotata.
Eccezione E1 — Referto firmato ma mai pubblicato sul REPOSITORY¶
Scenario: il flusso CUP funziona correttamente sia su MEDWARE che su T4MED; il referto viene correttamente firmato dal medico, ma si verificano problemi in fase di pubblicazione sul REPOSITORY.
Conseguenza: su MEDWARE sarà presente un referto firmato ma mai spedito. Su T4MED non saranno presenti referti associati a quella visita prenotata.
Eccezione E2 — Referto pubblicato su REPOSITORY ma non caricato su T4MED¶
Scenario: il flusso CUP funziona correttamente sia su MEDWARE che su T4MED; il referto viene correttamente firmato dal medico e spedito al REPOSITORY. Si verificano tuttavia problemi in fase di upload su T4MED.
Conseguenza: su MEDWARE sarà presente un referto firmato e archiviato sul REPOSITORY. Su T4MED non saranno presenti referti associati a quella visita prenotata.
Strategia di retry sulle chiamate verso T4MED¶
Ogni volta che gt4medServices invoca i servizi della piattaforma T4MED, in caso di errore eseguirà al massimo 3 tentativi, a distanza di 5 secondi l'uno dall'altro. Ciascun tentativo attende un timeout massimo di 60 secondi.
L'obiettivo è che le micro-interruzioni di rete di breve durata si risolvano automaticamente senza degenerare in un errore definitivo.
Nota aperta: il timeout di 60 secondi per tentativo potrebbe essere eccessivo nel contesto del Flusso D/E, quando il medico è in attesa del completamento dell'intero ciclo di recupero, merge, generazione CDA2, normalizzazione PDF/A-3b e inclusione del documento CDA2 nel referto PDF (conforme alle norme FSE 2.0). Da valutare se ridurre il timeout nei flussi interattivi.