APP Diia Ucraina

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

  1. Che cos’è l’app Diia?
  2. A cosa serve: funzionalità principali
  3. Architettura del sistema
  4. Stack tecnologico: analisi dei repository GitHub
  5. Esempi pratici di codice
  6. Diia.AI: l’intelligenza artificiale al servizio del cittadino
  7. Best practice: pro e contro di Diia
  8. Cosa possiamo imparare da Diia per i nostri progetti
  9. 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.

(fonte) (fonte) (fonte) (fonte) (fonte)

Ti potrebbe interessare

Articoli correlati