docs: POC-katselmus — git-pages retention, ADRt, dokumenttipäivitykset

- ADR 0004: commit-status-periaate (natiivi riittää, API vain custom-linkkiin)
- ADR 0005: provider & consumer -malli (ci-engine.yml lukittu rajapinta)
- docs/design-rationale: uusi periaate 1 "Hyödynnä natiivia",
  periaate 2 korjattu (API vain tarvittaessa),
  periaate 6 (MinIO→git-pages), teknologiavalinnat poistettu
- docs/config-model: isContainerBuild→isArtifactBuild, Docker-labelit poistettu
- docs/ai-context: monorepo-kuvaus (git-pages oma kokonaisuus, ohut rajapinta)
- docs/architecture, tech-stack, report-hosting, shared-scripts, workflows:
  MinIO→git-pages, provider agnostinen build-ekosysteemeille
- docs/adr/: ADRt siirretty decisions/→adr/
- git-pages/docs: retention-osiot päivitetty CronJob→sidecar+HTTP API,
  URL-kaava korjattu (reports/{sha8}/)
- git-pages/docs/implementation-notes: uusi (storage v2, Host-header,
  whiteout, .init, PATCH+directoryt)
- git-pages/templates/init-job.yaml: post-install init (.index)
- scripts/publish-git-pages.sh: PUT-fallback poistettu (init hoitaa),
  palauttaa BASE URL ilman index.html

docs/design-rationale.md

@@ -12,21 +12,45 @@ Organisaatiolla on tuotannossa Jenkins-pohjainen CI-järjestelmä (`ci-jenkins-l
 
 Jenkins on kuitenkin raskas ylläpitää Kubernetesissa, ja organisaatio on siirtymässä Giteaan. Tavoitteena on **sama toiminnallisuus, pienemmällä ylläpitotaakalla**, hyödyntäen Gitea Actionsin natiiveja ominaisuuksia.
 
-Kirjasto ei ole Jenkins-migraatiotyökalu. Se on Gitea Actions -natiivi uudelleensuunnittelu, joka säilyttää Jenkins-version todistetut patternit mutta hylkää ne osat, jotka olivat sidottuja Jenkinsin arkkitehtuuriin.
+Kirjasto ei ole Jenkins-migraatiotyökalu. Se on Gitea Actions -natiivi
+uudelleensuunnittelu, joka säilyttää Jenkins-version todistetut patternit
+mutta hylkää ne osat, jotka olivat sidottuja Jenkinsin arkkitehtuuriin.
+Gitea Actionsin ja Gitean natiiveja ominaisuuksia hyödynnetään aina kun
+mahdollista — uutta kilpailevaa toteutusta ei kirjoiteta, jos toimiva
+ratkaisu on jo olemassa.
 
 ---
 
 ## Suunnitteluperiaatteet
 
-### 1. Git-commit on universaali statusnäkymä
+### 1. Hyödynnä natiivia
+
+Gitea Actionsin ja Gitean natiiveja ominaisuuksia käytetään aina kun ne
+riittävät. Uutta kilpailevaa toteutusta ei kirjoiteta, jos toimiva ratkaisu
+on jo olemassa.
+
+**Miksi:** Oma toteutus on aina ylläpidettävä, testattava ja
+dokumentoitava. Natiivi ominaisuus tulee ilmaiseksi, kehittyy alustan
+mukana ja on käyttäjälle tuttu.
+
+**Esimerkkejä:**
+- Gitea Actions näyttää jobien statuksen automaattisesti — omaa
+  commit-status API -kutsua ei tarvita jokaiselle vaiheelle
+- Gitea organization secrets/variables korvaa erillisen credential-hallinnan
+- Reusable workflow -mekanismi korvaa custom action -runtimen
+
+### 2. Git-commit on universaali statusnäkymä
 
 Buildin jokainen vaihe raportoi tilansa Git-committiin. Kehittäjä näkee yhdellä silmäyksellä, missä vaiheessa build on — ei tarvitse navigoida CI-järjestelmän UI:hun.
 
 **Miksi:** Jenkins-versio osoitti, että commit-statusviestit poistavat tarpeen CI-dashboardille. Kehittäjä työskentelee Gitissä, joten status kuuluu Gitiin. Statusviestien `url`-kenttä linkittää suoraan raportteihin — Cucumber-tulokset, SonarQube-tulokset, Docker-rekisteri — ilman että URL tarvitsee etsiä erikseen.
 
-**Mitä tarkoittaa käytännössä:** Jokainen `testBegin/End`, `buildBegin/End`, `pushBegin/End`-vaihe POSTaa Gitean REST APIin (`/api/v1/repos/{owner}/{repo}/statuses/{sha}`). Uniikki `key` per vaihe estää duplikaatit ja mahdollistaa rinnakkaiset statukset samassa commitissa.
+**Mitä tarkoittaa käytännössä:** Gitea Actions näyttää jobien tilan
+(checkmark/risti/spinner) commit-näkymässä automaattisesti. API:a
+(`/api/v1/repos/{owner}/{repo}/statuses/{sha}`) käytetään vain
+custom-raporttilinkin välittämiseen. ADR 0004.
 
-### 2. Reusable workflow — ei omaa runtimea
+### 3. Reusable workflow — ei omaa runtimea
 
 Kirjasto jaetaan Gitea Actionsin reusable workflow -mekanismilla. Ei Docker-pohjaisia custom actioneita, ei erillistä ajonaikaista palvelinta.
 
@@ -34,15 +58,17 @@ Kirjasto jaetaan Gitea Actionsin reusable workflow -mekanismilla. Ei Docker-pohj
 
 **Mitä tämä ei ole:** Tämä ei ole monorepo-työkalu, joka asennetaan projekteihin. Tämä on joukko `.gitea/workflows/`-tiedostoja, joihin mikropalvelut viittaavat `uses:`-direktiivillä.
 
-### 3. Konfiguraatio kuuluu repoon
+### 4. Konfiguraatio kuuluu repoon
 
 Projektikohtainen konfiguraatio (`ci-flow-values.yaml`-tyyppinen tiedosto) asuu mikropalvelun omassa repossa. Reusable workflow lukee sen, ei toisinpäin.
 
 **Miksi:** Mikropalvelun kehittäjä omistaa buildinsa. Hän tietää mitä Dockefileä käytetään, mitä SonarQube-projektia, mitä testi-steppejä tarvitaan. Jos konfiguraatio hajautetaan useaan repoon, muutokset vaativat koordinaatiota, ja yhden totuuden lähteen periaate rikkoutuu.
 
-**Poikkeus:** Infra-tason asetukset (MinIO-URL, Gitea-instanssin URL) ovat organisaatiotasolla Gitean organization secrets/variables -mekanismissa. Ne eivät ole repokohtaisia, koska DNS voi osoittaa eri paikkaan kuin repo, ja usean repossa toistuva sama arvo on ylläpitoriski.
+**Poikkeus:** Infra-tason asetukset (git-pages host, Gitea-instanssin URL)
+ovat organisaatiotasolla Gitean organization secrets/variables
+-mekanismissa. Ne eivät ole repokohtaisia.
 
-### 4. Deterministinen testigraafi, vaiheittainen suoritus
+### 5. Deterministinen testigraafi, vaiheittainen suoritus
 
 Test flow on tunnettu ennen buildin alkua, ja testit ajetaan yksi kerrallaan. Jos steppi epäonnistuu, koko flow pysähtyy.
 
@@ -50,13 +76,18 @@ Test flow on tunnettu ennen buildin alkua, ja testit ajetaan yksi kerrallaan. Jo
 
 **Miten:** Orkestroiva workflow käyttää Gitea REST API:a workflow-dispatchiin ja pollaa ajettavan workflow'n tilaa synkronisesti (`GET /api/v1/repos/{owner}/{repo}/actions/runs/{id}`). Tämä vastaa Jenkinsin `buildJob()`-kutsun semantiikkaa, mutta toteutetaan curl + pollaus -silmukalla.
 
-### 5. Raportit ovat selailtavia URL:n takana
+### 6. Raporttien hallinta erillisellä palvelulla
 
-Testiraportit (Cucumber HTML, Jacoco HTML, JUnit XML) viedään MinIO:hon, jonka staattinen web-hosting renderöi ne selaimessa. URL linkitetään Git-committiin.
+Raporttien selailtavuudesta ja elinkaaresta vastaa erillinen palvelu, joka
+asennetaan git-pages Helm-chartilla. Raportit ovat julkisia URL:lla
+(osoite tunnettava). URL linkitetään Git-committiin.
 
-**Miksi:** Jenkins-versiossa linkki Cucumber-raporttiin oli kriittinen feature — kehittäjä klikkasi commitin statusviestistä ja näki heti mitkä testit epäonnistuivat. Gitea Actionsin sisäänrakennettu artifact-järjestelmä ei tue HTML-selailtavuutta (vain ZIP-lataus). MinIO täyttää tämän aukon: se on kevyt, Kubernetes-natiivi, ja sen S3 API on standardi. URL-rakenne `{BASE}/{repo_slug}/{commit_short}/{report_type}/` on ennustettavissa ilman erillistä URL-generaattoria.
+**Miksi:** Jenkins-versiossa linkki Cucumber-raporttiin oli kriittinen
+feature. Gitea Actionsin artifact-järjestelmä ei tue HTML-selailtavuutta
+(vain ZIP-lataus). Erillinen palvelu mahdollistaa hallitun retention ja
+pääsyn ilman CI-alustan rajoitteita.
 
-### 6. Yksi CI-alusta, yksi integraatiopiste
+### 7. Yksi CI-alusta, yksi integraatiopiste
 
 Kirjasto tukee vain Giteaa. Ei GitLab-, BitBucket- tai GitHub-abstraktioita.
 
@@ -64,7 +95,7 @@ Kirjasto tukee vain Giteaa. Ei GitLab-, BitBucket- tai GitHub-abstraktioita.
 
 **Mitä tarkoittaa tulevaisuudessa:** Jos toinen alusta tulee ajankohtaiseksi, Gitea-versiota käytetään joko pohjana redesignille tai mallina erilliselle toteutukselle. Rajapintoja ei suunnitella etukäteen alustariippumattomiksi — se on ennenaikaista optimointia.
 
-### 7. Cross-repo commit traceability
+### 8. Cross-repo commit traceability
 
 Kun build-ketju ylittää reporajat (mikropalvelu → deployment → integraatiotestit → e2e-testit), jokainen vaihe raportoi kahteen suuntaan: omaan committiinsa ja takaisin root-committiin, josta ketju käynnistyi.
 
@@ -128,18 +159,7 @@ sequenceDiagram
 
 ---
 
-## Teknologiavalinnat (seurauksina ylläolevista periaatteista)
-
-| Valinta | Miksi |
-|---------|------|
-| **Gitea Actions reusable workflows** | Periaate 2: natiivein tapa jakaa CI-logiikkaa ilman omaa runtimea |
-| **Gitea REST API** (`/api/v1/...`) | Periaate 1: commit-statusraportointi. Periaate 4: workflow-dispatch ja status-pollaus. Periaate 7: cross-repo statusraportointi useaan committiin |
-| **MinIO** (S3-yhteensopiva) | Periaate 5: HTML-selailtavat raportit ilman ulkoista palvelinta. Kubernetes-natiivi, yksi binääri |
-| **YAML** konfiguraatioformaattina | Periaate 3: repo omistaa konffinsa. YAML on luettava, versioitava ja tuttu Jenkins-versiosta |
-| **curl + jq + bash** integraatiokerroksena | Periaate 2: ei custom action -runtimea. Gitea REST API:a kutsutaan suoraan workflow-stepistä |
-| **Gitea organization secrets/variables** | Periaate 3: infra-tason asetukset (MinIO-URL, tokenit) eivät kuulu reposuuteen |
-
----
+## Mitä tietoisesti hylättiin
 
 ## Mitä tietoisesti hylättiin