📖 This is a static documentation page. Open the interactive version with live canvas demos →

Сохранение процесса

Каждая модель процесса на холсте может быть сохранена в облако как версионный файл. Система сохранения собирает все элементы, упаковывает их в сжатый архив и загружает — сохраняя полную иерархию, микроэлементы, среду, поток и все свойства.

Что сохраняется

Конвейер сохранения собирает четыре категории данных:

Элементы процесса

Все Изделия, Операции, Переходы и Действия на холсте — включая:

  • Основные свойства (ID, тип, тип перехода, параметры)
  • Иерархию вложенности (отношения родитель-потомок)
  • Данные контрольного плана, прикреплённые к операциям
  • Теги, назначенные каждому элементу

Микроэлементы (Natives)

Все BES-микроэлементы — включая:

  • Идентификацию группы и расширения
  • Базовое значение времени
  • Качественные и численные факторы
  • Назначения тегов (механизация, цель, носитель, поток)

Элементы среды

Все рабочие места, оборудование, персонал, профессии и другие элементы среды — включая:

  • Тип и иерархию
  • Множители и коэффициенты вариации
  • Флаги домена и коды

Данные потока

Все узлы и связи потока — включая:

  • Типы узлов, порты и уровни качества
  • Соединения связей и логику (временнáя стоимость, записи затрат, влияние на качество)
  • Привязки к операциям

Конвейер сохранения

Шаг 1 — Сбор

Система обходит дерево элементов, начиная с элементов верхнего уровня. Для каждого элемента:

  • Определяет, является ли он элементом процесса, микроэлементом или элементом среды
  • Дедуплицирует по ID (каждый элемент упаковывается ровно один раз)
  • Упаковывает элемент в портативный формат

После сбора всех трёх категорий система также собирает данные потока для всех собранных элементов процесса.

Шаг 2 — Упаковка

Элементы сериализуются в JSON — портативный формат, который отбрасывает свойства, существующие только в рантайме (ссылки на DOM, контроллеры перетаскивания, реактивные обёртки), и сохраняет только данные, необходимые для реконструкции.

Шаг 3 — Сжатие

Данные JSON сжимаются в ZIP-архив с помощью библиотеки fflate. Архив содержит:

  • Файл данных с сериализованными элементами
  • Файл метаданных с информацией о версии

Шаг 4 — Загрузка

Сжатый архив отправляется на сервер через событие `sendToCloud` Socket.IO. Сервер:

  • Проверяет сессию и квоту пользователя
  • Сохраняет данные в коллекцию data MongoDB
  • Создаёт или обновляет запись в коллекции meta MongoDB
  • Возвращает подтверждение с ID файла

Когда происходит сохранение

  • Ручное сохранение — инициируется пользователем через клавиатурное сочетание или кнопку в интерфейсе
  • Сохранение всегда является полным снимком — нет инкрементальных или частичных сохранений
  • Каждое сохранение создаёт новую версию файла

Формат файла

Сохранённый файл — это ZIP-архив с JSON-данными. Этот формат:

  • Компактен (сжатый бинарный формат)
  • Может быть эффективно сохранён и передан
  • Содержит всю информацию для полной реконструкции состояния холста

Формат сохранения самодостаточен. Сохранённый файл может быть загружен в любом экземпляре приложения без внешних зависимостей.


Квота

У каждого пользователя есть квота хранения. Если сохранение превысит квоту, сервер отклоняет загрузку с ошибкой `QUOTA_EXCEEDED`, сообщая текущее использование и лимит. Управляйте квотой, удаляя старые версии или ненужные файлы.