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

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

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

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

```bash
~# grep VERSION .env
SW_FRONTEND_VERSION=v5.4.0
SW_BACKEND_VERSION=v5.4.0
SW_HELPCENTER_VERSION=v5.4.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\. Запустите команду, которая переведет условия пользовательских фильтров, использующих кастомные поля, в новый формат:

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

3\. Запустите команду, которая перенесет балансировщик, перераспределяющий заявки, на новый движок:

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

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

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

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

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

*   🧩 **Кастомные поля** 
    *   Поддержка **множественного выбора** кастомных полей в фильтрах
    *   Новые операторы ≥ / ≤ для кастомных полей типа *Число и Дата*
    *   Фильтрация и сортировка по **относительным датам** (например, «за последние 7 дней»).
*   💻 **Интерфейс и удобство работы**
    *   Улучшен UX работы с тикетами и статьями  — длинные строки теперь красиво переносятся.
    *   Поддержка **Статуса агента** в профиле и учет его для автоназначения тикетов и чатов
    *   Теперь правила автоназначения для перебалансировки тикетов можно запускать по расписанию через **новый механизм,** более эффективный по ресурсам и позволяющий задать собственное расписание.
    *   Правила автоназначения получили раздельные опции простого перевода в группу и остановки обработки остальных правил
    *   В списке статей теперь можно быстро фильтровать по их`id`.
*   🧱 **Виджет чата**
    *   Появились новые параметры `open` и `page` в URL — они влияют на то, как виджет открывается и маршрутизируется.
    *   Поддержка параллельной работы в нескольких браузерах/устройствах.

***

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

*   🗂 **Тикеты и кастомные поля**
    *   Исправлены ошибки фильтрации и отображения каналов.
*   💬 **Чаты и вебсокеты**
    *   Исправлена логика обновления WebSocket-соединений
    *   Исправлены ошибки при обновлении токена и мерцания интерфейса при смене маршрутов.
    *   Исправлено подключение и обновление состояния чатов.
*   🧾 **Почта и интеграции**
    *   Исправлено исключение объединённых тикетов при экспорте.
    *   Исправлена обработка комментариев без base64-данных в email.
*   🧩 **Интерфейс и оформление**
    *   Исправлены стили списка групп, бейджей навыков, кнопок и тёмной темы.
    *   Исправлены отступы, переносы текста и отображение в мобильной версии.