Initial commit

attached_assets/Pasted-Visione-rapida-Perch-diverso-turni-24-7-reperibilit-ronde-presidi-fissi-controllo-titoli-po-1760173868664_1760173868668.txt

@@ -0,0 +1,78 @@
+Visione rapida
+
+Perché diverso: turni 24/7, reperibilità, ronde, presidi fissi, controllo titoli (porto d’armi, certificazioni), geofencing dei siti, timbratura mobile, consegna e tracciamento dotazioni, reportistica verso i clienti.
+
+Core tech: Web (Next.js/React) + API (NestJS/FastAPI) + Postgres + Redis; app mobile (Flutter/React Native); engine di ottimizzazione turni (CP-SAT/ILP); code-signing e audit completo.
+
+Compliance by design: GDPR, audit trail, ruoli granulari, data retention configurabile, crittografia at-rest/in-transit. (Regole contrattuali/CCNL configurabili, non hard-codate.)
+
+Moduli funzionali
+1) Anagrafiche & abilitazioni
+
+Profili guardie (foto, matricola, ruoli), scadenze porto d’armi, certificazioni, visite mediche, corsi.
+
+Skill-matrix (armato, antincendio, primo soccorso, automunito, lingua).
+
+Dotazioni: arma, giubbotto, bodycam, radio, automezzo (con consegna/resa e stato).
+
+2) Gestione siti/commesse
+
+Siti con finestre orarie, SLA e regole (minimo n° guardie, profili richiesti, armato/non armato).
+
+Tipologie: presidio fisso, pattugliamento/ronde, ispettorato notturno, pronto intervento.
+
+KPI e penali configurabili.
+
+3) Pianificazione turni (rota)
+
+Calendario 24/7 (giornaliero/settimanale/mensile).
+
+Motore vincoli: orari massimi giornalieri/settimanali, riposi minimi, alternanza notte/giorno, limiti straordinari, pause, incompatibilità e vincoli per sito.
+
+Preferenze operatore, ferie/malattie, reperibilità.
+
+Simulazioni “what-if” e saldo ore.
+
+4) App Guardia (iOS/Android)
+
+Timbratura geolocalizzata (GPS + geofencing; opzionale NFC/QR sul sito).
+
+Ricezione turni/missioni, navigazione al sito, checklist digitali (apertura/chiusura).
+
+Panic button, incident reporting (foto/audio), note di servizio, verbalizzazione.
+
+Stato dotazioni e check pre-servizio (es. arma, bodycam).
+
+Lavoro offline-first, sync appena c’è rete.
+
+5) Sala Operativa (Control Room)
+
+Cruscotto live: presenze in servizio, ritardi, SOS, SLA in scadenza.
+
+Ronde: percorso pianificato, tap-point (NFC/QR), ritmi e deviazioni.
+
+Ticket eventi/incidenti collegati a turni/siti, escalation e report finale.
+
+6) Portale Clienti
+
+Calendario presidi per sito, rapporti e Report di ronda (timbrature, percorso, foto).
+
+KPI/SLA, verbali, fatturato per commessa (ore previste/erogate).
+
+Segnalazioni e richieste straordinarie.
+
+7) Amministrazione & Payroll
+
+Timesheet consolidati, straordinari, indennità (notturno/festivo/armato/trasferte).
+
+Esport paghe (CSV/JSON/Excel) verso Zucchetti/Teamsystem/… (mappatura personalizzabile).
+
+Fatturazione per commessa (ore, forfait, canoni), estratti per cliente.
+
+8) Compliance & Sicurezza
+
+Audit trail completo, firme elettroniche interne per verbali.
+
+Gestione privacy (consensi, informative app, minimizzazione dati geolocalizzazione).
+
+Ruoli/permessi granulari (Sicurezza, Sala Operativa, Pianificatore, HR, Cliente, Guardia).