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

:::danger
ВАЖНО! Перед обновлением на v5.0.x необходимо иметь версию Swarmica не ниже [v4.8.x](https://support.swarmica.com/article/ru/774-obnovlenie-v48x.html "v4.8.x")
:::

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

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

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

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

:::tip
Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально
:::

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

```bash
docker compose pull
docker compose up -d --remove-orphans
docker compose restart traefik
```

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

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

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 calculate_article_links
```
3\. Запустите команду перенастройки почтовых уведомлений в системе:

:::danger
ВНИМАНИЕ! Данная команда восстановит сопоставление почтовых настроек по умолчанию по ролям пользователей. Если в системе устанавливались другие настройки по умолчанию, эту команду выполнять не нужно
:::

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py setup_email_notifications --update-existing
```

4\. Если в системе используются функции ИИ, то необходимо запустить подсчет метрики потребления токенов:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py aggregated_metric_token_consumption 120
```

Если ИИ не используется, то данную команду запускать не нужно.

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

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

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


## 🧠 **AI-функции**

*   ✍ **Перефразировка текста** — сохранение нужного *tone of voice* в тикетах, статьях и чатах.
*   ✅ **Проверка текста (Proofread)** — автоматическая корректура текста в тикетах, статьях и чатах.
*   🌐 **Перевод ответов** — на русский и английский языки *(можно добавлять любые другие)*.
*   🔍 **Автопоиск решения** — при написании ответа выполняется поиск информации в «глобальном интернете».
*   📏 **Сжатие и расширение текста** — сокращение длинных или детализация коротких ответов.
*   🎯 **Нулевая линия** — автоматическая классификация входящих заявок и маршрутизация на агентов по навыкам и загрузке, с возможностью обучения.
*   🤝 **Синергия с KCS**
    *   💡 Автоматическое предложение решения клиенту **ещё до** создания заявки.
    *   🛠 ИИ-ассистент для агента — помощь в поиске узкоспециализированного решения в Базе знаний.
    *   📝 Автоматический анализ заявки и создание **черновика статьи** базы знаний.
    *   🔎 Проверка создаваемой статьи на возможные дубликаты.

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

*   📦 **Массовые действия с тикетами** — обновление сразу нескольких заявок, уведомления о выполнении.
*   **⚙️ QA:** Конфигурируемые карточки наборов критериев для разных групп агентов.
*   🤖 **Новые возможности автоназначения** — правила по навыкам агентов, времени создания тикета, удобный выбор исполнителя.
*   📧 **Работа с копиями (CC)** — добавление и управление адресами копий при создании, обновлении и форке тикетов, в UI и через API.
*   🛑 **Блокировка автоответов —** возможность отключать автоматические ответы сторонних систем для предотвращения "битвы роботов".
*   💬 **Цитирование комментариев** — поддержка цитат в тикетах, в том числе в VK и Telegram.
*   🔗 **Новые поля и типы данных** — кастомное поле «ссылка», расширенные параметры форм тикетов.
*   📊 Статистика потребления AI-токенов с фильтрацией и экспортом.
*   🔍 **Улучшенный фильтр и поиск** — новые операторы поиска (по задачам/issues, организациям, навыкам, идентичности пользователей), удобный выбор пользователей в фильтрах.
*   🖱 **Формы и кнопки** — унифицированные кнопки сохранения/отмены в редакторах правил, фильтров, EULA.
*   🎨 **UI и UX улучшения**
    *   Тёмная тема с поддержкой собственного логотипа и спиннера.
    *   Отправка сообщений в чат по **Ctrl/Cmd+Enter**.
    *   Подсветка синтаксиса Jinja2, поддержка Kotlin и YAML в редакторе кода.
    *   Более удобное редактирование данных о пользователях, организациях и заявках.
    *   Возможность копировать системные фильтры, автоматические правила и другие настройки.
    *   Оптимизация скорости работы таблиц и редактора статей.

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

*   ✅ **Обновление статуса и мердж тикетов** — исправлены проблемы с изменением статуса и логикой объединения заявок.
*   🔗 **Поля и ссылки** — корректное сохранение пользовательских полей, отображение ссылок и связанных статей.
*   👥 **Автоназначение** — исправлено поведение при изменении исполнителя системой.
*   💬 **Работа с чатом**
    *   Устранено «скакание» курсора в Firefox.
    *   Исправлена логика кнопок отправки сообщений.
*   🛡 **Лицензии, фильтры и роли** — корректная работа прав доступа и фильтров при различных настройках лицензий.
*   🌍 **Локализация** — исправлено отображение статей и переводов при смене языка.
*   📝 **Редакторы** — исправлены ошибки при подсветке синтаксиса в шаблонах писем и вставке ссылок.
*   🔄 **Интеграции с Billmanager** — исправлены ошибки синхронизации пользователей и тикетов.
*   📎 **Вложения** — исправлена обработка вложений и превью в массовых операциях.