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

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

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

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

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

2\. Если вы используете SEO-оптимизированный сервис helpcenter, то проверьте, что настройка выполнена в соответствии с тем, используется ли внешний балансировщик или нет:
[1040: Конфигурация SEO-оптимизированного публичного портала базы знаний (helpcenter, хелп-центр)](https://support.swarmica.com/article/ru/1040.html)

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

:::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 system prune -a
```

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

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

*   📱 **UX и UI**
    *   Возможность выбора языка на портале базы знаний для смены локали, а также поиска статей внутри этой локали
    *   Оптимизированы стили и сделана адаптивная вёрстка для работы с телефона.  Будьте всегда на связи со Swarmica!
    *   Возможность перетаскивать и расширять окно ответа в тикете
    *   Возможность включать/выключать автоназначение прямо из списка сотрудников
    *   Фильтрация по группам прямо в списке сотрудников
*   📄 **Работа с тикетами** 
    *   Возможность создания **исходящих тикетов** для взаимодействия со смежными подразделениями или контрагентами вне Swarmica
    *   Возможность создавать **дочерние тикеты** и управлять ими из основного окна для взаимодействия со смежными подразделениями внутри Swarmica
    *   Возможность выбора формата уведомлений о тикетах (html или plain) для конкретных пользователей
    *   Флаги для аккаунтов третьих систем для отключения служебных уведомлений по тикетам и минимизации "битвы роботов"	
*   🤖 **AI и KCS**
    *   Индексация и векторизация первичных черновиков статей для использования AI-ассистентом.
    *   Возможность обновить уже созданную и привязанную WIP статью в тикете при появлении дополнительной информации и/или финального решения
*   ⚙️ **Автоматизация и триггеры**
    *   Поддержка **макросов** для триггеров и cron-задач.
    *   Возможность добавлять действия в списки триггеров и cron-jobs.
    *   Возможность скачивать код скриптов прямо из интерфейса.
*   🎧 **Интеграции и каналы связи**
    *   Добавлен новый канал: телефония **Beeline PBX** для создания тикетов по звонку и логирования записей разговора.
*   🧩 **Контроль качества (QA)**
    *   Возможность изменять оцениваемого сотрудника в процессе оценки
    *   Возможность удаления оцениваемой сущности
    *    Добавлен расчёт процента выполнения правил QA критериев.

***

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

*   🧾 **Тикеты и SLA**
    *   Исправлена проверка SLA-политик и счётчиков после комментариев.
    *   Устранены проблемы с валидацией email и URL в формах тикетов.
    *   Исправлено отображение свойств организаций без доменов.
*   💬 **Чаты и боты**
    *   Исправлено задваивание сообщений
    *   Исправлена передача канала при блокировке пользователя.
*   🧑‍💼 **Пользователи и права**
    *   Исправлены коды ошибок API и валидация ролей.
    *   Добавлены уникальные ошибки при создании пользователя с уже существующим email.
*   📊 **QA и оценки**
    *   Исправлена фильтрация карт QA по правилам.
    *   Исправлено отображение даты и поля оцениваемого.
*   📡 **Интеграции и экспорт**
    *   Исправлена ошибка передача данных при экспорте отчётов 
    *   Добавлены метатеги кодировки в шаблоны экспорта.
    *   Исправлен разбор вложений email в формате message/rfc822.