La prenotazione da agenda oraria permette di visualizzare direttamente gli slot liberi e occupati di ciascun medico.

Passaggi Operativi:

1. Apri la sezione Calendario & Agende.
2. Usa il mini-calendario a sinistra per scegliere il giorno desiderato.
3. Individua la colonna oraria del medico ed il relativo slot vuoto, quindi fai doppio clic su di esso.
4. Nel pannello a comparsa, seleziona il paziente (o inserisci i dati per crearne uno nuovo) e scegli la prestazione medica da associare.
5. Clicca su Salva Prenotazione. L'appuntamento apparirà in colore azzurro (stato "Prenotata") all'interno della griglia oraria.

Il Wizard di Accettazione Rapida è pensato per gli sportelli con alto afflusso, riducendo al minimo i clic necessari.

Passaggi Operativi:

1. Clicca su Nuova Prenotazione (Wizard) in cima all'accettazione.
2. Digita il nome o codice fiscale del paziente nel box di ricerca standard.
3. Seleziona il tipo di prestazione desiderato (es. Visita, LIS, RIS) ed il listino prezzi.
4. Il sistema mostrerà i primi slot orari disponibili per quella specializzazione; seleziona quello ottimale per il paziente.
5. Clicca su Conferma ed Esegui Check-in per generare in un solo passaggio la prenotazione e l'accettazione attiva.

Le prestazioni erogate a tariffa intera a carico del cittadino vengono registrate come accettazioni di tipo Privato.

Passaggi Operativi:

1. Seleziona il paziente e la prestazione clinica desiderata.
2. Nel campo convenzione / tipo tariffa, mantieni impostata la voce "Privato (Listino Base)".
3. Fai clic su Accetta ed Avvia. Il sistema proporrà il pagamento dell'intero importo della prestazione.
4. Emetti la fattura con aliquota IVA esente (Art. 10) o con marca da bollo se l'importo supera i 77,47 €.

Le accettazioni SSN richiedono la validazione della ricetta elettronica (NRE) ed il calcolo del relativo ticket sanitario o quota fissa ricetta.

Passaggi Operativi:

1. In fase di accettazione, inserisci il codice **NRE (Numero Ricetta Elettronica)** ed il Codice Fiscale del paziente.
2. Clicca su **Interroga SOGEI / Catalogo**. Il sistema scaricherà le prestazioni ed il codice di esenzione associati alla ricetta.
3. NextCare calcolerà in automatico l'importo del ticket dovuto (fino al tetto massimo regionale di 36,15 € a ricetta + quota fissa) o esenterà il paziente in caso di codice di esenzione valido (es. ticket 0%, esenzione per reddito o patologia).
4. Conferma l'accettazione e registra i codici esame nel foglio di rendicontazione mensile.

Le accettazioni convenzionate permettono di ripartire la spesa tra la compagnia assicurativa ed il paziente in base alle franchigie contrattuali.

Passaggi Operativi:

1. Nel pannello di accettazione, seleziona l'ente assicurativo o convenzione associata al paziente.
2. Inserisci il numero di autorizzazione / claim della pratica.
3. Il sistema calcolerà lo sconto previsto dal listino convenzione e applicherà le regole di co-pay (es. 20% a carico del paziente, 80% a carico dell'assicurazione).
4. Esegui il check-in. In base alle impostazioni dell'ente, verranno prodotte due fatture separate in modalità split o un'unica fattura co-intestata.

NextCare distingue la prenotazione di risorse fisiche (apparecchiature/macchine, es. Risonanza Magnetica RM1) da quella delle visite dirette di un professionista.

1. Agenda Medico (Pre-compilata):

L'appuntamento è legato a un medico specifico. Quando si effettua l'accettazione ("Accetta e Avvia"), il campo "Medico Refertante" viene pre-compilato ed impostato automaticamente con quel professionista.

2. Agenda Macchina (Refertazione Manuale Obbligatoria):

L'appuntamento è collegato a un macchinario e non ha un medico refertante pre-compilato di default. Al momento del check-in, il dropdown mostrerà solo i medici refertanti abilitati la cui specializzazione corrisponde alla branca clinica dell'esame. L'operatore all'accettazione ha l'obbligo di selezionare manualmente il medico che firmerà il referto.

La pianificazione oraria previene casi di overbooking e coordina le presenze all'interno della struttura clinica.

Chiusure Agende:

In caso di ferie, malattia o congressi di un medico, accedi a Pianificazione Agende ➔ Chiusure Agende e inserisci l'intervallo di tempo da bloccare. Gli slot orari compresi in tale fascia verranno oscurati e disabilitati per le nuove prenotazioni del CUP.

Turni dello Staff:

Permette di pianificare la presenza di tecnici sanitari (TSRM), infermieri ed assistenti per branca medica o singola stanza, allineando le disponibilità delle agende macchina con la presenza effettiva degli operatori abilitati.

L'accettazione di laboratorio genera i record dei campioni biologici e le provette corrispondenti.

Passaggi Operativi:

1. Nel pannello CUP o accettazione diretta, seleziona gli esami di chimica o ematologia.
2. NextCare raggrupperà automaticamente i test in base alle provette richieste (es. EDTA, Siero) ed assegnerà i Barcode.
3. Stampa le etichette con il pulsante Stampa Barcode da applicare alle provette biologiche in fase di prelievo.
4. Il campione passerà nello stato "Accettato/Da Prelievare".

NextCare associa a ciascun esame del sangue la corretta tipologia di provetta e genera i barcode univoci necessari per i lettori del laboratorio.

Gestione Provette:

Accedendo a Configurazione Prestazioni ➔ Gestione Provette LIS, puoi visualizzare e aggiungere tipi di provette biologiche definendo il colore del tappo ed il suffisso numerico per la composizione del Barcode (Sample ID).

Il collegamento degli analizzatori (es. contaglobuli, chimica clinica) avviene tramite protocolli ASTM E1381/E1394 o standard HL7 LIS.

Collegamento & Ispezione:

1. Nella scheda Log & Simulatori LIS puoi visualizzare in tempo reale lo stato di ciascun analizzatore (Online/Offline) ed il relativo carico di lavoro.
2. Usa la console interattiva di ciascun simulatore per forzare l'iniezione manuale di risultati di test per finalità di convalida o calibrazione degli strumenti.

L'automazione del laboratorio velocizza la refertazione riducendo il tempo di consegna (Turnaround Time - TAT).

1. Fogli di Lavoro (Worksheets):

Gli operatori di laboratorio possono raggruppare i campioni accettati in "Fogli di Lavoro" divisi per tipologia di esame (es. Ematologia, Chimica) o per turno lavorativo per favorire l'elaborazione in serie sugli analizzatori.

2. Autovalidazione:

Se tutti i risultati di un campione rientrano perfettamente nei range di normalità e non ci sono alert diagnostici, il sistema valida automaticamente il referto e lo rende disponibile per il download sul Portale Paziente.

3. Reflex Testing (Esami di Riflesso):

Qualora un risultato analitico superi un valore di allerta critico (es. *TSH* alterato), NextCare avvia in automatico un esame integrativo (es. *FT4*) senza richiedere una nuova ricetta medica, allineando le provette per il test aggiuntivo.

L'accettazione radiologica inserisce lo studio nella coda di refertazione del radiologo ed invia il record di lavoro alla Modality Worklist.

Passaggi Operativi:

1. Seleziona una prestazione di radiologia (RX, RM o TC).
2. Associa l'esame a un macchinario/stanza e clicca su Accetta ed Avvia.
3. La prenotazione si converte in uno **Studio Radiologico** attivo ed invia una stringa DICOM al server MWL locale.
4. Il tecnico di radiologia può importare i dati del paziente direttamente sul pannello di comando del macchinario interrogando la Worklist.

L'integrazione PACS (DICOMweb / DIMSE) permette la ricerca e il retrieve delle immagini radiografiche.

1. Configurazione del Nodo PACS:

Vai su Database SQL ➔ Nodi DICOM ed imposta l'indirizzo IP del PACS, la porta di ascolto ed il relativo AE Title. Verifica la raggiungibilità cliccando su Esegui DICOM Ping (C-ECHO).

2. Interrogazione e Recupero Immagini:

• C-FIND (Query): Il medico esegue una ricerca sul PACS inserendo l'ID del paziente o la data esame per ottenere la lista delle serie disponibili.
• C-GET / C-MOVE (Retrieve): NextCare invia la richiesta di trasferimento. Le immagini DICOM vengono inviate al visualizzatore web interno.

Il visualizzatore DICOM web incorporato in NextCare consente l'analisi diagnostica direttamente da browser.

Visualizzatore DICOM:

Il canvas interattivo supporta la regolazione di contrasto e luminosità (Window Center/Width), zoom, pan ed il tracciamento di misurazioni fisiche calibrate (calcolo delle distanze in millimetri).

Firma Digitale dei Referti:

Una volta redatto il testo del referto radiologico nell'editor WYSIWYG, il medico radiologo inserisce il proprio codice PIN per applicare la firma digitale crittografica. Il documento viene salvato in formato PDF/A immutabile e caricato sul portale.

L'accettazione della fisioterapia si basa sul concetto di **Ciclo di Trattamento** (composto da più sedute) anziché su singole prestazioni slegate.

Passaggi Operativi:

1. In fase di accettazione, seleziona la prestazione di riabilitazione (es. Tecarterapia) ed inserisci il numero totale di sedute prescritte (es. 10 sedute).
2. Scegli se la fatturazione deve essere **Anticipata** (pagamento dell'intero importo al check-in) o **Posticipata** (pagamento all'ultima seduta o per singola presenza).
3. Clicca su **Accetta e Inizia Ciclo**. Il sistema genererà un record in `rehab_cycles` e la prima seduta associata in agenda.

La gestione delle reti fisioterapiche coordina i cicli di sedute, monitorando il decorso clinico e l'efficacia del trattamento del dolore.

1. Diario Clinico & Scala VAS:

Per ogni seduta eseguita, il terapista inserisce il diario del trattamento (esercizi, manipolazioni) e registra la Scala VAS da 0 a 10 riferita dal paziente per tracciare il grafico di miglioramento storico.

2. Pre-Authorization Assicurativa:

Molti enti richiedono un'autorizzazione preventiva prima di erogare il ciclo. NextCare blocca l'esecuzione delle sedute se la pratica non ha superato lo stato di "Approvata" o se è scaduto il limite massimo di spesa concesso dalla convenzione.

Il modulo logistico garantisce che il laboratorio ed i reparti non rimangano sprovvisti di reagenti e farmaci salvavita.

1. Registrazione DDT:

Durante il carico merci, inserisci il Documento di Trasporto (DDT), associando per ciascun articolo il codice lotto del produttore e la data di scadenza per la tracciabilità.

2. Allarmi Sotto-scorta e Scadenza:

Il sistema monitora le giacenze. Se un lotto scade entro 30 giorni o se le scorte scendono sotto la soglia minima configurata, viene inviato un alert in dashboard per procedere all'ordine d'acquisto.

3. Monitoraggio Termico (Catena del Freddo):

Traccia i log di temperatura registrati per ciascun frigorifero (range ottimale 2-8 °C). Se la temperatura esce dai limiti, viene generata un'anomalia per preservare l'integrità dei reagenti.

La configurazione economica di NextCare si basa su Listini Prezzi flessibili e contratti medici dettagliati.

1. Configurazione Prestazioni e Tariffe:

Nel menu Configurazione Prestazioni è possibile definire le tariffe base e creare listini personalizzati per convenzioni o categorie di pazienti (es. Listino SSN, Listino Privati, Listino Assicurazioni).

2. Calcolo dei Compensi Medici (Payout):

Ad ogni medico è associato un contratto. NextCare calcola le spettanze in base a due regole:

• Quota Percentuale: Una percentuale sul valore erogato (es. 40% sul prezzo della visita).
• Quota Fissa: Un compenso fisso predeterminato (es. 30,00 € per esame).

La liquidazione avviene alla refertazione dell'esame o all'incasso della fattura, a seconda degli accordi contrattuali configurati.

Gli amministratori clinici possono personalizzare l'intero catalogo delle prestazioni sanitarie erogate all'interno della struttura.

Passaggi per la configurazione:

1. Accedi a Configurazione Prestazioni ➔ Elenco Prestazioni.
2. Clicca sul pulsante **Nuova Prestazione** in alto a destra.
3. Inserisci il nome (es. *Elettrocardiogramma*), la branca specialistica (es. *Cardiologia*), la tipologia (*Visita*, *LIS* o *RIS*) e la tariffa standard privata di base.
4. Se si tratta di un esame LIS, potrai definire i singoli parametri con i relativi intervalli di normalità e l'unità di misura.
5. Fai clic su **Salva**. La prestazione sarà immediatamente selezionabile all'accettazione e CUP.

I listini definiscono le variazioni tariffarie applicate a categorie particolari di cittadini o a convenzioni assicurative.

Creazione di un Listino:

In **Configurazione Prestazioni ➔ Listini Prezzi**, clicca su **Nuovo Listino**. Inserisci il nome ed imposta se il listino deriva dal listino base applicando una percentuale di variazione automatica (es. sconto 10% per dipendenti) oppure se prevede l'inserimento manuale delle tariffe per ciascuna voce.

Il sistema invia email ricche in formato HTML con intestazione del Centro Medico, loghi e icone in corrispondenza di specifici eventi.

Setup del Server SMTP:

Nel menu **Database SQL ➔ Parametri SMTP** inserisci l'indirizzo dell'host email (es. *smtp.nextcare.tech*), la porta (es. *465* o *587*), le credenziali di accesso TLS/SSL ed attiva l'invio automatico in copia (BCC) a `nextcare@nextcare.tech` a fini di audit e sicurezza.

Il Registro Audit garantisce la conformità al GDPR (art. 30), tracciando in modo permanente chi ha effettuato qualsiasi operazione sui dati sanitari.

Consultazione del Registro:

Accedi alla scheda **Registro Audit**. Troverai l'elenco cronologico delle operazioni. Ciascun record è descrittivo ed espresso in lingua italiana, mostrando:

• Utente/Operatore: Il nome e ruolo del dipendente che ha effettuato l'azione.
• Azione Svolta: Badge colorati semantici (es. Verde per Creazioni, Giallo per Modifiche, Rosso per Eliminazioni).
• Dettagli: Tag chiave-valore chiari ed espansi (es. barcode, importi, o fatture collegate) invece di stringhe JSON grezze.

L'interoperabilità di NextCare garantisce la corretta comunicazione con il Sistema Sanitario Nazionale (SSN) e regionale.

1. Transcodifiche Codici Esami (CUR):

Per la rendicontazione dei flussi mensili (Flusso C/M) ed il FSE, ogni esame interno deve essere mappato sul relativo codice catalogo nazionale/regionale (CUR). Questa mappatura si effettua nella sezione Configurazioni ➔ Transcodifiche Codici.

2. Connessione FSE 2.0 & mTLS:

L'autenticazione con il gateway del Fascicolo Sanitario Elettronico richiede credenziali aziendali certificate. Configura i percorsi ai file di certificato client (.pem) e chiave privata (.key) per attivare la connessione sicura mTLS ed inviare i referti firmati digitalmente.

L'Edge Gateway locale di NextCare consente al Centro Medico di continuare a lavorare in accettazione anche in totale assenza di rete internet.

Funzionamento Offline/Online:

1. Durante il normale funzionamento, i dati clinici inseriti nel browser vengono memorizzati nella cache locale (LocalStorage) e inviati istantaneamente al database MySQL tramite API.
2. In caso di crash del server centrale o disconnessione della linea, il browser passa automaticamente in Modalità Offline. Tutti i dati rimangono registrati in sicurezza in LocalStorage.
3. Al ripristino della connettività, l'operatore accede a Database SQL ➔ Sincronizza. Il sistema allinea in background tutte le record locali con il server centrale in modo sicuro.

NextCare si appoggia ad un server relazionale MySQL (porta 3306) per la persistenza dei dati ed un servizio backend Python (server.py) per le API REST.

1. Configurazione del Database:

Durante il setup guidato iniziale o nel file di configurazione, inserisci le credenziali di accesso MySQL (IP, Porta, Username, Password e Nome Schema). NextCare popolerà il database creando le tabelle necessarie.

2. Esecuzione in Background come Servizio:

Per fare in modo che il server API Python non si interrompa quando viene chiusa la console di comando:

• Su Windows (con NSSM): Installa NSSM ed esegui `nssm install NextCareService` indicando il percorso di `python.exe` e passando `server.py` come argomento. Imposta l'avvio in modalità automatica.
• Su Linux (con Systemd): Crea il file `/etc/systemd/system/nextcare.service` impostando `ExecStart=/usr/bin/python3 server.py`, `WorkingDirectory` ed impostando `Restart=always`.