Piattaforma per gestione screening oncologici (cervice, mammo, colon retto).

Open source, sviluppata interamente da Marco Pingitore.

Codice sorgente disponibile gratuitamente per le ASL.

Nome: smartscreening

Data primo rilascio: 26/07/26

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:

1. 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).

2. 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.

3. Amministrativo (Administrative): Operatore di front-office per il contatto col pubblico. Gestisce anagrafiche, inviti e fissa le prenotazioni.

4. 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à.