synops/docs/features/kanban.md

Feature: Kanban (Planlegging)

Filsti: docs/features/kanban.md

1. Konsept

Et drag-and-drop Kanban-brett for planlegging. Primært brukt til episodeplanlegging i Redaksjonen, men også mottaker av AI-genererte action points fra Møterommet.

2. Status

Implementert med nodes+edges (mars 2026). Sanntid via SpacetimeDB.

Implementert

• Board = samlings-node (node_kind: 'collection', metadata.board: true)
• Kolonner definert i board-metadata: metadata.columns: ["todo", "in_progress", "done"]
• Kort = content-noder med belongs_to-edge til board
• Status via status-edge (kort → board) med metadata.value
• Posisjon via belongs_to-edge metadata.position (REAL for midpoint-innsetting)
• Backend: POST /intentions/update_edge for statusendring
• Backend: GET /query/board?board_id=... for board-spørring
• Frontend: /board/[id] route med HTML5 drag-and-drop
• Sanntid via SpacetimeDB edge-subscriptions (ingen polling)
• Opprett kort direkte i kolonne (tittel-input)
• Oppretting av nye brett fra mottak-siden

Gjenstår

• Reposisjonering ved dra innad i kolonne (sortert rekkefølge)
• Redigeringsmodal for kort (tittel/beskrivelse)
• Tildeling (assignee) UI
• Fargekoder/labels på kort
• AI-integrasjon: møtereferent → nye kort
• Tilpassbare kolonnenavn

3. Datamodell

Ingen separate kanban-tabeller. Alt er noder og edges (kjerneprimitivene):

Board = collection-node (metadata.board: true, metadata.columns: [...])
Kort  = content-node
         + belongs_to-edge → board (metadata.position: REAL)
         + status-edge → board (metadata.value: "todo"|"in_progress"|"done")

Tilgang styres via node_access-matrisen. Brett er synlige for brukere med owner/admin/member_of-edge til board-noden.

4. API-endepunkter

Metode	Sti	Beskrivelse
GET	/query/board?board_id=...	Hent brett med kort, status og posisjon
POST	/intentions/create_node	Opprett kort (content-node)
POST	/intentions/create_edge	Koble kort til brett (belongs_to + status)
POST	/intentions/update_edge	Endre status ved drag-and-drop
POST	/intentions/update_node	Oppdater tittel/beskrivelse
POST	/intentions/delete_node	Slett kort (cascader edges)

5. Redaksjonell arbeidsflate (Editorial Board)

Kanban-mønsteret gjenbrukes for redaktørens arbeidsflate (/editorial/[id]), men med en viktig forskjell: den bruker submitted_to-edges i stedet for belongs_to + status-edges. Status lever direkte i submitted_to-edge-metadata.

Kolonner: Innkomne (pending), Under vurdering (in_review), Godkjent (approved), Planlagt (scheduled)

Planlagt-kolonnen: Når en artikkel dras til "Planlagt", åpnes en dialog for å sette publish_at i edge-metadata. Statusen i edge er fortsatt approved, men publish_at skiller planlagte fra godkjente.

Backend: GET /query/editorial_board?collection_id=... — henter alle noder med submitted_to-edge til samlingen, inkludert forfatterinfo.

Tilgang: Kun owner/admin av samlingen kan dra kort mellom kolonner (statusendring). Tilgang kontrollert i update_edge.

6. Brukes av

Konsept	Bruk
Redaksjonen	Episodeplanlegging — dra Temaer inn i Kjøreplanen
Redaksjonen	Redaksjonell arbeidsflate — innsendinger gruppert på status
Møterommet	AI-referenten foreslår nye kort basert på action points

6. Instruks for Claude Code

• Alt er noder og edges — ingen separate kanban-tabeller.
• Board er en collection-node med metadata.board: true.
• Status er en status-edge (kort → board) med metadata.value.
• Bruk native HTML5 Drag and Drop, unngå tunge biblioteker.
• Sanntid via SpacetimeDB edge-subscriptions.
• Tilgang styres via node_access-matrisen.