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

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

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

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

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

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

:::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\. Запустите команду подсчета метрики KvN в новом формате:

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

3\. Обновите настройки почтовых уведомлений по умолчанию:

```txt
docker exec --env-file .env -it swarmica-django-1  python manage.py setup_email_notifications -u -uf 'for_robots'
```

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

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

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

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

*   🌍 **Хелпцентр и статьи**
    *   Добавлена **фильтрация статей по языку** внутри категорий.
    *   Статьи теперь отображаются **только для выбранной локали**, а при фильтрации исключаются пустые переводы.
    *   Добавлена сортировка статей **по дате публикации** — самые свежие наверху.
    *   Реализовано удаление комментариев к статьям.
*   🧩 **Кастомные поля и фильтры**
    *   Поддержка фильтра **ISNULL** (поиск пустых значений) для кастомных полей, пользователей и организаций.
    *   Добавлен **оператор time range** для фильтрации по кастомным полям дата и время.
    *   Добавлены индексы для ускорения работы с кастомными полями и перерасчет значений вынесен в отдельную фоновую задачу.
*   💬 **Работа с тикетами**
    *   В шаблонах ответов появились **категории, навыки и группы**, а также фильтры по этим параметрам.
    *   В API добавлено поле **автор комментария** при создании или редактировании тикета от третьего лица
    *   Можно менять дату *«До»* оставляя тикет в статусе "Ожидание"
    *   Перевод из статуса "Ожидание" в Решено и Закрыто.
    *   Поддержка **таблиц** в в ответах (только для почты и ЛК)
*   ⚙️ **Работа в мессенджерах**
    *   Поддержка **режима работы в группах** для Telegram-ботов.
    *   Обновлена совместимость и стабильность интеграций с Telegram, WhatsApp и VK — теперь пересылка сообщений надёжнее благодаря транзакционной обработке
*   📱 **Чат-виджет**
    *   Новые стили для поддержки интеграции в мобильное приложение, поддержка параметра `fullScreen`, новая звёздочная форма CSAT, корректное отображение кнопки «Назад».

***

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

*   🗂 **Тикеты и комментарии**
    *   Исправлены ошибки при изменении комментариев и отображении полей тикета.
    *   Исправлено удаление уведомлений из панели (колокольчика).
    *   Исправлено отображение статуса чата и фильтры по организациям пользователей.
*   💬 **Интерфейс и стили**
    *   Исправлены размеры иконок, выравнивание, перенос текста.
    *   Улучшен адаптив тикет-формы на мобильных устройствах.
*   📦 **Производительность и стабильность**
    *   Исправлены зависания при загрузке запросов и при открытии Helpcenter.
    *   Исправлены ошибки фоновых задач WebSocket и чистка устаревших соединений.
    *   Оптимизирована работа с кешем Redis
*   🧠 **Метрики и пересчёты**
    *   Исправлены ошибки расчёта при обновлении тикетов и комментариев.
    *   Исправлена конвертация чекбоксов в фильтрах кастомных полей.
*   📱 **Виджет чата**
    *   Исправлено падение виджета при работе в нескольких вкладках браузера.
    *   Исправлена обработка кликов по звёздам рейтинга (CSAT) на мобильных устройствах.