예제

기능별 Collaboration SDK 예제를 실행하고 가이드와 서버·Web 진입점을 확인합니다.

모든 예제는 univer-collaboration-examples에 있습니다. 같은 최소 web/main.ts + server/main.ts 구조로 독립 실행됩니다. 빠른 시작을 완료한 후 통합 작업에 맞는 예제를 선택하세요.

예제	핵심 개념	명령
빠른 시작	핵심 협업 경로	`pnpm example:quick-start`
데이터베이스 어댑터	데이터베이스 어댑터	`pnpm example:database-adapter`
권한	신원 확인과 권한 부여	`pnpm example:permissions`
기록	파생 버전 기록	`pnpm example:history`
댓글	독립 댓글	`pnpm example:comments`
Worktree	격리 편집·병합	`pnpm example:worktree`
파일 변환	Office 파일 변환	`pnpm example:exchange`
다중 노드 배포	문서별 다중 노드 라우팅	`pnpm example:multi-node`

빠른 시작

Collaboration Client, Transport, Endpoint, Service, Memory Adapter를 조합합니다. 두 브라우저에서 같은 Sheet의 HTTP 로드, WebSocket Session, Room, ACK, 브로드캐스트를 확인합니다.

Bash

pnpm example:quick-start

http://127.0.0.1:3010/?unit=quick-start-sheet&type=2를 엽니다.

내장 SQLite Adapter의 사용법과 사용자 정의 Database Adapter의 구현을 보여줍니다.

Bash

pnpm example:database-adapter

http://127.0.0.1:3010/?unit=persistent-sheet&type=2를 엽니다.

Cookie로 신뢰할 수 있는 신원을 만들고 Unit HTTP 읽기, 실시간 JOIN, 변경 집합 제출을 각각 보호합니다. 페이지에서 교육용 Alice · Editor와 읽기 전용 Bob · Viewer를 전환합니다.

Bash

pnpm example:permissions

http://127.0.0.1:3010를 엽니다.

핵심 밖에 History Service, 독립 Adapter, History Endpoint, 브라우저 기록 진입점을 추가합니다. Unit 생성·변경 커밋 Events로 재구축 가능한 파생 기록 인덱스를 만듭니다.

Bash

pnpm example:history

http://127.0.0.1:3010/?unit=history-sheet&type=2를 열고 Sheet를 편집한 뒤 상단의 History를 선택합니다.

Thread Comment Service, 독립 Adapter, Comment Endpoint, 프런트엔드 댓글 진입점을 추가합니다. Comment Endpoint는 주 협업 Endpoint의 Session과 Unit Room을 재사용합니다.

Bash

pnpm example:comments

http://127.0.0.1:3010/?unit=comments-sheet&type=2를 열고 셀을 선택해 댓글 기능을 사용합니다.

격리 초안, Ready, Reopen, Unit별 Merge 수명 주기를 보여줍니다. 트렁크와 초안을 전환해 병합 전 AI Agent 변경의 격리를 확인합니다.

Bash

pnpm example:worktree

http://127.0.0.1:3010/?unit=worktree-sheet&type=2&worktree=demo-worktree를 엽니다.

@univerjs-pro/exchange-node와 Collaboration Service로 서버 Sheet 가져오기·내보내기, 작업 폴링, 스냅샷 가져오기, 확정 리비전 내보내기를 구성합니다.

Bash

pnpm example:exchange

http://127.0.0.1:3010/?unit=exchange-sheet&type=2를 엽니다. **File → Open (File)**로 가져오고 File → Save As로 내보냅니다.

다중 노드 배포를 통해 문서별 협업 부하를 여러 서버 노드로 분산하여 각 노드의 부담을 줄이고 전체 동시 처리 능력을 높입니다.

Bash

pnpm example:multi-node

http://127.0.0.1:3010/를 열고 New Sheet를 클릭해 파일을 만듭니다. 전체 URL을 다른 탭에 복사하여 같은 문서의 협업 편집을 확인하세요. 파일을 몇 개 더 만들어 여러 노드에 어떻게 할당되는지 살펴보세요.

예제는 운영 애플리케이션이 아닙니다

고정 사용자, 교육용 권한, Memory Adapter, 로컬 비밀 정보, 메모리 파일·작업 저장소는 학습용입니다. 신원 확인, 권한, 영속성, 비밀 정보, 파일, 배포, 제품 상호작용은 애플리케이션이 담당합니다.

이 가이드는 어떠셨나요?