synops/ops/ryddejobb.md
vegard 00bf5d27ce Arkitekturbeslutninger: noder er sentrum, edges definerer alt
Grunnleggende arkitekturbeslutninger tatt og dokumentert:

- Alt er noder (brukere, team, innhold, mediefiler, samlings-noder)
- Edges definerer hva en node er (freeform typer, metadata i JSONB)
- Materialisert tilgangsmatrise (node_access) erstatter workspace-RLS
- Visibility (hidden/discoverable/readable/open) på noder
- Aliaser via usynlige system-edges
- Maskinrommet eier all skriving (SpacetimeDB først, PG asynk)
- SpacetimeDB holder hele grafen, PG er persistent backup
- Node- og edge-skjema spesifisert (docs/primitiver/)

Fjernet workspace-konseptet fra hele dokumentasjonen (~40 filer).
Fem retninger besluttet, én åpen (rom, ikke forum).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 10:29:54 +01:00

64 lines
2.7 KiB
Markdown

# Ryddejobb — Full prosjektrevisjon
## Hva
Systematisk gjennomgang av hele prosjektet for å oppdatere fremdrift, tette hull,
fjerne utdaterte referanser, og sikre at dokumentasjon stemmer med virkeligheten.
## Når
- Annenhver uke som rutine
- Etter store implementeringsjobber
- Når prosjektet føles uoversiktlig
## Sjekkliste
### 1. CLAUDE.md — stemmer instruksjonene?
- [ ] Er stack-beskrivelsen oppdatert?
- [ ] Er doc-treet komplett (alle filer i `docs/` er listet)?
- [ ] Er reglene fortsatt relevante?
- [ ] Finnes det nye konvensjoner som bør inn?
### 2. Docs vs virkelighet
- [ ] Gå gjennom `docs/concepts/` — stemmer beskrivelsene med hva som finnes i koden?
- [ ] Gå gjennom `docs/features/` — er det features beskrevet som ikke er påbegynt? Marker dem.
- [ ] Gå gjennom `docs/infra/` — stemmer infrastruktur-docs med `docker-compose.dev.yml` og prod?
- [ ] Gå gjennom `docs/setup/` — fungerer oppsettinstruksjonene fortsatt?
- [ ] Gå gjennom `docs/retninger/` — er tesene fortsatt relevante? Har noen modnet til beslutninger?
- [ ] Er det docs som refererer til filer, routes eller komponenter som ikke eksisterer?
### 3. Kode-hygiene
- [ ] Ubrukte SvelteKit-routes (mapper i `web/src/routes/` uten innhold eller med stub)
- [ ] Ubrukte komponenter (filer i `web/src/lib/components/` som ikke importeres)
- [ ] Ubrukte Rust-moduler i worker
- [ ] Ubrukte SpacetimeDB-reducere eller tabeller
- [ ] Gamle migrations som bør dokumenteres eller konsolideres
- [ ] `package.json` / `Cargo.toml` — ubrukte dependencies
### 4. Fremdriftsstatus
- [ ] Hva er faktisk implementert og fungerer?
- [ ] Hva er påbegynt men ufullstendig?
- [ ] Hva er kun planlagt (kun docs)?
- [ ] Oppdater en kort statusoversikt (kan legges i `ops/status.md` ved behov)
### 5. Asynkron tilstand — prod vs lokal vs docs
- [ ] Stemmer `docker-compose.dev.yml` med det som faktisk kjøres lokalt?
- [ ] Er prod-server oppdatert med siste push?
- [ ] Er det migrasjoner som er kjørt lokalt men ikke i prod (eller omvendt)?
- [ ] Er miljøvariabler (.env) synkronisert mellom miljøer?
### 6. CLAUDE.md minne
- [ ] Gå gjennom `~/.claude/projects/-home-vegard-server/memory/MEMORY.md`
- [ ] Fjern utdaterte minner
- [ ] Oppdater minner som har blitt unøyaktige
- [ ] Er det ny kunnskap fra nylige samtaler som bør lagres?
### 7. Erfaringslogg
- [ ] Er det gjort arbeid nylig som mangler erfaringsdokumentasjon i `docs/erfaringer/`?
- [ ] Er eksisterende erfaringsdokumenter fortsatt relevante og korrekte?
### 8. Utviklermiljø
- [ ] Fungerer lokal utvikling mot server (SvelteKit HMR, Rust build)?
- [ ] Er `docs/setup/lokal.md` oppdatert med eventuelle nye steg?
## Sist kjørt
_Ikke kjørt ennå._