Kollaboration
Orimora unterstützt Echtzeit-Kollaboration — mehrere Personen können dasselbe Dokument gleichzeitig bearbeiten, sehen wer online ist, hinterlassen Kommentare und durchstöbern den Revisionsverlauf.
Funktionsweise
Abschnitt betitelt „Funktionsweise“Kollaboration nutzt Yjs über eine WebSocket-Verbindung zum Pfad /collab auf derselben Origin wie die App (z. B. wss://orimora.com/collab).
- Änderungen synchronisieren nahezu in Echtzeit zwischen allen geöffneten Editoren
- Cursor und Auswahl jedes Nutzers erscheinen mit einem farbcodierten Label
- Das Dokument wird in PostgreSQL persistiert, wenn die Bearbeitung pausiert oder die Verbindung getrennt wird
Anwesenheits-Avatare
Abschnitt betitelt „Anwesenheits-Avatare“Wenn andere dasselbe Dokument bearbeiten, erscheinen in der Dokument-Meta-Leiste Avatar-Chips, die zeigen, wer aktiv ist. Fahre mit der Maus über sie für die Namen; bei vielen Nutzern erscheint eine „+N weitere“-Anzeige.
Für die Anwesenheit musst du nichts konfigurieren — sie aktiviert sich automatisch, sobald ein Dokument eine Collab-Session hat.
Kommentare
Abschnitt betitelt „Kommentare“- Text markieren im Editor
- Im Blasen-Menü auf Kommentar hinzufügen klicken
- Das Panel Kommentare öffnet sich — Nachricht schreiben und absenden
Kommentare sind an den markierten Text verankert. Klicke ein Kommentar-Highlight im Dokument an, um im Panel zum Thread zu springen.
Teammitglieder mit der Capability Beliebige Kommentare löschen können fremde Kommentare entfernen (siehe Berechtigungen).
Revisionsverlauf
Abschnitt betitelt „Revisionsverlauf“Öffne Verlauf aus dem Menü der Dokument-Panels.
- Revisionen werden beim Bearbeiten automatisch gespeichert
- Klicke einen beliebigen Snapshot an, um ihn mit der aktuellen Version zu vergleichen
- Wiederherstellen setzt das Dokument auf diesen Snapshot zurück (erzeugt eine neue Revision)
- Einzelne Snapshots löschen, sofern du Bearbeitungsrechte hast
Das Wiederherstellen wirkt sich nicht sofort auf den ungespeicherten Collab-Status anderer Nutzer aus — stimme dich mit deinem Team ab, bevor du auf aktiven Dokumenten wiederherstellst.
Server-Konfiguration
Abschnitt betitelt „Server-Konfiguration“| Variable | Zweck | Default |
|---|---|---|
COLLAB_SECRET | Optionales geteiltes Geheimnis für den Collab-Endpunkt | unset |
COLLAB_MAX_CONNECTIONS | Max. gleichzeitige WebSocket-Verbindungen | 50 |
COLLAB_MAX_YJS_STATE_BYTES | Max. Dokument-Zustandsgröße (Missbrauchsschutz) | 8 MB |
EXTRA_ALLOWED_ORIGINS | Zusätzliche erlaubte Origins, wenn die App über mehrere Domains erreichbar ist | — |
Setze EXTRA_ALLOWED_ORIGINS, wenn Nutzer die App über eine Staging-Domain oder einen alternativen Hostnamen erreichen, der dasselbe Backend teilt.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“| Symptom | Was prüfen |
|---|---|
| Bearbeitungen synchronisieren nicht | WebSocket blockiert? Browser-DevTools → Netzwerk → WS zu /collab |
| „Getrennt“-Banner | Netzwerkabbruch — Seite neu laden; WS-Timeout des Reverse Proxy prüfen |
| Collab funktioniert am Desktop, aber nicht mobil | Gleiche Origin erforderlich; kein gemischtes HTTP/HTTPS |
| Rate-Limits beim Login treffen alle hinter dem Proxy | ADDRESS_HEADER und XFF_DEPTH setzen — siehe Coolify Setup |
Siehe auch
Abschnitt betitelt „Siehe auch“- Editor — Schreiben, Slash-Befehle, Panels
- Berechtigungen & Gruppen — wer welche Collections bearbeiten darf
- Konfiguration —
COLLAB_*undEXTRA_ALLOWED_ORIGINS