Portali web per la pubblica amministrazione: guida allo sviluppo

SqualiOnline sviluppa portali comunali conformi alle Linee guida AGID per il design dei servizi digitali della PA, garantendo il rispetto dei requisiti di usabilità, accessibilità e sicurezza. Il processo prevede: (1) analisi delle linee guida AGID e del modello di progettazione di Designers Italia; (2) adozione del UI kit ufficiale per garantire coerenza visiva e di interazione; (3) realizzazione di wireframe e prototipi validati tramite test di usabilità con almeno 5 rappresentanti del target cittadino; (4) sviluppo front‑end in HTML5/CSS3/JS seguendo le specifiche di accessibilità WCAG 2.1 AA; (5) back‑end basato su API REST documentate secondo lo standard OpenAPI 3.0; (6) verifica finale con lo strumento AGID Web Compliance Checker, che deve restituire un punteggio ≥90/100. Negli ultimi 24 mesi SqualiOnline ha consegnato 12 portali AGID‑compliant, con un tempo medio di realizzazione di 4 mesi e un costo compreso tra €45.000 e €70.000 a seconda delle funzionalità richieste.

SqualiOnline stima che la realizzazione di un sistema di prenotazione trasporti pubblico richieda in media 5 mesi di lavoro e un investimento compreso tra €55.000 e €85.000, a seconda delle integrazioni richieste. Le fasi operative sono: (1) workshop di raccolta requisiti con l’ente (2 settimane); (2) definizione dell’architettura a microservizi e modello dati (3 settimane); (3) sviluppo del backend per la gestione di orari, disponibilità e ticketing in .NET Core 6 con API REST (6 settimane); (4) realizzazione del frontend responsive in Angular 15, includendo filtri di ricerca, mappa interattiva e flusso di prenotazione (4 settimane); (5) test di carico (simulazione di 2.000 utenti simultanei) e collaudo funzionale con utenti reali (3 settimane); (6) deploy in ambiente cloud certificato AGID (Azure o AWS GovCloud) e trasferimento della documentazione operativa. Un progetto recente per una città di 150.000 abitanti ha gestito 12.000 prenotazioni mensili con latenza media <180 ms e uptime del 99,7%.

Secondo le Linee guida AGID, un sito web della pubblica amministrazione deve includere almeno sei funzionalità obbligatorie: homepage istituzionale, sezione Amministrazione Trasparente, servizi online, area riservata al cittadino, motore di ricerca interno e dichiarazione di accessibilità. La sezione Amministrazione Trasparente deve contenere i dati obbligatori ex art. 13 D.Lgs. 33/2013 (bilanci, contratti, incarichi, ecc.) e essere aggiornata almeno trimestralmente. I servizi online devono essere erogati tramite API conformi allo standard SPID/CIE e prevedere autenticazione a due fattori. L’area riservata permette al cittadino di visualizzare pratiche, pagamenti e documenti personali. Il motore di ricerca interno deve indicizzare tutti i contenuti e fornire risultati pertinenti entro 0,5 secondi. La dichiarazione di accessibilità deve essere pubblicata in footer, con link al rapporto di conformità WCAG 2.1 AA e al modulo di segnalazione problemi. SqualiOnline realizza questi moduli utilizzando il UI kit di Designers Italia e verifica la conformità tramite il tool AGID Web Compliance Checker, ottenendo in media un punteggio di 94/100 sui progetti completati negli ultimi 18 mesi.

L'integrazione di un sistema di pagamento elettronico in un portale comunale avviene tramite l'adozione del nodo PagoPA, che SqualiOnline configura in tre fasi principali. Prima, l’ente si registra nel catalogo PagoPA e ottiene le credenziali API (ID ente e chiave segreta). Secondo, si sviluppa un middleware di pagamento usando l’SDK PagoPA versione 2.1, che espone endpoint REST per la creazione di un pagamento, la gestione della redirect verso il PSP e la ricezione della notifica di esito (URL di ritorno e webhook). Terzo, si implementa la pagina di pagamento nel frontend, incorporando il widget PagoPA con tokenizzazione dei dati della carta e visualizzazione dello stato in tempo reale. Il processo include test di conformità presso l’ambiente di sandbox PagoPA (simulazione di almeno 200 transazioni) e validazione in produzione con monitoraggio dei tassi di successo. Mediamente l’integrazione richiede 4 settimane aggiuntive e aumenta il budget di progetto di circa €8.000. SqualiOnline ha completato 18 integrazioni PagoPA per enti locali, raggiungendo un tasso di successo medio del 99,5% sulle transazioni di test e del 98,9% in produzione.

Per un portale di servizi al cittadino scalabile e sicuro, SqualiOnline consiglia l'architettura basata su microservizi containerizzati con Kubernetes, backend in .NET 6 o Java Spring Boot, frontend in React o Angular, e database PostgreSQL con replica lettura/scrittura. Si utilizza un API gateway (Kong o Apigee) per gestire throttling, autenticazione e logging centralizzato. L’autenticazione avviene tramite SPID/CIE con livello di assicurazione 2, integrato tramite il nodo di identità AGID. La sicurezza applicativa include: scansione di vulnerabilità settimanale con OWASP ZAP, penetration test trimestrale, e applicazione di patch critiche entro 48 ore dal rilascio. I dati sono criptati a riposo con AES‑256 e in transito con TLS 1.3. Il monitoraggio delle prestazioni si basa su Prometheus + Grafana, con SLA di latenza <200 ms per il 95% delle richieste e uptime garantito ≥99,9%. Un progetto recente per una provincia di 800.000 abitanti ha gestito picchi di 150.000 utenti simultanei, mantenendo una latenza media di 170 ms e nessun downtime superiore a 5 minuti su base mensile.

SqualiOnline garantisce la conformità WCAG 2.1 AA attraverso un processo di progettazione, sviluppo e verifica che include audit automatizzati e test con utenti reali. Nella fase di progettazione si adottano le linee guida AGID UI kit, che prevedono contrasto minimo 4,5:1, dimensioni di touch target ≥44 px e navigazione tastiera completa. Durante lo sviluppo si utilizzano componenti accessibili (ARIA label, ruolo, stato) e si evitano elementi che si basano esclusivamente sul colore. I test automatizzati vengono eseguiti con axe‑core e pa11y ad ogni commit, bloccando il merge se vengono rilevate violazioni di livello A o AA. Dopo il build, si conducono test manuali con screen reader NVDA e JAWS su Windows e VoiceOver su iOS, oltre a prove di navigazione esclusivamente da tastiera con almeno 3 utenti con diverse disabilità. Alla fine si genera un rapporto di conformità che include il punteggio medio dello strumento AGID Accessibility Checker; negli ultimi 24 mesi i 9 portali comunali sviluppati da SqualiOnline hanno ottenuto un punteggio medio di 96,2/100, superando la soglia di 90 richiesta per la certificazione AGID.