Plán modernizácie hotový, rozpočet predbežne schválený. Dodávateľ položí prvú otázku: „Kde je dokumentácia systému?“ Ukáže sa, že existuje wiki naposledy aktualizovaná pred piatimi rokmi, pár schém „niekde na sieťovom disku“ a kód, ktorý si robí dokumentáciu sám sebe. Cenová ponuka rastie o tretinu. Lebo dodávateľ neoceňuje prácu, ale neistotu.
Tento text opisuje prax, ktorá túto neistotu odstraňuje zo stola: skôr než sa ktokoľvek dotkne kódu starej aplikácie, obnoví sa znalosť o nej. Ešte nedávno taká etapa znamenala týždne práce analytika a málokto sa na ňu odhodlal. Dnes AI vykoná väčšinu tejto analýzy za pár pracovných dní. A to mení poradie celého projektu.
Najprv mapa, potom kód
Modernizácia systému bez aktuálnej dokumentácie pripomína rekonštrukciu budovy bez plánu rozvodov. Dá sa to, ale každé vysekanie steny je lotéria: možno za ňou nič nie je a možno rúra, od ktorej závisí polovica poschodia. V aplikáciách býva touto rúrou integrácia s veľkoobchodom, na ktorú si pamätal len autor kódu, alebo nočný export, ktorý potichu používa učtáreň.
Preto je rozumné poradie opačné, než velí intuícia. Nezačína sa písaním nového kódu, ba ani cenovou ponukou. Začína sa mapou.
Čo AI vyťaží z kódu, databázy a logov
Moderné analytické nástroje dokážu prečítať tri zdroje pravdy o systéme: zdrojový kód, štruktúru databázy a logy z produkčnej prevádzky. Z ich prieniku vzniká mapa systému, ktorá zahŕňa štyri vrstvy.
Prvá sú moduly: z čoho sa systém skladá a za čo jednotlivé časti zodpovedajú, opísané jazykom zrozumiteľným aj pre ľudí mimo IT. Druhá sú dátové toky: kadiaľ dáta vstupujú, čo sa s nimi deje po ceste, kde končia. Tretia sú integrácie, teda všetky miesta, kde sa aplikácia rozpráva s inými systémami: účtovníctvom, skladom, e-shopom, partnermi. Práve tie pri zmenách praskajú najčastejšie.
Štvrtá vrstva je najmenej zjavná: mŕtvy kód. Analýza logov ukáže, ktoré funkcie neboli volané roky a do ktorých tabuliek nikto nezapisuje od roku 2019. V starších systémoch tvorí takáto záťaž často značnú časť celku. Každý riadok, ktorý netreba prenášať, je reálna úspora v projekte.
Čo mapa mení v rozhodnutí „prepísať či modernizovať“
O samotnom rozhodnutí sme písali osobitne, v texte o štyroch kritériách: rozhodovací framework. Mapa systému dáva týmto kritériám tvrdé dáta. Bez nej sa technologický dlh hodnotí od oka a riziko na základe anekdot. S ňou vidno čierne na bielom: ktoré moduly nesú biznisovú hodnotu, ktoré sú mŕtve, kde sedia integrácie zvyšujúce riziko každej zmeny.
Výsledky bývajú prekvapivé oboma smermi. Niekedy sa systém, ktorý „treba prepísať od nuly“, ukáže z troch štvrtín zdravý a stačí vymeniť dva moduly. Niekedy naopak: aplikácia vyzerá nevinne a mapa odhalí vyše tucta nezdokumentovaných prepojení, ktoré robia čiastočnú modernizáciu drahšou než prepísanie. V oboch prípadoch padá rozhodnutie na dátach, nie na emóciách. A dodávateľ, ktorý dostane mapu namiesto hádanky, oceňuje prácu namiesto rizika.
Podľa nás by obnovenie mapy malo byť samostatnou, prvou etapou modernizačnej zmluvy, s vlastným odovzdaním. Aj keby ste sa po tejto etape rozhodli, že modernizáciu urobí niekto iný alebo ju neurobíte vôbec, dokumentácia zostáva vo firme a pracuje ďalej.
Ako overiť to, čo vygenerovala AI
Automaticky vygenerovaná dokumentácia nie je veštiareň. Treba ju preveriť. Najúčinnejšia metóda je jednoduchá: prejsť ju s človekom, ktorý systém pozná najlepšie, často jediným takým vo firme. Rozdiel oproti klasickému prístupu spočíva v úlohe tejto osoby. Nežiadate ju o spísanie znalostí, čo nikto nemá rád a čo sa ťahá mesiace. Žiadate ju o recenziu hotového opisu, a ukázať „tu to sedí, tu nie“ ide mnohonásobne rýchlejšie než písanie od nuly.
Dobrou praxou je prejsť niekoľko najdôležitejších procesov od začiatku do konca: objednávka, faktúra, reklamácia. Ak mapa správne opisuje kritické toky a náhodne preverené detaily, možno jej dôverovať aj v ostatných oblastiach. Dá sa to stihnúť za deň.
Čo AI neobnoví
Tu poctivá výhrada: kód hovorí, čo systém robí, ale nehovorí, načo. Zvláštna výnimka pri výpočte zľavy môže byť chyba, ale aj obchodná dohoda z roku 2016, ktorá stále platí pre jedného veľkého klienta. To žiadna analýza kódu nerozhodne. Biznisové zámery spred dekády sa obnovujú rozhovormi: krátkymi stretnutiami s ľuďmi z predaja, účtovníctva a prevádzky, vedenými už s mapou v ruke. Mapa napovie, na čo sa pýtať, ale odpovede má človek.
Samostatnou témou je aj okolie aplikácie: servery, sieť, zálohy. O dokumentovaní tejto vrstvy sme písali v texte o audite dokumentácie infraštruktúry.
V ESKOM AI vedieme etapu mapovania tímom špecializovaných AI agentov pod dohľadom skúsených inžinierov: analýza typického firemného systému trvá pár pracovných dní a výsledkom je dokumentácia čitateľná pre vedenie aj technický tím. Ak po nej padne rozhodnutie o modernizácii, ďalšie práce prebiehajú v automatizovanom procese vývoja softvéru s plným rozsahom testov — jednotkových, integračných, E2E, UI, bezpečnostných a výkonnostných.
Kde začať u seba
Vyberte jeden systém: ten, ktorého modernizáciu odkladáte najdlhšie, alebo ten, na ktorý sa najviac bojíte siahnuť. Zadajte obnovenie jeho mapy ako samostatnú, malú etapu, skôr než kohokoľvek požiadate o cenovú ponuku prestavby. Na bezplatnej konzultácii poradíme, ako takú etapu naplánovať a čo od nej čakať.
Dohodnite si bezplatnú konzultáciu cez kontaktný formulár →