Un applicativo desktop a supporto degli sviluppatori che aiuta a valutare la qualità dei siti istituzionali dei Comuni e delle scuole e la corrispondenza a molti dei criteri di conformità della misura 1.4.1 del PNRR Esperienza del cittadino nei servizi pubblici digitali.
Le App di valutazione sono strumenti che integrano la libreria Lighthouse ed effettuano test per la verifica della corretta adesione al modello Comuni e al modello scuole di Designers Italia.
Scopri di più sulle App di valutazione.
- Possibilità di lanciare l'auditing su un sito web online o in locale.
- Possibilità di utilizzare il pacchetto come dipendenza global eseguendolo come cli-application.
- Possibilità di integrare il pacchetto come dipendenza NPM in progetti terzi.
Test | Descrizione |
---|---|
Criteri di conformità per la misura 1.4.1 | Vengono mostrati i risultati degli audit relativi ai criteri di conformità del modello scuole. |
Raccomandazioni non abbligatorie | Vengono mostrati i risultati degli audit relativi alle raccomandazioni progettuali del modello scuole. |
Test aggiuntivi | Vengono mostrati i risultati di test standard forniti da lighthouse. Non sono rilevanti in termini di raggiungimento dei criteri di conformità, ma rappresentano comunque indicazioni utili a valutare eventuali miglioramenti del sito. |
Test | Descrizione |
---|---|
Conformità al modello di sito comunale - Cittadino informato | Vengono mostrati i risultati degli audit relativi ai criteri di conformità per il sito comunale. |
Raccomandazioni non abbligatorie | Vengono mostrati i risultati degli audit relativi alle raccomandazioni progettuali per il sito comunale |
Lighthouse | Vengono mostrati i risultati di test standard forniti da lighthouse. Non sono rilevanti in termini di raggiungimento dei criteri di conformità, ma rappresentano comunque indicazioni utili a valutare eventuali miglioramenti del sito. |
L'applicazione genera un report in stile Lighthouse del risultato della valutazione, che viene mostrato nel browser. Inoltre nella console dove è stato lanciato il comando vengono mostrati in tempo reale dei messaggi relativi agli audit che l'applicazione sta conducendo in quel momento, inclusi messaggi di errore; in particolare, per ogni pagina che viene caricata appariranno messaggi del tipo:
...
SCAN first-level https://esempio.scuola.edu.it/: Gathering start
SCAN first-level https://esempio.scuola.edu.it/: Gathering end
SCAN first-level https://esempio.scuola.edu.it/: Auditing start
SCAN first-level https://esempio.scuola.edu.it/: Auditing end
...
che indicano rispettivamente:
- SCAN => messa in scansione la pagina x
- first-level => tipo di pagina messa in scansione
- https://esempio.scuola.edu.it/ => url
- Gathering => raccolta informazioni pagina
- Audit => controlli sulla pagina per superare i criteri ad essa connessi
PA Website Validator utilizza le seguenti tecnologie
- Node.js - Javascript runtime
- npm - Gestore di pacchetti
- Lighthouse - Libreria principale estesa per l'esecuzione degli audit
- Typescript - Linguaggio di programmazione fortemente tipizzato che si basa su JavaScript
PA Website Validator necessita Node.js v18+ (LTS), npm e Google Chrome.
PA Website validator utilizza le seguenti dipendenze esterne principali
Plugin | Repository |
---|---|
Lighthouse | GitHub |
Yargs | GitHub |
Puppeteer | GitHub |
Cheerio | GitHub |
JSDOM | GitHub |
Geo Ip | GitHub |
Get SSL Certificate | GitHub |
Per l'installazione locale, una volta clonato il repository, eseguire:
cd DTD_Crawler
npm install
La directory dist
sarà popolata con l’output del processo di build.
Utilizzo:
node dist --type <type> --destination <folder> --report <report_name> --website <url> --scope <local|online> --view <true|false> --timeout <number> --number-of-service-pages <number> --concurrentPages <number>
Esempio:
node dist --type school --destination ~/pa-italia-crawler-reports --report myreport --website https://www.ismonnet.edu.it/ --scope online --view false --accuracy all concurrentPages 10
Una volta effettuata l’installazione globale sarà possibile usare il comando pa-website-validator-ng
dal terminale, senza dover entrare nella directory clonata. Questa è la procedura per installare il comando globalmente:
cd pa-website-validator-ng
npm install
npm install -g --install-links
NB: Potrebbe essere necessario riavviare la shell/terminale per la propagazione del comando e la pulizia della cache npm:
npm cache clean
Utilizzo:
pa-website-validator-ng --type <type> --destination <folder> --report <report_name> --website <url> --scope <local|online> --view <boolean> --timeout <number> --number-of-service-pages <number> --concurrentPages <number>
Esempio:
pa-website-validator-ng --type school --destination ~/pa-italia-crawler-reports --report myreport --website https://www.ismonnet.edu.it/ --scope online --view --accuracy all
Parametro Comando | Descrizione | Obbligatorio | Possibili valori | Default |
---|---|---|---|---|
- -help | Mostra la mappa comando | ❌ | ||
- -version | Versione del pacchetto | ❌ | ||
- -type | Tipologia di crawler da lanciare | ✅ | "municipality" "school" | |
- -destination | Folder dove salvare la reportistica | ✅ | ||
- -report | Nome da assegnare al report | ✅ | ||
- -website | Url sito web da analizzare | ✅ | ||
- -scope | Scope di esecuzione | ❌ | "local" "online" | "online" |
- -view | Visualizzazione istantanea report | ❌ | ||
- -accuracy | Definisce la morbosità della scansione | ✅ | "min", "suggested", "high", "all" | "suggested" |
- -concurrentPages | Definisce il numero di pagine in parallelo | ❌ | 20 | |
- -timeout | Definisce il timeout per dichiarare una pagina non raggiungibile | ❌ | 300000 | |
- -number-of-service-pages | Definisce il numero minimo di servizi da trovare | ❌ | 10 |
Note:
-
--type
indica quale tipologia di sito web viene passato da ispezionare (comunale o scolastico). -
--scope
indica la tipologia di audit da eseguire:local
se il tool è lanciato su un sito web in ambiente locale: esegue tutti gli audit che lavorano sulla struttura del sito ispezionato e mostra dei messaggi informativi per alcuni audit che non producono risultati se eseguiti in un ambiente locale.online
esegue tutti gli audit disponibili.
-
--view
se passato al comando alla fine dell'auditing lancia un'istanza di chrome che mostra automaticamente la reportistica generata. -
--accuracy
indica la precisione della scansione, definita come il numero di pagina analizzate:all
la scansione è effettuata su tutte le pagine disponibili.
-
--timeout
timeout utilizzato per dichiarare la pagina non raggiungibile -
--concurrentPages
numero massimo di pagine di Puppeteer aperte in parallelo -
--number-of-service-pages
numero minimo di pagine di servizio da trovare, per dichiarare superato il check sui servizi