Claude Fable 5
14711a18c2
Two new CI-wired Playwright packs, each in its own shared pond so the fixture ponds stay untouched: - page-tree.spec.ts — create-as-child with the form hint, collapsible folder view (collapse state survives reload), label view grouping, the local view override vs the owner-set pond default (fresh context without localStorage sees the new default), the Move-to dialog with the own subtree disabled, promote vs subtree delete, and a restored orphan re-attaching at the root. - graph.spec.ts — pond graph nodes/edges/legend, node click-through, the phantom-create flow (dashed node turns solid), the local panel with hop toggle and highlight ring, and the permission slice: a label-denied reader sees neither the hidden node nor its edge. Both packs 3× flake-free locally. Manuals: user guide (page tree, moving/deleting with subpages, knowledge graph + local graph), pond admin guide (sidebar view default), features.md (knowledge graph bullet) — with the docs/de mirrors updated (English authoritative). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
5.3 KiB
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.
- 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.)
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.