Инструкция

Подготовка

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

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

Обновление

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

docker compose pull
docker compose down
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 remove_clean_stale_ws_connections_deprecated_task

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

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

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

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

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

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

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

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

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

docker system prune -a

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

• 📊 Отчёты и аналитика
  • Сводные таблицы можно создавать с использование только столбцов или только строк.
  • Добавлены измерения по дате создания и обновления.
  • Добавлены фильтры по 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.