Exemples

Exécutez les exemples du Collaboration SDK par fonction et consultez leurs guides et entrées serveur et Web.

Tous les exemples se trouvent dans univer-collaboration-examples. Ils partagent la structure minimale web/main.ts + server/main.ts et fonctionnent indépendamment. Terminez le démarrage rapide, puis choisissez selon votre intégration.

Exemple	Concept principal	Commande
Démarrage rapide	Circuit collaboratif central	`pnpm example:quick-start`
Adaptateur de base de données	Adaptateurs de base de données	`pnpm example:database-adapter`
Autorisations	Identité et autorisations	`pnpm example:permissions`
Historique	Historique dérivé	`pnpm example:history`
Commentaires	Commentaires indépendants	`pnpm example:comments`
Worktree	Édition isolée et fusion	`pnpm example:worktree`
Service de fichiers	Stockage de fichiers	`pnpm example:file-service`
Conversion de fichiers	Conversion Office	`pnpm example:exchange`
All Unit	Toutes les capacités réunies	`pnpm example:all-unit`
Déploiement à plusieurs nœuds	Mise à l’échelle horizontale	`pnpm example:multi-node`

Démarrage rapide

Assemblez Collaboration Client, Transport, Endpoint, Service et Memory Adapter. Vérifiez dans deux navigateurs le chargement HTTP, les Sessions WebSocket, Room, ACK et diffusions pour la même Sheet.

Bash

pnpm example:quick-start

Ouvrez http://127.0.0.1:3010/?unit=quick-start-sheet.

Adaptateur de base de données

Cet exemple montre comment utiliser le SQLite Adapter intégré et comment passer au PostgreSQL Adapter ou à votre propre Adapter.

Bash

pnpm example:database-adapter

Ouvrez http://127.0.0.1:3010/?unit=persistent-sheet.

Autorisations

Établissez une identité fiable par cookie et protégez séparément lecture HTTP Unit, JOIN temps réel et soumission. La page bascule entre un Alice · Editor pédagogique et un Bob · Viewer en lecture seule.

Bash

pnpm example:permissions

Ouvrez http://127.0.0.1:3010.

Historique

Ajoutez hors du cœur History Service, un Adapter distinct, History Endpoint et l’entrée historique du navigateur. Les Events de création Unit et de commit construisent un index dérivé reconstructible.

Bash

pnpm example:history

Ouvrez http://127.0.0.1:3010/?unit=history-sheet, modifiez la Sheet puis choisissez History en haut.

Commentaires

Ajoutez Thread Comment Service, un Adapter distinct, Comment Endpoint et l’entrée frontend. Comment Endpoint réutilise les Sessions et Rooms Unit de l’Endpoint principal.

Bash

pnpm example:comments

Ouvrez http://127.0.0.1:3010/?unit=comments-sheet, sélectionnez une cellule et utilisez les commentaires.

Worktree

Explorez le cycle complet : brouillon isolé, Ready, Reopen et Merge par Unit. Basculez entre tronc et brouillon pour voir les changements de l’AI Agent isolés avant fusion.

Bash

pnpm example:worktree

Ouvrez http://127.0.0.1:3010/?unit=worktree-sheet&worktree=demo-worktree.

Service de fichiers

Connectez File Service et File Endpoint : les images insérées dans la Sheet sont téléversées vers le serveur et les données de la Unit ne conservent que l’ID du fichier.

Bash

pnpm example:file-service

Ouvrez http://127.0.0.1:3010/?unit=file-service-sheet et insérez une image via Insert → Image → Float Image.

Conversion de fichiers

Assemblez Exchange Service et Exchange Endpoint pour l’import/export Sheet serveur, le suivi des tâches et l’export de révisions confirmées.

Bash

pnpm example:exchange

Ouvrez http://127.0.0.1:3010/?unit=exchange-sheet. Importez et exportez via la barre Import / Export au-dessus de l’éditeur.

All Unit

Combinez les six types de Unit, les fichiers, l’import/export, les pièces jointes incorporées, les commentaires, l’historique et l’impression dans une seule application.

Bash

pnpm example:all-unit

Ouvrez http://127.0.0.1:3010 et changez de Unit dans la barre latérale.

Déploiement à plusieurs nœuds

Exécutez deux nœuds de collaboration derrière Nginx. Redis relaie les mises à jour en temps réel entre les nœuds et partage les session tickets, de sorte que n’importe quel nœud peut servir n’importe quelle requête. Nécessite Docker Compose et une licence couvrant deux nœuds.

Bash

pnpm example:multi-node

Ouvrez http://127.0.0.1:3010/ et cliquez sur New Sheet pour créer un fichier. Copiez l’URL complète dans un autre onglet pour vérifier l’édition collaborative du même document. Créez ensuite quelques fichiers supplémentaires pour observer leur répartition entre les nœuds.

Guide de l’exemple

Les exemples ne sont pas des applications de production

Utilisateurs fixes, autorisations pédagogiques, Memory Adapters, secrets locaux et stockage en mémoire des tâches sont didactiques. Identité, autorisation, persistance, secrets, fichiers, déploiement et interactions restent à la charge de l’application.

Que pensez-vous de ce guide ?