🎨 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