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

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

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

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

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

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

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

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

3\. Запустите команду миграции данных о событиях на новый формат

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

Данная команда может выполняться достаточно долгое время, в зависимости от объема данных в системе, вплоть до нескольких часов.

4\. Запустите команду добавления шаблонов новых сообщений для ботов, если вы используете каналы Telegram, Whatsapp и/или VK:

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

Если вы не используете мессенджеры для получения заявок в Swarmica, этот шаг можно пропустить.

5\. Если вы используете ИИ-функции с Yandex GPT, то выполните миграцию с Assistants API на Responses API:

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

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

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

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

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

*   📊 **Отчёты и аналитика**
    *   Сводные таблицы можно создавать с использование только столбцов или только строк.
    *   Добавлены измерения по дате создания и обновления.
    *   Добавлены фильтры по **CC и BCC** для тикетов.
*   🧠 **Статьи и управление знаниями**
    *   Улучшен поиск дубликатов статей: используется индексный поиск и более точные подсказки.
    *   Возможность создавать и использовать собственные шаблоны для статей.
    *   Поддержка событий ревизий статей — основа для автоматизаций и аудита.
    *   Расширенные фильтры статей: фильтрация по продуктам, версиям, платформам и задачам.
    *   Возможность настраивать видимость статьи до публикации.
*   ⚙️ **Автоматизация и триггеры**
    *   Добавлен графический интерфейс с конфигурации действий по условиям
*   🎨 **Интерфейс и UX**
    *   Возможность создания вкладок в редакторе статей.
    *   Новые языки для кода (SQL, HTML) и  улучшенную работа со ссылками в редакторе статей.
    *   Сортировка для по метрикам списках оценок **QA / LAI / AQI** .
    *   Поддержка `cc_emails` при создании тикета через URL..

***

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

*   🧾 **Тикеты, SLA и QA**
    *   Исправлены ошибки расчёта SLA.
    *   Тикеты на QA-оценку попадают теперь только единожды..
*   💬 **Мессенджеры и чаты**
    *   Telegram: исправлена работа с большим количеством файлов и их именами.
    *   Улучшено логирование сообщений.
    *   Исправлено поведение чатов при логине и в fullscreen-режиме.
*   📈 **API и отчёты**
    *   Исправлены NaN-значения в отчётах.
    *   Корректная фильтрация datetime по дате.
*   🧹 **Стабильность системы**
    *   Упрощена структура core-views и lifecycle-хуков.
    *   Улучшена документация CLI-команд и внутренних процессов.
    *   AI-ассистент для **YandexGPT** переведён на **Responses API**.