vegard
00bf5d27ce
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>
117 lines
3.6 KiB
Markdown
117 lines
3.6 KiB
Markdown
# Edges — spesifikasjon
|
|
|
|
**Status: Besluttet.**
|
|
|
|
> Edges er relasjoner mellom noder. De er retningsbestemte, typede med
|
|
> freeform strenger, og kan bære metadata. Hva en node "er" bestemmes
|
|
> av dens edges, ikke av noden selv.
|
|
|
|
## Skjema
|
|
|
|
```sql
|
|
CREATE TABLE edges (
|
|
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
source_id UUID NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
|
|
target_id UUID NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
|
|
edge_type TEXT NOT NULL,
|
|
metadata JSONB NOT NULL DEFAULT '{}',
|
|
system BOOLEAN NOT NULL DEFAULT false,
|
|
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
|
|
created_by UUID REFERENCES nodes(id),
|
|
|
|
UNIQUE (source_id, target_id, edge_type)
|
|
);
|
|
|
|
CREATE INDEX idx_edges_source ON edges (source_id);
|
|
CREATE INDEX idx_edges_target ON edges (target_id);
|
|
CREATE INDEX idx_edges_type ON edges (edge_type);
|
|
```
|
|
|
|
## Retning
|
|
|
|
Edges er retningsbestemte: `source_id → target_id`. "Vegard eier
|
|
Sidelinja" er en annen edge enn "Sidelinja eier Vegard" (som ikke
|
|
gir mening). Retningen leses naturlig:
|
|
|
|
```
|
|
Vegard ──owner──→ Sidelinja (Vegard eier Sidelinja)
|
|
Referat ──belongs_to──→ Møte (referatet tilhører møtet)
|
|
Episode ──mentions──→ Jonas Gahr Støre (episoden nevner ham)
|
|
```
|
|
|
|
Symmetriske relasjoner (f.eks. vennskap) modelleres som to edges
|
|
eller som en edge-type maskinrommet vet er symmetrisk.
|
|
|
|
## Edge-typer
|
|
|
|
Freeform strenger med konvensjoner — ikke en hard enum. Nye
|
|
relasjonstyper krever ingen migrering. Systemkritiske typer
|
|
valideres i maskinrommet.
|
|
|
|
### Kjente edge-typer
|
|
|
|
| Type | Betydning | Metadata |
|
|
|------|-----------|----------|
|
|
| `owner` | Eier noden | — |
|
|
| `admin` | Administrerer noden | — |
|
|
| `member_of` | Er medlem av | — |
|
|
| `reader` | Kan kun lese | — |
|
|
| `belongs_to` | Tilhører (innhold → samling) | — |
|
|
| `alias` | Identitet (systemedge) | `system: true` |
|
|
| `mentions` | Refererer til | — |
|
|
| `reply_to` | Svar på | — |
|
|
| `scheduled` | Tidsplanlagt | `{ "at": "2026-03-20T14:00Z" }` |
|
|
| `status` | Tilstand | `{ "value": "done" }` |
|
|
| `tagged` | Merket med | `{ "tag": "urgent" }` |
|
|
| `host_of` | Vert i | — |
|
|
|
|
Listen vokser organisk. Nye typer legges til ved behov uten
|
|
skjemaendring.
|
|
|
|
## Metadata
|
|
|
|
JSONB-feltet bærer kontekstspesifikk data om relasjonen:
|
|
|
|
- `status`-edge: `{ "value": "in_progress" }`
|
|
- `scheduled`-edge: `{ "at": "2026-03-20T14:00Z" }`
|
|
- `tagged`-edge: `{ "tag": "urgent", "color": "#ff0000" }`
|
|
|
|
Metadata er fleksibelt og spørrbart uten migrering.
|
|
|
|
## Systemedges
|
|
|
|
Edges med `system: true` er usynlige ved traversering. De
|
|
eksisterer for systemet, ikke for brukere.
|
|
|
|
Kjente systemedges:
|
|
- `alias` — identitetskobling, aldri eksponert
|
|
|
|
## Unique-constraint
|
|
|
|
`UNIQUE (source_id, target_id, edge_type)` betyr: én edge av
|
|
hver type mellom to noder. Vegard kan ha `owner`-edge *og*
|
|
`member_of`-edge til Sidelinja, men ikke to `owner`-edges.
|
|
|
|
## Hva edges gjør med noder
|
|
|
|
Edges definerer hva en node "er" — ikke noden selv:
|
|
|
|
```
|
|
Node + member_of → kanal = chatmelding
|
|
Node + belongs_to → board
|
|
+ status → "todo" = kanban-kort
|
|
Node + scheduled → tidspunkt = kalenderoppføring
|
|
Node + belongs_to → kun bruker = privat notat
|
|
Node + mentions → topic = faktoid i kunnskapsgrafen
|
|
Node uten edges = løs tanke
|
|
```
|
|
|
|
Retyping er å endre edges. Ingen datamigrasjon.
|
|
|
|
## Tilgangsmatrise-oppdatering
|
|
|
|
Når en edge med tilgangsrolle (`owner`, `admin`, `member_of`,
|
|
`reader`) opprettes eller slettes, oppdaterer maskinrommet
|
|
`node_access`-matrisen i samme transaksjon. Se
|
|
[noder er sentrum](../retninger/bruker_ikke_workspace.md)
|
|
for full spesifikasjon.
|