📂 Projektinäkymä: kehitys¶

Projektit-välilehden informaation ja -arkkitehtuurin kehittymisen suuntaviivat¶

Projektit-välilehti on Repostagen "ohjaamo". Se ei ole vain lista linkkejä, vaan dynaaminen koontinäyttö, joka aggregoi dataa jokaisesta järjestelmään kytketystä repositoriosta.

🏗️ 1. Välilehden päärakenne (Layout)¶

Välilehti on jaettu kolmeen tasoon, jotka palvelevat eri käyttäjäryhmiä (kehittäjät, arkkitehdit, johto).

A. Suodattimet ja haku (Search & Discovery)¶

• Haku: Tekstihaku projektin nimen, teknologioiden (esim. Python, React) tai omistajan mukaan.
• Kategoriat: Suodatus statuksen mukaan (Tuotannossa, Kehityksessä, Arkistoitu) tai kriittisyyden mukaan.
• Tägit: Esim. #microservice, #frontend, #pci-dss, #sox.

B. Projektikortit (Project Cards)¶

Jokainen projekti esitetään korttina, joka sisältää kriittisen informaation yhdellä silmäyksellä:

📊 2. Tuotettava informaatio (Data points)¶

Repostage kerää jokaisesta projektista seuraavat tiedot projektikohtaiseen analyysiin:

🛠️ Tekninen syvyys (Engineering Insights)¶

• Koodin laatu: SonarQube-arvosanat, testikattavuus (%) ja tekninen velka (päivinä).
• Stack-analyysi: Mitä kieliä ja versioita projekti käyttää (esim. Java 17, Node.js 20).
• Pipeline Status: Viimeisimmän buildin tila ja onnistumisprosentti.

🛡️ Turvallisuus (Security Insights)¶

• Vulnerability Count: Kriittiset ja korkean riskin haavoittuvuudet.
• Policy Compliance: Noudattaako projekti organisaation "Kultaista sääntöä" (esim. onko uhkamallinnus tehty).
• Dependencies: Lista vanhentuneista tai kielletyistä kirjastoista.

📖 Dokumentaation laatu (Knowledge Health)¶

• ADR Count: Kuinka monta arkkitehtuuripäätöstä on kirjattu viimeisen 6 kk aikana.
• Staleness: Milloin dokumentaatiota on viimeksi päivitetty suhteessa koodimuutoksiin.
• Structure Check: Löytyykö pakolliset osiot (Arkkitehtuuri, API-kuvaus, Deployment).

🔍 3. Drift-analyysin esittäminen (The "Drift" View)¶

Projektit-välilehdellä on erillinen näkymä tai ikoni poikkeamille: * Architecture Drift: Jos koodi on muuttunut, mutta arkkitehtuurikuvaan ei ole koskettu, korttiin ilmestyy varoituskolmio ⚠️. * Template Drift: Jos projektin rakenne on eriytynyt liikaa alkuperäisestä Repostage-templatesta, järjestelmä ehdottaa synkronointia.

🤖 4. AI-avustettu yhteenveto (Executive Summary)¶

Välilehden ylälaidassa on AI-generoitu tiivistelmä koko portfoliosta:

AI Summary: "Organisaation 45 projektista 42 on vihreällä. Kolmessa projektissa (Payment-Service, Auth-API, Data-Sync) havaittu teknisen velan kasvua ja vanhentuneita tietoturvakirjastoja. Suositus: Kohdista sprintin 04 resurssit näiden korjaamiseen."

💡 Miksi tämä on tärkeää?¶

1. Läpinäkyvyys: Kukaan ei voi enää sanoa "en tiennyt, että tämä projekti on vaarassa".
2. Tehokkuus: Uusi kehittäjä löytää oikean projektin ja sen dokumentaation sekunneissa.
3. Hallinta: Arkkitehdit näkevät välittömästi, missä projektit alkavat poiketa sovitusta linjasta.

Projektit-välilehti tekee hajautetusta koodimassasta hallittavan, visuaalisen ja mitattavan kokonaisuuden.