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

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

Обновления важно выполнять последовательно: если версия Swarmica ниже необходимой, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.
:::

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

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

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

### Обновление

:::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_cf_permissions
```

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

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

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

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

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

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

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

:::note
[Подробнее](https://support.swarmica.com/article/ru/596-ficha-flagi-features-vozmozhnost-vklyuchat-i-vyklyuchat-bloki-funkcij-v-swarmica.html) про добавление/удаление фича-флагов
:::

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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