Collaboration en temps réel
Coordonnez les modifications simultanées avec OT, HTTP, WebSocket et persistance.
La collaboration en temps réel permet aux personnes et aux agents connectés de travailler sur le même document. Une modification prend effet localement d'abord. Le serveur commande ensuite les modifications et les distribue aux autres participants, de sorte que les utilisateurs reçoivent des commentaires immédiats tandis que tous les participants convergent sur le même contenu.
Concurrence et conflits
Univer utilise OT (Transformation Opérationnelle) pour coordonner les modifications simultanées. Les clients regroupent leurs opérations d'édition en changements, et le serveur transforme chaque changement par rapport aux révisions confirmées avant de le lancer.
Par exemple, Alice édite C2 alors que Bob insère une colonne avant B. L'édition transformée suit la cellule vers D2. Undo et redo tiennent également compte des opérations distantes. OT tente de préserver l'intention de l'utilisateur, mais il ne peut pas résoudre chaque conflit d'affaires automatiquement.
Une opération qui ne peut être transformée ou appliquée place le client dans un état de conflit et désactive l'édition pour ce document. CollaborationConflict rapporte la raison et les modifications locales qui n'ont jamais été reconnues. Les applications peuvent utiliser ces informations pour récupérer ou enregistrer le travail de l'utilisateur, mais elles doivent conserver les données locales avant de recharger. Voir le rétablissement des conflits et OT et conception de la collaboration.
Canaux et reconnexion
| Canal | Rôle |
|---|---|
| HTTP | Charge les instantanés et les modifications, obtient un ticket Session et soumet les modifications. |
| WebSocket | Maintenez la session de collaboration et la salle des documents, et recevez des ACK, des modifications à distance et des notifications de présence. |
Le client échange un ticket Session unique pour une connexion WebSocket et rejoint la salle du document. Présence partage l'adhésion en ligne, les curseurs et les sélections sur la même connexion. L'état du client avance comme le serveur confirme les révisions. Une socket connecté ou une requête HTTP réussie n'indique pas que l'édition est enregistrée. Derive save status from ACKs, collaboration status, and en attente de modifications.
Bien que déconnecté, le client peut cacher des modifications qui n'ont pas encore été reconnues. Lors de la reconnexion, il récupère les révisions qu'il a manquées et renvoye les soumissions en attente. Le serveur dédouble les soumissions, de sorte qu'une nouvelle tentative n'est pas appliquée deux fois. Voir état de synchronisation et relevés et Présence.
Persistance et snapshots
Le service de collaboration persiste les changements confirmés et les révisions, et génère des instantanés selon sa politique. Chargement d'un document restaure un instantané et applique ensuite les changements qui l'ont suivi.
Pour le calcul pendant la génération d'instantanés, voir Calcul sans tête et côté serveur. Les panneaux d'historique, les commentaires et l'ébauche de l'agent sont fournis par extensions de la collaboration séparé, qui peut être ajouté au besoin.
Architecture de déploiement
- Noeud unique: assemble Transport, Endpoint, Service et un adaptateur de base de données à l'intérieur de votre application Node.js. La mémoire est suffisante pour les tests temporaires, SQLite convient aux déploiements locaux et petits, et d'autres bases de données sont connectées par un adaptateur fourni par l'application.
- La seule persistance partagée de Conception de l'échelle: est insuffisante. La diffusion de documents entre nœuds, la présence, la validation de tickets de session et la cohérence de stockage doivent également être coordonnées.
- Séparer les tâches lourdes : déploie séparément la conversion de fichiers intensifs en CPU pour réduire son interférence avec la réactivité de collaboration.
Voir responsabilité des modules pour l'ensemble complet, guide de déploiement et exemple de multi-noeud.
Performances et capacité
Des repères de performance et des chiffres de capacité pour la version actuelle sont encore en attente. La capacité et la latence de collaboration dépendent de la taille du document, de la fréquence d'édition, du nombre de collaborateurs par document et de l'environnement de déploiement.
Lorsque vous évaluez le système, considérez le temps de réception, le temps d'affichage à distance, les changements par seconde, le volume de diffusion et la mémoire utilisée par les documents actifs.
Intégration et périmètre
Commencez par le Aperçu général de la collaboration pour comprendre la relation entre les modules, puis lancez le bi-browser démarrage rapide afin de vérifier l'édition, la reconnaissance et la diffusion. L'identité et l'autorisation sont connectées par l'application Middleware. Pour des données durables, sélectionnez un Adaptateur de base de données persistant et vérifiez que le contenu survit à un redémarrage du service.
Portée
Le service de base prend en charge Feuille, Doc, Diapositive, Toiles, et Table Relationnelle; PDF n'est pas inclus dans cette couverture de base de cinq produits. Worktree sont des extensions séparées.
Que pensez-vous de ce guide ?