vegard/synops
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
synops/docs/erfaringer/README.md
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

1.1 KiB
Raw Blame History

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

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.