Инструкция

Подготовка

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

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

# 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

Обновление

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

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

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

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

• Версия 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.