Совместное редактирование
Координируйте параллельные изменения через OT, HTTP, WebSocket и постоянное хранение.
Сотрудничество в режиме реального времени позволяет людям и подключенным агентам работать над одним и тем же документом. Сначала редактирование вступает в силу локально. Затем сервер заказывает редактировать и распространяет их другим участникам, поэтому пользователи получают немедленную обратную связь, в то время как все участники сходятся на одном и том же контенте.
Параллельная работа и конфликты
Univer использует OT (Operational Transformation) для координации одновременных правок. Клиенты группируют свои операции редактирования в пакеты изменений, а сервер преобразует каждый пакет изменений в подтвержденные изменения перед его совершением. Клиенты сходятся после того, как они получают изменения друг друга.
Например, Алиса редактирует C2, в то время как Боб вставляет столбец перед B. Преобразованное редактирование следует за ячейкой в D2. Отмена и переделка также учитывают удаленные операции. OT пытается сохранить намерение пользователя, но не может автоматически разрешать каждый бизнес-конфликт.
Операция, которая не может быть преобразована или применена, помещает клиента в конфликтное состояние и отключает редактирование для этого документа. CollaborationConflict сообщает причину и локальные изменения, которые никогда не были признаны. Приложения могут использовать эту информацию для восстановления или сохранения работы пользователя, но они должны сохранять локальные данные перед перезагрузкой. См. Восстановление конфликтов и OT и дизайн совместной работы.
Каналы и переподключение
| Канал | Назначение |
|---|---|
| HTTP | Загружает снимки и обменники, получает билет на сеанс и отправляет изменения. |
| WebSocket | Поддерживает сеанс совместной работы и комнату документов, а также получает ACK, удаленные изменения и уведомления о присутствии. |
Клиент обменивает одноразовый билет сеанса на соединение с WebSocket и присоединяется к залу документа. Присутствие делится онлайн-членством, курсорами и выборами по тому же соединению. Состояние клиента продвигается по мере того, как сервер подтверждает изменения. Подключенный сокет или успешный HTTP-запрос не указывают на сохранение правки. Derive сохраняет статус от ACKs, статус совместной работы и ожидающие изменения.
При отключении клиент может кэшировать еще не признанные правки. При повторном подключении он извлекает пропущенные изменения и пересылает отложенные представления. Сервер дублирует представления, поэтому повторный запрос не применяется дважды. См. состояние синхронизации и повторы и Присутствие.
Хранение и снимки
Служба совместной работы сохраняет подтвержденные изменения и доработки и генерирует снимки в соответствии со своей политикой. Загрузка документа восстанавливает снимок, а затем применяет изменения, которые последовали за ним. Не каждое редактирование требует нового снимка.
Для расчета при генерации снимков см. Расчет без головы и на стороне сервера. Исторические панели, комментарии и обзор проектов агентов предоставляются отдельным Расширения сотрудничества, который может быть добавлен по мере необходимости.
Развёртывание
- Одиночный узел: собирает Транспорт, конечную точку, Сервис и Адаптер баз данных внутри приложения Node.js. Памяти достаточно для временного тестирования, SQLite подходит для локальных и небольших развертываний, а другие базы данных подключаются через Адаптер, предоставляемый приложением.
- Масштабный дизайн: общая настойчивость сама по себе недостаточна. Трансляция документов через узлы, Присутствие, Проверка билетов сеанса и согласованность хранения также должны быть согласованы. Добавление большего количества процессов обслуживания не обеспечивает эти возможности, поэтому следуйте дизайну развертывания для версии, которую вы интегрируете.
- Отдельные тяжелые задачи: развертывает CPU-интенсивное преобразование файлов отдельно, чтобы уменьшить его помехи с отзывчивостью к сотрудничеству.
См. Обязанности модуля для полной сборки, Руководство по развертыванию - для этапов развертывания и многоузловый пример.
Производительность и ёмкость
Пока еще не определены ориентиры эффективности и показатели пропускной способности для текущей версии. Вместимость и задержка совместной работы зависят от размера документа, частоты редактирования, количества сотрудников на документ и среды развертывания.
Когда вы оцениваете систему, учитывайте время подтверждения отправки, время удаленного отображения, изменения в секунду, объем трансляции и память, используемую активными документами.
Подключение и охват
Начните с Обзор сотрудничества, чтобы понять, как связаны модули, затем запустите двухбраузер Быстрый старт для проверки редактирования, подтверждения и вещания. Идентификацию и авторизацию подключают через приложение Middleware. Для прочных данных выберите постоянный Адаптер базы данных и проверьте, что контент выживает при перезапуске службы.
Сфера применения
Базовый сервис поддерживает Sheet, Doc, Slide, Canvases и Relational Table; PDF не входит в это пятипродуктовое базовое покрытие. Приложения обеспечивают идентификацию, авторизацию, управление файлами и политику хранения. История, комментарии и Worktree являются отдельными расширениями.
Насколько полезно это руководство?