📊 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ä.