Guida all'uso di Guardiano EU
Istruzioni per l'utilizzo tramite Web App nel browser (Linux, macOS, Windows) e applicazione desktop Windows.
1. Installazione consigliata
Guardiano EU offre due modalità di utilizzo adatte a qualsiasi esigenza operativa:
Web App Online & Installazione PWA (Zero configurazione)
È la modalità più rapida e completa per lavorare su qualsiasi sistema operativo:
- Apri la pagina Guardiano EU Web App con qualsiasi browser moderno (Chrome, Safari, Firefox, Edge).
- Installazione come App (PWA): su Chrome/Edge clicca sull'icona Installa app nella barra degli indirizzi; su Safari iOS seleziona Condividi → Aggiungi a schermata Home; su Android seleziona Installa app dal menu del browser.
- Funzionamento Offline: grazie al Service Worker integrato, l'applicazione si avvia ed esegue l'autovalutazione anche in totale assenza di connessione internet.
- Storage Locale IndexedDB: risposte, documenti allegati e registro eventi vengono conservati nel database locale del browser.
Applicazione Desktop Windows (.ZIP portable)
Ideale per chi desidera archiviare report e documenti di prova in cartelle fisiche su file system locale:
- Scarica l'archivio ZIP dalla pagina Download o direttamente dalla scheda prodotto.
- Fai clic destro sul file scaricato e seleziona Estrai tutto in una cartella locale.
- Avvia
Guardiano EU.exe. L'applicazione non richiede diritti di amministratore né runtime esterni.
2. Primo avvio
All'avvio, l'interfaccia ti guida attraverso i requisiti dell'AI Act europeo per costruire il tuo Fascicolo Prove e Documentazione Tecnica:
Cosa include l'autovalutazione e cosa resta fuori
- Cosa coprono le 40 verifiche: applicabilità territoriale e materiale (Artt. 2-3), obbligo di alfabetizzazione (Art. 4), 9 pratiche vietate (Art. 5), classificazione dei sistemi ad alto rischio (Art. 6, Allegati I e III), 8 presidi di governance e supervisione (Artt. 9-20 e Art. 26), 9 obblighi di trasparenza (Art. 50 e Art. 111) e regole per modelli GPAI (Capo V).
- Cosa resta fuori: le valutazioni di conformità formali da parte di Organismi Notificati terzi (Art. 43), la registrazione nella banca dati europea dell'AI Office (Art. 71) e i pareri legali specifici. Lo strumento genera un report tecnico e fascicolo prove a uso interno.
Procedura passo per passo
- Selezione del Ruolo Organizzativo: scegli se la tua organizzazione agisce come Deployer / Utilizzatore professionale (integra e usa sistemi AI altrui nei propri processi), Fornitore / Provider (sviluppa o commercializza sistemi AI con proprio marchio) oppure seleziona la Valutazione Completa (40 verifiche).
- Autovalutazione su 40 Controlli: analizza ciascun quesito diviso per sezioni tematiche e riferimenti normativi precisi.
- Stato del Presidio: imposta per ogni articolo l'esito reale (In verifica, Conforme / Verificato, Gap da sanare, Non applicabile / Sì, No).
- Note Operative di Verifica: inserisci direttamente le azioni svolte (es. contratti con i fornitori, nomine di supervisione umana, esiti di vulnerability assessment).
- Allegato di Prova: clicca su 📎 Allega Prova sotto la domanda per associare documenti probatori (PDF, immagini, checklist). Il file viene salvato nel database locale IndexedDB.
- Calcolo Profilo di Rischio: lo stato iniziale parte da ⏳ Da valutare. Non appena compili le verifiche, l'indicatore aggiorna in tempo reale la classificazione (Rischio Minimo, Trasparenza Specifica Art. 50, Alto Rischio Art. 6 oppure VIETATO Art. 5) e il conteggio delle prove associate.
3. Comandi utili e funzionalità
Completamento del Questionario e Azioni di Fondo Pagina
Al termine delle 40 verifiche, in fondo alla schermata compare automaticamente il riquadro di completamento:
- Genera Report & Stampa PDF: passa alla schermata del report e scorre automaticamente in cima alla vista per la consultazione o la stampa.
- Esporta Fascicolo JSON: scarica immediatamente sul computer la copia di sicurezza dell'intero fascicolo con risposte, note e documenti allegati.
- Vedi Tavola Prove: apre la vista tabellare per il controllo di tutti i documenti archiviati.
Correzione Rapida dei Gap con il Pulsante "Modifica →"
All'interno della scheda Report & PDF, la sezione Presidi di Governance da Sanare / In Verifica elenca i punti non ancora conformi o privi di prove. Accanto a ciascuna voce è presente il pulsante Modifica →: cliccandolo, la Web App ritorna direttamente alla domanda specifica, la centra sullo schermo e la evidenzia con un impulso visivo per consentirti di correggere lo stato o allegare subito il documento di prova.
Gestione di più Sistemi AI e Uso di "Azzera verifiche"
- Per correggere il sistema attuale: non serve azzerare. Modifica direttamente le singole domande o usa i pulsanti Modifica → dal report.
- Per iniziare la valutazione di un nuovo sistema: prima esporta il file di backup del sistema precedente con Esporta Fascicolo JSON (es.
fascicolo-assistente-clienti.json), poi fai clic su Azzera verifiche per ripulire il questionario e riportarlo allo stato iniziale ⏳ Da valutare. - Per passare da un sistema all'altro: usa Ripristina Fascicolo per caricare in un secondo il file JSON del progetto su cui vuoi lavorare.
Tavola del Fascicolo Prove (Dossier Completo)
Dalla scheda Tavola Prove puoi:
- Consultare la matrice ordinata dei 40 requisiti con risposte, documenti collegati, stato di conformità e note operative.
- Aggiungere allegati generali (es. policy aziendali complessive, contratti quadro o nomine DPO).
- Scaricare o rimuovere i singoli documenti archiviati.
Generazione del Report di Autovalutazione con Tavola Prove
Dalla scheda Report & PDF puoi:
- Visualizzare il quadro sintetico con scadenze normative aggiornate e gap di controllo da completare.
- Consultare la tabella dettagliata di tutte le 40 verifiche con gli allegati probatori associati.
- Stampa o Salva PDF: genera un documento formattato ad alto contrasto pronto per la conservazione interna o la presentazione ad auditor e clienti.
Salvataggio, Backup e Ripristino Totale (Fascicolo JSON)
Per preservare l'intero fascicolo a lungo termine o trasferirlo su un altro computer:
- Conservazione su disco: i dati nel browser (IndexedDB) possono essere rimossi dal sistema operativo (es. Safari iOS dopo 7 giorni di inattività o durante la pulizia dei dati del browser).
- Fai clic su Esporta Fascicolo JSON per salvare un unico file contenente tutte le 40 verifiche, le note, i file allegati e l'audit trail.
- Fai clic su Ripristina Fascicolo per ricaricare istantaneamente il database locale.
Scadenze Normative Ufficiali (post-Regolamento UE 2026/1744)
- 2 febbraio 2025: Divieti assoluti (Art. 5) e obbligo di Alfabetizzazione AI (Art. 4).
- 2 agosto 2025: Regole per modelli di AI per finalità generali (GPAI - Capo V) e governance istituzionale.
- 2 agosto 2026: Obblighi generali di trasparenza e informativa per chatbot e IA generativa (Art. 50).
- 2 dicembre 2026: Marcatura machine-readable e rilevamento dei contenuti sintetici generati (Art. 50 comma 2, abbreviata a 3 mesi dal Reg. 2026/1744).
- 2 agosto 2027: Termine di adeguamento per i sistemi generativi immessi prima del 2 agosto 2026 (Art. 111(4) mod. Reg. 2026/1744).
- 2 dicembre 2027: Obblighi e presidi di governance per sistemi ad alto rischio autonomi dell'Allegato III (prorogati dal Reg. 2026/1744).
- 2 agosto 2028: Obblighi per sistemi ad alto rischio integrati come componenti di sicurezza in prodotti regolamentati dell'Allegato I (prorogati dal Reg. 2026/1744).
Problemi comuni
- Se le risposte non compaiono più nella Web App, importa il backup JSON precedentemente salvato.
- Se il PDF non si apre, abilita la stampa o il download dei file nel browser.
- Se la pagina non si aggiorna, ricaricala completamente svuotando la cache del browser.
4. GitHub per sviluppatori
Il codice sorgente dell'applicazione desktop è disponibile con licenza open source sul repository pubblico ufficiale:
Repository GitHub: https://github.com/MC-Project-Lab/guardiano-eu
Per compilare e testare localmente la versione desktop (richiede Rust e Tauri):
# Esegui i test automatici di validazione normativa
cargo test --manifest-path src-tauri\Cargo.toml
# Avvia l'applicazione in modalità sviluppo
cargo run --manifest-path src-tauri\Cargo.toml
5. Versione e licenza
Versione corrente: 1.00.02 (aggiornata a luglio 2026 con le modifiche del Regolamento UE 2026/1744).
Licenza: Open source con licenza MIT. Libero utilizzo sia per scopi personali che commerciali.
Aggiornamento e rimozione: per aggiornare la Web App ricarica la pagina. La versione Windows portable si aggiorna scaricando il nuovo archivio ZIP ed estraendolo in una nuova cartella. Per rimuoverla, chiudi l'applicazione ed elimina la cartella estratta.
Limitazione di responsabilità: Guardiano EU è uno strumento di supporto all'autovalutazione tecnica e organizzativa. Il report generato documenta i controlli effettuati e non costituisce una certificazione legale formale o un verdetto emesso da un'autorità di vigilanza.