synops/docs/features/kanban.md
vegard f1752e73f5 Redaktørens arbeidsflate (oppgave 14.11): Kanban-brett for innsendinger
Redaktøren ser alle artikler med submitted_to-edge til samlingen,
gruppert i fire kolonner etter status. Drag-and-drop mellom kolonner
endrer status via update_edge. Siste kolonne ("Planlagt") åpner en
dialog for å sette publish_at i edge-metadata — klar for oppgave 14.12
(planlagt publisering).

Backend: GET /query/editorial_board med forfatterinfo og edge-metadata.
Frontend: /editorial/[id] med sanntidsoppdateringer via SpacetimeDB.
Lenke fra PublishingTrait når require_approval er aktivt.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 02:09:03 +00:00

90 lines
3.7 KiB
Markdown

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