# Erfaringer — Ting vi lærte av å feile

Denne mappen samler **praktiske lærdommer** fra implementering — ikke hva vi valgte, men hva vi lærte som ikke er åpenbart fra koden eller arkitekturdokumentene.

Formålet er å treffe raskere blink med neste komponent. Hver fil dekker én teknologi eller ett mønster og inneholder konkrete feller, anti-patterns og løsninger vi landet på.

## Innhold

| Fil | Tema |
|---|---|
| `svelte5_reaktivitet.md` | Svelte 5 $state, SSR, reaktivitet gjennom funksjoner |
| `authentik_oidc.md` | Authentik sub-claim format, @auth/sveltekit JWT-quirks |
| `authentik_oppsett.md` | OIDC-provider/app-konfigurasjon, endepunkter, redirect URIs, API-admin |
| `faster_whisper_oppsett.md` | Docker-oppsett, CPU vs GPU, modellvalg, API-bruk, healthcheck-quirks |

## Arkiv

`arkiv/`-mappen inneholder historiske erfaringsdokumenter for teknologier som er faset ut:

| Fil | Tema | Status |
|---|---|---|
| `arkiv/spacetimedb_integrasjon.md` | SDK-konvensjoner, TypeScript-bindings, BigInt, tilkobling | Fjernet mars 2026 |
| `arkiv/adapter_moenster.md` | Adapter/factory for PG↔SpacetimeDB, hybrid-tilnærming | Fjernet mars 2026 |

## Retningslinjer

- **Kort og konkret.** Maks 1–2 sider per fil. Fellen først, forklaring etter.
- **Bare ting som ikke er åpenbare.** Ikke dokumenter at `npm install` installerer pakker.
- **Oppdater fremfor å legge til.** Hvis en erfaring utdypes, oppdater eksisterende fil.
- **Kodereferanser.** Vis til filer der mønsteret er implementert, så man kan lese koden.
