# Una coda che si può vedere prima di mettersi in fila

> Piattaforma per prenotare appuntamenti in Questura e preparare i documenti, con verifica assistita dall'AI che resta consultiva: a decidere è sempre una persona.

**Enneci Agency** — Tenuta del Barone di Montemurlo di Nicolò Coppi. Via Piemonte 4/40, 59100 Prato (PO), Italia.
Contatti: ciao@enneciagency.it · +39 379 2885434 (anche WhatsApp) · https://www.enneciagency.it
Zona servita: Prato e provincia, Firenze e Pistoia, e in tutta la Toscana.

## Scheda

- Cliente: QuesturaSmart
- Settore: Servizi
- Tipo di lavoro: Piattaforma web
- Anno: 2026
- null
- Tecnologie: TypeScript, Terraform, Docker, AI documentale, i18n
- Pagina: https://www.enneciagency.it/progetti/questurasmart/

## Risultati

- **5** — tipi di pratica gestiti
- **QR** — ricevuta firmata per il check-in
- **0** — decisioni prese dalla macchina
- **IT · i18n** — contenuti in italiano, interfaccia tradotta

Rinnovare un permesso di soggiorno significa file, documenti che tornano indietro per un dettaglio e appuntamenti persi. QuesturaSmart è un prototipo pensato per essere attivato in convenzione con le autorità competenti, e prova a togliere l'incertezza da questo percorso.

## Il problema non è la fila: è non sapere

Chi si presenta allo sportello non sa quanto durerà l'attesa, se i documenti che porta bastano, se quel modulo andava compilato in un altro modo. Ogni errore costa un altro appuntamento, e un altro giorno di permesso dal lavoro.

C'è poi un vincolo che viene prima di ogni funzione: un servizio del genere non può in alcun modo sembrare un canale ufficiale della Pubblica Amministrazione. Il rischio non è tecnico, è che qualcuno creda di aver fatto una pratica che non ha fatto.

## Dichiarare la propria natura in ogni messaggio

Il progetto dichiara esplicitamente, in ogni notifica e in ogni pagina, di essere un servizio da attivare in convenzione e di non sostituire i canali ufficiali. Le integrazioni verso i sistemi esterni sono adattatori sostituibili, finti in sviluppo: nessuna funzione imita comunicazioni della PA.

Sulla verifica dei documenti la regola è la stessa: l'AI segnala che cosa sembra mancare o non tornare, ma è un parere. La decisione resta a una persona, come l'articolo 22 del GDPR richiede quando una valutazione automatica avrebbe effetti significativi su qualcuno.

## Cosa fa la piattaforma

- **Prenotazione con ricevuta firmata** — Primo rilascio, rinnovo, conversione, duplicato e aggiornamento, con numero giornaliero e QR Code firmato.
- **Documenti al sicuro** — Caricamento protetto e controllo assistito dall'AI, dichiarato come consultivo.
- **Coda in tempo reale** — Stima dell'attesa e avvisi in anticipo, per non passare la mattina allo sportello.
- **Check-in con QR** — Arrivo registrato leggendo il codice, senza passaggi intermedi.

## Una cartella che si chiama "compliance"

Accanto alle due applicazioni — l'API e il sito — ci sono due cartelle che in un progetto qualunque non esistono: `compliance`, dove stanno i documenti di conformità, e `docs/adr`, dove ogni decisione architetturale è registrata con il motivo per cui è stata presa e le alternative scartate.

Su un servizio che tocca documenti d'identità e permessi di soggiorno, quelle due cartelle valgono quanto il codice: se un domani qualcuno chiede perché i dati stanno lì e non altrove, la risposta è scritta, con la data.

L'infrastruttura è descritta in Terraform invece che configurata a mano: l'ambiente si ricrea da zero leggendo tre file, e nessuno deve ricordarsi quale impostazione era stata cambiata in fretta un venerdì sera.

## Un prototipo costruito per reggere un confronto

La piattaforma è un prototipo dimostrativo pensato per essere attivato in convenzione con Questura e Ministero dell'Interno. Le scelte più importanti non riguardano le funzioni ma i limiti che si è data: nessuna simulazione dei canali ufficiali, nessuna decisione automatica sui documenti, e la natura del servizio scritta in ogni comunicazione.
