Стадии

Как устроены наборы стадий, что настраивается у каждой стадии и как набор связан с проектом. Как задача проходит стандартные стадии, описано в разделе «Как задача идёт по стадиям».

Наборы стадий

Стадии собраны в наборы. Проект работает по одному набору, а один набор может обслуживать несколько проектов. Колонки доски проекта — это стадии его набора.

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

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

Создать набор

Нажмите «Добавить набор стадий» и заполните форму:

Поле	Что указать
Название	Обязательно, не должно повторять название другого набора
Ключ	Обязателен. 2–32 символа: строчные латинские буквы, цифры, «-» и «_», начинается с буквы или цифры
Описание	Необязательно
Скопировать стадии из	Набор-образец. «Не копировать» — набор создастся пустым

Копия переносит стадии образца вместе со всеми настройками. Дальше наборы живут независимо: правка копии не трогает образец.

После создания сразу открывается список стадий нового набора.

Список наборов

У каждого набора в списке три кнопки:

• карандаш — сменить название, ключ и описание набора;
• стрелка — открыть стадии набора;
• корзина — удалить набор.

Удалить можно только набор, который не назначен ни одному проекту.

Стадии набора

Стадии идут в списке в том же порядке, что и колонки на доске. Порядок меняется перетаскиванием. Под названием стадии видно, кто может перевести на неё задачу. Отметки рядом с названием показывают служебные стадии: «Начальная», «Старт», «Финальная».

Новая стадия — кнопка «Добавить стадию», она встаёт в конец списка. Изменить стадию — карандаш, удалить — корзина.

Правка набора действует сразу во всех его проектах

Набор общий для всех проектов, которым он назначен. Если правило нужно поменять только для новых проектов, создайте для них отдельный набор копией.

Порядок стадий

От порядка зависит, куда агент отправит задачу после своего хода:

• «Работа принята» — на следующую стадию в списке;
• «Работа не принята» — назад, на ближайшую предыдущую стадию, где работает исполнитель.

Если следующей стадии нет или вернуть задачу некуда, она остаётся на месте и ждёт решения человека.

Настройки стадии

Поле	Что задаёт
Ключ	Обязателен, правила те же, что у ключа набора. Уникален внутри набора
Название	Обязательно, уникально внутри набора
Описание	Видно в шапке колонки на доске
Цвет	Цвет колонки и отметки стадии
Кто переводит на стадию	Какие участники задачи могут перевести её на эту стадию. Нужна хотя бы одна роль
Кто работает на стадии	Чья это стадия: ревизора, исполнителя или оператора
Таймаут стадии, сек	Сколько длится один ход агента. У новой стадии — 1800 секунд
Попыток	Сколько раз доска запустит агента, если запуск сорвался. У новой стадии — 3
Требует подтверждения человеком	Решение агента ждёт подтверждения, см. ниже
Инструкция стадии	Текст, который получает агент на этой стадии

Сохранить стадию нельзя без названия, без роли в «Кто переводит на стадию» и без роли в «Кто работает на стадии».

Кто переводит на стадию

В списке можно отметить «Ревизор», «Исполнитель» и «Оператор». Ревизора и исполнителя вместе выбрать нельзя: на стадию переводит либо одна сторона, либо другая.

Создатель и оператор задачи могут перевести её на любую стадию вручную, даже если их роли нет в списке. Пока агент работает над задачей, вручную её не перевести.

Кто работает на стадии

Если в этой роли у задачи агент, доска запускает его на стадии. Если роль у человека или не назначена, агент не запускается и задача ждёт, пока человек сделает свой ход. Подробнее — в разделе «Когда на стадии человек».

На стадии работает только одна роль. Если нужен ход другой роли, заведите для него отдельную стадию.

Служебные стадии

Три отметки делают стадию служебной:

Отметка	Что значит
Начальная	Сюда попадает новая задача. В новой доске это «Бэклог»
Старт работы агента	Сюда задача переходит при запуске: по времени из «Запустить в» или из очереди. С входа в неё начинается отсчёт фактического времени. В новой доске это «К запуску»
Конечная	Задача на ней закрыта. В новой доске это «Готово»

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

Согласование человеком

Если включено «Требует подтверждения человеком», решение агента на этой стадии не выполняется сразу. В карточке задачи появляется запрос в «Согласованиях», и задача ждёт, пока человек его одобрит или отклонит. В очереди «Авто» подтверждение пропускается.

Как выглядит запрос и кто его решает, описано в разделе «Согласования».

Попытки агента

Запуск срывается, если агент упал или не уложился в «Таймаут стадии, сек». Тогда доска запускает агента снова, пока не кончатся попытки из поля «Попыток». Когда попытки кончились, задача останавливается и ждёт человека. Какая сейчас попытка, видно в секции «Запуски» карточки задачи: «Попытка 2/3».

Удалить стадию

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

Стандартный набор

Так настроены стадии «Стандартного набора» в новой доске:

Стадия	Кто работает	Кто переводит на стадию	Попыток	Таймаут, сек	Подтверждение
Бэклог	Ревизор	Ревизор, Оператор	3	1800	нет
К запуску	Исполнитель	Ревизор	1	900	нет
План	Ревизор	Исполнитель	2	1800	да
В работе	Исполнитель	Ревизор	3	3600	нет
Проверка	Ревизор	Исполнитель	1	900	да

«Бэклог» — начальная стадия, «К запуску» — старт работы агента. «Готово» — конечная стадия: на ней задача закрыта, перевести на неё может ревизор.

Набор стадий проекта

Набор выбирают при создании проекта, в поле «Набор стадий». По умолчанию подставляется «Стандартный набор». Подробнее — в разделе «Создать проект».

Набор проекта не меняется

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

Какой набор у проекта, видно в карточке проекта, на вкладке «Данные проекта», в строке «Набор стадий». Если у вас есть доступ к настройкам стадий, название набора — ссылка: она открывает стадии этого набора.