L'IA non analizza il suo codice legacy: lo analizza un parser
Di Xavier Franco, CEO de Elternativa · Grupo Zemsania
· 6 min di lettura
Redatto con l’aiuto dell’IA e rivisto da Xavier Franco

In questo articolo
- La vera paura non è il linguaggio
- Perché non basta chiederlo a un'IA
- Prima deterministico, poi l'IA
- La documentazione che non ha mai avuto
- Le persone che lo conoscono, a convalidare
- E poi, confrontare con dati reali
- Cosa chiedere a chi le propone di documentare il suo legacy
- Da dove iniziare
- Come la aiutiamo
Quando si parla di modernizzare i sistemi legacy con l'IA, la domanda che si sente più spesso è: «e se l'IA si inventasse ciò che fa il mio sistema?». È una domanda sensatissima. E la mia risposta è questa: l'IA non deve analizzare il suo codice. Deve analizzarlo un parser. L'IA viene dopo, per spiegarlo.
La vera paura non è il linguaggio
Un sistema legacy non fa paura perché è scritto in COBOL, in Visual Basic 6, in Oracle Forms o in PL/SQL. Fa paura perché nessuno sa davvero cosa fa. Decenni di modifiche, regole di business nascoste in un programma, integrazioni che solo una persona capisce e una documentazione che ha smesso di essere aggiornata anni fa.
Prima di migrare, modernizzare o anche solo mantenere un sistema così, bisogna capirlo. E capirlo deve essere qualcosa che si possa verificare.
In pratica: chieda al suo team dove si trova la documentazione del suo sistema più vecchio e di quando è. Se esitano, sa già da dove iniziare.
Perché non basta chiederlo a un'IA
I modelli linguistici sono straordinari nello spiegare il codice. Ma hanno un tratto che conviene non dimenticare: quando non sanno qualcosa, a volte la completano con qualcosa che suona bene.
Uno studio lo illustra molto bene. Un gruppo di ricercatori ha analizzato 576.000 frammenti di codice generati da 16 modelli e ha verificato che il 19,7% dei pacchetti raccomandati non esisteva. In totale, più di 205.000 nomi di pacchetti inventati. È un caso concreto, quello delle dipendenze, ma lo schema è generale: un modello può dare una risposta sicura, ben scritta e falsa.
Se quel modello è quello che le dice quali regole di business ha il suo sistema di fatturazione, il rischio è evidente. Una regola inventata viene migrata come se fosse reale. Una regola omessa scompare in silenzio.
Prima deterministico, poi l'IA
Per questo, nel nostro approccio, l'analisi si fa in due livelli:
- Il parser legge il codice. Un'analisi deterministica: lo stesso codice dà sempre lo stesso risultato. Estrae programmi, dipendenze, dati letti e scritti, chiamate, condizioni e regole. Ogni elemento è collegato alla riga di codice da cui proviene.
- L'IA lo spiega. Su quell'analisi, l'IA redige la documentazione funzionale e tecnica in un linguaggio comprensibile al business. Spiega, riassume e mette in ordine. Ma non inventa cosa fa il programma, perché l'ha già detto il parser.
La differenza è enorme. Con la sola IA, ha un'interpretazione. Con il parser davanti, ha una mappa che si può verificare, e ogni frase della documentazione si può rintracciare fino alla sua origine.
In pratica: quando qualcuno le propone di documentare il suo sistema con l'IA, chieda come si verifica che ogni regola documentata esista nel codice. Se la risposta è «lo controlliamo alla fine», non basta.
La documentazione che non ha mai avuto
Il risultato, facendo così, è qualcosa che molte organizzazioni non hanno mai avuto: una documentazione funzionale e tecnica ricavata dal codice stesso, che dice cosa fa il sistema oggi, non ciò che qualcuno credeva facesse.
E ha un effetto che si nota subito: emerge ciò che non si usa. Programmi che nessuno chiama, report che nessuno richiede, processi rimasti «per sicurezza». Questo non si migra: si spegne.
Le persone che lo conoscono, a convalidare
Un parser non sostituisce chi conosce il sistema. Al contrario: gli dà uno strumento. Le due o tre persone che sanno perché esiste una regola o quale processo non si tocca a fine mese passano a convalidare la documentazione ricavata dal codice, regola per regola.
La loro conoscenza, che oggi è nella loro testa, resta scritta e collegata al codice. Per me, questa è una delle migliori notizie nel modernizzare un sistema così: le sue persone chiave smettono di essere un rischio e diventano quelle che danno il via libera.
In pratica: metta i suoi esperti davanti alla documentazione ricavata dal codice. Se la convalidano, ha fatto metà della modernizzazione.
E poi, confrontare con dati reali
Capire il sistema è il primo passo. Quando lo si ricostruisce, lo stesso principio vale alla fine: il sistema nuovo e quello vecchio girano in parallelo e si confrontano caso per caso, con i suoi dati reali. Non si stacca nulla finché non quadra.
Così, l'IA lavora in ciò che sa fare meglio (spiegare, scrivere, ricostruire) e la verità la mettono due cose che non allucinano: il codice e i dati.
Cosa chiedere a chi le propone di documentare il suo legacy
Ci sono sempre più offerte per documentare o modernizzare sistemi legacy con l'IA. Prima di scegliere, io chiederei cinque cose:
- Tracciabilità: che ogni regola documentata indichi da quale programma e da quale riga proviene.
- Ripetibilità: che lo stesso codice dia sempre la stessa analisi. Se la esegue due volte e cambia, non è un'analisi: è un'opinione.
- Sola lettura: che la scansione legga i suoi sistemi senza toccarli né modificarli.
- Ciò che non si usa, segnalato: che l'inventario dica cosa gira e cosa è fermo da anni.
- Convalida da parte della sua gente: che i suoi esperti rivedano la documentazione prima di riscrivere qualsiasi cosa.
Se una proposta non soddisfa questi cinque punti, la documentazione sarà magari bella, ma non potrà fidarsene per prendere decisioni. E in un sistema critico, una documentazione di cui non ci si fida è quasi peggio di non averne nessuna.
In pratica: chieda a qualsiasi fornitore di documentare un suo programma e di indicare, per ogni regola, la riga da cui proviene. È la prova più rapida.
Da dove iniziare
- Scelga un sistema circoscritto, con valore di business e qualcuno che lo conosca.
- Lo inventari in sola lettura e ne ricavi la documentazione dal codice.
- Faccia convalidare la documentazione ai suoi esperti, regola per regola.
- Segni ciò che non si usa e lo spenga.
- Decida con quella documentazione se modernizzare, migrare o mantenere.
Come la aiutiamo
In Migrazione di codice e applicazioni migriamo COBOL e mainframe, Visual Basic 6, Access, Oracle Forms e PL/SQL verso il linguaggio che sceglie. Prima inventariamo il codice in sola lettura e documentiamo ciò che fa ricavandolo dal codice, non dalla memoria di qualcuno; poi lo ricostruiamo e passiamo processo per processo con parità misurata.
Lo facciamo con il modulo di migrazione di Datagentis, che scansiona i suoi sistemi in sola lettura, documenta ciò che fanno e genera il piano per migrare ciò che deve uscire.
Ha documentato ciò che fa il suo sistema più vecchio?
In una demo, su un'applicazione legacy di esempio, le mostriamo come si ricava dal codice la documentazione funzionale e tecnica, regola per regola.


