Yleistä¶

RepoStage – yleiskuvaus¶

RepoStage on automatisoitu dokumentaatio-ekosysteemi, joka keskittää hajallaan olevan projektitiedon GitHubista ja GitLabista yhdeksi hallituksi portaaliksi. Se ratkaisee manuaalisen ylläpidon haasteet hyödyntämällä rajapintoja ja CI/CD-automaatiota, ja kehittyy tulevaisuudessa älykkääksi järjestelmäksi, joka hyödyntää LLM‑malleja tiedon rikastamiseen, analysointiin ja automaattiseen dokumentointiin.

🏗️ Arkkitehtuuri ja tiedon virtaus¶

RepoStage‑arkkitehtuuri rakentuu vahvasti Single Source of Truth ‑periaatteen ympärille. Jokainen tieto‑elementti – dokumentaatio, konfiguraatio, koodi ja metadata – haetaan aina suoraan alkuperäisestä lähteestään. Näin dokumentaatio ei ole erillinen artefakti, vaan elävä näkymä järjestelmän todelliseen tilaan.

Tämä on lähtötilanne, josta kehitys alkaa. RepoStage ei ole vielä valmis, vaan perusta oppimiselleni – ympäristö, jossa voin oppia ja rakentaa yhä vaativampia työnkulkuja, automaatioita ja älykkäitä palveluita. Jokainen osa‑alue on suunniteltu niin, että sitä voidaan laajentaa ilman, että kokonaisuus hajoaa.

RepoStage toimii siis sekä arkkitehtuurina että oppimisalustana: järjestelmänä, joka kasvaa samaa tahtia kuin oma ymmärrykseni. Kun omat taidot syvenevät, myös RepoStage muuttuu entistä älykkäämmäksi kokonaisuudeksi.

graph TD
    %% Paikallinen kehitys
    PC[Paikallinen VS Code] -- push develop --> DEV_REPO[GitLab: docs-dev]
    PC -- push develop:main --> PROD_REPO[GitLab: docs-prod]

    %% Automaatio ja lähteet
    subgraph CI_CD [CI/CD Pipeline]
        PY[generate_projects.py]
        MK[MkDocs Material Build]
    end

    GH[(GitHub API)] -- metadata --> PY
    GL[(GitLab API)] -- metadata --> PY
    SUB[README-tiedostot] -- sisältö --> PY

    %% Julkaisu
    DEV_REPO --> PY
    PROD_REPO --> PY
    PY --> MK
    MK --> PAGES[GitLab Pages: DocsDev & DocsProd]

Dev 1.0 – projektin lähtötila ennen MCP‑arkkitehtuuria ja AI‑ominaisuuksia

🚀 Keskeiset ominaisuudet¶

• Automatisoitu haku Räätälöity Python-skripti noutaa projektien nimet, kielet ja tagit suoraan GitHub- ja GitLab-rajapinnoista.

• Dynaaminen sisältöintegraatio Järjestelmä skannaa aliprojektit ja poimii niiden README-tiedostoista automaattisesti parhaat kuvaukset portaalin etusivulle.

• Staging- Production -malli Kaksivaiheinen CI/CD-julkaisu mahdollistaa automaation ja ulkoasumuutosten turvallisen testaamisen dev-ympäristössä ennen tuotantoon siirtymistä.

• Älykäs navigointi Sivuston valikkorakenne rakentuu dynaamisesti awesome-pages-pluginin ja autogeneroitujen .pages-tiedostojen avulla projektien määrän mukaan.

Kehitysympäristö: repostage-docs-dev

Tuotantoympäristö: repostage-docs-prod