El pla de modernització a punt, el pressupost acceptat de manera preliminar. El proveïdor fa la primera pregunta: «On és la documentació del sistema?». Resulta que hi ha una wiki actualitzada per última vegada fa cinc anys, uns quants esquemes «en algun lloc del disc de xarxa» i un codi que es fa de documentació a si mateix. La valoració puja un terç. Perquè el proveïdor no valora la feina, sinó la incertesa.
Aquest text descriu una pràctica que treu aquesta incertesa de la taula: abans que ningú toqui el codi d'una aplicació antiga, se'n recupera el coneixement. Fins fa poc, una etapa així volia dir setmanes de feina d'un analista i poca gent s'hi decidia. Avui la IA fa la major part d'aquesta anàlisi en dies laborables. I això canvia l'ordre de tot el projecte.
Primer el mapa, després el codi
Modernitzar un sistema sense documentació actualitzada s'assembla a reformar un edifici sense el plànol de les instal·lacions. Es pot fer, però cada cop de mall a la paret és una loteria: potser al darrere no hi ha res, o potser hi ha una canonada de la qual depèn mitja planta. A les aplicacions, aquesta canonada sol ser la integració amb el magatzem que només recordava l'autor del codi, o l'exportació nocturna que la comptabilitat fa servir en silenci.
Per això l'ordre assenyat és el contrari de l'intuïtiu. No es comença escrivint codi nou, ni tan sols per la valoració. Es comença pel mapa.
Què extreu la IA del codi, la base de dades i els logs
Les eines modernes d'anàlisi saben llegir tres fonts de veritat sobre el sistema: el codi font, l'estructura de la base de dades i els logs del funcionament en producció. Del seu encreuament en surt un mapa del sistema que cobreix quatre capes.
La primera són els mòduls: de què es compon el sistema i de què respon cada fragment, descrits en un llenguatge comprensible també per a persones de fora d'IT. La segona són els fluxos de dades: per on entren les dades, què els passa pel camí, on acaben. La tercera són les integracions, és a dir, tots els punts on l'aplicació parla amb altres sistemes: comptabilitat, magatzem, botiga, socis. Són les que més sovint es trenquen amb els canvis.
La quarta capa és la menys òbvia: el codi mort. L'anàlisi dels logs mostra quines funcions no s'han cridat des de fa anys i a quines taules ningú no escriu des del 2019. Als sistemes més antics, aquest llast sol ser una part considerable del total. Cada línia que no cal migrar és un estalvi real al projecte.
Què canvia el mapa en la decisió «reescriure o modernitzar»
Sobre la decisió en si en vam escriure a part, al text sobre els quatre criteris: el framework de decisió. El mapa del sistema dona a aquests criteris dades sòlides. Sense el mapa, el deute tecnològic s'avalua a ull i el risc a partir d'anècdotes. Amb el mapa es veu blanc sobre negre: quins mòduls aporten valor de negoci, quins són morts, on s'amaguen les integracions que fan pujar el risc de cada canvi.
Els resultats sorprenen en totes dues direccions. De vegades el sistema que «cal reescriure de zero» resulta estar sa en tres quartes parts i n'hi ha prou de substituir dos mòduls. De vegades és al revés: l'aplicació sembla innocent i el mapa revela una dotzena llarga de connexions no documentades que fan que la modernització parcial surti més cara que reescriure-la. En tots dos casos la decisió es pren amb dades, no amb emocions. I el proveïdor que rep un mapa en lloc d'un enigma valora la feina, no el risc.
Al nostre parer, la reconstrucció del mapa hauria de ser una etapa separada i inicial del contracte de modernització, amb la seva pròpia acceptació. Encara que després d'aquesta etapa decideixis que la modernització la fa algú altre o que no la fas, la documentació es queda a l'empresa i continua treballant.
Com verificar el que ha generat la IA
La documentació generada automàticament no és cap oracle. Cal comprovar-la. El mètode més eficaç és senzill: una revisió amb la persona que coneix millor el sistema, sovint l'única a l'empresa. La diferència respecte a l'enfocament clàssic és el paper d'aquesta persona. No li demanes que escrigui el seu coneixement, cosa que ningú no suporta i que s'allarga mesos. Li demanes que revisi una descripció ja feta, i assenyalar «això quadra, això no» va moltes vegades més ràpid que escriure de zero.
Una bona pràctica és recórrer uns quants processos clau de principi a fi: comanda, factura, reclamació. Si el mapa descriu correctament els fluxos crítics i els detalls comprovats a l'atzar, s'hi pot confiar a la resta d'àrees. Això es pot fer en un dia.
Què no pot recuperar la IA
Aquí una advertència honesta: el codi diu què fa el sistema, però no diu per a què. Una excepció estranya al càlcul d'un descompte pot ser un error, o pot ser un acord comercial del 2016 que encara és vigent per a un gran client. Això cap anàlisi de codi no ho resoldrà. Les intencions de negoci de fa una dècada es recuperen amb entrevistes: converses curtes amb la gent de vendes, comptabilitat i operacions, fetes ja amb el mapa a la mà. El mapa suggereix què preguntar, però les respostes les té una persona.
Un tema a part és l'entorn de l'aplicació: servidors, xarxa, còpies de seguretat. Sobre com documentar aquesta capa en vam escriure al text sobre l'auditoria de la documentació d'infraestructura.
A ESKOM AI duem a terme l'etapa de mapatge amb un equip d'agents d'IA especialitzats sota la supervisió d'enginyers experimentats: l'anàlisi d'un sistema empresarial típic ocupa dies laborables, i el resultat és una documentació llegible per a la direcció i per a l'equip tècnic. Si després es pren la decisió de modernitzar, els treballs següents es fan amb un procés automatitzat de desenvolupament de programari amb un ventall complet de proves — unitàries, d'integració, E2E, d'interfície, de seguretat i de rendiment.
Per on començar a casa teva
Tria un sistema: el que fa més temps que n'ajornes la modernització o el que més por et fa tocar. Encarrega la reconstrucció del seu mapa com una etapa petita i independent, abans de demanar a ningú una valoració de la reforma. En una consulta gratuïta et direm com planificar aquesta etapa i què esperar-ne.
Demana una consulta gratuïta a través del formulari de contacte →