# Обновление v5.6.x
# Инструкция

:::danger
ВАЖНО! Перед обновлением на v5.6.x необходимо иметь версию Swarmica не ниже [v5.5.x](https://support.swarmica.com/article/ru/1128-obnovlenie-v55x.html "v5.5.x")

Обновления важно выполнять последовательно: если версия Swarmica ниже v5.5.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, а затем устанавливать v5.6.x.
:::

### Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

```bash
~# grep VERSION .env
SW_FRONTEND_VERSION=v5.6.0
SW_BACKEND_VERSION=v5.6.0
SW_HELPCENTER_VERSION=v5.6.0
```

### Обновление

:::tip
Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально
:::

Выполните обновление с перезагрузкой системы:

```bash
docker compose pull
docker compose down
docker compose up -d
```

### После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1\. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py post_start
```

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2\. Запустите команду создания отсутствующих шаблонов сообщений для WhatsApp и Telegram ботов:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py restore_bot_messages
```

3\. Если используете модуль **Контроль Качества Сервиса**, пересчитайте метрику **Несоблюдение критериев качества сервиса**:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py aggregated_metric_qa_criteria 500
```

4\. Пересчитайте значения SLA, если используете метрики **Время без ожидания** и **Время решения в поддержке**:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py recalculate_sla -e
```

5\. Запустите очистку неиспользуемых данных:

```bash
docker system prune -a
```

:::tip
ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды
:::

## ✨ **Основные улучшения**

*   🔎 **Подключение внешних источников для поиска (доступно в Премиум)**
    *   Теперь Swarmica может искать информацию за пределами своей базы. Можно подключать внешние порталы документации, базы знаний и т.д (при наличии соответствующего API) для поиска непосредственно:
        *   В хелпцентре
        *   В **KCS-виджете**, чтобы быстрее находить решения.
        *   В веб-виджете
    *   Helpcenter также получил поддержку внешнего поиска.
*   📊 **Гибкие отчеты (Beta доступно в Премиум)**
    *   В системе появились система гибких отчетов  - построение сводных таблиц по собственному выбору и компоновке метрик с сортировкой, усреднением, суммаризацией и т.д.
*   🧠 **KCS и статьи**
    *   Поддержка **ревизий статей** и события при их добавлении (для автоматизаций и вебхуков)
    *   Добавлено поле `issues` в `/api/articles/` и в экспорт — теперь статьи можно связывать с задачами.
    *   Добавлен **фильтр по задачам** для статей в API и языке запросов.
*   💌 **Мессенджеры**
    *   Реализована отправка и обработка **CSAT-оценок** в Telegram и WhatsApp.
    *   При отправке файлов в Telegram теперь сохраняются оригинальные имена.
*   🧩 **UX**
    *   Теперь при создании шаблона из комментария копируются вложения.
    *   Добавлен поиск по имени в в списке фильтров..

***

## 🔧 **Исправленные ошибки**

*   🗂 **SLA и метрики**
    *   Теперь уведомление "тикет назначен" отправляется при создании тикета с заведомо назначенным агентом.
    *   Исправлен экспорт тикетов — корректное отображение `timedelta` и названий связей.
    *   Исправлено сохранение и перерасчёт SLA через Celery.
    *   Исправлены ошибки в диаграммах QA Criteria.
*   💬 **Коммуникации и интеграции**
    *   Добавлены логи отправки и получения сообщений в WhatsApp.
    *   Исправлено обновление выпадающего списка доменов электронной почты.
    *   Helpcenter теперь корректно сохраняет параметр URL при переходе по статье.
*   ⚡ **Производительность и стабильность**
    *   Исправлено поведение WebSocket-переподключений.
    *   Исправлены циклические ссылки в дереве запросов.
    *   Оптимизирована работа с кэшом Redis