#1039: Обновление v5.3.x

Инструкция

ВАЖНО! Перед обновлением на v5.3.x необходимо иметь версию Swarmica не ниже v5.2.x

Подготовка

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

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

2. Если вы используете SEO-оптимизированный сервис helpcenter, то проверьте, что настройка выполнена в соответствии с тем, используется ли внешний балансировщик или нет:
1040: Конфигурация SEO-оптимизированного публичного портала базы знаний (helpcenter, хелп-центр)

Обновление

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

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

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

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

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

  • 📱 UX и UI
    • Возможность выбора языка на портале базы знаний для смены локали, а также поиска статей внутри этой локали
    • Оптимизированы стили и сделана адаптивная вёрстка для работы с телефона. Будьте всегда на связи со Swarmica!
    • Возможность перетаскивать и расширять окно ответа в тикете
    • Возможность включать/выключать автоназначение прямо из списка сотрудников
    • Фильтрация по группам прямо в списке сотрудников
  • 📄 Работа с тикетами
    • Возможность создания исходящих тикетов для взаимодействия со смежными подразделениями или контрагентами вне Swarmica
    • Возможность создавать дочерние тикеты и управлять ими из основного окна для взаимодействия со смежными подразделениями внутри Swarmica
    • Возможность выбора формата уведомлений о тикетах (html или plain) для конкретных пользователей
    • Флаги для аккаунтов третьих систем для отключения служебных уведомлений по тикетам и минимизации "битвы роботов"
  • 🤖 AI и KCS
    • Индексация и векторизация первичных черновиков статей для использования AI-ассистентом.
    • Возможность обновить уже созданную и привязанную WIP статью в тикете при появлении дополнительной информации и/или финального решения
  • ⚙️ Автоматизация и триггеры
    • Поддержка макросов для триггеров и cron-задач.
    • Возможность добавлять действия в списки триггеров и cron-jobs.
    • Возможность скачивать код скриптов прямо из интерфейса.
  • 🎧 Интеграции и каналы связи
    • Добавлен новый канал: телефония Beeline PBX для создания тикетов по звонку и логирования записей разговора.
  • 🧩 Контроль качества (QA)
    • Возможность изменять оцениваемого сотрудника в процессе оценки
    • Возможность удаления оцениваемой сущности
    • Добавлен расчёт процента выполнения правил QA критериев.

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

  • 🧾 Тикеты и SLA
    • Исправлена проверка SLA-политик и счётчиков после комментариев.
    • Устранены проблемы с валидацией email и URL в формах тикетов.
    • Исправлено отображение свойств организаций без доменов.
  • 💬 Чаты и боты
    • Исправлено задваивание сообщений
    • Исправлена передача канала при блокировке пользователя.
  • 🧑‍💼 Пользователи и права
    • Исправлены коды ошибок API и валидация ролей.
    • Добавлены уникальные ошибки при создании пользователя с уже существующим email.
  • 📊 QA и оценки
    • Исправлена фильтрация карт QA по правилам.
    • Исправлено отображение даты и поля оцениваемого.
  • 📡 Интеграции и экспорт
    • Исправлена ошибка передача данных при экспорте отчётов
    • Добавлены метатеги кодировки в шаблоны экспорта.
    • Исправлен разбор вложений email в формате message/rfc822.