🎨 Hallintateemat ja Standardipohjat¶

RepoDock-ekosysteemi perustuu loogisiin teemoihin ja vakioituihin pohjiin, jotka mahdollistavat datalähtöisen projektinhallinnan ja automaation.

🏛️ Projektiteemat (Strategic Themes)¶

Teemat jakavat repositoriot kolmeen pääluokkaan niiden elinkaaren mukaan:

Learning & Research (study-, lab-)
Tarkoitus: Teorian haltuunotto ja tekniset kokeilut.
Solutions & Development (project-, tool-)
Tarkoitus: Käytännön työkalujen ja ohjelmistojen rakentaminen.
Platform & Architecture (infra-, config-, engine-)
Tarkoitus: Käyttöjärjestelmien, automaation ja infrastruktuurin hallinta.

🔄 Käyttölogiikka: Laajat vs. Suppeat kokonaisuudet¶

RepoDock skaalautuu projektin koon mukaan. Valitse hallintatapa työmäärän ja kriittisyyden perusteella:

A. Laajat kehityskokonaisuudet (Full Scrum Flow)¶

Käytetään, kun kyseessä on useita viikkoja kestävä kehitys, monimutkainen arkkitehtuuri tai state-production tavoite. * README.md: Toimii porttina ja "käyttöliittymänä". Sisältää asennusohjeet, hyvät ohjelmistokehityksen käytänteet ja teknisen yleiskuvan. * Scrum-vakiopohja: Käytetään täyttä scrum/-kansiorakennetta. Kaikki tehtävät, epicit ja milestonet dokumentoidaan backlog.md-tiedostoon. * Automaatio: Python-moottori seuraa sprinttien etenemistä ja DoD-kriteerien täyttymistä.

B. Suppeat projektit ja kokeilut (Micro Flow)¶

Käytetään pienille työkaluille, kertaluonteisille skripteille tai lab- tason kokeiluille. * Universal README.md: Kaikki oleellinen tieto (metadata, pikaohje, pieni tehtävälista) on yhdessä tiedostossa. * Scrum-rakenne: Voidaan jättää pois tai pitää minimaalisena (vain backlog). * Hyöty: Poistaa dokumentaatiokynnyksen. Fokus on 100% koodissa, mutta kategoria-tagi pitää huolen, että moottori löytää projektin.

🔄 Yhtenäinen Scrum-projektirakenne¶

Jokainen aliprojekti noudattaa vakioitua kansiorakennetta, mikä tekee ekosysteemistä ennustettavan. Tämä rakenne varmistaa, että hallinnollinen data (Scrum) on erotettu teknisestä toteutuksesta (src/).

scrum/01_backlog/: Projektin suunta ja tavoitteet (Epicit, Milestonet).
scrum/20_sprints/: Operatiivinen eteneminen ja retrospektiivit.
src/ / configs/: Itse tekninen sisältö.

📝 Pohjien (Templates) merkitys hallinnassa¶

Vakioidut pohjat eivät ole vain ohjeita, vaan ne ovat järjestelmän koneisto:

Automaation mahdollistaminen: Python-moottori osaa lukea vain vakioitua dataa. Pohjat varmistavat, että tehtävät ja tilastot ovat aina samassa paikassa.
Laadunvalvonta (DoD): Pohjat pakottavat projektit noudattamaan asetettuja standardeja ennen niiden hyväksymistä vakaaseen tilaan.
Readme-strategia: Skaalautuva dokumentaatio varmistaa, ettei pieniä projekteja ylidokumentoida, mutta suuret pysyvät hallinnassa.

🛠️ Keskeiset hallintatyökalut¶

Työkalu	Käyttötarkoitus	Automaation rooli
Standard Backlog	Tehtävien ja milestonien seuranta.	Laskee valmiusasteen (%).
Universal README	Projektin pikaohje ja metadata.	Poimii kuvauksen ja tagit automaattisesti.
DoD (Def. of Done)	Laadunvarmistus ja tarkistuslista.	Vahvistaa `state-stable` -tilan.
JSON Config	Kategorisointi ja säännöt.	Ohjaa moottorin luokittelulogiikkaa.

Tavoite: Muuttaa hajanainen tiedostoarkisto hallituksi ja mitattavaksi asiantuntijaekosysteemiksi.

Dokumentin tila: Luonnos — Pvm: 10.01.2026