Инструкция

Подготовка

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

~# 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 и всех сервисов:

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"

Обновление

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

docker compose pull
docker compose down --remove-orphans
docker compose up -d 

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

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

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

2. Запустите команду для сохранения порядка пунктов меню в кастомных полях Меню и Бейдж:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_choices_order

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

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

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

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

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

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

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

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 (контроль точности связанности):

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. Запустите очистку неиспользуемых данных:

docker system prune -a

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

🤖 AI

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

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

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

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

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

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

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

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

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

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

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