Управление версиями (релизы продуктов)

В этом разделе описывается, как в LICANT-IT реализована версионность продуктов, а также как пользователи получают доступ к нужным дистрибутивам в своем Личном кабинете.

1. Как Релиз связан с Продуктом

В управление версиями добавлена сущность - Релиз продукта (это необязательное поле). Это выпуск обновления для конкретного продукта с датой и файлом. Релиз применим только к выбранным типам продукта. Релизы привязаны к продукту и к типам продукта через связь product_types.

У каждого продукта в Панели администратора есть поле «Версия» — основная версия (ветка), например: 1, 2, 3.

Основная версия используется:

• для отображения информации в карточке лицензии в Личном кабинете;
• для группировки релизов и истории обновлений продукта.

Если поле «Версия» пропущено, то в дальнейшем для продукта используется нумерация релизов.

2. Релизы продукта

К записи Релиза привязывается файл дистрибутива. При создании Релиза нужно сохранить дистрибутив в файловое хранилище LICANT-IT.

Релизы отображаются в отдельной таблице в Панели администратора, причем в этой таблице перечислены существующие релизы для всех продуктов.

Релизы сортируются ТОЛЬКО по дате релиза: актуальным для данного продукта (с учетом типа продукта) считается самый свежий по дате релиз. Именно он отображается по умолчанию в Личном кабинете.

3. Номер релиза

Номер релиза задаётся вручную и может быть произвольным (например: 2026.001, 002.dev, 1.92). Для удобства рекомендуется придерживаться единого стиля.

Правила:

• Длина номера релиза: от 1 до 8 символов. Может содержать не только цифры, но и любые символы.
• Сортировка и выбор актуального релиза выполняются по дате релиза, а не по номеру.

4. Создание релиза

Процесс создания релиза выполняется в два шага:

1. Открыть: Панель администратора → Релизы продуктов.
2. Нажать кнопку «Добавить релиз продукта» в правом верхнем углу.
3. Заполнить поля:

Шаг 1

На первом шаге заполняются:

• Продукт
• Номер релиза
• Файл дистрибутива
• Дата релиза
• Флаг Active
• История изменений

После нажатия кнопки ПРОДОЛЖИТЬ релиз в базе данных еще не создается: данные
сохраняются как черновик для второго шага.

Шаг 2

На втором шаге необходимо указать:

• Типы продукта (для которых доступен релиз)
• Флаг Отправить уведомление (опционально, если включена глобальная
  настройка уведомлений)

Релиз создается только после нажатия кнопки СОХРАНИТЬ на втором шаге.

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

5. Отображение релизов в Панели администратора

В Панели администратора доступны два способа просмотра Релизов продуктов:

• Пункт «Релизы продуктов» ведет на таблицу со списком всех выпущенных релизов для всех продуктов. Находится в левом меню.
• Также в Карточке продукта встроена таблица (inline) с последними релизами данного продукта.

Обратите внимание:

• В обеих таблицах последняя колонка — «История» — отображается иконкой. При наведении на иконку показывается всплывающее окно с текстом из поля «История изменений».

6. Отображение релизов в Личном кабинете пользователя

1. В основном окне Личного кабинета в списке лицензий нажмите на номер интересующей лицензии (в правом столбце) — откроется карточка лицензии.
2. В самом низу, в последнем разделе «Ссылки», доступна кнопка «Предыдущие релизы». По нажатию раскрывается таблица релизов.

Параметры таблицы:

• Показываются последние 10 релизов по текущему продукту лицензии для конкретного типа продукта.
• Сортировка: дата релиза по убыванию.

7. Как формируется ссылка на дистрибутив в Личном кабинете

Ссылка на дистрибутив есть и в карточке продукта, и в карточке релиза (как обязательное поле).

При наличии хотя бы одной ссылки на загрузку в Личном кабинете действуют следующие правила:

• Если в карточке продукта есть дистрибутив, а релизов у данного продукта нет, то в карточке лицензии в Личном кабинете отображается дистрибутив продукта.
• Если у данного продукта есть релизы, то вне зависимости от наличия дистрибутива в карточке продукта, в Личном кабинете отображается дистрибутив последнего релиза.
• Если ссылка на дистрибутив отсутствует в карточке продукта и у продукта нет релизов — дистрибутив не отображается.

8. История изменений

Поле «История изменений» предназначено для краткого списка изменений, реализованных в данном релизе. Также в нем можно хранить информацию об исправленных ошибках.

В разработке приняты и другие названия для поля «История изменений»: changelog (или release note).

9. Рекомендации

• Ведите даты релизов аккуратно; именно они определяют актуальность релиза.
• В карточке Типа продукта, если данный Тип продукта не предполагает поставки ПО (например, «Техническая поддержка»), включите флаг «Не требует дистрибутива». В этом случае данный Тип продукта не будет появляться при создании нового Релиза.