VeraFrame — prosessi- ja datavirtadokumentaatio

Näyte on jäätynyt tilannekuva 2026-08-12, lähdekoodin commit 944016d. Elävä dokumentaatio päivittyy koodin mukana — tämä ei.

Tämä on näyte

Tässä on yksi moduuli 19:stä VeraFramen dokumentaatiosta: tilaukset ja laskutus. Näyte on tuotettu vnetcon-docs-menetelmällä ja se on aitoa tuotosta — ei esittelyversiota. Muut moduulit on jätetty pois, joten linkit niihin näkyvät muodossa (ei näytteessä).

Huomaa dokumenteissa kolme asiaa: lahteet-kentässä ne koodipolut joista kuvaus on johdettu, git-viite joka kertoo mistä committista, ja tila: luonnos niissä dokumenteissa joita ei ole vielä tarkistettu. Neljä 16:sta on luonnos — työkalu merkitsee epävarmuutensa eikä esitä kaikkea varmana.

Menetelmä on avointa lähdekoodia: https://github.com/vnetcon/vnetcon-docs

Johdanto

VeraFrame on EU:ssa hostattu verifiointikerros tekoälyn tuottamalle sisällölle. Se ei yritä kontrolloida mallia, vaan validoi mallin tuottaman tekstin, dokumentin tai JSON-vastauksen organisaation omaa, rajattua lähdeaineistoa vasten ja tuottaa korjattavan luottamusraportin: mitä voi käyttää sellaisenaan ja mitä on korjattava. Tarkistus on deterministinen — todiste, täydellisyys, numerot ja ristiriidat ratkaistaan koodilla, ei mallilla, koska juuri se tekee tuloksesta auditoitavan.

Neljä käyttötapaa: dokumentin generointi, chatbot-vastauksen audit, kysymys lähdeaineistoa vasten ja REST/JSON-integraatio. Sama sovelluskoodi ajetaan selainpohjaisena työkaluna, asiakkaan integraatiorajapintana ja monitenanttina SaaS-palveluna (VeraFrame Cloud).

Tämä on VeraFramen prosessi- ja datavirtadokumentaatio: liiketoimintaprosessit (mitä substanssin kannalta tapahtuu), järjestelmäprosessit (miten asia kulkee moduulien läpi), moduulien prosessit (yhden moduulin sisälogiikka) ja datavirrat (mikä data ja mikä rakenne missäkin kohtaa on käytössä).

Kenelle

• Substanssiosaaja → aloita Liiketoimintaprosesseista. Ei-tekninen kuvaus, josta pääset poraamaan tarkempiin teknisiin kohtiin.
• Kehittäjä → Moduulit sisältää yleiskuvauksen, prosessit, datavirrat ja datarakenteet, sekä linkit lähdekoodiin.

Sama dokumentaatio toimii kontekstipohjana, kun muutoksia toteutetaan tekoälyavusteisesti.

Kaksi asiaa jotka on hyvä tietää heti

1. HTTP-reitit eivät ole koodissa. Reittitaulu on deployment/template.yaml:n Events-lohkoissa; koodin puolella reititys on merkkijonovertailua.
2. Repossa on kuolleita sukupolvia (infra/ sekä lambdat cleanup, history, targets). Ne on rajattu dokumentaation ulkopuolelle — ne kuvaavat rakennetta, jota ei ole deployattu.

Asiakkaille suunnattu käyttöohjeistus on erillinen ja löytyy hakemistosta docs-site/ (en + fi).

Moduulit

Liiketoimintaprosessit

• Cloud-tilauksen elinkaari

Dokumentaation tuottaminen

Miten dokumentaatio syntyy ja pysyy ajan tasalla: menettely, mallipohjat ja tiketit — ks. vasemman palkin osio Dokumentaation tuottaminen.