dorfteich/docs/de/features.md
Claude Fable 5 2d51a55119
All checks were successful
CD / Build and push images (push) Successful in 2m40s
CD / Deploy to Test (push) Successful in 10s
CD / Smoke tests against Test (push) Successful in 1m9s
CI / Lint, typecheck, test (push) Successful in 4m23s
CI / Build container images (push) Has been skipped
CD / Promote to Int (push) Successful in 12s
CI / Auth e2e pack (push) Successful in 6m15s
CI / Import/export fidelity gate (push) Successful in 47s
Release / Build release images and notes (push) Successful in 1m7s
Release / Release-candidate operations QA (push) Successful in 41s
Prod deploy / Deploy the released images to Prod (push) Successful in 16s
QA: wire the M13 packs into CI, document the vault import (#119)
CI runs the two new packs after the graph pack (chained, each preceded
by the login rate-limit reset): create-missing-page.spec.ts (#115) and
import-vault.spec.ts (#117/#118).

Docs: the pond-admin guide gains a full 'Import an Obsidian vault'
chapter — the three dialog choices, and what happens to folders, links
(including the duplicate-name rule: the alphabetically first vault path
wins), tags, images, and embeds, plus the limits and the all-or-nothing
semantics. The user guide explains following a link to a page that does
not exist yet. features.md gets both bullets. German mirrors updated
throughout (English stays authoritative).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-14 18:28:45 +02:00

141 lines
6.8 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).
- **Obsidian-Vault-Import**: Eine Teich-Administration lädt einen ganzen
Vault als ZIP hoch — Ordner werden zum Seitenbaum, Tags zu Labels,
`[[Wikilinks]]` werden so umgeschrieben, dass sie weiter funktionieren,
und Bilder kommen als Teich-Dateien mit
- **Tote Links sind einen Klick von einer Seite entfernt**: Wer einen Link
auf eine noch nicht existierende Seite öffnet, bekommt sie direkt zum
Anlegen angeboten
- **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)._