synops/docs/erfaringer
vegard 69997c6e87 Rydd sidelinja-referanser: generiske AI-nivåer + synops.no-domener
AI-aliaser: sidelinja/rutine → synops/low, sidelinja/resonering →
synops/high. Fire nivåer i LiteLLM: low/medium/high/extreme.
Oppdatert i: LiteLLM config, PG ai_job_routing, all Rust-kode
(maskinrommet + 5 CLI-verktøy).

Domener: sidelinja.org → synops.no i fallback-URLer, health-sjekker,
LiveKit WSS, bandwidth-logger, docs/erfaringer, docs/setup,
reference/server-state, .env.example.

Docker container-navn (sidelinja-*) beholdes — styrt av
COMPOSE_PROJECT_NAME i /srv/synops/.env, endres separat ved behov.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:22:22 +00:00
..
arkiv Opprydding: arkiver STDB-docs, fjern Caddy-konfig, rydd referanser (oppgave 22.5) 2026-03-18 13:45:30 +00:00
authentik_oidc.md Rydd sidelinja-referanser: generiske AI-nivåer + synops.no-domener 2026-03-19 17:22:22 +00:00
authentik_oppsett.md Rydd sidelinja-referanser: generiske AI-nivåer + synops.no-domener 2026-03-19 17:22:22 +00:00
faster_whisper_oppsett.md Fullfør oppgave 7.2: Transkripsjons-pipeline (CAS → Whisper → content) 2026-03-17 17:44:54 +01:00
modell_benchmark.md Oppdater benchmark-rapport: parallelle tester feilet, sekvensielt er nødvendig 2026-03-18 14:28:52 +00:00
README.md Opprydding: arkiver STDB-docs, fjern Caddy-konfig, rydd referanser (oppgave 22.5) 2026-03-18 13:45:30 +00: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
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 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.