Инструкция

Подготовка

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

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

Обновление

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

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

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

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

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

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

docker system prune -a

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

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

---

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

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