italia / validator-handler

Handler per il validatore di comuni e scuole

PA Website Validator Handler

Gestore del validatore della pubblica amministrazione

PA Website validator handler è un tool che gestisce le scansioni effettuate da PA Website Validator.

Funzionalità

• Creazione e gestione di code di PA da scansionare.
• Integra Pa Website Validator per eseguire scansioni programmate e salvarne i risultati.
• Espone API.
• Si integra con la piattaforma PA2026

Tecnologie

PA Website Validator handler utilizza le seguenti tecnologie

• Node.js - Javascript runtime
• npm - Gestore di pacchetti
• Typescript - Linguaggio di programmazione fortemente tipizzato che si basa su JavaScript
• PostgreSQL - Sistema database relazionale a oggetti
• Redis - Archivio dati in memoria e di tipo chiave-valore
• Swagger - Libreria per documentazione API

Requirements

PA Website Validator necessita Node.js v18+ (LTS), npm, PostgreSQL e Redis.

Plugins

PA Website validator handler utilizza le seguenti dipendenze esterne principali

Plugin	Repository
Yargs	GitHub
Sequelize	Sequelize
BullMQ	BullMQ
Express	Express
Swagger-ui-express	GitHub
Swagger-jsondoc	GitHub
Redis	Redis
PA Website Validator	GitHub

Utilizzo

Comando di build:

npm run build

Comando di creazione coda:

npm run dist-queue-manager --maxItems <number> --passedOlderThanDays <number> --failedOlderThanDays <number> --asservationOlderThanDays <number> --manualScanLogic <boolean>

Mappa opzioni comando

Parametro Comando	Descrizione	Obbligatorio	Default
- -maxItems	Numero massimo di PA da accodare	❌	100
- -passedOlderThanDays	Giorni dopo i quali le entity con Job che ha fornito risultato PASSED vengono riaccodate per essere scansionate	❌	28
- -failedOlderThanDays	Giorni dopo i quali le entity con Job che ha fornito risultato FAILED vengono riaccodate per essere scansionate	❌	14
- -asservationOlderThanDays	Giorni dopo i quali le entity asseverate vengono riaccodate per essere scansionate	❌	28
- -manualScanLogic	Flag per permettere solo alle entity flaggate come 'da scansionare' su PA2026 di entrare in coda di scansione	❌	false

Comando di prelievo Job da coda e start scansione:

npm run dist-scan-manager

Comando di esecuzione flusso integrazione PA2026:

npm run dist-PA2026-manager

Comando di start webserver:

npm run dist-webserver

API DOC

Per visualizzare la documentazione API avviare il webserver e andare sulla rotta: /docs