Hallinta ja ympäristöt GIT¶

Tämä ohjeistus määrittelee standardin kahden repositorion mallille, jossa erotetaan kehitysvaiheen (Development) ja tuotantovalmiin (Production) dokumentaation ja koodin hallinta. Malli varmistaa, että portaalissa julkaistava tieto on aina tarkistettua ja luotettavaa.

Repositoriorakenne¶

Kehitysmalli perustuu kahden toisistaan eristetyn repositorion käyttöön:

• Development Repo (Dev): Paikka jatkuvalle kehitykselle, kokeiluille ja luonnoksille. Täällä dokumentaatio ja koodi voivat muuttua nopeasti.

• Production Repo (Prod): Vakaa, tarkistettu ja julkaisukelpoinen versio. Tämä repositorio syöttää datan viralliseen portaaliin.

Työnkulku ja synkronointi¶

Koodin ja dokumentaation siirtyminen ympäristöjen välillä noudattaa tiukkaa kontrollia:

1. Kehittäjä tekee muutokset Dev-repositorion feature-branchiin.

2. Muutokset katselmoidaan ja testataan (Pull Request).

3. Hyväksynnän jälkeen muutokset mergetään Dev-mainiin.

4. Julkaisusyklissä Dev-mainin tila siirretään Prod-repositorioon automaattisella tai manuaalisella synkronoinnilla.

Julkaisuputken visualisointi¶

graph LR
    subgraph DEV_ENV [Kehitysympäristö]
        A[Feature Branch] --> B[Dev Main]
    end

    subgraph PROD_ENV [Tuotantoympäristö]
        B -- "Release Sync" --> C[Prod Main]
        C --> D[Portaali / Julkaisu]
    end

    style B fill:#fff2cc,stroke:#d6b656
    style C fill:#d5e8d4,stroke:#82b366

Parhaat käytännöt¶

Viestintä: Käytä selkeitä commit-viestejä, jotka viittaavat tiketteihin tai muutoshistoriaan.

Eristäminen: Älä koskaan tee suoria muokkauksia Prod-repositorioon. Kaiken tiedon on kuljettava Dev-ympäristön kautta.

Automaatio: Hyödynnä CI/CD-putkia dokumentaation automaattiseen validointiin ennen siirtoa tuotantoon.

Dokumentin tila: Kehitys — Pvm: 13.01.2026