dorfteich/docs/de/manual/pond-admin-guide.md

# Teich-Admin-Handbuch

_Englisches Original: [docs/manual/pond-admin-guide.md](../../manual/pond-admin-guide.md)_

Was du an einem Teich konfigurieren kannst, den du verwaltest.
Teich-Admin bist du auf deinem persönlichen Teich und auf jedem Teich,
auf dem du die Rolle `pond_admin` hast. All das liegt hinter dem
**Zahnrad-Symbol** in der Kopfleiste (sichtbar auf Teich-Routen, wenn
du den Teich verändern darfst).

## Teiche in einer Minute

Jedes Mitglied bekommt automatisch einen **persönlichen Teich**.
Zusätzliche **gemeinsame Teiche** legst du über **„+ Neuer Teich"** am
unteren Ende des Teich-Umschalters in der Kopfleiste an (oder über die
API, `POST /api/v1/ponds`); sie unterliegen dem Pro-Person-Kontingent
des Site-Admins („Zusätzliche geteilte Teiche pro Person", Standard 0).
Wer den Teich anlegt, wird sein Teich-Admin.

## Name, Beschreibung, Darstellung

- **Name und Beschreibung** des Teichs.
- **Schriften**: Wähle pro Teich Schriften für Überschriften, Fließtext
  und Code aus dem eingebauten, selbst gehosteten Katalog (stöbern unter
  `/fonts`) — sie gelten für die App-Ansicht, öffentliche Seiten und
  PDF-Exporte.
- **Seitenleisten-Sortierung** für alle: A–Z, Erstellungsdatum oder
  manuelle Reihenfolge.
- **Seitenleisten-Ansicht** als Standard: der Seitenbaum („Ordner")
  oder Seiten gruppiert unter dem Label-Baum. Mitglieder können ihre
  eigene Seitenleiste weiterhin lokal umschalten — die Einstellung
  bestimmt nur den Ausgangspunkt.

## Mitglieder und Rollen

Der Abschnitt **Mitglieder** verwaltet, wer im Teich ist:

| Rolle        | Darf                                                       |
| ------------ | ---------------------------------------------------------- |
| `reader`     | Seiten lesen (soweit die Regeln es erlauben)               |
| `editor`     | Seiten lesen + schreiben, Dateien hochladen                |
| `pond_admin` | alles, einschließlich Einstellungen, Mitglieder und Labels |

Die Mitgliederzahl begrenzen die Instanz-Kontingente (Bearbeiter/Leser
pro Teich). Auch persönliche Teiche nehmen Mitglieder auf — genau so
teilst du deinen.

## Zugriffsregeln (das Kleingedruckte)

Über die reine Mitgliedschaft hinaus bearbeitet der Abschnitt
**Zugriffsregeln** die Berechtigungen direkt. Eine Regel besteht aus:
_Subjekt_ (eine Person, alle Angemeldeten oder die Öffentlichkeit) +
_Recht_ (Leser/Bearbeiter/Teich-Admin) + _Geltungsbereich_ (ganzer
Teich, ein Label oder eine Seite) + _Wirkung_ (erlauben oder verbieten).

- **Label-Regeln** sind das Power-Tool: Gib den vertraulichen Seiten das
  Label „Vorstand" und erlaube nur den Vorstandsmitgliedern dieses
  Label — oder verbiete ein Label jemandem, der sonst alles lesen darf.
- **Öffentliche Seiten:** Eine _Erlauben, Leser, öffentlich_-Regel auf
  einer Seite (oder einem Label) veröffentlicht sie schreibgeschützt
  unter `/public/<teich>/<seite>`.
- Verbieten schlägt Erlauben; verweigertes Lesen sieht aus wie „nicht
  gefunden" (das System verrät nie, was existiert).
- Der Inspektor **„Effektive Rechte"** auf einer Seite erklärt das
  wirksame Ergebnis für jede Person — nutze ihn immer, wenn dich eine
  Regel-Kombination überrascht.

## Labels

Verwalte den Label-Baum des Teichs (anlegen, umbenennen, umfärben,
verschachteln, verschieben, löschen). Das Löschen eines Labels, das
noch auf Seiten liegt, fragt nach. Labels erscheinen auch im
Label-Wähler der Seiten; dort ist das Anlegen neuer Labels dir
vorbehalten.

## Kommentar-Richtlinie

Wähle, ob **alle mit Lesezugriff** kommentieren dürfen oder **nur
Bearbeitende**. Bestehende Kommentare bleiben so oder so lesbar.

## Den Teich beobachten

Die Glocke im Kopf der Teich-Einstellungen beobachtet den ganzen Teich
— du wirst über jede Seitenänderung und jeden Kommentar darin
benachrichtigt.

## Plugins

Plugins, die der Site-Admin mit Modus _Optional_ installiert hat,
erscheinen hier mit einem Schalter pro Teich. _Erforderliche_ Plugins
sind immer aktiv; _deaktivierte_ tauchen gar nicht auf. (Welche Plugins
es gibt und was sie tun:
[Site-Admin-Handbuch](site-admin-guide.md#plugins).)

## Maschinenzugriff: API- und MCP-Freigabe

Zwei getrennte Schalter geben diesen Teich für Token-Zugriff frei —
**beide standardmäßig aus**, und beide nur wirksam, wenn der Site-Admin
den passenden Instanz-Schalter aktiviert hat:

- **Öffentliche REST-API** (`apiEnabled`): Skripte und Integrationen
  erreichen den Teich mit persönlichen API-Tokens — mit exakt den
  Berechtigungen der Token-Besitzerin.
- **MCP / KI-Assistenten** (`mcpEnabled`): MCP-Clients wie Claude Code
  erreichen den Teich auf demselben Weg.

Ein Teich ohne Freigabe ist über diese Schnittstellen unsichtbar —
selbst für die Tokens der eigenen Mitglieder.

## Obsidian-Vault importieren

Teich-Einstellungen → **Obsidian-Vault importieren** nimmt ein ZIP eines
ganzen Vaults und macht Seiten daraus. Du wählst drei Dinge:

- **Einhängen unter** — die Seite, unter der der Vault landet (oder die
  oberste Ebene).
- **Zusätzliche Labels** — bekommt jede importierte Seite, zusätzlich zu
  den Labels aus den Tags des Vaults.
- **YAML-Frontmatter** — entfernen oder als Code-Block am Seitenanfang
  behalten.

Was mit dem Vault passiert:

- **Ordner werden Seiten.** Jeder Ordner wird eine Container-Seite, die
  Notizen hängen darunter — die Vault-Struktur bleibt erhalten. Seiten
  verschachteln höchstens sechs Ebenen tief; ist der Vault (samt
  Einhänge-Tiefe) tiefer, werden die untersten Ordner-Ebenen zu einer
  Seite mit Titel `so/zusammengelegt`.
- **`[[Wikilinks]]` funktionieren weiter.** Obsidian-Links zeigen auf
  Notiz-_Namen_, Dorfteich-Links auf Seiten-_Adressen_ — jeder Link wird
  deshalb auf die Adresse umgeschrieben, die die Notiz tatsächlich
  bekommen hat: `[[Notiz|Anzeigetext]]`, `[[Notiz#Überschrift]]` (der
  Überschriften-Teil entfällt) und `[[Ordner/Notiz]]` inklusive. Links
  auf Notizen, die es im Vault nicht gibt, werden zu Links auf fehlende
  Seiten — genau wie selbst getippt. Tragen zwei Notizen in verschiedenen
  Ordnern denselben Namen, zeigt ein einfaches `[[Name]]` auf die, deren
  Vault-Pfad alphabetisch zuerst kommt.
- **Tags werden Labels.** Sowohl `tags:` im Frontmatter als auch `#Tags`
  im Text (die dabei aus dem Text verschwinden). Verschachtelte Tags wie
  `#status/aktiv` werden zu einer Label-Hierarchie.
- **Bilder und Dateien kommen mit.** Bilder, auf die eine Notiz verweist
  (`![[bild.png]]` oder `![](media/bild.png)`), werden zu Teich-Dateien
  und erscheinen in der Seite; andere erlaubte Dateitypen werden Anhänge.
  Sie zählen gegen das Speicher-Kontingent des Teichs.
  `![[Andere Notiz]]`-Einbettungen werden zu normalen Links (Dorfteich
  bettet keine Seiten ineinander ein).

Grenzen: Das ZIP darf bis zu 64 MiB groß sein, entpackt bis 256 MiB.
**Ein Import ist Alles-oder-nichts** — schlägt etwas fehl (voller Teich,
kaputtes Archiv), bleibt nichts zurück und du kannst es einfach erneut
versuchen.

## Dateien

Die **Dateiverwaltung** listet die Uploads des Teichs mit ihrer
Verwendung (welche Seite sie referenziert) und lässt dich verwaiste
Dateien löschen. Der Speicher zählt gegen das Kontingent des Teichs;
die aktuelle Nutzung wird angezeigt.

## Export und Löschung

- **Export**: der ganze Teich als ZIP aus Markdown-Dateien plus Medien.
- **Teich löschen**: Die Gefahren-Sektion am Ende der
  Teich-Einstellungen verschiebt einen gemeinsamen Teich in den
  Instanz-Papierkorb (zur Bestätigung den Teichnamen eintippen); ein
  Site-Admin kann ihn wiederherstellen. Dein persönlicher Teich lässt
  sich nicht löschen — er ist das Zuhause deines Kontos.