siivous: scriptit env-pohjaisiksi, validointi, siistit kutsut

README.md

@@ -180,6 +180,30 @@ Tarkista ennen ensimmäistä ajoa: [Provider-binding](#provider-binding--miten-c
 
 Lisätietoa runnerin toiminnasta, konteista ja DinD:stä: [docs/runner.md](docs/runner.md)
 
+## Vaaditut secretit ja muuttujat
+
+Consumer-repossa on oltava seuraavat asetukset:
+
+### Repo Actions Secrets (`{repo} → Settings → Actions → Secrets`)
+
+| Secret | Kuvaus |
+|--------|--------|
+| `GIT_PAGES_PUBLISH_TOKEN` | Git-pages-palvelimen BasicAuth-token. Nimi on lukittu — tämä tarkka nimi vaaditaan. |
+
+`GITEA_TOKEN` on Gitean sisäinen secret (`secrets.GITEA_TOKEN`), joka on automauttisesti saatavilla — sitä ei tarvitse erikseen luoda.
+
+### Org/Repo Variables (`{repo} → Settings → Actions → Variables`)
+
+Nämä tulevat `config-file`:n kautta (`env_json`-input). Katso [config-model.md](docs/config-model.md).
+
+### Validaatio
+
+Jokaisen jobin alussa ajetaan `ci-validate.sh`, joka tarkistaa:
+- Vaaditut ympäristömuuttujat on asetettu
+- URLit ovat oikeaa muotoa
+
+Jos validointi epäonnistuu, job keskeytyy selkeällä virheviestillä ja Gitean commit-status näyttää epäonnistumisen linkkinä lokiin.
+
 ### Muuta
 
 | Muuttuja | Kuvaus |