Projektinäkymän kehitys ja informaatioarkkitehtuuri¶
Projektit-näkymä toimii RepoDock-ekosysteemin operatiivisena ohjaamona. Se ei ole vain luettelo linkkejä, vaan dynaaminen koontinäyttö, joka aggregoi reaaliaikaista dataa jokaisesta järjestelmään kytketystä repositoriosta.
1. Rakenteellinen jaottelu (Layout)¶
Näkymä on jaettu kolmeen tasoon, jotka palvelevat kehittäjiä, arkkitehteja ja johtoa:
Haku ja suodatus (Discovery)¶
- Tekstihaku: Haku nimen, teknologioiden (esim. Python, React) tai omistajan perusteella.
- Kategoriasuodatus: Luokittelu statuksen (Tuotannossa, Kehityksessä, Arkistoitu) tai kriittisyyden mukaan.
- Taksonomiatägit: Esimerkiksi
#microservice,#frontend,#pci-dss.
Projektikortit (Project Cards)¶
Jokainen projekti esitetään korttina, joka tiivistää projektin terveyden ilman tarvetta siirtyä repositorion sisään:
| Informaatioryhmä | Sisältö | Indikaattori |
|---|---|---|
| Identiteetti | Nimi, kuvaus, tiimi. | Tekstuaalinen metadata. |
| Health Score | Laadun ja turvallisuuden kokonaisarvo. | Liikennevalovärit (Punainen, Keltainen, Vihreä). |
| Security Status | Haavoittuvuudet ja säädöstenmukaisuus. | Numeerinen riskitaso. |
| Docs Maturity | Dokumentaation kattavuusaste. | Prosentuaalinen edistymispalkki. |
| Lähde | Alkuperäinen sijainti. | Lähdejärjestelmän nimi (GitHub/GitLab). |
2. Datalähteet ja analyysipisteet¶
Automaatiomoottori kerää jokaisesta projektista seuraavat syväanalyysitiedot:
Tekninen analyysi¶
- Koodin laatu: Testikattavuus (%) ja tekninen velka laskettuna päivissä.
- Teknologiapino: Käytetyt kielet ja kirjastoversiot (esim. Java 17, Node.js 20).
- CI/CD Status: Viimeisimmän ajon tila ja onnistumisprosentti.
Tietoturva ja vaatimustenmukaisuus¶
- Riskianalyysi: Kriittiset haavoittuvuudet ja vanhentuneet riippuvuudet.
- Standardien noudattaminen: Tarkistus, onko pakolliset vaiheet (kuten uhkamallinnus) suoritettu.
Dokumentaation terveys¶
- Päätöksenteko: ADR-merkintöjen (Architecture Decision Record) määrä ja tuoreus.
- Ajantasaisuus: Dokumentaation päivitysväli suhteessa koodimuutosten intensiteettiin.
3. Poikkeama-analyysi (Drift Management)¶
Järjestelmä valvoo automaattisesti projektien eriytymistä määritellyistä standardeista:
graph TD
A[Projektin nykytila] --> B{Vertailu standardiin}
B -- Poikkeama havaittu --> C[Architecture Drift]
B -- Rakenne muuttunut --> D[Template Drift]
C --> E[Varoitus kortissa]
D --> F[Synkronointiehdotus]4. AI-avustettu yhteenveto (Executive Summary)¶
Näkymän yläosaan generoidaan automaattinen tiivistelmä koko portfolion tilasta:
Esimerkki: Organisaation 45 projektista 42 on vihreällä tasolla. Kolmessa projektissa on havaittu teknisen velan kasvua ja vanhentuneita tietoturvakirjastoja. Suositus: Kohdista seuraavan sprintin resurssit näiden korjaamiseen.
Strateginen merkitys¶
Läpinäkyvyys: Poistaa epätietoisuuden projektien todellisesta tilasta ja riskeistä.
Perehdytys: Uudet kehittäjät löytävät tarvittavan tiedon ja dokumentaation välittömästi.
Arkkitehtuurin hallinta: Mahdollistaa välittömän reagoinnin, kun projektit poikkeavat sovitusta linjasta.
Dokumentin tila: Luonnos — Päivitetty: 13.01.2026