Documentazione Tecnica AddOn CGM CSE DEMATERAILIZZAZIONE RICETTA SANITARIA Software di Cartella Clinica CCBASIC

Transcript

1 Documentazione Tecnica AddOn CGM CSE DEMATERAILIZZAZIONE RICETTA SANITARIA Software di Cartella Clinica CCBASIC For internal use only! State: released Date: 07/11/2014 Version: Author: CGM Italia Absstract Documentazione tecnica richiesta per l adeguamento del software AddOn CGM CSE dell applicativo di cartella clinica CCBASIC il dotazione ai Medici di Medicina Generale (MMG) ai flussi di dematerializzazione della ricetta sanitaria cartacea. 1 of 13

2 Sommario 1 Dati identificativi Descrizione del Sistema Dematerializzazione della Prescrizione Annullamento Prescrizione Dematerializzata Architettura Casi d Uso Attori Use Case Diagrams Dematerializzazione / Annullamento Prescrizione Use Case Specification PRS_UC_DEMA_001 Dematerializzazione Prescrizione PRS_UC_DEMA_002 Annullamento Prescrizione Dematerializzata Scenari di Cooperazione Dematerializzazione Prescrizione (PRS_UC_DEMA_001) Annullamento Prescrizione Dematerializzata (PRS_UC_DEMA_002) of 13

3 1 Dati identificativi NOME APPLICAZIONE CGM CSE NUMERO DI VERSIONE DATA DI RILASCIO 03/11/2014 RFC E.TOSCANA DI RIFERIMENTO N. 161 Prescrizione elettronica (eprescription) o N. 161 DM2011 Guida all implementazione di alcuni casi N. 207 Acquisizione Numeri Ricetta Elettronica N Storage Geografico HDIS - Archiviazione e Consultazione degli Eventi Sanitari RESPONSABILE DEL PRODOTTO REFERENTE TECNICO Claudio Muscogiuri Massimo Di Bisceglie Tabella 1 Dati relativi all'applicazione software VERSIONE SOFTWARE DATA MODIFICHE /11/2014 Integrazione servizi per la dematerializzazione della prescrizione sanitaria (eprescriptiondm2011) Tabella 2 Storico dell applicativo software NOME DEL DOCUMENTO VERSIONE DEL DOCUMENTO AUTORE Documentazione Tecnica AddOn CGM CSE -Integrazione DEMA- Cartella Clinica CCBASIC CGM Italia DATA DI RILASCIO 07/11/2014 Tabella 3 Dati relativi al documento tecnico VERSIONE DOCUMENTO DATA MODIFICHE /11/2014 Prima stesura 3 of 13

4 /11/2014 Revisioni dovute a riscontri per richiesta di accreditamento (IMR-RTC- RVT RT CGM) Tabella 4 Storico del documento 2 Descrizione del Sistema Questa sezione fornisce una descrizione di carattere generale dell'applicazione software e delle sue funzionalità previste per la FASE DEMA. Le funzionalità di integrazione ai servizi CSE di prescrizione elettronica (eprescriptiondm2011) scaturite dalla applicazione del DM 2 novembre 2011, sono da intendersi come evoluzione di quelle relative al trattamento della ricetta sanitaria cartacea (eprescripriondpcm2008). In tal senso, i flussi operativi abbinati alla ricetta sanitaria cartacea (eprescriptiondpcm2008, quindi produzione della ricetta rossa) rientrano nella eprescriptiondm2011 come caso particolare, quando risulta non attuabile la dematerializzazione della ricetta sanitaria (i.e. indisponibilità servizi regionali, problemi di connettività). Le funzionalità CSE eprescription della Regione Toscana sono rese disponibili, in linea a quanto attuato da CGM nella FASE 1, per le utenze dei medici convenzionati attraverso un software di AddOn che estende le originali funzionalità dell applicativo gestionale di cartella clinica CCBASIC ed integra nuove librerie che offrono nuove classi di funzionalità e specifiche interfacce utente con l obiettivo di implementare gli scenari di integrazione come indicati nelle specifiche tecniche di eprescription. 2.1 Dematerializzazione della Prescrizione Il modulo di integrazione supporta il client di cartella clinica nella realizzazione dello scenario di dematerializzazione della prescrizione sanitaria. Le funzionalità dell AddOn per la dematerializzazione della prescrizione sanitaria sono integrate con i processi di registrazione/stampa della prescrizione prevista dall applicativo di cartella clinica. Alla richiesta di stampa da parte dell utente Medico, tramite le funzionalità dell AddOn, viene generato un documento clinico corredato di NRE, nel formato HL7v3 CDA v2.0, per ogni ricetta generata. I documenti clinici sono gestiti in appositi store dell AddOn per il tracciamento delle code, quindi documenti da inviare, inviati e falliti. Gli scenari d integrazione non prevedono specifiche implementazioni lato cartella clinica per la gestione dei collaboratori di studio; a tal proposito, l azienda si è riservata la libertà progettuale di implementare nell AddOn funzionalità utili a soddisfare eventuali necessità della propria utenza di gestione dei dati di prescrizione in regime di collaboratori di studio e configurazione di medicina di gruppo, nel rispetto delle obbligatorietà dettate. 4 of 13

5 2.2 Annullamento Prescrizione Dematerializzata L AddOn implementa le funzionalità per realizzare l annullamento della prescrizione dematerializzata. L interfaccia dell AddOn offre all utente la possibilità di interrogare la lista delle prescrizioni trasmesse, quindi selezionare l evento di prescrizione oggetto della richiesta di annullamento. 3 Architettura Questa sezione presenta una descrizione testuale e grafica (UML Deployment Diagram) dell architettura dell applicativo di gestione dello studio medico focalizzata sulle principali responsabilità funzionali delle componenti software dell AddOn CGM CSE realizzato per l integrazione con i servizi del progetto CSE Toscana. cmp AddOn Deployment Diagram Applicativo Gestione Studio Medico «device» CCBASIC «execution environment» AddOn CSE eprescription Custom Action Module Scheda Pazienti Controller Module User Inteface Layer (GUI) Serv ice Agent Module Patient Summary Ticket Patient Summary Business Serv ice Module Prescrizione Logon/Logoff Data Application Layer (DAL) SAR Anagrafe «device» DataBase «device» DataBase APS NIL PDD Anagrafiche AAS Il modello architetturale dell AddOn di cartella clinica in Figura 1 si basa sui canoni del pattern MVC (Model View Controller) dove i ruoli principali sono interpretati dal: "Controller": riceve i comandi dell'utente (in genere attraverso la View ) e li attua modificando lo stato degli altri due componenti; "View": visualizza i dati contenuti nel model e si occupa dell'interazione con utenti e agenti; "Model": fornisce i metodi per accedere ai dati utili all'applicazione. La scelta di utilizzo di questo schema ha permesso la separazione fra la logica applicativa (o "logica di business"), quasi totalmente a carico del Model e in piccola parte del Controller, e l'interfaccia utente a carico del View. Di seguito, una descrizione delle interazioni tra le componenti. L'addOn riceve due macro classi di input: Figura 1 - UML Deployment Diagram AddOn CGM CSE 5 of 13

6 1) l'applicativo di cartella clinica chiama i metodi di interfaccia del controller a seguito di eventi di tipo - logon/logoff; - stampa prescrizione; - apertura/chiusura/eliminazione scheda paziente. 2) l'utente, tramite la GUI dell'addon, - chiede di inviare il patient summary del paziente attivo - chiede di allineare le informazioni anagrafiche e la posizione ticket del paziente attivo; - chiede l'allineamento massivo dei dati anagrafici degli assistiti a lui assegnati; - chiede l'allineamento delle iscrizioni degli assistiti che hanno revocato la scelta. 3) Il Controller, ricevuta la richiesta, demanda al Model, che contiene il core applicativo dell'addon, il processing della richiesta eventualmente connettendosi al data application layer o al service agent module. I risultati delle elaborazioni restituiti al Controller sono poi opportunamente visualizzati mediante GUI. L architettura presentata in Figura 1 illustra per semplicità esplositiva i domini di interazione (paziente, prescrizione, patient summary, login/logoff, etc) tra l applicativo di gestione dello studio medico ed il software di AddOn; quest ultimo interagisce con i servizi CSE mediante apposite interfacce applicative implementate nel Service Agent Module. 4 Casi d Uso Questa sezione riporta gli attori e i casi d uso necessari per descrivere le funzionalità principali dell AddOn dell applicativo di cartella clinica in uso ai Medici di Medicina Generale (MMG) relativi alla dematerializzazione della ricetta sanitaria. 4.1 Attori Si riportano i principali attori individuati nella gerarchia di Figura 2 per la descrizione delle funzionalità dell AddOn: Medico di Medicina Generale (MMG) AddOn CSE o Sistema software da accreditare Access Point Subsystem (APS) 6 of 13

7 uc Gerarchia Attori MMG AddOn C... Medico Applicativ o Gestione Studio Medico Medico Medicina Generale (MMG) AddOn CSE Access Point Subsystem (APS) Figura 2 UML Actor Diagram 7 of 13

8 4.2 Use Case Diagrams Di seguito, la descrizione grafica in UML dei casi d uso necessari a descrivere le funzionalità di dematerializzazione della ricetta sanitaria dell applicativo di AddOn con i servizi CSE. Per semplicità espositiva, si assume d ora in poi che l attore generico Medico presentato nelle seguenti sezioni implementi il ruolo effettivo di MMG Dematerializzazione / Annullamento Prescrizione L evento che attiva la dematerializzazione della prescrizione è scatenato dall esecuzione dell attività di stampa della stessa; il documento è inviato al sistema regionale dopo le verifiche sui dati obbligatori richiesti. In questo diagramma, si illustra anche lo use case relativo all annullamento di una prescrizione dematerializzata. uc Start here Aprire Scheda Paziente Medico Compilare Prescrizione Stampare Prescrizione «include» Ricercare Prescrizione Inv iata PRS_UC_DEMA_001 Dematerializzazione Prescrizione PRS_UC_DEMA_002 Annullamento Prescrizione Dematerializzata AddOn CSE Access Point Subsystem (APS) Figura 3 - UML UC Diagram relativo a Invio / Annullamento Prescrizione Dematerializzata 8 of 13

9 4.3 Use Case Specification Di seguito la descrizione delle specifiche dei caso d uso relativi alla dematerializzazione della ricetta sanitaria PRS_UC_DEMA_001 Dematerializzazione Prescrizione ID USE CASE NOME USE CASE ATTORE PRINCIPALE ATTORI SECONDARI DESCRIZIONE PRE-CONDIZIONI POST-CONDIZIONI SCENARIO PRINCIPALE PRS_UC_DEMA_001 Dematerializzazione Prescrizione Medico o AddOn AddOn, APS Consente di inviare una prescrizione al Sistema Regionale per la dematerializzazione. L assistito ha fornito il proprio consenso al trattamento dei dati personali. L operatore sanitario è il medico scelto o il medico associato / sostituto. Il Sistema Regionale fornisce un messaggio di conferma dell avvenuta dematerializzazione della prescrizione, in seguito al quale è prodotta la stampa del Promemoria. 1. Il medico apre la scheda del paziente per cui compilare una prescrizione, dove troverà riportati, oltre ai dati anagrafici del paziente selezionato, anche le eventuali esenzioni/riduzioni dal ticket (es: esenzione da reddito, esenzione per patologia, riduzione per fascia di reddito, contemporanea presenza sia di esenzione di patologia che della fascia di reddito, etc.). 2. Il medico compila una prescrizione per l assistito selezionato, richiedendo eventualmente la Non Sostituibilità del farmaco in caso di prescrizione farmaceutica, conferma i dati inseriti nell apposita interfaccia utente e avvia il processo di stampa; 3. L AddOn verifica nell archivio locale la presenza dell ID Universale del paziente per cui erogare la prescrizione; 4. L AddOn verifica nell archivio locale la presenza dell ID Universale del medico che eroga la prescrizione; 5. L AddOn verifica nell archivio locale la disponibilità di almeno un NRE da utilizzare; 6. Nel caso in cui il medico stia sostituendo un altro medico, l AddOn verifica nell archivio locale la presenza dell ID Universale del medico sostituito; 7. L AddOn produce la prescrizione nel formato HL7v3 CDA v2.0 conforme alle specifiche definite nella RFC161 RCMR_IN000002UV02 - che visualizza al medico prima dell invio, rappresentando appropriatamente la presenza di eventuali esenzioni (da reddito, da patologia) o riduzioni derivanti dalla fascia di reddito, la eventuale non sostituibilità del farmaco prescritto, se richiesta dal medico, l'eventuale medico sostituito, nel caso in cui il medico prescrittore stia agendo in sostituzione di altro medico; 8. Il medico attiva la funzionalità dall interfaccia utente che invia la prescrizione (invio sincrono) al servizio regionale preposto alla dematerializzazione; 9. A fronte dell esito positivo dell operazione (messaggio MCCI_IN00002UV01), l AddOn aggiorna il LOG dei documenti INVIATI ; viene acquisito il codice di autenticazione SAC restituito con l'esito positivo dell'elaborazione; il codice di autenticazione SAC è riportato nella stampa del promemoria da consegnare al cittadino in sostituzione della Ricetta Rossa; 10. Il caso d uso termina 9 of 13

10 SCENARIO ERRORE 1 SCENARIO ERRORE 2 SCENARIO ERRORE 3 A fronte della mancanza di almeno uno dei seguenti dati fondamentali: ID Universale del paziente per cui erogare la prescrizione; ID Universale del medico che eroga la prescrizione; NRE da utilizzare per la prescrizione erogata; al medico prescrittore viene proposto di annullare la stampa perché non sarà possibile creare la prescrizione elettronica secondo il formato HL7v3 CDA v2.0 A fronte di una situazione di OFF-LINE / non disponibilità servizio SAR eprescriptiondm2011 (GestioneInvioPrescrizione), il medico può decidere di proseguire secondo DPCM2008, producendo la stampa della ricetta rossa ed alimentando la lista dei documenti DA INVIARE (per il successivo invio della prescrizione al servizio SAR) A fronte dell esito negativo dell operazione di dematerializzazione (presenza di errori scartanti nella risposta), l AddOn visualizza la lista degli errori e il medico può decidere di proseguire secondo DPCM2008, producendo la stampa della ricetta rossa ed alimentando la lista dei documenti DA INVIARE (per il successivo invio della prescrizione al servizio SAR) Tabella 5 - UC Specification "Dematerializzazione Prescrizione" 10 of 13

11 PRS_UC_DEMA_002 Annullamento Prescrizione Dematerializzata ID USE CASE NOME USE CASE ATTORE PRINCIPALE ATTORI SECONDARI DESCRIZIONE PRE-CONDIZIONI POST-CONDIZIONI PRS_UC_DEMA_002 Annullamento Prescrizione Dematerializzata Medico AddOn, APS Consente di annullare una prescrizione dematerializzata precedentemente inviata al Sistema Regionale. L assistito ha fornito il proprio consenso al trattamento dei dati personali. Il Sistema Regionale fornisce un messaggio di conferma dell avvenuto annullamento della prescrizione dematerializzata. 1. Il medico attiva la ricerca della prescrizione da annullare tra quelle già inviate al SAR, impostando il filtro fornito dall interfaccia utente e avvia il processo di annullamento SCENARIO PRINCIPALE 2. L AddOn prima verifica la tipologia di invio che si intende annullare, differenziando le ricette inviate secondo modalità [DM 2011] e modalità [DPCM 2008]; successivamente, dopo aver prodotto il messaggio di annullamento RCMR_IN000023UV02, richiede attraverso l attivazione del servizio corrispondente il suo annullamento presso il Sistema Regionale; 3. A fronte dell esito positivo dell operazione (messaggio MCCI_IN000002UV01), l AddOn aggiorna il LOG dei documenti ANNULLATI ; 4. Il caso d uso termina SCENARIO ERRORE A fronte dell esito negativo dell operazione (errore applicativo o di comunicazione), l AddOn visualizza la descrizione dell errore ottenuto Tabella 6 - UC Specification "Annullamento Prescrizione Dematerializzata" 11 of 13

12 5 Scenari di Cooperazione Di seguito i diagrammi di sequenza dei casi d uso presentati nella sezione precedente. Per ciascuno sono proposti gli step salienti dello scenario principale. 5.1 Dematerializzazione Prescrizione (PRS_UC_DEMA_001) sd Start here Medico Aprire Scheda Paziente() Applicativo Gestione Studio Medico AddOn CSE Access Point Subsystem (APS) Compilare(Prescrizione) Confermare(Prescrizione) Stampare(Prescrizione) Stampare(Prescrizione) Recupera NRE(AutoreCDA) Genera CDA(Prescrizione) : RCMR_IN000002UV02_Message Visualizza CDA() GestioneInvioPrescrizione(RCMR_IN000002UV02_Message) GestioneInvioPrescrizione() :MCCI_IN000002UV01_Message Aggiorna Lista Documenti Inviati() Stampare() :Esito Stampa Promemoria() Visualizza Messaggio Esito Positivo() Figura 4 - UML Sequence Diagram "Dematerializza Prescrizione" 12 of 13

13 5.2 Annullamento Prescrizione Dematerializzata (PRS_UC_DEMA_002) sd Start here Medico AddOn CSE Access Point Subsystem (APS) Richiesta Annullamento() AnnullamentoPrescrizione(RCMR_IN000023UV02_Mesage) AnnullamentoPrescrizione(MCCI_IN000002UV01_Message) Aggiorna Stato Prescrizione() Visualizza Messaggio Esito Positivo() Figura 5 - UML Sequence Diagram "Annullamento Prescrizione Dematerializzata" 13 of 13