Документация

Контракты по результатам

Завершённость работы — это результат выполнения задачи, выходящий за рамки простого объединения изменений в pull request, оформленный тем, кто её инициировал.

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

У каждой новой задачи он есть. Он принадлежит тому, кто инициировал работу, а не агенту, который её выполняет, чтобы сам агент не мог произвольно менять критерии успеха.

Где его найти

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

Как создаётся договор

Coroid формирует технический договор при создании задачи на основе уже имеющихся требований:

  • На основе критериев приемки. Задача с критериями приемки — на основе её спецификации или плана — получает черновик, условием успеха которого является успешное прохождение указанных сценариев, подтверждённое тестами в браузере.
  • На основе сигнала. Запрос, поступивший из системы мониторинга, автоматизации или рабочего ввода API, содержит соответствующий сигнал: ошибку, оповещение или проблему. Договор предусматривает, что этот сигнал исчезнет — больше не будет событий с таким же идентификатором из того же источника — после того, как изменение обслужит достаточное количество запросов на заданных маршрутах, и сохранится в таком виде в течение 24 часов. В запросе необходимо указать маршруты и количество запросов; подробнее — в поле signal поле приёма задач API.
  • При отсутствии измеримых критериев. Если нет критериев приемки или сигнала с указанием маршрутов и количества запросов, договор создаётся окончательным и неизмеримым. В нём об этом прямо сказано, без попыток скрыть факт.

Это касается всех задач, включая те, что Coroid создаёт сам как часть плана, в результате автоматизации или для устранения неполадок. Задачи, существовавшие до введения договоров, договоров не имеют.

Финализация и изменение договора

Условие черновик можно изменить. Финализировать означает зафиксировать его. После этого Новая версия сохраняет изменения как следующую версию, оставляя предыдущую — так всегда можно увидеть, что было обещано в начале работы.

Только тот, кто инициировал работу, может создавать договоры, или, при работе по мандату, — владелец мандата. Агенты и учетные записи служб не имеют права создавать, редактировать или финализировать договоры.

Результаты

Договор завершается одним из четырёх результатов:

РезультатЗначение
ПровереноУсловие успеха выполнено после достижения необходимого уровня воздействия и в установленный срок.
Не достигнутУсловие успеха не выполнено.
НеоднозначныйИзменение не получило достаточного воздействия для однозначного вывода.
НеизмеримыйПоказатель невозможно измерить.

Договоры и объединение изменений

Договор никогда не объединяет изменения и не блокирует их объединение. Решение об объединении остаётся за человеком, как описано в Рецензировать и объединить результат. Договор лишь фиксирует, чего должно было достичь это объединение.