synops/ops/doc-audit.md
vegard b5aa5bb243 Fjern SpacetimeDB komplett (oppgave 22.4)
SpacetimeDB er nå helt fjernet fra Synops. Sanntid håndteres av
PG LISTEN/NOTIFY + WebSocket i portvokteren (maskinrommet).

Kode fjernet:
- spacetimedb/ Rust-modul og spacetime.json
- maskinrommet/src/stdb.rs (HTTP-klient for STDB-reducers)
- frontend module_bindings/ (23 auto-genererte filer)
- spacetimedb npm-avhengighet fra package.json
- scripts/test-sanntid.sh (testet STDB-flyt)

Infrastruktur:
- Docker-container stoppet og fjernet fra docker-compose.yml
- Caddy: fjernet /spacetime/* reverse proxy
- maskinrommet-env.sh: fjernet STDB_IP og SPACETIMEDB_*-variabler
- .env.example: fjernet SpacetimeDB-seksjoner

Dokumentasjon oppdatert:
- CLAUDE.md: stack, lagmodell, kjerneprinsipper, driftsmodell
- docs/arkitektur.md: skrivestien, lesestien, datalag, teknologivalg
- docs/retninger/datalaget.md: migrasjonshistorikk, status "fjernet"
- 37 andre docs oppdatert (features, concepts, infra, ops, retninger)
- Alle kode-kommentarer med STDB-referanser oppdatert

Verifisert: maskinrommet bygger og starter OK, frontend bygger OK,
helsesjekk returnerer 200. Caddy reloadet.
2026-03-18 13:39:09 +00:00

1.7 KiB

Doc-audit — Dokumentasjon vs kode

Hva

Målrettet gjennomgang av docs/-treet for å sikre at dokumentasjonen stemmer med faktisk kode. Mer fokusert enn ryddejobben — kun docs.

Når

  • Månedlig som rutine
  • Etter store refaktoreringer eller arkitekturendringer
  • Når nye docs legges til

Sjekkliste

1. Filreferanser

  • Sjekk alle filstier nevnt i docs — eksisterer de?
  • Sjekk alle komponent-/modul-navn nevnt i docs — eksisterer de i koden?
  • Sjekk alle route-referanser — matcher de web/src/routes/?

2. CLAUDE.md doc-tre

  • Er alle filer i docs/ listet i CLAUDE.md doc-treet?
  • Er det filer listet i CLAUDE.md som ikke eksisterer?
  • Er beskrivelsene i doc-treet fortsatt dekkende?

3. Tekniske detaljer

  • Stemmer database-skjema beskrevet i docs med faktiske migrasjoner?
  • Stemmer API-endepunkter beskrevet i docs med faktiske routes?
  • Stemmer WebSocket-/sanntids-beskrivelser i docs med implementasjonen?

4. Setup-docs

  • docs/setup/lokal.md — fungerer stegene fortsatt?
  • docs/setup/produksjon.md — stemmer med faktisk server-oppsett?
  • docs/setup/migration_safety.md — er sjekklisten oppdatert?

5. Proposals

  • Er noen proposals implementert og bør flyttes til concepts/ eller features/?
  • Er noen proposals foreldet og bør slettes eller arkiveres?
  • Er noen proposals egentlig retningsspørsmål og bør flyttes til retninger/?

6. Retninger

  • Er tesene i docs/retninger/ fortsatt relevante?
  • Har noen retninger modnet nok til å påvirke andre docs (arkitektur, features, infra)?
  • Er det nye arkitektoniske spenninger som fortjener en egen retning?

Sist kjørt

Ikke kjørt ennå.