APP Diia Ucraina
APP Diia Ucraina
Come il governo ucraino ha costruito il portafoglio digitale dei cittadini: architettura, tecnologie e codice open source
Indice dei contenuti APP Diia Ucraina
- Che cos’è l’app Diia?
- A cosa serve: funzionalità principali
- Architettura del sistema
- Stack tecnologico: analisi dei repository GitHub
- Esempi pratici di codice
- Diia.AI: l’intelligenza artificiale al servizio del cittadino
- Best practice: pro e contro di Diia
- Cosa possiamo imparare da Diia per i nostri progetti
- Conclusioni e formazione
1. Che cos’è l’APP Diia Ucraina?
Se lavori nello sviluppo software da qualche anno, probabilmente hai già sentito parlare di e-government o di identità digitale. Ma nessun paese al mondo è riuscito a portare questi concetti a una scala così ampia e con risultati così misurabili come l’Ucraina con la sua app Diia.
Diia, acronimo di «Держава і Я» (Derzhava i Ya), ovvero «Stato e Io», è un’applicazione mobile e un portale web lanciati ufficialmente il 6 febbraio 2020 dal Ministero della Trasformazione Digitale ucraino. L’obiettivo dichiarato era ambizioso: rendere ogni ucraino in grado di interagire con lo Stato con pochi tap sullo smartphone, eliminando code, burocrazia cartacea e intermediari inutili.
I numeri, aggiornati al 2025, parlano chiaro: oltre 21,7 milioni di utenti attivi, più di 130 servizi pubblici disponibili in app, e documenti digitali che hanno piena validità legale, esattamente come i corrispettivi cartacei. L’Ucraina è stata la prima nazione al mondo a introdurre passaporti digitali giuridicamente equivalenti a quelli fisici.
Diia ha ricevuto il riconoscimento TIME Best Inventions 2024 e, nel 2025, l’assistente AI integrato Diia.AI è stato premiato come miglior soluzione GovTech europea alla conferenza SEMIC.
Il codice sorgente è stato reso pubblico nel marzo 2024 sotto licenza EUPL-1.2 (European Union Public Licence), rendendola uno dei rari esempi di governo open source a scala nazionale. Al momento della pubblicazione erano disponibili oltre 46 repository su GitHub, coperti da attività di commit documentate fino ad aprile 2026.
2. A cosa serve: funzionalità principali
Diia non è semplicemente un’app per mostrare documenti digitali. È un ecosistema che copre l’intera relazione fra cittadino e Stato. Ecco le macro-aree funzionali:
Documenti digitali
L’app ospita nella stessa interfaccia una serie di documenti ufficiali con validità legale piena:
- Carta d’identità (prima al mondo ad avere valore legale in formato digitale)
- Patente di guida (valida durante i controlli stradali)
- Passaporto biometrico (valido per i viaggi sul territorio ucraino)
- Certificato di nascita del figlio
- Codice fiscale, libretto studente, certificato di assicurazione veicolo
- Certificato IDP (persone sfollate per effetto della guerra)
Servizi pubblici
Attraverso l’app è possibile, tra le altre cose:
- Registrare o cambiare la residenza
- Rinnovare la patente di guida
- Pagare multe e tasse (anche tramite QR code)
- Registrare un’impresa individuale in pochi minuti
- Richiedere certificati penali e di stato civile
- Segnalare danni alla proprietà causati dalla guerra (programma eVidnovlennia)
- Acquistare titoli di guerra (war bonds) e donare a sostegno delle forze armate
Condivisione sicura dei documenti
Tramite Diia.QR e la funzione di share firmato con CEP (firma elettronica qualificata), l’utente può inviare copie digitali dei propri documenti (validate crittograficamente) a enti terzi. Più di 2 milioni di condivisioni documentali effettuate.
3. Architettura del sistema – APP Diia Ucraina
Dal punto di vista architetturale, Diia segue un modello a microservizi distribuiti, progettato per essere resiliente, scalabile e, come è risultato cruciale durante la guerra, delocalizzabile rapidamente. Quando la Russia ha invaso l’Ucraina nel 2022, l’intero backend è stato migrato su datacenter esteri in poche ore, senza interruzioni di servizio percepibili dagli utenti.
Livelli dell’architettura
L’ecosistema Diia si articola su quattro livelli principali:
- Client Layer: app native per Android (Kotlin) e iOS (Swift), con architettura modulare a feature-module.
- Gateway Layer: be-gateway-service gestisce il routing delle richieste, l’autenticazione JWT/OAuth2 e il rate limiting.
- Service Layer: ogni dominio funzionale (utenti, documenti, autenticazione, notifiche, pagamenti) è un microservizio autonomo scritto in TypeScript su Node.js.
- Data Layer: MongoDB come database principale, Redis per caching e sessioni, RabbitMQ per la comunicazione asincrona tra servizi tramite message queue.
La scelta di microservizi indipendenti non è solo architetturale: consente a qualunque paese o ente che adotta il codice open source di includere solo i moduli necessari, senza portare l’intera piattaforma.
Pattern di comunicazione
I servizi comunicano in modo sincrono via HTTP REST attraverso il gateway, oppure in modo asincrono tramite il sistema di code be-diia-queue (basato su RabbitMQ). Il repository be-diia-logger implementa il logging strutturato centralizzato, mentre be-diia-metrics raccoglie le metriche in formato Prometheus-compatibile.
4. Stack tecnologico: analisi dei repository GitHub
Analizzando l’organizzazione https://github.com/diia-open-source emerge un quadro tecnologico molto preciso:
Frontend mobile
- Android: Kotlin (99,8% del codice), con architettura multi-modulo Gradle. Ogni feature è un modulo Gradle indipendente (auth_bankid, biometric, documents, payment, scanner, notifications…).
- iOS: Swift, struttura analoga per separazione delle responsabilità.
- Build system Android: Gradle con Kotlin DSL (build.gradle.kts), supporto Huawei (HMS/Huawei App Gallery) oltre al classico Google Play.
Backend
- Linguaggio: TypeScript su Node.js — 100% dei repository backend usa TypeScript.
- Licenza: EUPL-1.2 su tutti i pacchetti.
- Pacchetti @diia-inhouse: framework modulare interno, distribuito come scope npm privato.
- Database: MongoDB (@diia-inhouse/db), Redis (be-pkg-redis).
- Messaggistica: be-diia-queue (RabbitMQ wrapper).
- HTTP: be-pkg-http, be-pkg-healthcheck per health check dei servizi.
- Scaffolding: be-scaffold in Raku (linguaggio Perl 6) — usato per generare nuovi microservizi.
Servizi principali
- be-auth-service: gestione autenticazione, token JWT, integrazione BankID.
- be-user-service: gestione del profilo utente, consensi, dati personali.
- be-gateway-service: API gateway, routing, middleware.
- be-diia-app: bootstrap dell’intera applicazione backend con dependency injection.
5. Esempi pratici di codice
Vediamo qualche estratto rappresentativo dei pattern utilizzati nel progetto.
Esempio 1: Build Android con Gradle (Kotlin DSL)
Nel file build.gradle.kts del modulo opensource, i flavors Gplay e Huawei vengono dichiarati così:
// build.gradle.kts — strategie di flavor per mercati diversi
android {
flavorDimensions += "store"
productFlavors {
create("gplay") { dimension = "store" }
create("huawei") { dimension = "store" }
}
}
Per compilare e installare su device Android (Google Play variant):
./gradlew :opensource:installGplayDebug
Esempio 2: Clonare tutti i repository con GitHub CLI
Come suggerito nella community, per esplorare l’intera codebase in locale:
gh auth login
mkdir -p ~/workspaces/diia && cd ~/workspaces/diia
gh repo list diia-open-source --limit 100 \
| cut -f1 \
| xargs -n 1 -P 5 gh repo clone
Esempio 3: Pattern TypeScript per un microservizio backend
Il bootstrap di un servizio Diia segue un pattern consistente basato su dependency injection:
// be-diia-app — pattern di avvio del servizio
import { bootstrap } from '@diia-inhouse/diia-app'
import { Application } from './application'
async function start(): Promise<void> {
const app = new Application()
await bootstrap(app) // Avvia DI container + HTTP server + queue listeners
}
start().catch(console.error)
Ogni servizio esporta la propria interfaccia tramite TypeScript types centralizzati nel pacchetto be-types, garantendo contratti forti tra microservizi senza accoppiamento diretto.
6. Diia.AI: l’intelligenza artificiale al servizio del cittadino
A settembre 2025, l’Ucraina ha fatto un ulteriore salto evolutivo lanciando Diia.AI — il primo assistente AI nazionale per servizi governativi al mondo, realizzato in collaborazione con la società IT Kitsoft e basato su Google Gemini.
Il funzionamento è semplice ma potente: l’utente scrive in chat cosa ha bisogno («voglio un certificato di reddito»), l’assistente analizza la richiesta, crea automaticamente la domanda nel sistema Diia, recupera i dati dai registri in tempo reale e consegna il documento nella casella digitale dell’utente — tutto senza compilare moduli o navigare tra pagine.
Dal punto di vista della privacy, l’AI assistant non ha accesso diretto ai dati personali. All’LLM vengono inviate solo richieste anonimizzate, senza nomi, indirizzi, numeri di documento o altri identificatori.
Sul piano tecnico, Diia.AI richiede un’infrastruttura capace di: recupero dati in real-time dai registri statali, generazione documenti on-the-fly, architettura Liquio standardizzata per rendere i servizi leggibili da sistemi AI, e integrazione con un LLM via API in modalità agentica.
Diia.AI ha vinto il Best Cases Awards 2025 alla conferenza SEMIC come miglior soluzione per i cittadini europei, ed è stata ufficialmente riconosciuta come primo assistente AI nazionale della storia.
7. Best practice: pro e contro di Diia
Pro
- Architettura microservizi reale e ben strutturata: ogni servizio ha responsabilità chiara, può essere deployato indipendentemente e testato in isolamento.
- Open source con licenza EUPL-1.2: il codice è ispezionabile, adattabile (con le dovute restrizioni) e già adottato come riferimento da altri paesi.
- Modularità Android/iOS: la struttura multi-modulo facilita il lavoro in team numerosi — ogni squad possiede il suo modulo feature.
- Resilienza dimostrata sul campo: la migrazione rapida del backend durante il conflitto bellico è una prova concreta di disaster recovery planning.
- TypeScript end-to-end sul backend: type safety forte, migliore manutenibilità, tooling eccellente (ESLint, Jest, OpenAPI generation).
- CI/CD via GitHub Actions: pipeline di test e build automatizzate anche sui PR pubblici.
- Privacy-by-design nell’AI integration: pattern corretto di anonimizzazione prima dell’invio al modello linguistico.
Contro
- I repository pubblici sono snapshot, non mirror live del codebase interno: le versioni su GitHub possono essere in ritardo rispetto alla produzione reale.
- Dipendenze @diia-inhouse non pubblicate su npm: per eseguire il backend in locale è necessario un processo di link manuale dei pacchetti, aumentando la complessità di onboarding.
- Mancanza di documentazione architetturale centralizzata: chi vuole capire il sistema completo deve navigare tra 46+ repository.
- Nessun framework cross-platform (Flutter/MAUI): la scelta di mantenere due codebase native (Kotlin + Swift) implica un effort di sviluppo e manutenzione doppio rispetto a soluzioni cross-platform.
- Rischi di sicurezza strutturali: il progetto ha avuto in passato episodi di data breach (2020) e la gestione della protezione dei dati rimane una sfida complessa in un contesto di guerra informatica.
8. Cosa possiamo imparare dall’ APP Diia Ucraina per i nostri progetti
Anche se non stai costruendo un sistema di e-government, il codice e le scelte architetturali di Diia offrono spunti preziosi:
- Separazione delle responsabilità: ogni feature come modulo autonomo è un pattern applicabile a qualsiasi app mobile complessa.
- TypeScript come lingua franca del backend: riduce i bug a runtime, migliora la collaborazione tra team, genera automaticamente documentazione API.
- Multi-flavor build: gestire varianti per store diversi (Google Play, Huawei, F-Droid) con un singolo codebase è una tecnica applicabile anche in contesti enterprise.
- Pensare alla resilienza dall’inizio: la capacità di migrare in poche ore dimostra quanto valga investire in infrastruttura cloud-native e in architetture stateless.
- AI integration responsabile: il pattern di anonimizzazione pre-LLM è un riferimento pratico per chiunque voglia integrare AI in applicazioni che trattano dati sensibili.
9. Conclusioni e formazione continua
Il caso Diia dimostra in modo inequivocabile che il software di qualità può cambiare la vita delle persone, ridurre la burocrazia e persino sostenere una nazione sotto attacco. Ma dimostra anche quanto velocemente il mercato tecnologico si evolva: dall’app mobile nativa al portale web, dai microservizi TypeScript all’AI generativa integrata direttamente nei flussi burocratici, tutto in meno di sei anni.
Il mercato del software è in continua evoluzione e questa accelerazione non accenna a fermarsi. L’unico modo reale per mantenere il proprio team allineato alle tecnologie più richieste è investire in formazione continua e strutturata. Non è più sufficiente fare esperienza sul campo: i developer che rimangono competitivi sono quelli che studiano le architetture dei progetti più innovativi al mondo, come Diia, e acquisiscono le competenze su strumenti cross-platform moderni.
Se l’architettura di Diia ti ha incuriosito ed in azienda volete sviluppare app mobile di qualità professionale, Innovaformazione ha i corsi giusti per te:
Corso Flutter — sviluppo mobile cross-platform
Flutter di Google è oggi lo standard de facto per chi vuole sviluppare app iOS e Android da un’unica codebase in Dart, con performance native e un design system coerente. Il Corso Flutter di InnovaFormazione è pensato per sviluppatori che vogliono padroneggiare questo framework dalla A alla Z, con esercitazioni pratiche su progetti reali.
Corso MAUI .NET — sviluppo cross-platform con Microsoft
Se il tuo team lavora nell’ecosistema Microsoft e preferisce C#, .NET MAUI è la risposta moderna a Xamarin per lo sviluppo di app mobile e desktop da un’unica codebase. Il Corso MAUI .NET di InnovaFormazione ti guida nello sviluppo cross-platform con strumenti enterprise-grade.
Formazione finanziata con Fondimpresa
Se sei un’azienda con dipendenti, sappi che è possibile accedere ai fondi Fondimpresa per finanziare la formazione tecnica del tuo team a costo zero o ridotto. InnovaFormazione supporta le aziende nell’iter di richiesta del contributo: dalla progettazione del piano formativo all’erogazione del corso, inclusa tutta la documentazione necessaria per l’accesso ai fondi interprofessionali.
Richiedi informazioni e preventivo
Vuoi approfondire i temi di questo articolo? Hai bisogno di un piano formativo personalizzato per il tuo team su Flutter, MAUI, sviluppo mobile o AI generativa? Contattaci senza impegno:
Email: info@innovaformazione.net
Tel: 347 101 2275 — Dario Carrassi
Sito web: innovaformazione.net
Per altri articoli tecnici consigliamo di navigare sul nostro blog QUI.
Articoli correlati
Claude Code con Arduino
Novità .Net 11
Backdoor nei modelli AI open-weight
Opportunità di lavoro Bari
Spieghiamo il Weight space programming
