dorfteich/docs/de/features.md

Dorfteich — was es ist und warum du es haben willst

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

• 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 (englisch).