🛡️ Hallintastandardi¶

Governance Framework & Documentation Architecture¶

Tämä dokumentti määrittelee ekosysteemin hallintamallin, dokumentaation rakenteen ja automaatiota tukevat periaatteet. Standardin tavoitteena on varmistaa tiedon eheys, projektien hallittavuus ja automaation luotettava toiminta koko ekosysteemin elinkaaren ajan.

Hallintamalli ei ole vain dokumentaatiota varten, vaan se toimii aktiivisena ohjausmekanismina: projektien tila, laatu ja näkyvyys määräytyvät sen mukaan, kuinka hyvin ne noudattavat tässä kuvattuja sääntöjä.

Hallinnan perusperiaatteet¶

• Projektit luokitellaan strategisen merkityksen ja elinkaaren mukaan
• Dokumentaation vaatimustaso kasvaa projektin kriittisyyden mukana
• Automaation rooli kehittyy sallivasta valvovaan
• Vakioidut pohjat toimivat automaation syötteenä, eivät pelkkinä muistiinpanoina

Strategiset tasot ja hallintamalli¶

Ekosysteemi jakautuu kolmeen strategiseen tasoon. Tämä luokitus määrittelee projektin elinkaaren, vaatimustason ja automaation tarkkuuden.

1. Innovaatiotaso: Exploration & Research (01-02)¶

Fokus: Uuden oppiminen, konseptointi ja tekniset kokeilut.

• Prefixit: study-, lab-

• Elinkaari: Lyhyt tai avoin. Projekti voidaan päättää heti, kun oppimistavoite on saavutettu.

• Vaatimustaso: Matala. Dokumentaatio keskittyy havaintoihin, kokeiluihin ja muistiinpanoihin.

• Automaation rooli: API-tieto toimii automaation syötteenä kokeiluprojektien ja opiskeltujen teknologioiden tunnistamisessa. README.md-metadatan avulla täydennetään projektin kuvaus ja konteksti.

2. Suoritustaso: Solutions & Tooling (03-05)¶

Fokus: Konkreettiset ratkaisut, työkalut ja loppukäyttäjäsovellukset.

• Prefixit: project-, tool-, app-

• Elinkaari: Hallittu eteneminen prototyypistä vakaaseen ratkaisuun (state-prototype) → (state-stable).

• Vaatimustaso: Keskitaso. Vaatii Universal README -mallin ja aktiivisen tehtävien hallinnan.

• Automaation rooli: Seuraa tehtävien etenemistä ja projektin tilaa. Metadata varmistaa, että työkalu löytyy portaalin hausta oikeilla tageilla.

3. Ydintasotaso: Core Platform & Infrastructure (06-07)¶

Fokus: Ekosysteemin infrastruktuuri, automaatiomoottorit ja konfiguraatiot.

• Prefixit: infra-, config-, engine-

• Elinkaari: Pitkäikäinen, jatkuvasti ylläpidetty ja kriittinen muiden projektien toiminnalle.

• Vaatimustaso: Kriittinen. Täysi Scrum-malli (Backlog, Sprintit, Definition of Done) ja tiukka versionhallinta ovat pakollisia.

• Automaation rooli: validator.py toimii migraatiotyökaluna vanhojen projektien siirrossa tuotantoon. Se valvoo laatukriteereitä ja nimeämisstandardeja ja voi estää projektin julkaisemisen portaaliin.

Pohjien merkitys ja käyttölogiikka¶

Vakioidut pohjat eivät ole vain muistiinpanoja, vaan hallintajärjestelmän koneisto. Ne skaalautuvat projektin koon mukaan:

Skaalautuva hallintamalli¶

• Laajat kehityskokonaisuudet: Scrum-malli (Backlog, Sprints, DoD) ohjaa kehitystä. README tarjoaa portaalin perustiedot, kun taas GitLab Pages hallitsee teknistä dokumentaatiota ja prosessien kuvauksia valmiiden pohjien avulla.

• Suppeat projektit (Micro Flow): Käytetään universal README -mallia. Kaikki hallinnollinen tieto (metadata, tehtävät, pikaohje) keskitetään yhteen tiedostoon dokumentaatiotaakan minimoimiseksi.

• Automaatiokerros: Python-pohjainen automaatio tunnistaa projektien teknologiapinon ja visualisoi sen suoraan portaalissa, varmistaen teknisen läpinäkyvyyden läpi koko ekosysteemin.

🏷️ Nimeäminen ja Metadata Control¶

Hallintajärjestelmä perustuu tiukkaan nimeämislogiikkaan, joka mahdollistaa automaattisen indeksoinnin:

• Nimeäminen: kebab-case (esim. tool-python-api) varmistaa teknisen yhteensopivuuden.
• Metadata (Tags): Mahdollistaa projektien suodattamisen osaamistason (level-100...level-400) ja tilan (state-prototype...state-production) mukaan.

Tavoite: Muuttaa hajanainen tiedostoarkisto hallituksi ja mitattavaksi asiantuntijaekosysteemiksi.

Dokumentin tila: Luonnos — Pvm: 11.01.2026