Controluce: sviluppare un’applicazione reale con l’IA, senza scrivere codice
È possibile sviluppare e pubblicare un’applicazione completa, senza scrivere manualmente una sola riga di codice, affidandosi agli agenti di Intelligenza Artificiale?
È questa la domanda da cui è partito il lavoro che Marco Ranica ha svolto per realizzare Controluce, il portale dedicato all’archivio fotografico storico di Urgnano e Basella.
Il progetto, sviluppato tra giugno e settembre 2026 nel corso di una Gilda Intré, è oggi online e accessibile a tutti, ospitato su un server del comune. Non si tratta quindi di una semplice demo, ma di un’applicazione reale, progettata per gestire fotografie storiche, utenti, contenuti e contributi della comunità.
L’obiettivo della sperimentazione era comprendere fino a che punto fosse possibile delegare la scrittura del codice all’IA, mantenendo il controllo sulle scelte progettuali, sull’architettura e sulla qualità del risultato.
Dall’idea degli studenti alla nascita di Controluce
La storia di Controluce inizia prima della sperimentazione con l’IA.
Il progetto nasce infatti da un percorso di alternanza scuola-lavoro realizzato con l’Istituto Andrea Fantoni, durante il quale gli studenti sono stati coinvolti nella progettazione di un sito web dedicato alla memoria fotografica del territorio.
L’attività è stata organizzata simulando un vero rapporto tra cliente e team di progettazione, con requisiti, obiettivi e indicazioni da rispettare.
Al termine del percorso sono stati realizzati otto prototipi con Adobe XD, successivamente analizzati per individuarne gli elementi più interessanti.
Tra questi:
- Il nome Controluce, scelto per la sua capacità di rappresentare l’identità del progetto.
- La struttura di History of Urgnano, particolarmente efficace nell’organizzazione dell’archivio e delle testimonianze.
- L’identità territoriale proposta da Storie tra le vie.
- Alcune funzionalità ideate dagli altri gruppi, tra cui la creazione di cartoline, la raccolta di fotografie dei cittadini, una timeline storica e diversi giochi.
Queste proposte hanno costituito il punto di partenza per lo sviluppo dell’applicazione.
I materiali sono stati raccolti e organizzati in un brief su Figma, insieme a indicazioni visive e priorità progettuali. Il documento è diventato uno dei principali riferimenti forniti agli agenti IA durante lo sviluppo.
Un passaggio importante della sperimentazione: fornire all’IA un contesto strutturato, anziché affidarsi a richieste generiche, per ottenere risultati più coerenti con gli obiettivi del progetto.
Una sperimentazione con una regola precisa: nessuna riga di codice scritta manualmente
La sperimentazione è stata condotta seguendo un vincolo ben definito: tutto il codice dell’applicazione doveva essere generato e modificato esclusivamente attraverso strumenti di Intelligenza Artificiale.
Questo non significava lasciare agli agenti completa autonomia.
Al contrario, il lavoro si è concentrato su tre attività fondamentali: definizione del contesto, progettazione dell’architettura e verifica dei risultati.
Fornire un contesto stabile agli agenti
Per garantire continuità tra le diverse sessioni di sviluppo, sono stati predisposti file di istruzioni contenenti le informazioni essenziali sul progetto: obiettivi, tecnologie utilizzate, vincoli e regole da rispettare.
A questi documenti sono stati affiancati un piano di progetto e un registro delle attività, con riferimenti ai commit che ne attestavano il completamento.
In questo modo, ogni nuova sessione poteva riprendere il lavoro dal punto raggiunto in precedenza, riducendo la necessità di ricostruire continuamente il contesto.
Definire l’architettura applicativa
Le scelte architetturali sono rimaste sotto il controllo umano.
Per lo sviluppo di Controluce è stato adottato uno stack tecnologico composto da:
- Angular, per il frontend.
- NestJS, per il backend.
- PostgreSQL, per la gestione dei metadati.
- MinIO, per l’archiviazione delle fotografie.
- Docker, per l’esecuzione dei componenti applicativi in container.
L’applicazione prevede inoltre un sistema di autenticazione con ruoli differenti, dedicati ad amministratori e contributori, e un meccanismo di backup automatico settimanale.
Gli agenti IA si sono occupati dell’implementazione, seguendo le decisioni architetturali definite durante la progettazione.
Verificare il lavoro prodotto
Un altro elemento centrale è stato il controllo della qualità.
Nel corso dello sviluppo sono stati eseguiti test automatici, verifiche di sicurezza, controlli di accessibilità e test delle pagine su dispositivi mobili attraverso Playwright.
Anche queste attività sono state affidate agli agenti, ma i risultati sono stati esaminati da una persona.
La sperimentazione ha quindi mantenuto una distinzione precisa tra automazione delle attività e responsabilità delle decisioni.
Cinque agenti IA per organizzare l’archivio fotografico
Uno degli aspetti più interessanti di Controluce riguarda la catalogazione delle fotografie.
La realizzazione di un archivio storico non richiede soltanto un’applicazione in grado di conservare e visualizzare immagini. Ogni fotografia deve essere accompagnata da informazioni che ne permettano la ricerca, la consultazione e la contestualizzazione.
Titoli, descrizioni, luoghi, periodi storici e parole chiave sono elementi fondamentali, ma la loro compilazione manuale può richiedere molto tempo.
Per affrontare questa attività è stato progettato un sistema di agenti IA specializzati nella catalogazione fotografica.
Il processo prevede un agente coordinatore che organizza il materiale ricevuto dai donatori, suddivide le fotografie in gruppi e distribuisce le attività a cinque agenti archivisti che lavorano in parallelo.
Ogni agente analizza le immagini, compila le schede descrittive e organizza i file negli album corrispondenti.
Al termine dell’elaborazione, il coordinatore raccoglie le informazioni in un file CSV, che può essere importato direttamente nel portale.
Catalogare senza inventare informazioni
La catalogazione è stata progettata seguendo regole precise, con particolare attenzione all’affidabilità delle informazioni generate.
Gli agenti devono descrivere esclusivamente ciò che è visibile nelle immagini, evitando interpretazioni non supportate.
Per esempio, non possono attribuire arbitrariamente una data a una fotografia, identificare persone senza informazioni certe o dedurre rapporti di parentela e professioni.
Quando un’informazione non è disponibile, il relativo campo viene lasciato vuoto oppure viene segnalata l’incertezza.
Anche i testi alternativi, necessari per rendere le fotografie accessibili alle persone che utilizzano screen reader, seguono regole specifiche e devono essere distinti dai titoli.
L’obiettivo non è ottenere schede apparentemente complete, ma informazioni affidabili e verificabili.
Prima della pubblicazione, ogni scheda viene comunque sottoposta a controllo umano.
Questo approccio permette di sfruttare la velocità dell’IA senza rinunciare alla qualità dei contenuti e al rispetto della memoria storica.
Controluce oggi: 467 fotografie e un archivio aperto alla comunità
Il risultato è un archivio che, al momento della presentazione, comprendeva 467 fotografie pubblicate e organizzate in 12 album.
Ogni immagine dispone di una scheda contenente titolo, anno, luogo, album di appartenenza, parole chiave e informazioni sul donatore.
Le fotografie possono essere scaricate in alta risoluzione con licenza Creative Commons Attribution 4.0 (CC BY 4.0), che ne consente il riutilizzo nel rispetto delle condizioni previste.
Il portale include inoltre una funzionalità per segnalare eventuali correzioni alle schede.
Chi riconosce un luogo, un evento o un periodo storico può contribuire a migliorare le informazioni presenti nell’archivio.
È un aspetto particolarmente importante del progetto: l’IA supporta l’organizzazione delle informazioni, mentre la comunità contribuisce a ricostruire e preservare la memoria del territorio.
Non solo fotografie: le funzionalità del portale
Controluce non si limita alla consultazione dell’archivio fotografico.
Il sito integra diverse funzionalità, molte delle quali derivano direttamente dai prototipi realizzati dagli studenti dell’Istituto Andrea Fantoni.
Raccontare la storia del territorio
La sezione dedicata alla linea del tempo raccoglie 50 eventi documentati, organizzati in cinque epoche storiche. Ogni evento dispone di una pagina dedicata e di collegamenti alle fotografie dell’archivio.
A questa si affianca una raccolta di 13 storie e racconti dedicati a persone, luoghi e aspetti della vita quotidiana del territorio, consultabili attraverso filtri tematici.
Sono inoltre previste due ulteriori sezioni, ancora in fase di realizzazione: una dedicata alle testimonianze degli abitanti e una mappa interattiva che permetterà di individuare i luoghi rappresentati nelle fotografie.
Le testimonianze audio verranno trascritte per facilitarne l’accessibilità e la ricerca, mentre la mappa richiederà un lavoro progressivo di georeferenziazione delle immagini.
Coinvolgere i cittadini
Il portale offre anche strumenti per favorire la partecipazione della comunità.
Tra questi, una funzionalità che permette di creare cartoline personalizzate utilizzando le fotografie dell’archivio, scaricabili in formato A6 per la stampa oppure in formato 4:5 per la condivisione sui social.
Sono presenti anche due giochi basati sulle immagini storiche: un puzzle fotografico e un memory.
Attraverso la sezione Partecipa, i cittadini possono inoltre proporre nuove fotografie, condividere ricordi, segnalare correzioni e inviare testimonianze audio o video.
Tutti i contributi vengono sottoposti a moderazione prima della pubblicazione.
La gestione di queste attività avviene attraverso un back office dedicato agli amministratori, che consente di approvare le fotografie, importare le schede preparate dagli agenti, moderare i contenuti e gestire gli utenti.
Dal progetto alla pubblicazione: la presentazione del 23 ottobre 2026
Il 23 ottobre 2026 Controluce è stato presentato ufficialmente alla comunità di Urgnano, durante un evento organizzato nella sala conferenze della Rocca Albani.
L’incontro è stato l’occasione per raccontare il percorso del progetto, dalle prime proposte degli studenti fino alla sperimentazione con gli agenti IA e alla pubblicazione del portale.
Durante la serata sono stati illustrati anche il funzionamento degli archivisti digitali e il contributo delle famiglie che hanno messo a disposizione le proprie fotografie.
Ai partecipanti sono state consegnate 36 cartoline stampate, ciascuna con un’immagine storica e il relativo racconto.
Il progetto è stato quindi presentato non soltanto come risultato di una sperimentazione tecnologica, ma anche come strumento a disposizione del territorio.
I materiali dell’evento sono disponibili online:
Cosa insegna questa sperimentazione sullo sviluppo software con l’IA?
L’esperienza di Controluce offre diversi spunti di riflessione sul ruolo dell’Intelligenza Artificiale nei processi di sviluppo software.
Il primo riguarda l’importanza del contesto e delle istruzioni.
La qualità dei risultati non dipende esclusivamente dalla formulazione di un singolo prompt, ma dalla capacità di fornire agli agenti obiettivi chiari, vincoli, documentazione e riferimenti coerenti.
Un secondo aspetto riguarda la necessità di verificare ciò che viene prodotto.
Gli agenti possono accelerare numerose attività, dalla generazione del codice alla catalogazione dei contenuti, ma non eliminano il rischio di errori. Test, revisioni e controlli rimangono quindi indispensabili.
La sperimentazione mette inoltre in evidenza un cambiamento nelle attività dello sviluppatore.
Nel caso di Controluce, non è stato necessario scrivere manualmente codice. Questo non ha però eliminato il lavoro di progettazione, le decisioni architetturali, la valutazione delle soluzioni e il controllo della qualità.
L’attenzione si è spostata dalla produzione diretta del codice alla definizione delle istruzioni, alla supervisione del processo e alla verifica dei risultati.
Infine, il lavoro sull’archivio fotografico ha evidenziato l’importanza di gestire consapevolmente l’incertezza. Quando le informazioni non sono sufficienti, è preferibile dichiarare un dato come non disponibile piuttosto che generare una risposta non verificata.
Sperimentare per comprendere le opportunità e i limiti dell’IA
Controluce rappresenta un esempio concreto di come un percorso di sperimentazione possa trasformarsi in un’applicazione reale, con un’utilità che va oltre l’ambito tecnologico.
La Gilda estiva ha permesso di esplorare nuove modalità di sviluppo assistito dall’Intelligenza Artificiale, mettendo alla prova strumenti, processi e responsabilità in un contesto applicativo completo.
L’esperienza mostra che delegare la scrittura del codice all’IA non significa rinunciare alle competenze di sviluppo software, ma utilizzarle in modo diverso.
Progettare un’architettura, definire requisiti, riconoscere i limiti degli strumenti e valutare criticamente i risultati restano attività fondamentali per realizzare software di qualità.
È proprio questo uno degli obiettivi delle Gilde di Intré: creare occasioni di apprendimento e sperimentazione, condividere le conoscenze acquisite e trasformarle in nuove competenze.
In questo caso, il risultato è anche un archivio digitale che contribuisce a conservare e valorizzare la memoria di una comunità.
Controluce è online e può essere consultato liberamente.
Un ringraziamento al Comune di Urgnano, all’Istituto Andrea Fantoni e ai suoi studenti, e a tutte le famiglie che hanno contribuito al progetto condividendo le proprie fotografie.