## Wie alles zusammenhängt

```
Workspace (z. B. eine Abteilung)
 └── Projekt (z. B. ein Team oder ein Vorhaben)
      ├── Einträge   ← das eigentliche Wissen
      └── Zugänge    ← API-Keys mit Rolle
```

## Die Begriffe

**Workspace**
Ein Bereich für eine Abteilung oder eine größere Gruppe von Teams. Jeder
Workspace liegt in einer eigenen Datenbankdatei. Workspaces sehen sich
gegenseitig nie: Die Trennung ist technisch erzwungen, nicht nur eine
Filtereinstellung. Mit einem Projekt-Key bist du immer in genau einem Workspace.
Du musst ihn nicht auswählen.

**Projekt**
Die Einheit, in der Wissen geteilt wird, meist ein Team oder ein Vorhaben. Jedes
Projekt hat eigene Einträge, eigene Zugänge und eine eigene Suche. Projekte
sehen sich gegenseitig nicht, auch nicht innerhalb desselben Workspace.

**Eintrag**
Ein Stück Wissen: Titel, Inhalt in Markdown, Schlagworte. Ein guter Eintrag
beantwortet genau eine Frage, etwa „Wie läuft das Deployment?“ oder „Warum
nutzen wir SQLite?“.

**Bezeichner** (slug)
Der kurze, dauerhafte Name eines Eintrags, zum Beispiel `deployment-prozess`.
Er steht in der Adresse und dient als Schlüssel gegen Dubletten: Wer zweimal
mit demselben Bezeichner schreibt, **aktualisiert** den Eintrag, statt einen
zweiten anzulegen. Erlaubt sind `a-z`, `0-9`, `-` und `_`.

**Schlagworte** (tags)
Ordnen Einträge thematisch ein, zum Beispiel `ops` oder `sicherheit`. Es gibt
keine Ordner. Wo etwas „hingehört“, ist selten eindeutig, deshalb kann ein
Eintrag mehrere Schlagworte tragen. Besser wenige, einheitliche Schlagworte als
viele leicht verschiedene.

**Verweis**
`[[bezeichner]]` im Inhalt verlinkt auf einen anderen Eintrag. Die Gegenrichtung
entsteht automatisch: Jeder Eintrag zeigt, welche anderen auf ihn verweisen.
Ein Verweis darf auch auf einen Eintrag zeigen, den es noch nicht gibt. Das
markiert eine Lücke, die jemand füllen sollte.

**Fassung** (version)
Zählt bei jeder Änderung eines Eintrags hoch. Die vorherigen Fassungen bleiben
erhalten und lassen sich über *Verlauf ansehen* vergleichen. Ein gelöschter
Eintrag behält seinen Verlauf, solange er im Papierkorb liegt.

**Papierkorb**
Gelöschte Einträge liegen dort 30 Tage, bevor sie endgültig verschwinden. Für
Agenten und die Suche sind sie sofort unsichtbar; Menschen mit Schreibrecht
können sie zurückholen.

**Herkunft**
Jeder Eintrag vermerkt, ob zuletzt ein **Mensch** (über die Weboberfläche) oder
ein **Agent** (über MCP) geschrieben hat, und unter welchem Zugangsnamen.

**Kuratiert**
Ein Haken, den ein Mensch setzt, wenn er einen Eintrag geprüft hat. Einträge
von Agenten ohne diesen Haken sind Beobachtungen, keine bestätigten Fakten.
Agenten sehen den Haken ebenfalls und können danach filtern.

**API-Key** (Zugang)
Ein Schlüssel, der mit `wk_` beginnt und genau zu einem Projekt gehört. Er
dient zur Anmeldung im Browser und im KI-Werkzeug. Munin speichert nur eine
Prüfsumme, daher wird der Key beim Anlegen ein einziges Mal angezeigt.

**Protokoll**
Hält fest, wer wann etwas geschrieben oder gelöscht hat, wer sich angemeldet hat
(auch Fehlversuche) und wann Zugänge angelegt oder zurückgezogen wurden. Lesen
und Suchen stehen nicht darin. Protokolleinträge werden nach 90 Tagen
automatisch gelöscht.

## Rollen

Jeder Key hat genau eine Rolle.

| Rolle | Darf | Gedacht für |
|---|---|---|
| `read` | lesen und suchen | Agenten, die nur Auskunft geben sollen |
| `write` | zusätzlich schreiben und löschen | der Normalfall für Menschen und beaufsichtigte Agenten |
| `admin` | zusätzlich die Zugänge des Projekts verwalten | Menschen, die für das Projekt verantwortlich sind |

Darüber steht der **Plattform-Admin**. Er meldet sich mit einem eigenen
Admin-Token an, legt Workspaces und Projekte an und kommt an jedes Projekt.