Выпуски

Релиз — это набор принятых фич, которые уходят пользователям одной выкаткой. Actari сам ничего не выкатывает: вы выкатываете как привыкли, а облако собирает релизы, замораживает их по выбранному правилу и закрывает, когда выкатка записана. Из записи выкатки облако двигает карточки на доске, закрывает фичи, рассылает сообщение «Релиз N» в Telegram и пополняет ленту обновлений.

Цикл релизаКопировать ссылку на раздел

У релиза есть номер в пространстве (Релиз 18, Релиз 19) и один из трёх статусов:

• Готовится — открытый релиз. Принятая фича попадает в него сама, помечена «авто». Открытых может быть несколько: следующий создаётся, когда вы переносите в него фичу.
• Заморожен — состав зафиксирован, ждёт выкатки. Релиз замораживается правилом (см. ниже) или кнопкой «Заморозить сейчас».
• Выпущен — выкатка записана, фичи стали «Выпущено». Следом сам открывается следующий релиз.

Если замороженный релиз стоит дольше периода расписания (в других режимах дольше 7 дней), он подсвечивается на странице «Релизы» («Заморожен 3 ноября, выкатки нет 9 дней»), а владельцы и администраторы один раз получают личное сообщение в Telegram: «Релиз N заморожен и ещё не выпущен».

Как формируются релизыКопировать ссылку на раздел

Режим задаёт владелец или администратор в «Настройки → Общие → Процесс → Выпуск» (виден при включённом учёте выпуска). Режимов четыре:

Смена режима не трогает открытый релиз: новое правило применится со следующей отсечки, принятия отмеченной фичи или выкатки.

Принято и выпущено — разные вещиКопировать ссылку на раздел

Проверенная работа ещё не у пользователей. Чтобы это различать, в пространстве есть учёт выпусков, и тогда на доске вместо одной колонки «Сделано» появляются две:

• Принято — проверено, но ещё не у пользователей.
• Выпущено — изменение уже у пользователей.

В разделе «Фичи» этим колонкам соответствуют статусы «Принята» и «Выпущена» и фильтр «Принято, ждёт выпуска».

Учёт включается сам, когда в пространство приходит первый выпуск из журнала. Пространство, в котором его нет, работает как раньше: принятая карточка сразу попадает в «Сделано», релизы не формируются, а каждая выкатка просто появляется в ленте. Владелец или администратор может включить или выключить учёт в настройках пространства; при включении сразу открывается релиз.

Что в релизеКопировать ссылку на раздел

Состав открытого релиза — принятые фичи без релиза (они «авто») плюс фичи, которые вы перенесли или закрепили. В карточке фичи видна плашка релиза: «Релиз 19 · авто», «Релиз 19 · закреплена», «Релиз 18 · выпущен». Меню «Перенести» отправляет фичу в следующий релиз или в любой открытый и замороженный, и закрепляет её там; «Вернуть в авто» снимает закрепление. Выпущенный релиз целью переноса быть не может. Состав и всё, что к нему относится (тест-план, регрессии, архитектура, пункты выкатки), — на странице релиза, см. Тест-план.

Как записать выпускКопировать ссылку на раздел

После выкатки агент вызывает record_release. В items перечисляются фичи (по slug) и любые свободные строки, в ref стоит коммит или тег выкатки, а в notes — название и одна фраза «что нового» для каждого пункта:

record_release { project: "shop",
                 items: ["csv-export", "fix-login-redirect"],
                 ref: "4f3e8f2",
                 notes: [
                   { item: "csv-export", title: "Выгрузка отчёта в CSV",
                     note: "Отчёт можно скачать файлом, который открывается в Excel" },
                   { item: "fix-login-redirect", title: "Исправлен вход по ссылке",
                     note: "После входа вас возвращает на нужную страницу" }
                 ] }
sync {}

Фраза «что нового» — до 160 символов, пишется для пользователя продукта, а не для разработчика. Без notes пункт покажется своим slug. Вызов sync отправляет запись в облако сразу, чтобы уведомление не ждало.

Выпуск записывается один раз на выкатку и не привязан к одной задаче. Повторная отправка того же выпуска ничего не меняет, а более поздний выпуск той же фичи обновляет дату и подпись.

Что происходит в облакеКопировать ссылку на раздел

1. Релиз. Закрывается открытый или замороженный релиз пространства (старейший замороженный, иначе текущий открытый): он становится «Выпущен». Фичи, которых не было в релизе, но которые вы записали в выкатку, добавляются в него; непринятые фичи релиза уходят в следующий. Если выкатки двух проектов пришли с разницей до часа, вторая дописывается в тот же релиз, а не закрывает следующий.
2. Доска. Карточки фич из выпуска переезжают из «Принято» в «Выпущено», на них видны дата и подпись выпуска (коммит или версия). Если фичу выпустили раньше, чем приняли, карточка остаётся в своей колонке с пометкой «Уже у пользователей» и переедет после приёмки.
3. Фича закрывается сама. Если все неотменённые карточки фичи стали «Выпущено», она из «В работе» становится «Готово» (в списке фич при учёте выпусков — «Выпущена»). Кнопку «Сдать» нажимать не нужно. В ленте фичи появляется запись «Фича сдана по выпуску» с подписью выпуска.
4. Telegram. В группу пространства, а если групп нет — в личные сообщения приходит сообщение «Релиз N»: фичи со ссылками и фразами «что нового» отдельно от мелких правок. Его включают и выключают переключателем «Выпуски: что вышло на прод» в настройках уведомлений. Подробности — на странице Бот в Telegram.
5. Лента обновлений. Выпуск попадает на страницу «Релизы» выпущенным релизом, с теми же названиями и фразами. Владелец может сделать ленту публичной и поделиться ссылкой с пользователями, см. Лента обновлений.

Выпуск без журналаКопировать ссылку на раздел

Команда, которая выкатывает без агента, нажимает «Выпустить» на карточке релиза на странице «Релизы» или на странице самого релиза (у текущего открытого и у замороженного релиза) и подтверждает выпуск. Релиз становится выпущенным, фичи переходят в «Выпущено», а уведомления уходят так же, как для выпуска из журнала. Если ошиблись, пункт «Убрать из выпуска» в меню карточки вернёт фичу в «Принято» и в авто-состав, а закрытую этим выпуском фичу вернёт в «В работе».

Если выпуск не должен быть виден снаружиКопировать ссылку на раздел

Если агент записал в выпуск то, что не стоит показывать наружу, владелец или администратор во внутренней ленте нажимает «Скрыть из публичной» у выпуска или у отдельного пункта. Внутри пункт остаётся с пометкой «скрыто», а наружу пропадает.

Что дальшеКопировать ссылку на раздел

• Что должно произойти до выпуска: Приёмка.
• Как скилл feature доводит работу до записи выпуска: Скиллы цикла.
• Инструмент подробно: Справочник MCP.