Scheda Tecnica: Sistema di Gestione Screening Oncologici

1. Descrizione Generale

L’applicazione è una piattaforma web gestionale completa (Single Page Application) progettata specificamente per l’organizzazione, il monitoraggio e la somministrazione delle campagne di Screening Oncologico (Mammella, Cervice Uterina, Colon Retto). Il sistema digitalizza l’intero flusso: dall’invito e anagrafica del paziente, alla prenotazione dell’appuntamento (Agenda), fino alla refertazione, l’analisi statistica e il monitoraggio dei Livelli Essenziali di Assistenza (LEA).

2. Architettura e Stack Tecnologico

Linguaggio principale: TypeScript.
Frontend: React 18 (framework UI) configurato con Vite per la compilazione rapida.
Stile e Design: Tailwind CSS (utility-first CSS) con un approccio “responsive” per un’ottima fruibilità sia su desktop (cliniche/uffici) che mobile (portale paziente).
Backend e Database (BaaS):
- Google Firebase Firestore: Database documentale NoSQL, garantisce persistenza robusta in cloud, sincronizzazione in tempo reale e query efficienti.
- Firebase Authentication: Gestione sicura dell’identità degli utenti, login e sessioni.
Librerie principali: react-big-calendar (per la gestione complessa dell’agenda visiva), date-fns (manipolazione avanzata delle date e fusi orari).

3. Gestione Ruoli (RBAC – Role-Based Access Control)

Il sistema implementa un controllo degli accessi granulare basato su 4 livelli di utenza:

Amministratore (Admin): Ha accesso globale al sistema. Può gestire gli operatori, le strutture, configurare le agende, visualizzare tutti i dati e le analisi statistiche (LEA).
Medico (Doctor): Accesso ristretto alle proprie Strutture/Reparti assegnati e al proprio Tipo di Screening. Vede solo l’agenda di sua competenza e i relativi pazienti.
Amministrativo (Administrative): Operatore di front-office per il contatto col pubblico. Gestisce anagrafiche, inviti e fissa le prenotazioni.
Paziente (Patient): Utente finale che accede a un’interfaccia dedicata (Portale Paziente) per visualizzare i propri appuntamenti, le notifiche e gli esiti degli esami.

4. Modulo Dati (Entità Principali)

Pazienti (Patient): Anagrafica completa (Nome, Cognome, Codice Fiscale, Data di nascita, Sesso, Contatti).
Screening (Screening): Traccia il ciclo di vita dell’esame preventivo.
- Tipologie: Mammella, Cervice, Colon Retto.
- Stati: Invitato (invited), Prenotato (booked), Completato (completed), Positivo (positive), Negativo (negative).
Appuntamenti ed Agenda (Appointment & Agenda_Slots): Gestisce gli incastri temporali. Ogni appuntamento fa riferimento ad uno slot pre-configurato.
Strutture (Department): Anagrafica delle sedi in cui vengono erogati gli screening.

5. Funzionalità Core del Sistema

🗓️ Gestione Agenda e Prenotazioni

Visualizzazione Calendario Avanzata: Interfaccia stile “Google Calendar” con viste Mese, Settimana e Giorno.
Filtri Rapidi: Possibilità di saltare rapidamente ad una data specifica tramite input nativo e filtrare l’agenda in base alla branca di screening.
Feedback Visivo (Color-Coding): Gli eventi in calendario modificano automaticamente il proprio colore in base allo “stato” dell’appuntamento (es: Verde = Eseguito, Rosso = Annullato, Grigio = Non Presentato, Ambra = Rimandato, Colori specifici per branca = Programmato).
Generazione Slot (AgendaConfig): Strumento per l’amministratore che permette di generare massivamente blocchi di disponibilità (slot liberi) per le varie strutture sanitarie in base a durate specifiche.

👤 Gestione Anagrafica e Clinica

Pazienti: Cruscotto per la registrazione, ricerca e modifica dei dati anagrafici dei pazienti. Visualizzazione dello storico di tutti gli screening di un singolo individuo.
Operatori (Staff): Inserimento del personale e associazione rigida medico ↔ struttura ↔ tipologia di screening per garantire il principio del minimo privilegio sui dati trattati.

📊 Cruscotti e Business Intelligence

Dashboard Operativa: Riepiloghi istantanei sul carico di lavoro odierno, gli appuntamenti imminenti e le attività recenti.
Statistiche LEA (Livelli Essenziali di Assistenza): Modulo dedicato al calcolo e monitoraggio degli indicatori di performance ministeriali (es. tasso di adesione agli inviti, percentuale di copertura della popolazione target).
Analisi Avanzata: Strumenti di data-visualization (grafici) per estrarre insight sui flussi di lavoro, picchi di prenotazione ed esiti (positivi/negativi) per facilitare il governo clinico.

💬 Interazione e Sicurezza

Portale Paziente: Spazio dedicato al cittadino, con notifiche integrate (simulazione di invio comunicazioni come email/SMS) per ricordare gli appuntamenti.
Audit Logging (Logs): Tracciamento automatico (“Chi ha fatto cosa e quando”) di ogni operazione critica a sistema (creazione appuntamenti, modifiche agli esiti, ecc.), garantendo conformità, sicurezza e responsabilità.