Hyppää sisältöön

🛡️ Group Policy

Hallintaperiaatteet ja säännöt (GitLab)

Tämä dokumentti määrittelee Repostage-ekosysteemin säännöt, rakenteen ja hallintaperiaatteet. Kaikkien ryhmään luotavien projektien on noudatettava näitä ohjeita eheyden, tietoturvan ja automaation varmistamiseksi.

Ryhmärakenne ja näkyvyyspolitiikka

Ekosysteemi on jaettu aliryhmiin projektin tarkoituksen mukaan. Näkyvyystasot on valittu suojaamaan kriittistä infrastruktuuria, samalla kun oppimisprosessi ja valmiit ratkaisut pidetään avoimina osana ammatillista portfoliota.

Parent Group (Repostage – Top-level Group): Määrittää yleiset säännöt ja hallintaperiaatteet. Se sisältää pää-README-tiedoston, joka toimii koko ekosysteemin "kotisivuna" ja keskeisenä ohjeistuksena.

Subgroups (01–07): Toimivat itsenäisinä säilöinä eri tyyppisille projekteille. Tämä helpottaa laajan projektisalkun hallintaa ja pitää kokonaisuuden selkeänä organisoimalla projektit niiden elinkaaren ja tarkoituksen mukaan.

Parent Group (Repostage – Top-level Group)

Subgroups Tarkoitus Näkyvyys Sisältöesimerkki
01-study Opintokokonaisuudet Julkinen Kurssit, sertifikaatit, oppimispolut
02-concept Teoria & Arkkitehtuuri Julkinen Suunnitelmat, tutkimus, dokumentaatio
03-lab Tekniset kokeilut Julkinen POC-projektit, hiekkalaatikkotestit
04-project Laajat ratkaisut Julkinen Sovellus kokonaisuudet
05-tool Automaatio & Apu Yksityinen Skriptit, loggerit, apuvälineet
06-config Infrastruktuuri Yksityinen IaC, Docker-konfiguraatiot, YAML
07-engine Hallintajärjestelmät Yksityinen Repostage Control Engine, validaattorit

Nimeämisstandardi (Naming Convention)

Yhtenäinen nimeäminen on pakollista automaation ja resurssien hallinnan vuoksi.

Muoto: prefix-nimi (esim. tool-log-analyzer tai lab-python-basics)

Säännöt: * Vain pieniä kirjaimia (a-z). * Sanat erotetaan tavuviivalla (-) eli kebab-case. * Erikoismerkit, ääkköset tai välilyönnit eivät ole sallittuja.

Resurssien hallinta ja laadunvarmistus

Jokaisen projektin on oltava yhteensopiva ekosysteemin hallintatyökalujen kanssa:

  1. Ennakkotarkastus: Projekti on tarkistettava validator.py -työkalulla ennen siirtoa aliryhmään.

  2. Standardit: Säännöt ja sallitut etuliitteet on määritelty keskitetysti standards.json -tiedostossa.

Projektin siirto-ohjeet (Transfer)

Kun siirrät olemassa olevan projektin Repostage-ryhmään:

  1. Varmista, että nimeäminen vastaa standardia.
  2. Suorita siirto GitLabissa: Settings > General > Advanced > Transfer project.
  3. Päivitä paikallinen Git-osoite (remote):
git remote set-url origin git@gitlab.com:repostage/[subgroup-slug]/[repo-name].git

Dokumentin tila: Työn alla — Pvm: 01.01.2026