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

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

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

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

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

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



:::danger
ВАЖНО! Если Swarmica установлена внутри виртуальной машины Qemu, KVM, Proxmox, Hyper-V, проверьте, что режим эмуляции процессора установлен в host и внутри виртуальной машины доступны флаги ssse3, sse4\_1, sse4\_2, popcnt:



```bash
# grep -m1 'flags' /proc/cpuinfo
flags           : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ss ht syscall nx pdpe1gb rdtscp lm constant_tsc arch_perfmon rep_good nopl xtopology cpuid tsc_known_freq pni pclmulqdq vmx ssse3 fma cx16 pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand hypervisor lahf_lm abm 3dnowprefetch cpuid_fault invpcid_single ssbd ibrs ibpb stibp ibrs_enhanced tpr_shadow vnmi flexpriority ept vpid ept_ad fsgsbase tsc_adjust bmi1 avx2 smep bmi2 erms invpcid mpx avx512f avx512dq rdseed adx smap clflushopt clwb avx512cd avx512bw avx512vl xsaveopt xsavec xgetbv1 xsaves arat umip pku ospke avx512_vnni md_clear arch_capabilities
```
:::



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

:::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
ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды
:::

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

### 🔐 Безопасность и интеграции

*   Версия python в backend ядре системы обновлена до 3.13
*   Администраторы теперь могут **отключать 2FA у пользователей** без подтверждения пароля.
*   Добавлена возможность использовать **ключи идемпотентности** в API запросах

***

### 🧠 AI и работа с ИИ

*   Добавлена возможность **управлять промптами для ИИ-функций для кастомизации:**
    *   Ваш Tone of Voice
    *   Создания черновиков статей в вашей структуре
    *   Работа с переводами и редакцией текста для тикетов и статей
    *   Промпты для Виртуального агента

***

### 📊 Отчёты и аналитика

*   Добавлены новые модификаторы для дат: **неделя, месяц, квартал с учетом часового пояса**.
*   Поддержка **относительных дат**
*   Добавлена возможность **пересчёта агрегированных метрик через API и UI**.
*   Возможность тонкой настройки **Точности vs Скорости** подсчета метрик в аналитике.

***

### ⚙️ Автоматизация и триггеры

*   Расширены возможности для действий по расписанию и событиям:
    *   поддержка **относительных дат в** условиях для автоматизаций вида: "Отправить сообщение если нет ответа от агента последние 30 минут"
    *   новые операторы (например, `IEXCLUDES`)
*   Автоматическая подстройка макросов под события в тикете `event.ticket.id`.

***

### 💬 Интерфейс и UX

*   Добавлены новые статусы агентов: **Перерыв** и **В Работе**.
*   Реализована возможность настройки **кастомного лейаута экрана тикета:**  изменение порядка и минимизация блоков
*   Минималистичный (свернутый) интерфейс SLA-счетчиков в тикете
*   Поддержка открытия формы создания тикета с URL-параметром `assignee=me`
*   Добавлены hash-ссылки на события в тикете

***

### 🌐 Брендинг и настройки

*   В настройки бренда добавлена возможность конфигурации системы:
    *   Протокол (https/http) доступа для конфигурации собственных обратных прокси
    *   Имя домена (по которому доступна система)
    *   Порт доступа

***

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

*   📊 Исправлены расчёты SLA, прогресс-бары и обновление метрик в условиях race condition.
*   💬 Исправлены ошибки отображения комментариев и шаблонов в определенных условиях/браузерах.
*   ⚙️ Повышена стабильность системы: кэш, фоновые задачи, обработка событий и API.