Plán modernizace hotový, rozpočet předběžně schválený. Dodavatel položí první otázku: „Kde je dokumentace systému?". Ukáže se, že existuje wiki naposledy aktualizovaná před pěti lety, pár schémat „někde na síťovém disku" a kód, který si dělá dokumentaci sám sobě. Nabídka roste o třetinu. Protože dodavatel neoceňuje práci, ale nejistotu.
Tento text popisuje praxi, která tuto nejistotu sundává ze stolu: než se kdokoli dotkne kódu staré aplikace, obnoví se znalosti o ní. Ještě nedávno takový krok znamenal týdny práce analytika a málokdo se pro něj rozhodl. Dnes AI zvládne většinu této analýzy během pracovních dnů. A to mění pořadí celého projektu.
Nejdřív mapa, potom kód
Modernizace systému bez aktuální dokumentace připomíná rekonstrukci budovy bez plánu instalací. Jde to, ale každé probourání zdi je loterie: možná za ní nic není, možná trubka, na které závisí půlka patra. V aplikacích bývá takovou trubkou integrace s datovým skladem, o které věděl jen autor kódu, nebo noční export, který potichu využívá účtárna.
Rozumné pořadí je proto opačné, než napovídá intuice. Nezačíná se psaním nového kódu, ani cenovou nabídkou. Začíná se mapou.
Co AI vytáhne z kódu, databáze a logů
Moderní analytické nástroje umějí přečíst tři zdroje pravdy o systému: zdrojový kód, strukturu databáze a logy z produkčního provozu. Z jejich průniku vzniká mapa systému, která pokrývá čtyři vrstvy.
První jsou moduly: z čeho se systém skládá a za co která část odpovídá, popsané jazykem srozumitelným i lidem mimo IT. Druhá jsou datové toky: odkud data vstupují, co se s nimi děje po cestě, kde končí. Třetí jsou integrace, tedy všechna místa, kde aplikace komunikuje s jinými systémy: účetnictvím, skladem, e-shopem, partnery. Právě ty při změnách praskají nejčastěji.
Čtvrtá vrstva je nejméně zřejmá: mrtvý kód. Analýza logů ukazuje, které funkce nebyly roky zavolány a do kterých tabulek nikdo nezapisuje od roku 2019. Ve starších systémech tvoří takový balast často značnou část celku. Každý řádek, který není třeba přenášet, je reálná úspora v projektu.
Co mapa mění v rozhodnutí „přepsat, nebo modernizovat"
O samotném rozhodnutí jsme psali zvlášť, v textu o čtyřech kritériích: rozhodovací framework. Mapa systému dává těmto kritériím tvrdá data. Bez ní se technologický dluh odhaduje po citu a riziko na základě anekdot. S ní je černé na bílém vidět: které moduly nesou byznysovou hodnotu, které jsou mrtvé, kde sedí integrace zvyšující riziko každé změny.
Výsledky bývají překvapivé oběma směry. Někdy se systém, který „je nutné přepsat od nuly", ukáže ze tří čtvrtin zdravý a stačí vyměnit dva moduly. Jindy naopak: aplikace vypadá nevinně a mapa odhalí kolem patnácti nezdokumentovaných propojení, kvůli kterým je částečná modernizace dražší než přepsání. V obou případech padá rozhodnutí na datech, ne na emocích. A dodavatel, který dostane mapu místo hádanky, oceňuje práci místo rizika.
Podle nás by obnovení mapy mělo být samostatnou, první etapou modernizační smlouvy s vlastní akceptací. I když se po této etapě rozhodnete, že modernizaci udělá někdo jiný nebo ji neuděláte vůbec, dokumentace zůstává ve firmě a pracuje dál.
Jak ověřit to, co AI vygenerovala
Automaticky vygenerovaná dokumentace není orákulum. Je třeba ji zkontrolovat. Nejúčinnější metoda je prostá: revize s člověkem, který systém zná nejlépe, často jediným takovým ve firmě. Rozdíl oproti klasickému přístupu spočívá v roli tohoto člověka. Nežádáte ho o sepsání znalostí, což nikdo nemá rád a táhne se to měsíce. Žádáte o recenzi hotového popisu, a ukázat „tady to sedí, tady ne" jde mnohonásobně rychleji než psaní od nuly.
Dobrou praxí je projít několik nejdůležitějších procesů od začátku do konce: objednávka, faktura, reklamace. Pokud mapa správně popisuje kritické toky a namátkově ověřené detaily, lze jí důvěřovat i v ostatních oblastech. To se dá stihnout za den.
Co AI neobnoví
Zde poctivá výhrada: kód říká, co systém dělá, ale neříká proč. Podivná výjimka ve výpočtu slevy může být chyba, nebo obchodní dohoda z roku 2016, která pro jednoho velkého klienta stále platí. To žádná analýza kódu nerozhodne. Byznysové záměry staré deset let se obnovují rozhovory: krátkými schůzkami s lidmi z obchodu, účetnictví a provozu, vedenými už s mapou v ruce. Mapa napovídá, na co se ptát, ale odpovědi má člověk.
Samostatným tématem je také okolí aplikace: servery, síť, zálohy. O dokumentování této vrstvy jsme psali v textu o auditu dokumentace infrastruktury.
V ESKOM AI vedeme etapu mapování týmem specializovaných AI agentů pod dohledem zkušených inženýrů: analýza typického firemního systému trvá pracovní dny a výsledkem je dokumentace čitelná pro vedení i technický tým. Pokud po ní padne rozhodnutí o modernizaci, další práce probíhají v automatizovaném procesu vývoje softwaru s plným rozsahem testů — jednotkových, integračních, E2E, UI, bezpečnostních a výkonnostních.
Kde začít u sebe
Vyberte jeden systém: ten, jehož modernizaci odkládáte nejdéle, nebo na který se nejvíc bojíte sáhnout. Zadejte obnovení jeho mapy jako samostatnou, malou etapu, než kohokoli požádáte o nacenění přestavby. Na bezplatné konzultaci poradíme, jak takovou etapu naplánovat a co od ní čekat.
Domluvte si bezplatnou konzultaci přes kontaktní formulář →