vegard 0a467066ba Synops v2: arkitektur, retninger og dokumentasjon

Nystart basert på arkitektonisk innsikt fra Sidelinja v1.
Koden er ny, visjon og primitiver er validert gjennom tidligere arbeid.

Inneholder:
- Komplett arkitekturdokumentasjon (docs/arkitektur.md)
- 6 vedtatte retninger (docs/retninger/)
- Alle concepts, features, proposals og erfaringer fra v1
- Server-oppsett og drift (docs/setup/)
- LiteLLM-konfigurasjon (API-nøkler via env)
- Editor.svelte referanse fra v1

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-17 06:43:08 +01:00

2.4 KiB

Raw Blame History

Feature: Live Transkripsjon (Whisper-pipeline)

Filsti: docs/features/live_transkripsjon.md

1. Konsept

Den felles Whisper-pipelinen som brukes av flere konsepter for å transkribere lyd. Abstraherer bort konfigurasjonsforskjeller (modellvalg, latenskrav) bak et felles grensesnitt.

2. Moduser

Kontekst	Modell	Latenskrav	initial_prompt	Output
Studioet (live)	`small`	<1s per chunk	Nei (hastighet prioritert)	Flyktig tekst → NER-pipeline
Møterommet (live)	`small`	<1s per chunk	Nei	Flyktig tekst → AI-referent
Podcastfabrikken (batch)	`medium` + prompt	Ingen (asynkront)	Ja (navneliste)	SRT → Git → PG

3. Teknisk arkitektur

Lydkilde: LiveKit server-side hooks (live) eller filopplasting (batch).
Whisper-server: fedirz/faster-whisper-server (Docker, OpenAI-kompatibelt API). Endepunkt: POST /v1/audio/transcriptions.
Chunking (live): Rust-tjeneste mater lyd i ~5-sekunders chunks. small-modellen prosesserer ~5x raskere enn sanntid, noe som gir <1s forsinkelse per chunk.
Output: SRT (batch) eller ren tekst (live).

4. Whisper-konfigurasjon

Språk: Sett language=no eksplisitt for norsk — unngå auto-detect som kan velge dansk/svensk.
large-v3 KREVER vad_filter=true — uten hallusinerer modellen repeterende tekst.
Benchmark og modellvalg: Se docs/concepts/podcastfabrikken.md seksjon 4 for ytelsestall og anbefalinger.

4.1 initial_prompt (navneliste)

Brukes kun i batch-modus (Podcastfabrikken). Prompten bygges automatisk fra workspace-config (workspaces.settings.whisper_prompt) + aktører i workspace-ets kunnskapsgraf.

Effekten er tydelig:

Uten prompt: "Vegard Nøgnes", "SideLinja", "Sidlinja"
Med prompt: "Vegard Nøtnæs", "Sidelinja" (riktig)

5. Lagring

Live-modus: Transkripsjonen er flyktig (kategori 4, TTL 30 dager). Lagres i live_transcription_log for feilsøking.
Batch-modus: SRT committes til Git (Forgejo, ett repo per workspace). Avledede formater (ren tekst, segmenter, søkeindeks) i PostgreSQL.

6. Instruks for Claude Code

Live transkripsjon blokkerer ALDRI web-requests — prosesseres i Rust-worker eller separat tjeneste.
Batch-transkripsjon kjøres som whisper_transcribe-jobb i jobbkøen (se docs/infra/jobbkø.md).
Workspace-spesifikk config (prompts) hentes fra workspaces.settings.

2.4 KiB Raw Blame History