sidelinja/server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
server/CLAUDE.md
vegard a5985ef3f8 Dokumentasjon, erfaringslogg, migrasjoner og infra-oppdateringer 
- Omorganiser docs/: konsepter, features, infra og proposals i egne mapper
- Ny docs/erfaringer/ med lærdommer fra chat-implementering (Svelte 5, SpacetimeDB, adapter-mønster)
- Oppdater ARCHITECTURE.md: Lag 1 status, ny §10 Erfaringslogg, SpacetimeDB i lokal dev
- Oppdater synkronisering.md med implementeringsstatus og designvalg
- Oppdater lokal.md med SpacetimeDB og AI Gateway
- Utvid PG-skjema med channels, messages, media_files, message_revisions
- Legg til seed_dev.sql, migration_safety.md, .env.example
- Nye feature-specs: chat, kanban, whiteboard, live_ai, lydmeldinger m.fl.
- Nye konsept-specs: studioet, møterommet, redaksjonen, den asynkrone gjesten m.fl.
- SpacetimeDB og AI Gateway i docker-compose.dev.yml
- collect-docs.sh inkluderer erfaringer/

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 01:40:14 +01:00

4.7 KiB
Raw Blame History

Sidelinja - Claude Code Prosjektguide

Prosjektoversikt

Sidelinja er et redaksjonelt operativsystem og kunnskapsgraf for podcast-produksjon. Self-hosted på Hetzner VPS med full datakontroll.

Nøkkelfiler

  • ARCHITECTURE.md — Overordnet arkitektur, stack, datamodell og infrastruktur
  • docs/setup/produksjon.md — Steg-for-steg oppsett av Hetzner VPS fra scratch
  • docs/setup/lokal.md — Steg-for-steg oppsett av lokalt WSL2 utviklingsmiljø
  • docs/setup/migration_safety.md — Sjekkliste for PostgreSQL-migrasjoner (RLS-verifisering)
  • docs/concepts/ — Brukeropplevelser (integrerte produkter):
    • studioet.md — Podcast-innspilling (LiveKit + Live AI + Aha-markør)
    • møterommet.md — Interne møter (LiveKit + AI-referent + Whiteboard)
    • redaksjonen.md — Daglig redaksjonelt arbeid (Chat + Kanban + Research)
    • podcastfabrikken.md — Publiseringspipeline (Whisper + AI + RSS)
    • kunnskapsgrafen.md — Utforsking og redigering av kunnskapsnettverk
    • valgomaten.md — Publikumsrettet crowdsourced valgomat
    • den_asynkrone_gjesten.md — Asynkrone gjestebidrag via tidsbegrenset lenke
  • docs/features/ — Tekniske byggeklosser (brukes av flere konsepter):
    • kunnskapsgraf_og_relasjoner.md — Nodes & Edges datamodell i PostgreSQL
    • chat.md — Trådet chat med mentions og autocomplete (SpacetimeDB)
    • kanban.md — Drag-and-drop planlegging
    • whiteboard.md — Sanntids frihåndstavle (møterom, chat, solo)
    • live_transkripsjon.md — Whisper-pipeline (felles motor for studio/møter/fabrikk)
    • live_ai.md — Live AI: faktoid-oppslag (studio) + referent (møter)
    • visuell_graf.md — Interaktiv graf-visning (D3.js/Vis.js)
    • ai_research_klipper.md — AI-drevet research-inntak til kunnskapsgrafen
    • lydmeldinger.md — Lydmeldinger, diktering og tale-til-tekst
    • podcast_statistikk.md — IAB-kompatibel lytterstatistikk fra Caddy-logger
    • kunnskaps_bridge.md — Cross-workspace discovery via vector embeddings
    • prompt_lab.md — Internt verktøy for testing og deploy av LLM-prompts
    • kalender.md — Redaksjonell kalender med abonnementsmodell og ICS-eksport
  • docs/infra/ — Infrastruktur (ikke brukersynlig):
    • jobbkø.md — Felles PostgreSQL-basert køsystem for alle bakgrunnsjobber
    • synkronisering.md — PostgreSQL ↔ SpacetimeDB dataflyt og eierskapsmodell
    • api_grensesnitt.md — Kommunikasjonskart: SvelteKit er web-API, Rust er worker
    • ai_gateway.md — LiteLLM som sentralisert AI-ruter (BYOK + OpenRouter fallback)
  • docs/proposals/ — Halvtenkte idéer og kreative innfall (se README.md for oversikt)
  • docs/erfaringer/ — Lærdommer fra implementering (feller, anti-patterns, løsninger):
    • svelte5_reaktivitet.md — $state-getters, SSR-feller, polling-mønster
    • spacetimedb_integrasjon.md — SDK-konvensjoner, BigInt, Rust borrow-feller
    • adapter_moenster.md — Hybrid PG+SpacetimeDB, anti-patterns, anbefaling for neste komponent

Stack

  • Backend/Automasjon: Rust
  • Frontend: SvelteKit (TypeScript, PWA)
  • Sanntid: SpacetimeDB (arbeidsflyt/state) + LiveKit (lyd/video)
  • Database: PostgreSQL (persistent/kunnskapsgraf) + SpacetimeDB (in-memory/sanntid)
  • AI: faster-whisper (transkripsjon), LiteLLM (AI Gateway → Gemini/Claude/Grok/OpenRouter)
  • Infra: Docker Compose, Caddy, Authentik (SSO), Forgejo (Git)

Produksjonsserver

  • IP: 157.180.81.26
  • SSH: ssh sidelinja@157.180.81.26 (nøkkelbasert, sudo uten passord)
  • Filer: /srv/sidelinja/ (docker-compose.yml, .env, config/, data/, media/, logs/)
  • Git repos:
    • server — app-kode, infra, arkitektur: ssh://git@git.sidelinja.org:222/sidelinja/server.git
    • sidelinja — podcastinnhold (transkripsjoner, show notes, research): ssh://git@git.sidelinja.org:222/sidelinja/sidelinja.git
  • Domener: sidelinja.org, auth.sidelinja.org (Authentik), git.sidelinja.org (Forgejo), vegard.info
  • Status: Lag A komplett (PostgreSQL, Caddy, Authentik, Forgejo, Redis). Lag B-C gjenstår.

Viktige regler

  • Aldri eksponere databaseporter mot internett (kun port 80/443 via Caddy)
  • Bruk tea CLI, ikke gh (vi bruker Forgejo, ikke GitHub)
  • Tunge AI-jobber (Whisper, LLM-kall) skal aldri blokkere web-requests
  • All AI-kode peker på http://ai-gateway:4000/v1 — aldri direkte til leverandør-APIer
  • Kod og test lokalt i WSL2, deploy via push til Forgejo + SSH pull
  • Sjekk alltid relevant doc i docs/concepts/, docs/features/ eller docs/infra/ før du implementerer
  • Sjekk docs/erfaringer/ for kjente feller før du implementerer med Svelte 5, SpacetimeDB eller adapter-mønsteret
  • Etter ferdig implementering av en komponent: dokumenter lærdommer i docs/erfaringer/