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 ja visio elävästä portfoliosta – opintojärjestelmästä, joka kehittyy ja päivittyy osaamisen 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ä kehitys korostaa jatkuvan oppimisen tärkeyttä: teknisen osaamisen rinnalla on ymmärrettävä prosessien logiikka ja kyettävä syventämään osaamistaan teknologian kehittyessä. Tämä projekti tarjoaa rakenteen, jossa ihminen ja työkalut täydentävät toisiaan tavoitteellisessa oppimisprosessissa.

Nykytila ja maturiteettianalyysi¶

Alla on kuvattu projektin nykytila, joka toimii uuden tiekartan (Roadmap) lähtöpisteenä.

1. Lähdekerros¶

Maturiteetti: Toimiva peruskerros * GitHub- ja GitLab-rajapintayhteydet on muodostettu. * README-sisällön haku ja säännöllisiin lausekkeisiin (Regex) pohjautuva kategorisointi on käytössä. * Kehityskohde: Rikastetun metadatan, kuten tägien, ohjelmointikielten ja laatusertifikaattien automaattinen kerääminen.

2. Työskentelykerros¶

Maturiteetti: Vahva perusta * Kehitysympäristö (VS Code) ja Git-haaramalli (docs-dev / docs-prod) on pystytetty. * Dokumentaation perusrakenne ja navigaatio toimivat loogisesti. * Kehityskohde: Standardoidun työnkulun luominen (Branch protection, PR-mallit ja commit-viestien standardointi).

3. Automaatiokerros¶

Maturiteetti: Proof-of-Concept * Generointiskripti yhdistää metadatan ja sisällön automaattisesti. * Navigaatio ja automaattisesti luotavat tiedostot toimivat ohjelmallisesti. * Kehityskohde: Skriptin kehittäminen moottoritasolle (virheenkäsittely, testaus, konfiguroitavuus ja CI/CD-integraatio).

4. Julkaisukerros¶

Maturiteetti: Manuaalisesti toimiva * MkDocs Material -ympäristö ja monorepo-tuki ovat käytössä. * GitLab Pages julkaisee sivuston molemmista kehityshaaroista. * Kehityskohde: Julkaisuprosessin ja rakennusvaiheiden (Build) täysi automatisointi sekä versionhallittu julkaisuprosessi.

Prosessin visualisointi¶

Nykytilan ja tavoitetilan välinen muutos voidaan kuvata seuraavan mallin avulla:

graph TD
    A[Lähdekerros: API-data] --> B[Työskentelykerros: Git-flow]
    B --> C[Automaatio: Python Engine]
    C --> D[Julkaisukerros: MkDocs]
    style A fill:#f9f,stroke:#333,stroke-width:2px
    style C fill:#bbf,stroke:#333,stroke-width:2px

Yhteenveto¶

Onnistuneen Proof-of-Concept-vaiheen jälkeen projekti on valmis seuraavaan kehitysaskeleeseen: manuaalisten toimien automatisointiin ja siirtymiseen kohti ammattimaista, itseohjautuvaa kehitysympäristöä. Painopiste siirtyy rakenteen ylläpidosta sisällön laadunvarmistukseen ja teknologisen syväosaamisen visualisointiin.

Dokumentin tila: Luonnos — Päivitetty: 09.01.2026