Kalibrointiraportti — VeraFrame

Luotu 2026-08-12 · vnetcon-docs · lähde: git ls-files · HEAD 944016d

Tämä raportti kertoo, kuinka hyvin geneerinen vnetcon-docs osuu tähän projektiin ja mikä jää katveeseen. Se on luotu koneellisesti, ilman tekoälyagenttia.

Tietosisältö: raportissa on hakemisto- ja moduulinimiä, tiedostomääriä ja osumalukuja. Ei koodia eikä tiedostojen sisältöä. Raportti on tarkoitettu myös lähetettäväksi eteenpäin — lue se silti läpi ennen kuin lähetät.

Yhteenveto

Asia	Tila
Käyttöönotto tehty	kyllä
Kartoitus kalibroitu tähän projektiin	kyllä
Moduuleja	19 (lähde: tila/rekisteri.yaml)
Dokumentoitu	5 / 19
Dokumentteja	87
Avoimia TODO-merkintöjä	11
Lähdepolkuja jotka eivät löydy	0

Löydökset

🟡 varoitus — Testikomento

Testikomentoa ei voitu päätellä.

Toimenpide: Kirjaa se tila/projekti.yaml → komennot.testi; tiketin toteutus tarvitsee sitä.

✅ käsitelty — Kartoitus: HTTP-reitit / endpointit

Ei osumia (http-reitit), mutta alue on tutkittu ja kirjattu kartoitukseen: "kyllä".

Toimenpide: Ei toimenpiteitä. Tarkista uudelleen vain jos koodi on muuttunut niin, että kirjattu päätelmä ei enää pidä.

✅ käsitelty — Kartoitus: Tietokantamigraatiot / skeema

Ei osumia (migraatiot), mutta alue on tutkittu ja kirjattu kartoitukseen: "ei relaatiomigraatioita".

Toimenpide: Ei toimenpiteitä. Tarkista uudelleen vain jos koodi on muuttunut niin, että kirjattu päätelmä ei enää pidä.

✅ käsitelty — Skeemalähteet

Koneluettavia skeemalähteitä ei löytynyt, ja asia on kirjattu kartoitukseen: "ei".

Toimenpide: Ei toimenpiteitä. Muista silti, että datamallit on kirjoitettava koodista lukemalla ja merkittävä tila: luonnos kunnes tarkistettu.

Vakavuusluokat. 🔴 esto = dokumentointi ei tuota luotettavaa jälkeä ennen korjausta. 🟡 varoitus = toimii, mutta laatu tai ajantasaisuus kärsii. ⚪ katve = geneeriset haut eivät nähneet aluetta; voi olla myös oikea tulos (aluetta ei ole). ✅ käsitelty = katve on tutkittu ja päätelmä kirjattu metodi/kartoitus.md:n Katvealueet-taulukkoon — ei toimenpiteitä. Käsitellyt näkyvät edelleen, koska hiljainen katoaminen olisi vastoin sitä periaatetta, että katve sanotaan ääneen.

Projektin laajuus

Tiedostoja: 381 (koodia 163)
Koodirivejä: 62 134 (skannattu 163 tiedostoa)

Kielet

Pääte	Tiedostoja
`py`	104
`sh`	24
`tsx`	19
`ts`	11
`js`	3
`mjs`	1
`cjs`	1

Moduulit (rekisteri)

Virallinen jako on tila/rekisteri.yaml. Koodirivit on kohdistettu moduulin tiedostot-listan mukaan, tai sen puuttuessa polkun mukaan.

Moduuli	Polku	Tyyppi	Koodirivejä	Tila
`verifiointiydin`	`backend/lambdas/generate` (4 kohdetta)	python	2 093	valmis
`lahdehaku`	`backend/lambdas/generate` (9 kohdetta)	python	3 231	valmis
`lahdeaineisto`	`backend/lambdas/generate` (8 kohdetta)	python	3 645	valmis
`mallikutsut`	`backend/lambdas/generate` (2 kohdetta)	python	2 136	valmis
`tyokalu-orkestrointi`	`backend/lambdas/generate` (3 kohdetta)	python	3 737	tekematta
`integraatio-api`	`backend/lambdas/generate` (2 kohdetta)	python	1 604	tekematta
`dokumenttipohjat`	`backend/lambdas/generate` (2 kohdetta)	python	1 219	tekematta
`tukichat`	`backend/lambdas/generate` (3 kohdetta)	python	427	tekematta
`tunnistautuminen`	`backend/lambdas/generate` (2 kohdetta)	python	758	tekematta
`tilaukset-laskutus`	`backend/lambdas/generate` (3 kohdetta)	python	1 811	valmis
`tallennus`	`backend/lambdas/generate` (7 kohdetta)	python	2 648	tekematta
`compliance`	`backend/lambdas/generate` (2 kohdetta)	python	127	tekematta
`tyokalu-ui`	`frontend/src` (14 kohdetta)	react-ts	10 425	tekematta
`hallintapaneeli`	`frontend/src/components` (2 kohdetta)	react-ts	3 988	tekematta
`julkisivu`	`frontend` (16 kohdetta)	react-ts	3 609	tekematta
`infrastruktuuri`	`deployment` (11 kohdetta)	sam-yaml	1 225	tekematta
`operointiskriptit`	`scripts` (18 kohdetta)	bash-python	2 708	tekematta
`laatuportit`	`backend/tests` (6 kohdetta)	python	12 066	tekematta
`dokumentaatiosivusto`	`docs-site` (8 kohdetta)	astro-starlight	85	tekematta
`infra-cdk`	`infra` (2 kohdetta)	python	334	rajattu-pois
`lambdat-legacy`	`backend/lambdas` (3 kohdetta)	python	153	rajattu-pois
`vanha-html-dokumentaatio`	`doc-en` (2 kohdetta)	html	2 347	rajattu-pois
`juuritason-spesifikaatiot`	`.` (25 kohdetta)	markdown	—	rajattu-pois
`myynti-ja-demoaineisto`	`pitch` (9 kohdetta)	aineisto	1 717	rajattu-pois

Rekisterin ulkopuolelle jäävä koodi

Ei mitään — rekisteri kattaa kaiken löydetyn koodin.

Kartoituksen osumat

Kukin rivi on geneerinen haku. Nolla osumaa tarkoittaa joko sitä, ettei aluetta ole, tai sitä että se on toteutettu tavalla jota haku ei tunnista — ja jälkimmäinen on se tapaus, joka tuottaa vaillinaista dokumentaatiota huomaamatta.

Alue	Tiedostoja	Moduuleissa
HTTP-reitit / endpointit	0	0
Viestijonot / tapahtumat	1	1
Ajastetut ajot	1	1
Tietokantakäsittely	13	4
Tietokantamigraatiot / skeema	0	0
Ulkoiset HTTP-kutsut	16	5
Validointi- ja skeemamäärittelyt (datan muoto)	3	3
Ympäristö- ja konfiguraatioarvot	37	5
Käynnistyspisteet (main / CLI)	15	4
Serverless-funktiot	10	3

Skeemalähteet (datamallien perusta)

Ei löytynyt.

Testaus ja build

Testikomento: ei pääteltävissä
Build: —
CI-konfiguraatio: —
Ajoskriptit: —

Olemassa oleva dokumentaatio

README.md
doc/architecture.html
doc/backend.html
doc/data-flow.html
doc/deployment.html
doc/frontend.html
doc/index.html
doc/saas.html

Näihin linkitetään, niitä ei duplikoida.

Dokumentaation tila

Mittari	Arvo
Dokumentteja	87
— valmis / luonnos / vanhentunut	25 / 62 / 0
Avoimia TODO-merkintöjä	11
Lähdepolkuja	396
— joita ei enää löydy	0
Synkronoinnin lähtötaso	944016d (0 committia jäljessä)

Laajuusarvio jäljellä olevalle työlle

Karkea arvio, perusta: toteutuneet ajot — ~0.39 h agenttiaikaa ja ~$9.2 tokenikulutusta per 1 000 koodiriviä.

Dokumentoimattomia moduuleja: 14 (44 626 koodiriviä)
Arvioitu dokumenttimäärä: 84–280
Arvioitu agenttiaika: 10.4–24.4 h
Arvioitu AI-kustannus: $246–575 omalla AI-tililläsi
Arvioitu tokenikulutus: 2.1–4.9 M tokenia (moduulimäärästä, ei rivipainotettu)

Kokonaissumma peittää sen, että moduulit ovat eri kokoisia. Priorisointi ja osa-alue kerrallaan myyminen tapahtuvat tällä tasolla:

Moduuli	Koodirivejä	Agenttiaika	AI-kustannus
`laatuportit`	12 066	4.7 h	$111
`tyokalu-ui`	10 425	4.1 h	$96
`hallintapaneeli`	3 988	1.6 h	$37
`tyokalu-orkestrointi`	3 737	1.5 h	$34
`julkisivu`	3 609	1.4 h	$33
`operointiskriptit`	2 708	1.1 h	$25
`tallennus`	2 648	1 h	$24
`integraatio-api`	1 604	0.6 h	$15
`infrastruktuuri`	1 225	0.5 h	$11
`dokumenttipohjat`	1 219	0.5 h	$11
`tunnistautuminen`	758	0.3 h	$7
`tukichat`	427	0.2 h	$4
`compliance`	127	<0,1 h	$1
`dokumentaatiosivusto`	85	<0,1 h	$1

⚠️ Arvio ei sisällä sitä osaa, joka ratkaisee lopputuloksen laadun: substanssiosaajan validointiaikaa ja TODO-kysymysten läpikäyntiä. Agenttiaika ja AI-kustannus ovat koneen osuus; ne ovat mitattuja ja pieniä. Ihmisen osuutta ei voi arvioida koneellisesti — se selviää vain käymällä ensimmäisen moduulin dokumentit läpi ja mittaamalla.

Aika- ja kustannuskertoimet ovat yhdestä mitatusta projektista. Kalibroi ne omiin ajoihisi: vnetcon.config.yaml → arvio.tunnit_per_moduuli ja arvio.usd_per_moduuli. Kustannus laskettiin sillä mallilla, jolla mittaus tehtiin — halvempi malli aliagenteille pudottaa sitä olennaisesti (ks. metodi/agentit.md).

Mitä tämä raportti ei kerro

Onko dokumentaatio sisällöllisesti oikein. Osumaluvut kertovat kattavuudesta, eivät totuudenmukaisuudesta. Sen näkee vain lukemalla dokumentit koodia vasten.
Onko moduulijako mielekäs. Kone päättelee sen manifesteista; oikea jako on domain-kysymys.
Mitkä TODO-merkinnät ovat tärkeitä. Substanssikysymys ja tekninen epävarmuus näyttävät tässä samalta.

Miten katveet korjataan

Kaikki projektikohtainen kalibrointi kuuluu laajennuspisteisiin — ei moottoriin, jotta paketti pysyy päivitettävänä. Ks. metodi/laajennuspisteet.md.

Tämän voi tehdä itse: kirjoita puuttuvat haut metodi/kartoitus.md:hen, vahvista moduulijako tila/rekisteri.yaml:iin ja aja kalibrointi uudelleen. Jos kalibrointi kannattaa ostaa, tämä raportti riittää tarjouksen pohjaksi sellaisenaan — koodia ei tarvitse luovuttaa.

Aja uudelleen: node tyokalut/kalibroi.mjs · konedata: tila/kalibrointi.json