Het moderniseringsplan ligt klaar, het budget is voorlopig goedgekeurd. De uitvoerder stelt zijn eerste vraag: 'Waar is de systeemdocumentatie?' Wat blijkt: er is een wiki die vijf jaar geleden voor het laatst is bijgewerkt, een paar schema's 'ergens op de netwerkschijf' en code die als zijn eigen documentatie moet dienen. De offerte stijgt met een derde. Want de uitvoerder prijst geen werk, maar onzekerheid.
Deze tekst beschrijft een praktijk die die onzekerheid van tafel haalt: voordat iemand de code van een oude applicatie aanraakt, wordt de kennis erover gereconstrueerd. Tot voor kort betekende zo'n fase weken analistenwerk en begon bijna niemand eraan. Vandaag doet AI het grootste deel van die analyse in werkdagen. En dat verandert de volgorde van het hele project.
Eerst de kaart, dan de code
Een systeem moderniseren zonder actuele documentatie is als een gebouw verbouwen zonder installatieplan. Het kan, maar elke muur die je openbreekt is een loterij: misschien zit er niets achter, misschien een leiding waar een halve verdieping van afhangt. In applicaties is die leiding vaak een integratie met de groothandel waar alleen de oorspronkelijke programmeur van wist, of een nachtelijke export waar de boekhouding stilletjes op draait.
Daarom is de verstandige volgorde het omgekeerde van de intuïtieve. Je begint niet met nieuwe code schrijven, en zelfs niet met een offerte. Je begint met een kaart.
Wat AI uit code, database en logs haalt
Moderne analysetools kunnen drie bronnen van waarheid over een systeem lezen: de broncode, de databasestructuur en de logs uit productie. Uit de kruising daarvan ontstaat een systeemkaart met vier lagen.
De eerste laag: modules. Waaruit het systeem bestaat en waar elk onderdeel voor dient, beschreven in taal die ook buiten IT begrijpelijk is. De tweede: datastromen. Waar gegevens binnenkomen, wat er onderweg mee gebeurt en waar ze belanden. De derde: integraties, dus alle plekken waar de applicatie met andere systemen praat: boekhouding, magazijn, webshop, partners. Die breken bij wijzigingen het vaakst.
De vierde laag is de minst voor de hand liggende: dode code. Loganalyse laat zien welke functies al jaren niet zijn aangeroepen en in welke tabellen sinds 2019 niemand meer schrijft. In oudere systemen vormt die ballast vaak een fors deel van het geheel. Elke regel die niet mee hoeft, is een reële besparing in het project.
Wat de kaart verandert aan de keuze 'herbouwen of moderniseren'
Over die keuze zelf schreven we apart, in een tekst over vier criteria: het beslisframework. De systeemkaart geeft die criteria harde data. Zonder kaart schat je technische schuld op gevoel in, en risico op basis van anekdotes. Met kaart zie je zwart op wit welke modules bedrijfswaarde dragen, welke dood zijn en waar de integraties zitten die elke wijziging riskant maken.
De uitkomsten verrassen in beide richtingen. Soms blijkt een systeem dat 'vanaf nul herschreven moet worden' voor driekwart gezond en volstaat het om twee modules te vervangen. Soms andersom: de applicatie oogt onschuldig, maar de kaart legt ruim tien ongedocumenteerde koppelingen bloot die gedeeltelijke modernisering duurder maken dan herbouwen. In beide gevallen valt de beslissing op basis van data, niet van emoties. En een uitvoerder die een kaart krijgt in plaats van een raadsel, prijst werk in plaats van risico.
Wat ons betreft hoort het reconstrueren van de kaart een aparte, eerste fase van het moderniseringscontract te zijn, met een eigen oplevering. Zelfs als je na die fase besluit dat iemand anders de modernisering doet, of dat je er helemaal van afziet, blijft de documentatie in het bedrijf en blijft ze haar werk doen.
Hoe je verifieert wat de AI heeft gegenereerd
Automatisch gegenereerde documentatie is geen orakel. Ze moet gecontroleerd worden. De doeltreffendste methode is simpel: een review met de persoon die het systeem het best kent, vaak de enige in het bedrijf. Het verschil met de klassieke aanpak zit in de rol van die persoon. Je vraagt hem niet om zijn kennis op te schrijven, iets wat niemand graag doet en maanden aansleept. Je vraagt om een beoordeling van een kant-en-klare beschrijving, en aanwijzen wat klopt en wat niet gaat vele malen sneller dan schrijven vanaf nul.
Een goede gewoonte is om enkele kernprocessen van begin tot eind door te lopen: een bestelling, een factuur, een klacht. Beschrijft de kaart de kritieke stromen correct, net als de steekproefsgewijs gecontroleerde details, dan kun je haar ook in de overige gebieden vertrouwen. Dat lukt op een dag.
Wat AI niet kan reconstrueren
Hier past een eerlijke kanttekening: code vertelt wat een systeem doet, maar niet waarom. Een vreemde uitzondering in de kortingsberekening kan een bug zijn, of een commerciële afspraak uit 2016 die voor één grote klant nog steeds geldt. Geen enkele codeanalyse geeft daar uitsluitsel over. Zakelijke bedoelingen van tien jaar terug reconstrueer je met interviews: korte gesprekken met de mensen van sales, boekhouding en operations, gevoerd met de kaart in de hand. De kaart vertelt wat je moet vragen, maar de antwoorden heeft de mens.
Een apart onderwerp is de omgeving van de applicatie: servers, netwerk, back-ups. Over het documenteren van die laag schreven we in de tekst over de audit van infrastructuurdocumentatie.
Bij ESKOM AI voeren we de mappingfase uit met een team gespecialiseerde AI-agenten onder toezicht van ervaren engineers: de analyse van een doorsnee bedrijfssysteem duurt werkdagen, en het resultaat is documentatie die leesbaar is voor zowel de directie als het technische team. Valt daarna het besluit om te moderniseren, dan verloopt het vervolg in een geautomatiseerd softwareontwikkelproces met het volledige testspectrum — unit-, integratie- en E2E-tests, UI-, beveiligings- en performancetests.
Waar je zelf begint
Kies één systeem: het systeem waarvan je de modernisering het langst uitstelt, of dat je het liefst niet aanraakt. Laat de kaart ervan reconstrueren als zelfstandige, kleine fase, voordat je wie dan ook om een offerte voor de verbouwing vraagt. Tijdens een gratis consult vertellen we hoe je zo'n fase plant en wat je ervan mag verwachten.
Plan een gratis consult via het contactformulier →