Инструкция

Подготовка

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

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

Если планируется использование двухфакторной аутентификации, то необходимо добавить новый фича-флаг 2fa

Так же, на этом же шаге можно подключить оптимизацию портала базы знаний для LLM.

Обновление

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

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. Запустите команду переименования поля chat_status в status:

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

3. Запустите команду переноса статуса автоназначения в поле status:

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

4. Если вы используете YandexGPT, то в этом релизе необходимо его перенастроить:

4.1. Переключите модель с YandexGPT-Lite на YandexGPT

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

4.2. Сбросьте состояние YandexGPT до "чистого":

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

После того, как завершатся все пост-апгрейдные шаги, будет необходимо перейти в графический интерфейс > Настройки > Интеграции > Провайдеры ИИ и заново включить ИИ-ассистентов

5. Запустите подсчет коэффициента несоблюдения SLA, который используется для упорядочивания тикетов при автоназначении:

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

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

docker system prune -a

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

🔐 Безопасность и доступы

• Возможность использования 2FA через TOTP и Email
• Черный список скомпроментированных JWT токенов
• Маскирование паролей, токенов и других чувствительных данных в API
• Защищенная форма ввода паролей, токенов и других чувствительных данных

🧠 Работа со статьями

• Возможность перевода всей статьи целиком (ИИ)
• Возможность создания 30+ вкладок (табов) в статью
• Авто-якоря заголовков
• События изменения статусов и сегментов статей
• Расширенные настройки SEO для статей
• Оптимизация базы знаний для LLM

📬 Автоматизация и шаблоны

• Поддержка Jinja в email-автоматизациях (to / cc / bcc)
• Поддержка Jinja переменных в тикетах
• Добавлен Индекс SLA, как интегральный показатель соблюдения/несоблюдения всех счетчиков, сконфигурированных в политиках, применяемых к тикетам

📊 Отчеты и фильтры

• Добавлены новые объекты и измеряемые сущности
• Поддержка isnull для продуктов/компановки/версий/платформ
• Модификаторы Час и День недели для полей типа Дата и время в отчетах + возможность задавать часовой пояс для этих модификаторов
• Возможность сортировки в конструкторе отчётов
• Возможность поиск по отчётам в конструкторе отчетов
• Доступ к отчетам для роли Менеджер в конструкторе отчетов

💬 Мессенджеры и каналы

• Углублена интеграция с MAX
• Добавлены настройки, ссылки и поддержка в виджете

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

🎨 Исправлены проблемы с редактором: видео, форматирование текста, отмена, выпадающие меню и стили.
📊 Отображение в отчётах: локали, даты, SLA-счётчики и отображение данных.
🧾 Исправлены ошибки логики автоназначения и обработки событий.
💬 Улучшена стабильность мессенджеров и обработка комментариев.
⚙️ Повышена стабильность и производительность системы: кэш, API, миграции и фоновые процессы.