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

2.7 KiB
Raw Blame History

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å.