synops/docs/erfaringer
vegard 9768a24693 Fullfør oppgave 7.2: Transkripsjons-pipeline (CAS → Whisper → content)
Implementerer komplett pipeline for automatisk transkripsjon av lydfiler:

- PostgreSQL jobbkø (job_queue-tabell med status, retry, backoff)
- Worker-loop i maskinrommet som poller hvert 2. sekund
- Whisper-integrasjon: leser CAS-fil, sender multipart til faster-whisper API
- Postprosessering: filtrerer hallusinerte segmenter (no_speech_prob > 0.6)
- Oppdaterer media-nodens content-felt med transkripsjon og metadata
- Automatisk trigger: upload_media enqueuer jobb for audio/*-filer

Testet ende-til-ende på server: jobb plukkes opp, Whisper prosesserer,
node oppdateres. Retry med eksponentiell backoff ved feil.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 17:44:54 +01:00
..
adapter_moenster.md Synops v2: arkitektur, retninger og dokumentasjon 2026-03-17 06:43:08 +01:00
authentik_oidc.md Authentik OIDC login (oppgave 3.2) 2026-03-17 13:45:33 +01:00
authentik_oppsett.md Authentik OIDC-provider verifisert og dokumentert (oppgave 1.5) 2026-03-17 12:16:42 +01:00
faster_whisper_oppsett.md Fullfør oppgave 7.2: Transkripsjons-pipeline (CAS → Whisper → content) 2026-03-17 17:44:54 +01:00
README.md Fullfør oppgave 7.1: faster-whisper Docker-oppsett for norsk STT 2026-03-17 17:21:29 +01:00
spacetimedb_integrasjon.md Fullfør oppgave 2.3: STDB-klient, warmup og docs 2026-03-17 12:49:50 +01:00
svelte5_reaktivitet.md Synops v2: arkitektur, retninger og dokumentasjon 2026-03-17 06:43:08 +01:00

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
spacetimedb_integrasjon.md SDK-konvensjoner, TypeScript-bindings, BigInt, tilkobling
adapter_moenster.md Adapter/factory for PG↔SpacetimeDB, hybrid-tilnærming
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

Retningslinjer

  • Kort og konkret. Maks 12 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.