Claude Fable 5
14711a18c2
All checks were successful
CD / Build and push images (push) Successful in 1m9s
CD / Deploy to Test (push) Successful in 10s
CD / Smoke tests against Test (push) Successful in 1m12s
CD / Promote to Int (push) Successful in 10s
CI / Lint, typecheck, test (push) Successful in 4m18s
CI / Build container images (push) Has been skipped
CI / Auth e2e pack (push) Successful in 5m59s
CI / Import/export fidelity gate (push) Successful in 47s
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>
125 lines
5.3 KiB
Markdown
125 lines
5.3 KiB
Markdown
# 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.
|
||
|
||
## 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.
|