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

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

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

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

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

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

Удалите контейнер `cron` из раздела `services` `docker-compose.yml` и том `swarmica_cron_d` из раздела `volumes` и всех сервисов:

```yaml
volumes:
  swarmica_postgres_data: {}
  swarmica_postgres_data_backups: {}
  swarmica_static: {}
  swarmica_logs: {}
  swarmica_ugc: {}
  swarmica_ai_assistant: {}
  swarmica_uploads: {}
  swarmica_runtime: {}
#  swarmica_cron_d: {} Эту строчку нужно удалить
  traefik_data: {}

services:
  django: &django
    ...
#      - swarmica_cron_d:/swarmica/swarmica/cron_d/:z Эту строчку нужно удалить

# Эту секцию целиком нужно удалить
#  cron:
#    <<: *django
#    restart: always
#    depends_on:
#      - postgres
#      - redis
#    command: /start-cron
#    volumes:
#      - ./.env:/etc/environment:ro
#      - swarmica_ai_assistant:/swarmica/swarmica/ai_assistant/articles/:z
#      - swarmica_cron_d:/etc/cron.d/:z
#      - swarmica_ugc:/swarmica/swarmica/attachments:z
#      - swarmica_runtime:/swarmica/swarmica/runtime_scripts/:z
#    labels:
#      - "traefik.enable=false"
```

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

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

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

```bash
docker compose pull
docker compose down --remove-orphans
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_choices_order
```

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

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

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

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

5\. Если вы используете ИИ-провайдер Yandex, то выполните следующую команду:

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

6\. Выполните команду создания шаблонных карточек для проверки AQI (контроль качества статей):

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

7\. Выполните команду создания шаблонных карточек для проверки LAI (контроль точности связанности):

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

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

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

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

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

### 🤖 AI

*   ⚡️⚡️⚡️ Добавлена поддержка **собственной (локальной) LLM** через OpenAI API
*   Добавлена поддержка новых AI-провайдеров:
    *   **ChatGPT**
    *   **DeepSeek**

### 📊 Отчёты и автоматизации

*   Добавлены новые модификаторы выбора временных интервалов событий.
*   Добавлен параметр **group\_rows** для группировки строк в отчетах.
*   Добавлен механизм предохранителя при попытке построить слишком большой отчет.
*   Улучшена сортировка и отображение поисковых результатов.
*   Добавлены описания для правил автоназначения.

### 🧠 Контроль качества

*   Реализовано полноценное управление собственными правилами оценки **Точности связанности** и **Индекса качества статей.**
*   Переработаны разделы оценки Контроля Качества, Точности связанности и Индекса качества статей – добавлены фильтры, сортировки и поиск.

### 📩 Омниканальность

*   Добавлена поддержка  работы Telegram через прокси сервер.
*   Улучшена надежность работы Email каналов при нестабильном сетевом соединении.

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

*   Добавлена поддержка массового обновления статей.
*   Добавлена возможность удаления локализации статьи.
*   Добавлена возможность drag-and-drop сортировки пунктов выбора в кастомных полях типа *Меню* или *Бейдж.*
*   Появилась возможность сворачивания длинных комментариев.

***

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

*   🎨 Исправлены проблемы с отображением layout’ов, вложений и комментариев.
*   🧾 Исправлены race condition при обновлении тикетов, SLA и fork операций.
*   💬 Улучшена стабильность и расширено покрытие сценариев установщика Swarmica
*   ⚙️ Повышена стабильность фоновых задач, кеширования и AI Assistants.
*   🧩 Исправлены проблемы с генерацией ревизий статей и обновлением вложений.

##