đ Teknisen laadun visualisointi Repostage-dashboardilla¶
Tehokas visualisointi muuttaa raa'an analyysidatan (JSON/XML) toiminnalliseksi tiedoksi. Repostagessa tÀmÀ toteutetaan kolmella tasolla: OrganisaationÀkymÀ, Projektikohtainen nÀkymÀ ja Drift-analyysi.
đ 1. Liikennevalomalli (Health Score)¶
Yksinkertaisin ja tehokkain tapa visualisoida laatu suuressa mÀÀrÀssÀ projekteja on aggregoida eri mittarit yhdeksi "terveysindeksiksi".
- VihreÀ: Kaikki laatuportit lÀpÀisty (Testikattavuus > 80 %, ei kriittisiÀ haavoittuvuuksia, dokumentaatio ajan tasalla).
- Keltainen: PieniÀ puutteita tai tekninen velka kasvamassa.
- Punainen: KriittisiÀ poikkeamia standardeista tai epÀonnistuneita tietoturvaskannauksia.
đ 2. Mittaristot (Metrics Dashboard)¶
Repostage voi visualisoida teknisen laadun trendejÀ, jotka se lukee CI/CD-putkien tuottamista artefakteista:
| Mittari | Visualisointitapa | MitÀ se kertoo? |
|---|---|---|
| Testikattavuus | Palkkikaavio (Trending over time) | Onko laatu pysyvÀÀ vai heikkeneekö se uusien ominaisuuksien myötÀ? |
| Koodin monimutkaisuus | LÀmpökartta (Heatmap) | MitkÀ osat jÀrjestelmÀstÀ ovat muuttumassa vaikeasti yllÀpidettÀviksi? |
| Haavoittuvuudet | Pinottu pylvÀskaavio (Critical/High/Med) | Organisaation tietoturvariski yhdellÀ silmÀyksellÀ. |
| Dokumentaation kattavuus | Edistymispalkki (%) | Onko projektista kirjoitettu vaaditut arkkitehtuurikuvaukset ja ADR:t? |
đ 3. Architecture & Code Drift -visualisointi¶
TÀmÀ on Repostagen uniikki ominaisuus. Se vertaa projektin nykytilaa (mitÀ koodista löytyy) ja tavoitetilaa (mitÀ Templatessa on mÀÀritelty).
- Visualisointi: "Tutka-kaavio" (Radar Chart), joka vertaa projektia organisaation "Kultaiseen standardiin".
- KÀyttökohde: Jos projekti poikkeaa sovitusta kansiorakenteesta tai kÀyttÀÀ kiellettyjÀ kirjastoja, se nousee esiin poikkeamana.
đ ïž Tekninen toteutus Repostagessa¶
Jotta visualisoinnit toimivat, Repostage hyödyntÀÀ seuraavaa ketjua: 1. Datan keruu: CI/CD-putki tuottaa raportin (esim. quality-report.json). 2. Metadata-rikastettu Markdown: Repostage lukee raportin ja kÀyttÀÀ laajennuksia (kuten Mermaid.js tai Vega-Lite) kaavioiden piirtÀmiseen suoraan portaalissa. 3. Aggregointi: Repostage-moottori laskee keskiarvot ja trendit kaikkien projektien yli.
đĄ Miksi tĂ€mĂ€ on tehokasta?¶
- Ei "Dashboard Fatigue" -ilmiötÀ: Tiedot ovat siellÀ, missÀ dokumentaatiokin. Sinun ei tarvitse avata erillistÀ työkalua nÀhdÀksesi koodin laadun.
- Konteksti: NÀet koodin laaturaportin vieressÀ arkkitehtuurikuvauksen, joka selittÀÀ, miksi ratkaisu on tehty tietyllÀ tavalla.
- Toiminnallisuus: Raporteista on suorat linkit koodiin tai tiketteihin, jotka korjaavat löydetyn ongelman.
Tehokas visualisointi Repostagessa ei siis vain nÀytÀ numeroita, vaan se kertoo tarinan projektin terveydentilasta ja auttaa tekemÀÀn parempia pÀÀtöksiÀ.