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