--- title: "Glossar" description: "Notarium-Begriffe: Space, Projekt, notarium-id, Notizklasse, Principal, PAT, Revisionsprotokoll, RRF und mehr." --- # Glossar Kurze Definitionen der wichtigsten Notarium-Begriffe. Jeder Begriff verweist auf die Seite, auf der er ausführlich erklärt wird. ## Speicherung und Identität **file-first** — das Prinzip, dass die Quelle der Wahrheit die Markdown-Dateien selbst sind, direkt auf der Festplatte. Der Suchindex, der Verknüpfungsgraph und alles Abgeleitete lassen sich aus den Dateien wieder aufbauen; du kannst den Ordner jederzeit mitnehmen und gehen. Mehr dazu in [File-first](/docs/concepts/file-first/). **Space** — eine isolierte Wissensbasis mit eigenem Index, Graph, eigener Suche, eigenem Baum, Revisionsprotokoll und eigener Mitgliederliste. Jeder Nutzer hat einen nicht löschbaren persönlichen Space (auf den agentenseitigen Seiten heißt er **persönliche Domäne**). Mehr dazu in [Spaces und Projekte](/docs/concepts/spaces-and-projects/). **Projekt** — eine leichtgewichtige, optionale Einheit: ein markierter Ordner mit stabiler Identität innerhalb eines Space (die Markierung ist eine Dot-Datei im Ordnerstamm). Ein Agent adressiert es über das Handle `space/slug`. Mehr dazu in [Spaces und Projekte](/docs/concepts/spaces-and-projects/). **`notarium-id`** — ein stabiler, 12-stelliger Notiz-Identifikator im Frontmatter. Er übersteht das Verschieben und Umbenennen der Datei, sodass Verknüpfungen und Verlauf nie abreißen. Mehr dazu in [Versionsverlauf](/docs/concepts/versioning/). **Notizklasse** — eine Sammlung von Sichtbarkeits- und Indexierungsrichtlinien, die sich aus dem Speicherort der Notiz ableitet (kein frei wählbares Feld): `user-doc` (Nutzernotiz, überall sichtbar), `agent-memory` (Agentenspeicher, indexiert und über `recall` erreichbar, aber vor nutzerseitigen Oberflächen verborgen), dazu die internen `attachment`, `derived` und `profile`. Mehr dazu in [Notiztypen](/docs/concepts/note-types/). ## Zugriff und Agenten **Principal** — ein verallgemeinertes Zugriffssubjekt: eine Person oder ein KI-Agent. Ein einziger Mechanismus für Zugriffsgewährungen deckt sie alle ab. Mehr dazu in [Zugriffsmodell](/docs/concepts/access-model/). **Rollen** — die Mitgliedschaft in einem Space: `reader` (liest alles), `writer` (bearbeitet Notizen), `owner` (verwaltet die Mitgliedschaft). Mehr dazu in [Zugriffsmodell](/docs/concepts/access-model/). **PAT (Personal Access Token)** — ein persönliches Zugriffstoken für Agenten, übermittelt im Header `Authorization: Bearer …`. Es trägt einen Scope (`read`/`write`), optional eine Einschränkung auf Spaces und ein Ablaufdatum. Das Geheimnis wird genau einmal angezeigt. Mehr dazu in [Einen Agenten verbinden](/docs/agents/connect/). **MCP-Gateway** — der eingebaute Endpunkt `POST /mcp`, über den ein KI-Agent die Wissensbasis mit absichtsorientierten Tools liest und schreibt (statt mit generischen CRUD-Operationen). Die Änderungen eines Agenten werden versioniert, durch Zugriffe begrenzt und mit Provenienz signiert. Mehr dazu in [Agenten und MCP](/docs/agents/). **Intent-Tool** — ein Tool des MCP-Gateways, das eine Absicht ausdrückt („finde", „erstelle eine Notiz") statt einer CRUD-Operation auf niedriger Ebene im Speicher. Mehr dazu in [Intent-Tools](/docs/agents/intent-tools/). ## Suche **hybride Suche** — eine Fusion aus drei Kanälen: lexikalisch (Volltext FTS/BM25, immer aktiv), semantisch (Vektoren, per Flag aktivierbar) und ein optionaler Graph-Boost. Die Ergebnisse werden per RRF-Algorithmus kombiniert. Mehr dazu in [Suche](/docs/concepts/search/). **RRF (Reciprocal Rank Fusion)** — ein Algorithmus, der Ranglisten (lexikalisch + semantisch + Graph) gewichtet und zu einem einzigen Ergebnissatz verschmilzt, ganz ohne gemeinsame Score-Skala. Mehr dazu in [Suche](/docs/concepts/search/). **Degradation** — eine Fähigkeit fällt auf eine einfachere Variante zurück, wenn ihre Abhängigkeiten fehlen: Ist der Vektor-Stack aus oder nicht verfügbar, arbeitet die Suche weiter über den Volltext (FTS) — ohne Fehler und mit demselben Ergebnis. Mehr dazu in [Suche einrichten](/docs/self-hosting/search-setup/). ## Versionen und Provenienz **Revisionsprotokoll** — der Versionsverlauf von Notizen in der Metadaten-Datenbank (nicht git). Eine Revision ist ein vollständiger Zustands-Snapshot; identische Zustände werden nach Inhalt dedupliziert. Der Schlüssel des Protokolls ist die `notarium-id`, sodass der Verlauf Verschieben und Umbenennen übersteht. Mehr dazu in [Versionsverlauf](/docs/concepts/versioning/). **Provenienz** — die Zuordnung jeder Revision: wer die Änderung vorgenommen hat und wie — eine bestimmte Person, ein bestimmter KI-Agent oder ein externer Datei-Editor. Mehr dazu in [Versionsverlauf](/docs/concepts/versioning/). ## Deployment **Self-Hosting** — das Deployment-Modell von Notarium: ein einziger, in sich geschlossener Container (Node/Fastify, Engine im Prozess, keine externen Dienste). Der Datenschutz entsteht dadurch, dass dir Server und Dateien gehören, nicht durch Ende-zu-Ende-Verschlüsselung. Mehr dazu in [Self-Hosting](/docs/self-hosting/). ## Siehe auch - [Umgebungsvariablen](/docs/reference/environment-variables/) — die vollständige Konfigurationstabelle. - [Referenz der Tastenkürzel](/docs/reference/keyboard-shortcuts/) — Layouts und Presets. - [Konzepte](/docs/concepts/) — wie Notarium aufgebaut ist.