vegard
7eae02eeb5
Oppretter transcription_segments-tabellen i PostgreSQL som master-kopi for alle transkripsjoner. transcribe.rs er oppdatert fra verbose_json til SRT-format med full parse → segment-innsetting pipeline. Endringer: - Migration 005: transcription_segments med GIN fulltekstsøk (norsk) - transcribe.rs: SRT-parser, segment-innsetting, node-oppdatering - Miljøvariabler: WHISPER_MODEL (default "medium"), WHISPER_INITIAL_PROMPT - Docker-compose: nye env vars for maskinrommet-containeren - Docs: oppdatert podcastfabrikken, arkitektur, primitiver, CLAUDE.md Tabellen kjørt på server, maskinrommet restartet med nye env vars. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
126 lines
4.3 KiB
Markdown
126 lines
4.3 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 | — |
|
|
| `has_media` | Har mediefil (innhold → CAS-node) | — |
|
|
| `intended_for` | Ment for publisering i (arbeidsfase) | — |
|
|
| `submitted_to` | Innsendt til redaksjonell vurdering | `{ "status": "pending" }` |
|
|
| `title` | Publisert overskrift (presentasjonsnode → innhold) | `{ "variant": "editorial" }` |
|
|
| `subtitle` | Undertittel | `{ "variant": "editorial" }` |
|
|
| `summary` | Ingress / forhåndsvisning | `{ "variant": "ai" }` |
|
|
| `og_image` | Forsidebilde / OpenGraph-bilde (media → innhold) | `{ "variant": "editorial" }` |
|
|
| `show_notes` | Show notes for episode | `{ "variant": "ai" }` |
|
|
| `chapter` | Kapittelmarkør for episode | `{ "at": "00:05:23" }` |
|
|
|
|
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.
|