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

Teich-Admin-Handbuch

Englisches Original: docs/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.)

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.