Инструкция

Подготовка

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

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

Обновление

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

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_cf_permissions

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

docker system prune -a

Новые фича-флаги

__ai_ticket_summary - для ИИ-провайдеров, поддерживающих эту функцию, включает возможность резюмировать заявки

__delete_comment_attachments - разрешает сотрудникам поддержки с ролью Агент, Менеджер или Администратор удалять вложенные файлы в заявках

__private_attachments - включает режим дополнительной защиты вложенных файлов, запрещая их предварительный просмотр и доступ по прямой ссылке без авторизации. Дополнительно, можно регулировать степень размытия миниатюр изображений таких файлов с помощью переменной env PRIVATE_THUMBNAIL_BLUR_RADIUS (по умолчанию 12 пикселей, чтобы отключить - укажите 0)

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

🧠 ИИ-функции:

• Теперь можно в один клик получить полное Резюме всей переписки в заявке, а так же рекомендации по улучшению качества сервиса

🔐 Безопасность и приватность:

• Расширили возможности по настройке доступа к Кастомным полям: теперь можно для каждой роли указывать возможность видеть и редактировать то или иное поле
• Добавили режим повышенной защиты для вложенных файлов – теперь для них не существует прямой ссылки, (включается фича-флагом __private_attachments)
• Добавили возможность "мягкого" и полного удаления вложенных файлов через веб-интерфейс

🎯 Фильтры и массовые действия:

• Добавили возможность массового редактирования навыков в заявках
• Добавили возможность задавать навыки через Макросы
• Добавили возможность фильтрации заявок и пользователей без навыков (оператор ISNULL)

⚙️ Автоназначение и работа с заявками:

• Добавили возможность отключать автоматическое назначение при создании заявки
• Добавили отключаемое почтовое уведомление ответственному о том, что заявка перешла в статус Решение предоставлено
• Для приложенных медиа файлов можно размывать миниатюры предварительного просмотра

🔌 Интеграции и экосистема:

• Для исходящих вебхуков добавилась возможность настраивать параметры действий при ошибке: количество повторных попыток, время между попытками, HTTP статусы, на которые выполнять повторные попытки
• Для исходящих вебхуков добавилась возможность передавать ключ идемпотентности в теле запроса или в заголовках
• Добавили возможность проверять настройки авторизации в ИИ-провайдерах

📚 Работа со статьями и базой знаний:

• Добавили возможность копировать часть статьи из KCS-виджета в буфер обмена или вставлять непосредственно в ответ клиенту с помощью перетаскивания
• Для авторизованных сотрудников в базе знаний отображаются Архивные статьи, с пометкой об их возможной неактуальности
• Добавили поддержку языков cmake и Makefile в блок кода редактора статей
• Добавили настраиваемое почтовое уведомление при снятии флага на доработку статьи

🎨Общие улучшения:

• Добавили возможность настраивать роли и состояние "по умолчанию" для почтовых уведомлений, а так же массово применять новые настройки ко всем пользователям системы
• Добавили индикатор сворачивания/разворачивания панелей в заявке
• Добавили возможность сбрасывать сортировку списков при повторном нажатии на название колонки
• Добавили возможность выбора Категорий шаблонов в окошке быстрой вставки шаблона ответа
• Добавили возможность клиентам самостоятельно переводить заявки в статус Решена из статуса Новая
• Добавили динамический заголовок вкладки браузера для всех разделов системы

🔧Устранены проблемы:

• Лишняя HTML/XML разметка в заявках, созданных через почту
• Сбрасывается выбор отображения тела KCS статьи в заявке