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.

## 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.

## 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.