Modernisointisuunnitelma valmis, budjetti alustavasti hyväksytty. Toimittaja esittää ensimmäisen kysymyksen: ”Missä on järjestelmän dokumentaatio?”. Käy ilmi, että on wiki, jota on viimeksi päivitetty viisi vuotta sitten, muutama kaavio ”jossain verkkolevyllä” ja koodi, joka toimii itse omana dokumentaationaan. Hinta-arvio kasvaa kolmanneksella. Koska toimittaja ei hinnoittele työtä vaan epävarmuutta.
Tämä teksti kuvaa käytännön, joka poistaa tuon epävarmuuden pöydältä: ennen kuin kukaan koskee vanhan sovelluksen koodiin, tieto siitä rekonstruoidaan. Vielä vähän aikaa sitten tällainen vaihe tarkoitti analyytikon viikkojen työtä, ja harva siihen ryhtyi. Nykyään AI tekee suurimman osan analyysistä työpäivissä. Ja se muuttaa koko projektin järjestyksen.
Ensin kartta, sitten koodi
Järjestelmän modernisointi ilman ajantasaista dokumentaatiota muistuttaa rakennuksen remonttia ilman putkipiirustuksia. Onnistuu kyllä, mutta jokainen seinän avaus on arpapeliä: ehkä sen takana ei ole mitään, tai ehkä siellä on putki, josta puoli kerrosta riippuu. Sovelluksissa se putki on usein integraatio varastoon, jonka muisti vain koodin kirjoittaja, tai öinen vienti, jota kirjanpito käyttää hiljaisuudessa.
Siksi järkevä järjestys on intuition vastainen. Ei aloiteta uuden koodin kirjoittamisesta eikä edes hinta-arviosta. Aloitetaan kartasta.
Mitä AI kaivaa esiin koodista, tietokannasta ja lokeista
Nykyaikaiset analyysityökalut osaavat lukea kolmea totuuden lähdettä järjestelmästä: lähdekoodia, tietokannan rakennetta ja tuotantokäytön lokeja. Niiden ristiinajosta syntyy järjestelmäkartta, jossa on neljä kerrosta.
Ensimmäinen on moduulit: mistä järjestelmä koostuu ja mistä kukin osa vastaa, kuvattuna kielellä, jota myös IT:n ulkopuoliset ymmärtävät. Toinen on tietovirrat: mistä data tulee sisään, mitä sille matkalla tapahtuu, mihin se päätyy. Kolmas on integraatiot eli kaikki kohdat, joissa sovellus keskustelee muiden järjestelmien kanssa: kirjanpidon, varaston, verkkokaupan, kumppanien. Juuri ne hajoavat muutoksissa useimmin.
Neljäs kerros on vähiten ilmeinen: kuollut koodi. Lokianalyysi näyttää, mitä funktioita ei ole kutsuttu vuosiin ja mihin tauluihin kukaan ei ole kirjoittanut vuoden 2019 jälkeen. Vanhemmissa järjestelmissä tällainen painolasti on usein merkittävä osa kokonaisuudesta. Jokainen rivi, jota ei tarvitse siirtää, on todellista säästöä projektissa.
Mitä kartta muuttaa päätöksessä ”kirjoittaa uusiksi vai modernisoida”
Itse päätöksestä kirjoitimme erikseen, tekstissä neljästä kriteeristä: päätöskehikko. Järjestelmäkartta antaa näille kriteereille kovaa dataa. Ilman sitä tekninen velka arvioidaan mutulla ja riskit anekdoottien varassa. Sen kanssa näkyy mustaa valkoisella: mitkä moduulit kantavat liiketoiminta-arvoa, mitkä ovat kuolleita, missä istuvat integraatiot, jotka nostavat jokaisen muutoksen riskiä.
Tulokset yllättävät molempiin suuntiin. Joskus järjestelmä, joka ”on kirjoitettava alusta uusiksi”, osoittautuu kolmelta neljäsosaltaan terveeksi, ja riittää vaihtaa kaksi moduulia. Joskus päinvastoin: sovellus näyttää viattomalta, mutta kartta paljastaa toistakymmentä dokumentoimatonta kytköstä, jotka tekevät osittaisesta modernisoinnista kalliimman kuin uudelleenkirjoituksesta. Kummassakin tapauksessa päätös syntyy datan, ei tunteiden pohjalta. Ja toimittaja, joka saa kartan arvoituksen sijaan, hinnoittelee työn eikä riskiä.
Meidän näkemyksemme mukaan kartan rekonstruointi kannattaa sopia modernisointisopimuksen erilliseksi ensimmäiseksi vaiheeksi, jolla on oma hyväksyntänsä. Vaikka päättäisit sen jälkeen, että modernisoinnin tekee joku muu tai ettet tee sitä lainkaan, dokumentaatio jää yritykseen ja jatkaa työtään.
Miten AI:n tuottama aineisto varmennetaan
Automaattisesti tuotettu dokumentaatio ei ole oraakkeli. Se on tarkastettava. Tehokkain menetelmä on yksinkertainen: läpikäynti sen henkilön kanssa, joka tuntee järjestelmän parhaiten, usein ainoan sellaisen koko yrityksessä. Ero perinteiseen lähestymistapaan on tämän henkilön roolissa. Et pyydä häntä kirjoittamaan tietämystään ylös, mistä kukaan ei pidä ja mikä venyy kuukausiksi. Pyydät arvioimaan valmiin kuvauksen, ja ”tämä pitää paikkansa, tämä ei” -osoittaminen käy moninkertaisesti nopeammin kuin kirjoittaminen tyhjästä.
Hyvä käytäntö on kulkea muutama tärkein prosessi läpi alusta loppuun: tilaus, lasku, reklamaatio. Jos kartta kuvaa kriittiset virrat oikein ja pistokokein tarkastetut yksityiskohdat täsmäävät, siihen voi luottaa muillakin alueilla. Sen ehtii tehdä päivässä.
Mitä AI ei pysty rekonstruoimaan
Tässä rehellinen varaus: koodi kertoo, mitä järjestelmä tekee, mutta ei kerro miksi. Outo poikkeus alennuksen laskennassa voi olla virhe, tai se voi olla vuoden 2016 kaupallinen sopimus, joka pätee edelleen yhteen suureen asiakkaaseen. Sitä ei mikään koodianalyysi ratkaise. Vuosikymmenen takaiset liiketoiminnan aikomukset rekonstruoidaan haastatteluilla: lyhyillä keskusteluilla myynnin, kirjanpidon ja operatiivisen puolen ihmisten kanssa, kartta jo kädessä. Kartta vihjaa, mitä kysyä, mutta vastaukset ovat ihmisellä.
Oma lukunsa on myös sovelluksen ympäristö: palvelimet, verkko, varmuuskopiot. Tämän kerroksen dokumentoinnista kirjoitimme tekstissä infrastruktuuridokumentaation auditoinnista.
ESKOM AI:lla vedämme kartoitusvaiheen erikoistuneiden AI-agenttien tiimillä kokeneiden insinöörien valvonnassa: tyypillisen yritysjärjestelmän analyysi vie työpäiviä, ja tuloksena on dokumentaatio, joka on luettavaa sekä johdolle että tekniselle tiimille. Jos sen jälkeen syntyy päätös modernisoinnista, jatkotyöt etenevät automatisoidussa ohjelmistokehitysprosessissa täydellä testien kirjolla — yksikkö-, integraatio-, E2E-, UI-, tietoturva- ja suorituskykytestit.
Mistä aloittaa omassa yrityksessä
Valitse yksi järjestelmä: se, jonka modernisointia olet lykännyt pisimpään tai johon pelkäät eniten koskea. Tilaa sen kartan rekonstruointi itsenäisenä, pienenä vaiheena, ennen kuin pyydät keneltäkään tarjousta uudistuksesta. Maksuttomassa konsultaatiossa neuvomme, miten tällainen vaihe suunnitellaan ja mitä siltä voi odottaa.
Varaa maksuton konsultaatio yhteydenottolomakkeella →