Projektin lähtötilanne¶

Projekti syntyi tarpeesta jäsentää aiempien opintojen dokumentaatio ja löytää selkeä suunta osaamisen syventämiselle. Syksyn 2025 aikana ideasta on kasvanut kokonaisvaltainen ajatusmalli, visio joka voi rakentua portfolioksi – opintojärjestelmäksi, joka kehittyy ja päivittyy osaamiseni mukana.

Tekoälyn nopea integraatio ohjelmistotuotantoon on siirtänyt painopisteen rutiininomaisesta koodin kirjoittamisesta korkeamman tason arkkitehtoniseen hallintaan ja ongelmanratkaisuun. Ihmisen rooli on muuttumassa toteuttajasta "orkestroijaksi", jonka on kyettävä ohjaamaan tekoälyä, arvioimaan sen tuotoksia kriittisesti ja hallitsemaan monimutkaisia kokonaisuuksia.

Tämä hämärtää perinteisiä taitorajoja ja korostaa tarvetta jatkuvalle oppimiselle: pelkkä tekninen osaaminen ei enää riitä, vaan on ymmärrettävä prosessien logiikka ja pystyttävä syventämään osaamistaan rinnakkain kehittyvän teknologian kanssa.

Tämä projekti on vastaus tähän muutokseen, tarjoten rakenteen, jossa ihminen ja työkalu täydentävät toisiaan tavoitteellisessa oppimisprosessissa.

Alla kuvattuna nykytila, joka toimii roadmapin uutena lähtöpisteenä.

1. Lähdekerros (Maturiteetti: Toimiva peruskerros)¶

• GitHub ja GitLab API-yhteydet muodostettu ja toimivat.
• README-sisällön haku ja regex-pohjainen kategorisointi on käytössä.
• Kehityskohde: Rikastetun metadatan (kuten tagit, ohjelmointikielet ja laatusertifikaatit) puuttuminen.

2. Työskentelykerros (Maturiteetti: Vahva perusta)¶

• VS Code -kehitysympäristö ja Git-haaramalli (docs-dev/docs-prod) on pystytetty.
• Dokumentaation perusrakenne ja navigaatio toimivat collapsible-muodossa.
• Kehityskohde: Standardoidun työnkulun puute (Branch protection, PR-mallit, commit-standardit).

3. Automaatio (Maturiteetti: Proof-of-Concept)¶

• Generointiskripti yhdistää metadatan ja README-sisällön automaattisesti.
• Navigaatio ja _autogenerated.md-tiedostot luodaan ohjelmallisesti.
• Kehityskohde: Skripti vaatii siirtymistä moottoritasolle (virheenkäsittely, testit, konfiguroitavuus ja CI/CD-kytkentä).

4. Julkaisukerros (Maturiteetti: Manuaalisesti toimiva)¶

• MkDocs Material Build ja monorepo-tuki (awesome-pages) ovat käytössä.
• GitLab Pages julkaisee sivuston molemmista haaroista.
• Kehityskohde: Julkaisuprosessin ja build-putkien täysi automatisointi sekä versionhallittu release-prosessi.

Yhteenveto¶

Onnistuneen Proof-of-Concept-vaiheen jälkeen projekti on valmis seuraavaan hyppäykseen: manuaalisten toimien automatisointiin ja siirtymiseen kohti ammattimaista, itseohjautuvaa kehitysympäristöä.