Guida al modulo Percorso Chirurgico

Il modulo gestisce il percorso clinico di un intervento chirurgico, dal primo controllo pre-operatorio fino alla dimissione e alle pratiche di segreteria successive. Non è un singolo modulo da compilare: è un percorso in fasi, con domande da rispondere in ciascuna fase, tracciato passo per passo e stampabile come cartella clinica al termine.

L'idea di fondo è simile a una checklist di sala operatoria: ogni fase ha le sue domande, ogni risposta viene registrata subito con data, ora e operatore, e il percorso si completa da solo quando tutto ciò che è obbligatorio è stato compilato. Nessun pulsante "chiudi percorso" da premere: ci pensa il sistema.

1. Dove si trova

Il modulo è già attivo. Nella scheda di ogni visita compare il pulsante Percorso chirurgico (accanto a "Impianti / Biomateriali"): da lì si apre, si compila e si scarica il percorso del paziente.

Da Impostazioni → Percorso Chirurgico si costruisce e si aggiorna il modello: le fasi e le domande che verranno proposte a ogni nuovo percorso.

2. Le aree del modulo

A differenza del modulo Impianti, qui non esiste una dashboard riassuntiva: la situazione dei percorsi si legge direttamente aprendo la visita del paziente.

3. Costruire il modello: fasi e domande

Da Impostazioni → Percorso Chirurgico si definisce il modello che verrà proposto per ogni nuovo percorso. Il modello è organizzato in fasi, ciascuna con le sue domande.

Fasi già presenti di default (modificabili e disattivabili, ma non è necessario partire da zero):

1. Visita pre-chirurgica — controlli e verifiche prima dell'intervento.
2. Intervento — verifiche e informazioni sulla fase operatoria.
3. Dimissione — controlli e istruzioni al termine dell'intervento.
4. Segreteria — attività amministrative successive.

3.1 Una fase

• Nome fase* e Descrizione (facoltativa, spiegazione per chi compila).
• Ordine: conviene usare 10, 20, 30… per lasciare spazio a inserimenti futuri.
• Fase attiva: se disattivata, non verrà più proposta nei nuovi percorsi (i percorsi già creati che la contengono non cambiano).
• Firme da prevedere nel PDF dopo questa fase: tre interruttori indipendenti — Operatore (attivo di default), Paziente, Medico. Decidono quali righe per la firma cartacea compariranno nel PDF subito dopo quella fase.

Questa configurazione viene fotografata nel percorso al momento della sua creazione: se in seguito si cambiano le firme richieste per una fase, i percorsi già aperti restano con le firme previste al momento della creazione.

3.2 Una domanda

Ogni domanda appartiene a una fase e ha:

• Domanda* (il testo mostrato all'operatore).
• Tipo risposta: Sì/No oppure Risposta aperta (testo libero).
• Motivazione / spiegazione (solo per le domande Sì/No): Facoltativa, Obbligatoria o Non prevista. Decide se sotto la risposta compare un campo di testo per spiegare la risposta, e se è obbligatorio compilarlo. Per le domande a risposta aperta questo campo non serve ed è disattivato in automatico.
• Ordine e Suggerimento (testo di aiuto mostrato come segnaposto nel campo).
• Risposta obbligatoria: se attivo, la domanda deve essere compilata perché il percorso possa considerarsi completo e il PDF possa essere generato.
• Domanda attiva: come per le fasi, disattivarla la esclude solo dai nuovi percorsi.

Eliminare una fase dal modello elimina anche tutte le sue domande nel modello (il sistema avvisa prima di procedere); i percorsi dei pazienti già creati non vengono toccati.

4. Percorsi multipli per paziente

Ogni visita può avere più di un percorso chirurgico, ad esempio uno per l'arcata superiore e uno per l'arcata inferiore, oppure interventi eseguiti in date diverse. Ogni percorso è del tutto indipendente: titolo, data, età, intervento, fasi, risposte, note e storico propri.

Alla prima apertura del pulsante Percorso chirurgico su una visita che non ne ha ancora nessuno, il sistema crea automaticamente il primo percorso ("Percorso chirurgico 1"), con la data odierna e l'età del paziente calcolata in automatico dalla data di nascita, se disponibile sulla visita.

Per aggiungerne un altro si usa Nuovo percorso, indicando:

• Nome percorso (se lasciato vuoto viene numerato automaticamente);
• Data (default: oggi);
• Età (0–120 anni);
• Intervento (descrizione libera, es. "Estrazione 38 + innesto").

Ogni percorso compare come scheda separata (tab) in cima alla finestra, con titolo, data e stato ("In corso" / "Completato").

5. Compilare un percorso

Dalla visita si apre Percorso chirurgico. La finestra mostra:

• in alto, i dati del percorso (Nome, Data, Età, Intervento), modificabili in qualsiasi momento con l'icona del salvataggio;
• una barra di avanzamento con il conteggio "N / M (X%)" delle domande compilate;
• una tab per ciascuna fase del percorso.

5.1 Rispondere alle domande

• Domande Sì/No: due pulsanti, Sì e No. La risposta viene salvata subito al clic.
• Se la domanda prevede una motivazione/spiegazione, sotto la risposta compare un campo di testo, salvato in automatico circa 700 millisecondi dopo aver smesso di scrivere (non serve premere nulla).
• Domande a risposta aperta: un campo di testo, stesso salvataggio automatico.
• Se la motivazione è impostata come Obbligatoria e si dà una risposta Sì/No senza scriverla, il sistema segnala l'errore e non salva.

5.2 Note della fase

Ogni fase ha un proprio campo Note della fase, con pulsante Salva note, per annotazioni libere non legate a una domanda specifica (es. imprevisti, osservazioni cliniche).

5.3 Cosa mostra ogni fase, a colpo d'occhio

• Un bordo colorato sulla tab: verde se la fase è completa (tutte le domande obbligatorie compilate), ambra se parzialmente compilata.
• Un badge rosso "N mancanti" se restano domande obbligatorie senza risposta.
• Un elenco "Attività fase": chi ha lavorato su quella fase e quando, calcolato automaticamente dallo storico (vedi §7) — utile per sapere a colpo d'occhio chi ha compilato cosa, senza dover aprire lo storico completo.
• I badge delle firme previste dopo quella fase (Operatore/Paziente/Medico), cioè quelle che verranno stampate nel PDF.

6. Lo stato del percorso è automatico

Il percorso ha solo due stati, e non c'è un pulsante per cambiarli manualmente:

Se in seguito si cancella o si svuota una risposta obbligatoria già data, il percorso torna automaticamente "In corso" — nello storico compare la voce "Percorso chirurgico tornato in lavorazione".

Questo comportamento è diverso dal modulo Impianti, dove invece si passa da uno stato all'altro premendo pulsanti come Associa o Utilizzato: qui basta rispondere a tutto ciò che è obbligatorio, il sistema fa il resto.

7. Lo storico: tracciabilità automatica

Il pulsante Storico attività, dentro il percorso, apre l'elenco completo di tutto ciò che è successo su quel percorso: ogni risposta inserita, modificata o cancellata, ogni nota aggiunta o cambiata, la creazione del percorso, il suo completamento e riapertura, ogni download del PDF. Per ciascuna voce si vede chi ha fatto cosa (utente e ruolo), quando, e — dove pertinente — il valore prima e dopo la modifica.

Questa tracciabilità è automatica e non richiede nessuna azione: viene registrata a ogni salvataggio, agganciata all'utente che ha effettuato l'accesso. Serve come prova di chi ha compilato il percorso e quando, ma non sostituisce le firme fisiche richieste sul documento stampato (vedi §8).

8. Il PDF del percorso e le firme cartacee

Il pulsante Scarica PDF genera la cartella del percorso chirurgico, pronta per la stampa e la raccolta firme su carta.

8.1 Quando è disponibile

Il PDF non si genera finché non sono compilati:

• i dati obbligatori del percorso (Età e Intervento);
• tutte le domande obbligatorie, in tutte le fasi.

Se manca qualcosa, il sistema mostra l'elenco preciso di cosa completare, fase per fase, invece del documento. Questo controllo vale anche a percorso "in teoria" scaricabile da un link diretto: non è aggirabile.

8.2 Come è fatto il PDF

• Intestazione: paziente, titolo del percorso, data, età, stato, descrizione dell'intervento.
• Una sezione per ogni fase, con la tabella di tutte le domande, le relative risposte e motivazioni, ed eventuali note della fase.
• Il riquadro "Compilazione della fase", che riporta in automatico chi ha lavorato su quella fase e quando (prima attività / ultimo aggiornamento) — la stessa tracciabilità visibile a video, stampata sul documento.
• Righe di firma in bianco, subito dopo ogni fase, per Operatore/Paziente/ Medico secondo quanto configurato per quella fase (vedi §3.1) — da firmare a mano dopo la stampa.
• In fondo al documento, un riquadro finale "Sottoscrizione finale del percorso chirurgico", con due righe di firma aggiuntive (professionista/medico responsabile e paziente) e la data, indipendenti dalle firme di fase.

8.3 Importante da sapere

Il modulo non gestisce firme digitali: non c'è una firma con il dito o il mouse, né un file caricato. Le firme si raccolgono solo su carta, dopo aver stampato il PDF. Ciò che il software garantisce automaticamente è la tracciabilità di chi ha compilato ogni fase a sistema — le firme restano un passo separato, da fare fisicamente con il paziente.

9. Esempio pratico

Paziente di esempio: Marco Bianchi, estrazione dentale con innesto osseo.

1. Sulla sua visita si clicca Percorso chirurgico: il sistema crea in automatico "Percorso chirurgico 1", con l'età calcolata dalla data di nascita.
2. Si compila Intervento: "Estrazione 38 + innesto osseo".
3. Tab Visita pre-chirurgica: si rispondono le domande Sì/No (es. "Esami del sangue effettuati?" → Sì, con motivazione facoltativa se richiesto).
4. Tab Intervento: si compilano le domande relative alla seduta operatoria, con eventuali note del caso in "Note della fase".
5. Tab Dimissione: istruzioni post-operatorie fornite al paziente.
6. Tab Segreteria: pratiche amministrative chiuse.
7. Non appena l'ultima domanda obbligatoria viene compilata, lo stato passa da solo a Completata.
8. Si preme Scarica PDF: il sistema genera la cartella con tutte le risposte e le righe firma previste. Si stampa e si raccolgono le firme del paziente e dell'operatore.
9. In Storico attività restano tutte le registrazioni: chi ha compilato cosa e quando, a garanzia della cartella clinica.

10. Domande frequenti

Posso modificare le domande di un percorso già iniziato? No: le domande di un percorso sono una "fotografia" del modello presa al momento della sua creazione. Modificare il modello in Impostazioni influenza solo i percorsi creati da quel momento in poi.

Posso cancellare un percorso sbagliato? Nell'interfaccia non è previsto un pulsante per eliminare un percorso paziente (a differenza delle fasi/domande del modello, che si possono eliminare). Se un percorso è stato creato per errore, conviene lasciarlo "In corso" senza compilarlo oppure segnalarlo internamente: non compare comunque nel PDF finché non viene completato.

Perché il pulsante "Salva testata" a volte dice "Nessuna modifica da registrare"? Perché il sistema confronta i dati prima e dopo il salvataggio: se non è cambiato nulla, evita di scrivere una riga inutile nello storico.

Le firme raccolte sono valide senza passare dal software? Sì: la parte firmata è sempre cartacea. Il software garantisce solo la tracciabilità informatica di chi ha compilato le risposte a sistema.

11. Buone pratiche

• Configurare tutte le domande obbligatorie davvero necessarie prima di iniziare a usare il modulo in reparto: cambiare il modello dopo non tocca i percorsi già aperti.
• Usare le note di fase per annotare qualsiasi cosa non prevista dalle domande standard (imprevisti, deroghe, osservazioni): restano nello storico e nel PDF.
• Controllare la barra di avanzamento prima di lasciare la sala: se il percorso non risulta "Completata", manca ancora qualcosa di obbligatorio.
• Generare il PDF solo a percorso completo e raccogliere subito le firme cartacee: rimandarlo aumenta il rischio di dimenticare la firma.
• In caso di dubbi su chi ha inserito una risposta o quando, consultare sempre lo Storico attività prima di modificare qualcosa.