dorfteich/docs/de/features.md
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
QA: page-tree and graph e2e packs in CI, manuals updated (#114)
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>
2026-07-14 11:10:14 +02:00

134 lines
6.4 KiB
Markdown

# Dorfteich — was es ist und warum du es haben willst
_Englisches Original: [docs/features.md](../features.md)_
Dorfteich ist ein Open-Source-Wiki für Menschen, die gemeinsam denken
und schreiben wollen — in Echtzeit, auf dem eigenen Server, ohne ihr
Wissen einem Cloud-Konzern zu überlassen.
Der Name kommt vom Dorfteich: dem Ort, an dem das ganze Dorf
zusammenkommt. Dein Wiki ist in **Teiche** gegliedert — ein persönlicher
Teich für jedes Mitglied, dazu gemeinsame Teiche für Teams, Vereine,
Familien oder Projekte.
## Gemeinsam schreiben, live
- **Echtzeit-Zusammenarbeit.** Öffne dieselbe Seite wie deine Kollegin
und seht euch gegenseitig tippen — mit benannten Cursorn und einer
Anwesenheitsleiste, die zeigt, wer auf der Seite ist. Kein Sperren,
keine „Jemand anderes bearbeitet gerade"-Dialoge, keine verlorenen
Änderungen.
- **Funktioniert offline.** Tippe weiter, wenn die Verbindung abreißt;
deine Änderungen fließen automatisch wieder ein, sobald du online bist.
- **Ein freundlicher Editor.** Überschriften, Listen, Aufgabenlisten,
Tabellen, Zitate, Code-Blöcke und Bilder — mit vollem
**Markdown**-Roundtrip: Was du schreibst, kann das System jederzeit
wieder als sauberes Markdown verlassen.
- **Wikilinks.** Tippe `[[seiten-name]]`, um Seiten zu verlinken. Links
auf Seiten, die es noch nicht gibt, werden für dich gesammelt — ein
Klick legt sie an. „Verlinkt von" zeigt dir, wo jede Seite referenziert
wird.
## Nie wieder etwas verlieren
- **Versionsverlauf.** Jede Seite behält automatische Schnappschüsse und
zusätzlich benannte Versionen, die du selbst speicherst. Vergleiche,
sieh, wer beigetragen hat, und stelle jeden früheren Stand wieder her —
Wiederherstellungen erscheinen live in jedem offenen Editor.
- **Papierkorb mit Schonfrist.** Gelöschte Seiten liegen in einem
Papierkorb pro Teich und lassen sich wochenlang wiederherstellen,
bevor sie endgültig entfernt werden.
- **Echte Backups.** Nächtliche Datenbank- und Datei-Backups, optional
externe Kopien auf eine **Nextcloud** deiner Wahl und eine getestete
Ein-Klick-Wiederherstellung — inklusive dokumentiertem Weg, eine
Instanz aus dem Nichts wieder aufzubauen.
## Organisieren, wie du denkst
- **Seitenbaum**: Seiten unter Seiten verschachteln (bis zu 6 Ebenen) —
Slugs und Links bleiben flach, Verschieben bricht also nie etwas; der
ZIP-Export bleibt ebenfalls flach (die Hierarchie ist rein
organisatorisch).
- **Wissensgraph**: eine interaktive Karte jedes Teichs — Seiten als
Knoten, Wikilinks als Kanten, fehlende Ziele als gestrichelte
Phantome, die ein Klick anlegt; jede Seite hat zusätzlich einen
lokalen Nachbarschafts-Graphen.
- **Labels**, auf Wunsch hierarchisch, um einen Teich beliebig zu
gliedern — und um Zugriffsregeln zu begrenzen (siehe unten).
- **Schnelle Volltextsuche** über alles, was du lesen darfst —
unempfindlich gegen Akzente und Umlaute, mit Teilwort-Treffern.
- **Inhaltsverzeichnis, Seitenindizes, Diagramme** und mehr über
mitgelieferte Plugins (siehe „Erweiterbar" unten).
## Teile genau so viel, wie du willst
- **Feingranulare Berechtigungen.** Vergib Lese- oder Schreibrechte pro
Teich, pro Label oder pro Seite — an einzelne Personen, an alle
angemeldeten Mitglieder oder ans öffentliche Internet. Deny-Regeln
schneiden Ausnahmen heraus. Ein eingebauter Inspektor („Effektive
Rechte") erklärt, _warum_ jemand eine Seite sehen kann oder nicht.
- **Öffentliche Seiten.** Veröffentliche ausgewählte Seiten schreibgeschützt
für die Welt, mit sauberen URLs — der Rest des Teichs bleibt privat.
- **Kommentare.** Diskutiere in Threads direkt neben dem Inhalt, erledige,
was geklärt ist, und entscheide pro Teich, ob alle Lesenden oder nur
Bearbeitende kommentieren dürfen.
- **Benachrichtigungen unter deiner Kontrolle.** Beobachte Seiten oder
ganze Teiche, nutze den In-App-Posteingang und wähle E-Mail-Digests
(stündlich, täglich oder aus) — mit funktionierendem Abmeldelink.
## Deine Dokumente kommen und gehen frei
- **Import** von Word- (`.docx`), LibreOffice- (`.odt`) und
Markdown-Dateien — eingebettete Bilder inklusive.
- **Export** jeder Seite als Markdown, Word, LibreOffice oder **PDF**
(mit der Typografie deines Teichs) und jedes Teichs als ZIP aus
Markdown-Dateien. Kein Lock-in, niemals.
## Maschinen sind auch willkommen — zu deinen Bedingungen
- **REST-API.** Eine saubere, token-authentifizierte öffentliche API zum
Lesen, Schreiben, Suchen, Labeln und Kommentieren — mit
OpenAPI-Beschreibung. Tokens tragen exakt die Berechtigungen ihrer
Besitzerin, nie mehr.
- **Eingebauter MCP-Endpoint.** Verbinde Claude Code oder einen anderen
MCP-fähigen KI-Assistenten direkt mit deinem Wiki — er kann suchen,
lesen und (wenn du es erlaubst) Seiten schreiben. Beide Schnittstellen
sind **standardmäßig aus**, und jeder Teich stimmt separat zu.
## Erweiterbar, aber sicher
- **Plugins** ergänzen Block-Typen (Mermaid-Diagramme, vollwertiges
**draw.io**-Bearbeiten), Seiten-Werkzeuge (Inhaltsverzeichnis,
Seitenindex) und Abschnitts-Stile. Jedes Plugin läuft in einer strikten
Sandbox: keine Cookies, kein Storage, kein Netzwerk — es kann nie mehr
lesen als die Person, die es gerade ansieht.
- Referenz-Plugins werden mitgeliefert und dienen zugleich als
dokumentierte Vorlagen für eigene Plugins.
## Privat by design
- **Selbst gehostet.** Ein `docker compose up`, ein freundlicher
Einrichtungsassistent beim ersten Start — und es gehört dir. Alles,
Schriften eingeschlossen, wird von deiner eigenen Domain ausgeliefert:
Seiten stellen **null Anfragen an Dritte**.
- **DSGVO-freundlich.** Impressums- und Datenschutzseiten sind eingebaut
(mit Vorlagen), persönliche Daten als ZIP exportierbar, Konto-Löschung
mit inhaltserhaltender Pseudonymisierung und ein Audit-Log der
administrativen Aktionen.
- **Zweisprachig.** Die gesamte Oberfläche spricht Deutsch und Englisch;
jede Person wählt ihre Sprache selbst.
## Ehrlicher Betrieb
- Health-Endpoints, die „down" von „degraded" unterscheiden, ein
Admin-System-Panel mit Job-Status, Backup-Zustand, Audit-Log und
Speicherübersicht, monatliche automatisierte Restore-Übungen — der
Betreiber kann _beweisen_, dass die Backups funktionieren, statt nur
zu hoffen.
---
_Dorfteich ist MIT-lizenzierte Open-Source-Software. Wer Docker
betreiben kann, kann Dorfteich betreiben — siehe
[Self-Hosting](../self-hosting/README.md) (englisch)._