App di valutazione dell'adesione ai modelli

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.

Funzionalità

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 del modello Scuole

Test	Descrizione
Criteri di conformità	Vengono mostrati i risultati degli audit relativi ai criteri di conformità del modello scuole.
Raccomandazioni progettuali	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.
Raccomandazione progettuale "R.SC.3.1 - Velocità e tempi di risposta"	Viene mostrato il risultato del test relativo alla raccomandazione progettuale "R.SC.3.1 - Velocità e tempi di risposta" per il sito scolastico.

Test del modello Comuni

Test	Descrizione
Pacchetto Cittadino Informato: criterio "C.SI.4.1 - Velocità e tempi di risposta"	Viene mostrato il risultato del test relativo al criterio "C.SI.4.1 - Velocità e tempi di risposta" per il sito comunale.
Pacchetto Cittadino Informato: criteri di conformità	Vengono mostrati i risultati degli audit relativi ai criteri di conformità per il sito comunale.
Pacchetto Cittadino Attivo: criteri di conformità	Vengono mostrati i risultati degli audit relativi ai criteri di conformità per i servizi digitali comunali.
Pacchetto Cittadino Informato: raccomandazioni progettuali	Vengono mostrati i risultati degli audit relativi alle raccomandazioni progettuali per il sito comunale.
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.

Report e messaggi in console

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:

...
https://esempio.scuola.edu.it/novita/ 200
https://esempio.scuola.edu.it/didattica/ 200
...

che indicano il risultato del caricamento della pagina in questione (200 = successo). Quest'informazione può essere usata per fare debug di un sito o dell'applicazione stessa.

Tecnologie

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

Requirements

PA Website Validator necessita Node.js v18+ (LTS), npm e Google Chrome.

Plugins

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

Installazione locale

Per l'installazione locale, una volta clonato il repository, eseguire:

cd pa-website-validator
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

Esempio:

node dist --type school --destination ~/pa-italia-crawler-reports --report myreport --website https://www.ismonnet.edu.it/ --scope online --view --accuracy all

Installazione globale

Una volta effettuata l’installazione globale sarà possibile usare il comando pa-website-validator dal terminale, senza dover entrare nella directory clonata. Questa è la procedura per installare il comando globalmente:

cd pa-website-validator
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