Il piano di modernizzazione è pronto, il budget approvato in via preliminare. Il fornitore pone la prima domanda: "Dov'è la documentazione del sistema?". Salta fuori che c'è una wiki aggiornata l'ultima volta cinque anni fa, qualche schema "da qualche parte sul disco di rete" e il codice che fa da documentazione a se stesso. Il preventivo cresce di un terzo. Perché il fornitore non sta quotando il lavoro, ma l'incertezza.
Questo testo descrive una pratica che toglie dal tavolo quell'incertezza: prima che chiunque tocchi il codice di una vecchia applicazione, se ne ricostruisce la conoscenza. Fino a poco tempo fa una fase del genere significava settimane di lavoro di un analista e pochi la sceglievano. Oggi l'IA esegue la maggior parte di questa analisi in giorni lavorativi. E questo cambia l'ordine dell'intero progetto.
Prima la mappa, poi il codice
Modernizzare un sistema senza documentazione aggiornata è come ristrutturare un edificio senza le planimetrie degli impianti. Si può fare, ma ogni parete demolita è una lotteria: forse dietro non c'è niente, o forse c'è il tubo da cui dipende mezzo piano. Nelle applicazioni quel tubo è a volte l'integrazione con il grossista che ricordava solo l'autore del codice, oppure l'export notturno che la contabilità usa in silenzio.
Per questo l'ordine sensato è l'opposto di quello intuitivo. Non si comincia scrivendo nuovo codice e nemmeno dal preventivo. Si comincia dalla mappa.
Cosa l'IA estrae da codice, database e log
I moderni strumenti di analisi sanno leggere tre fonti di verità su un sistema: il codice sorgente, la struttura del database e i log del funzionamento in produzione. Dal loro incrocio nasce una mappa del sistema che copre quattro livelli.
Il primo sono i moduli: di cosa si compone il sistema e di cosa risponde ogni parte, descritti in un linguaggio comprensibile anche per chi non è dell'IT. Il secondo sono i flussi di dati: da dove entrano i dati, cosa succede loro lungo il percorso, dove finiscono. Il terzo sono le integrazioni, cioè tutti i punti in cui l'applicazione dialoga con altri sistemi: contabilità, magazzino, negozio, partner. Sono loro a rompersi più spesso quando si fanno modifiche.
Il quarto livello è il meno ovvio: il codice morto. L'analisi dei log mostra quali funzioni non vengono richiamate da anni e su quali tabelle nessuno scrive dal 2019. Nei sistemi più vecchi questa zavorra è spesso una parte consistente del totale. Ogni riga che non serve migrare è un risparmio reale nel progetto.
Cosa cambia la mappa nella decisione "riscrivere o modernizzare"
Della decisione in sé abbiamo scritto a parte, nel testo sui quattro criteri: il framework decisionale. La mappa del sistema dà a quei criteri dati concreti. Senza di essa il debito tecnologico si valuta a sensazione e il rischio sulla base di aneddoti. Con la mappa si vede nero su bianco: quali moduli portano valore di business, quali sono morti, dove si annidano le integrazioni che alzano il rischio di ogni modifica.
I risultati sorprendono in entrambe le direzioni. A volte il sistema che "va riscritto da zero" si rivela sano per tre quarti e basta sostituire due moduli. A volte è il contrario: l'applicazione sembra innocua e la mappa rivela una quindicina di connessioni non documentate che rendono la modernizzazione parziale più costosa della riscrittura. In entrambi i casi la decisione si prende sui dati, non sulle emozioni. E il fornitore che riceve una mappa invece di un enigma quota il lavoro invece del rischio.
A nostro avviso la ricostruzione della mappa dovrebbe essere una fase separata e iniziale del contratto di modernizzazione, con una propria accettazione. Anche se dopo questa fase decidi che la modernizzazione la farà qualcun altro, o che non la farai affatto, la documentazione resta in azienda e continua a lavorare.
Come verificare ciò che l'IA ha generato
La documentazione generata automaticamente non è un oracolo. Va verificata. Il metodo più efficace è semplice: una revisione con la persona che conosce meglio il sistema, spesso l'unica in azienda. La differenza rispetto all'approccio classico sta nel ruolo di questa persona. Non le chiedi di mettere per iscritto la sua conoscenza, cosa che nessuno ama e che si trascina per mesi. Le chiedi di recensire una descrizione già pronta, e indicare "qui torna, qui no" è molte volte più rapido che scrivere da zero.
Una buona pratica è ripercorrere alcuni processi chiave dall'inizio alla fine: ordine, fattura, reclamo. Se la mappa descrive correttamente i flussi critici e i dettagli verificati a campione, ci si può fidare anche nelle altre aree. Si può fare in una giornata.
Cosa l'IA non può ricostruire
Qui una riserva onesta: il codice dice cosa fa il sistema, ma non dice perché. Una strana eccezione nel calcolo dello sconto può essere un errore, o può essere un accordo commerciale del 2016 ancora valido per un grande cliente. Nessuna analisi del codice può stabilirlo. Le intenzioni di business di dieci anni fa si ricostruiscono con le interviste: brevi conversazioni con le persone delle vendite, della contabilità e delle operations, condotte già con la mappa in mano. La mappa suggerisce cosa chiedere, ma le risposte le hanno le persone.
Un tema a parte è anche l'ambiente intorno all'applicazione: server, rete, backup. Della documentazione di questo livello abbiamo scritto nel testo sull'audit della documentazione dell'infrastruttura.
In ESKOM AI conduciamo la fase di mappatura con un team di agenti IA specializzati sotto la supervisione di ingegneri esperti: l'analisi di un tipico sistema aziendale richiede giorni lavorativi e il risultato è una documentazione leggibile per la direzione e per il team tecnico. Se dopo di essa si decide per la modernizzazione, i lavori successivi si svolgono in un processo automatizzato di sviluppo software con una gamma completa di test — unitari, di integrazione, E2E, UI, di sicurezza e di performance.
Da dove iniziare in azienda
Scegli un sistema: quello la cui modernizzazione rimandi da più tempo o quello che hai più paura di toccare. Commissiona la ricostruzione della sua mappa come fase autonoma e contenuta, prima di chiedere a chiunque un preventivo di ristrutturazione. In una consulenza gratuita ti suggeriremo come pianificare questa fase e cosa aspettarti dopo.
Prenota una consulenza gratuita tramite il modulo di contatto →