# Основные понятия

- Human documentation: [https://docs.univer.ai/ru-RU/guides/sheets/getting-started/quickstart](https://docs.univer.ai/ru-RU/guides/sheets/getting-started/quickstart)

- Agent Markdown: [https://docs.univer.ai/ru-RU/guides/sheets/getting-started/quickstart.md](https://docs.univer.ai/ru-RU/guides/sheets/getting-started/quickstart.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.2.0`

- Source: [sheets/getting-started/quickstart.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/sheets/getting-started/quickstart.ru-RU.mdx)

---

Познакомьтесь с плагинами, снимками, командами и Facade API Univer Sheets. Для создания редактора перейдите к [установке и основам использования](https://docs.univer.ai/ru-RU/guides/sheets/getting-started/installation.md).

## Основные понятия

Прежде чем углубляться в Univer, ознакомьтесь с его основными понятиями. Это поможет вам увереннее работать с системой.

К основным понятиям относятся:

* Плагин
* Снимок
* Команда
* Facade API

### Плагины

Все возможности Univer предоставляются плагинами — базовыми строительными блоками системы. Приложение Univer формируется из нескольких объединённых плагинов.

Плагины выполняют следующие задачи:

1. Реализуют функции: например, `@univerjs/sheets-filter` добавляет фильтрацию.
2. Предоставляют базовые возможности: например, `@univerjs/engine-render` отвечает за рендеринг.

Вы можете комбинировать плагины Univer, чтобы настроить приложение под свои требования и не загружать лишний код. Кроме того, вы можете создавать собственные плагины и расширять возможности Univer для конкретных задач.

#### Полезные ссылки

1. [Создание плагина для импорта CSV](/blog/csv-import-plugin) — узнайте, как написать плагин.
2. [Архитектура Univer](/blog/univer) — подробнее об архитектуре Univer.

### Снимок

Чтобы загрузить документ в Univer, необходимо загрузить его снимок. Для каждого типа документа предусмотрен собственный формат снимка. В документации API описано, как сформировать снимок в соответствии с требованиями формата:

1. Формат снимка электронной таблицы — [`IWorkbookData`](https://docs.univer.ai/ru-RU/guides/sheets/model/workbook-data.md#iworkbookdata).
2. Формат снимка документа — [`IDocumentData`](https://docs.univer.ai/ru-RU/reference/types/document-data.md).

Функциональные плагины могут хранить ресурсы, например изображения, в поле `resources`. Подробнее см. в разделе [Пользовательская модель плагина](/blog/custom-model).

> [!WARNING: Внимание]
> Снимок Univer предназначен только для хранения данных. Во время выполнения он не отражает актуальное состояние
> документа. Чтобы сохранить текущее состояние документа как снимок, используйте соответствующий метод Facade API.

### Команда

В Univer любые изменения данных выполняются с помощью команд. Командный подход позволяет отслеживать изменения значений, реализовывать отмену и повтор действий, совместное редактирование, а также обрабатывать сложные взаимосвязи между функциями.

Если вы хотите изменять данные документа с помощью команд, см. раздел [Как найти идентификатор команды](/blog/find-the-command-id). При изменении данных через Facade API этот API сам подготавливает параметры и выполняет команды внутри системы.

> [!WARNING: Внимание]
> **Не изменяйте снимок напрямую.** Такие изменения не вступят в силу и не приведут к обновлению представлений или
> интерфейса. Изменяйте данные с помощью команд или Facade API.

### Facade API

Офисные приложения сложны, поэтому архитектура Univer также достаточно комплексна. Чтобы разработчикам было проще работать с Univer, мы предоставляем Facade API — оболочку над официальными плагинами Univer с более простыми интерфейсами.

Facade API активно развивается. Если у вас есть вопросы или пожелания, создайте issue на GitHub.

Facade API — это высокоуровневый API, скрывающий детали внутренней реализации. Он упрощает типовые задачи, однако для сложных функций может потребоваться понимание архитектуры Univer и прямое использование низкоуровневого API.

#### Полезные ссылки

1. [Использование Facade API](https://docs.univer.ai/ru-RU/guides/sheets/getting-started/facade.md)
2. [Общий API](https://docs.univer.ai/ru-RU/guides/sheets/features/core/general-api.md)
3. [API Univer Sheets](https://docs.univer.ai/ru-RU/guides/sheets/features/core/sheets-api.md)

## Режим пресетов и режим плагинов

Пресет объединяет настроенные плагины. При одинаковом наборе плагинов возможности режимов совпадают. Пресеты упрощают настройку, а режим плагинов даёт явный контроль над составом и загрузкой.

> [!WARNING]
> Версии всех зависимостей Univer должны совпадать. Не регистрируйте повторно плагин, уже включённый в пресет.

| Режим плагинов                  | Режим пресетов                                  |
| ------------------------------- | ----------------------------------------------- |
| Явный импорт расширений Facade  | Расширения Facade включены                      |
| Контроль порядка регистрации    | Пресет управляет своими плагинами               |
| Загрузка плагинов по требованию | Загрузка настроенных пресетов при инициализации |