kehitys sykli määritelty, tdd

docs/ai-context.md

@@ -20,6 +20,13 @@ Gitea Actions reusable workflow -kirjasto mikropalveluiden build-, testaus-, rap
 | `scripts/` | Jaetut bash-skriptit |
 | `report-service/` | Raporttipalvelun koodi (retention, indeksigenerointi) |
 | `docs/` | Arkkitehtuuri-, vaatimus- ja konfiguraatiodokumentaatio |
+| `docs/tickets/` | Toteutustiketit (0001–0012), yksi per feature-branch |
+| `docs/test-plan/` | TDD-opas: 3-kerrosmalli, kehityslooppi, mock, kontekstikuratointi |
+| `docs/test-plan/tdd-guide.md` | Testivetoisen kehityksen menetelmädokumentti |
+| `tests/` | Bats-testit skripteille ja workflow-validointi |
+| `tests/features/` | Cucumber `.feature`-tiedostot (yksi per tiketti, tägätty @mock/@real/@ticket-NNNN) |
+| `tests/helpers/` | Jaettu mock-palvelin (Gitea API + MinIO) |
+| `.gitea/workflows/ci.yml` | Kirjaston oma CI — dogfood (käyttää itse itseään) |
 
 ## Key Technical Decisions
 - **Vain Gitea.** Ei multi-platform-tukea (GitLab, BitBucket, GitHub)
@@ -41,6 +48,15 @@ Gitea Actions reusable workflow -kirjasto mikropalveluiden build-, testaus-, rap
 - Workflow-triggerit: `push` branchiin tai `workflow_dispatch`
 - Skriptien kutsuminen tapahtuu workflow-stepeistä, ei paikallisesti
 - `ci-flow-values.yaml` validointi: skeema `docs/config-model.md`:ssa
+- Bats-testit: `bats tests/` — ajaa kaikki skripti- ja workflow-testit
+- Testit vaativat: `bats` (Bash Automated Testing System), `jq`, `yq`
+
+## Development Process
+- TDD: Red-Green-Refactor jokaiselle tiketille. Testit ensin, toteutus vasta kun testi epäonnistuu.
+- Ominaisuusbranchit: `feature/NNNN-tiketin-nimi` (esim. `feature/0001-report-status-sh`)
+- Yksi tiketti per sessio. Tiketit riippuvuusjärjestyksessä 0001 → 0012.
+- Ennen jokaista tikettiä: lataa `docs/test-plan/tdd-guide.md` + tiketin Required context -skillin lisäksi
+- Dogfood: `.gitea/workflows/ci.yml` — kirjaston oma CI käyttää omia reusable workflow'itaan
 
 ## What NOT to Do
 - Älä lisää tukea muille Git-alustoille (GitLab, BitBucket, GitHub)