Инструкция

Подготовка

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

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.4.0
SW_BACKEND_VERSION=v5.4.0
SW_HELPCENTER_VERSION=v5.4.0

Обновление

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

docker compose pull
docker compose down
docker compose up -d

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

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

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

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

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

2. Запустите команду, которая переведет условия пользовательских фильтров, использующих кастомные поля, в новый формат:

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

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

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

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

docker system prune -a

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

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

---

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

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