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

Фабрика

Что поставила фабрика, сколько это стоило, что требует вашего участия и как прошла каждая часть работы.

Фабрика — это страница, на которую вы попадаете после входа в систему. Она отображает то, что поставила ваша фабрика и сколько это стоило, а также то, что требует вашего участия; каждая задача и план описывают историю того, как всё прошло. Из неё можно получить доступ к задачам, потокам, планам, автоматизациям и отчётам, чтобы у вас был один центр для ответа на вопрос «Что мы получили и что от меня требуется?».

Для чего она предназначена

Фабрика отвечает на вопрос «Что было поставлено, сколько это стоило и что от меня требуется?». Mission Control — всего в один клик — отвечает на вопрос «Что выполняется прямо сейчас?».

Это различие важно, когда у вас одновременно выполняется более пары задач. Фабрика — это место, где вы принимаете решения; Mission Control — место, где вы наблюдаете за процессом.

Обзор

Выберите текущую неделю или месяц, а также все Проекты или один из них под соответствующим заголовком.

  • Три показателя: количество объединённых запросов на объединение, завершённая работа и потраченные средства, каждый из которых сравнивается с показателями предыдущего периода («на 4 единицы больше, чем на прошлой неделе»). Количество объединённых запросов на объединение pull request учитывает все такие запросы в ваших подключённых репозиториях, независимо от того, кто их открыл, и показывает, сколько их обработал Coroid («11 запросов от Coroid»). Выберите любой показатель, чтобы увидеть его динамику за последние восемь недель или месяцев; стоимость обработки одного запроса на объединение pull request Coroid указана под диаграммой. Эти данные берутся из фактических записей, а не из модели.
  • Требует вашего участия Раздел перечисляет только решения, которые необходимо принять: план для утверждения, работу для проверки или объединения, тестовую задачу, не принадлежащую ни к одной задаче, запрос на принятие и работу, которая завершилась ошибкой или заблокирована. Его заголовок отображает общее количество таких элементов; первые пять из них показаны, а Показать больше добавляет остальные элементы. Откройте строку, чтобы увидеть действие, которое нужно выполнить, или отложите её с помощью кнопки «Не сейчас».
  • Проекты Раздел отображает по одной строке для каждого Проекта с работой за выбранный период, причём сначала идут те, где больше всего объединённых запросов. Откройте строку, чтобы увидеть показатели самого Проекта, текущую работу, информацию о том, корректно ли работает поставленный продукт в производственной среде, а также детали выполнения работы: как часто проверка качества проходила успешно с первого раза и сколько времени занимает переход от запроса до поставки. Проекты, в которых за период не было работы, объединяются в одну строку («4 проекта находятся в режиме ожидания»).
  • Завершено на этой неделе Раздел перечисляет результаты, от самых новых к старым; рутинные операции автоматизации объединены в одну строку.
  • Вся работа Открывает полный список Задач, потоков, планов, автоматизаций и отчётов с разбивкой по статусу.

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

Фабрика
Эта неделяcoroid-expoМои запросыКраткий обзор Фабрики
Объединено
9
6 more than last week
7 с помощью Coroid
Завершено
7
5 more than last week
Потрачено
17,41 $
376 % more than last week
14 сент.Эта неделя
Требует вашего внимания10
Выбрать
  • Upgrade uuid (breaking change) is blockedcoroid-expo · 2 дня назад
  • Pin our GitHub Actions and let Dependabot keep them current stoppedcoroid-expo · 4 дня назад
  • Pin our GitHub Actions and let Dependabot keep them current stoppedcoroid-expo · 4 дня назад
Проекты
  • coroid-expo9 объединено · 7 завершено · 17,41 $ · 10 ожидают вашего вмешательства

Обзор Фабрики: три показателя и диаграмма за неделю, задачи, требующие вашего внимания, и по одной строке для каждого проекта. Иллюстративные данные.

Быстрое принятие нескольких решений сразу

Если в разделе «Требует вашего участия» накапливается старая работа, выберите несколько строк сразу: наведите курсор на строку, и её точка превратится в флажок, или воспользуйтесь Выбрать рядом с заголовком (на мобильных устройствах). Выделить все выбирает все строки. Затем:

  • Не сейчас откладывает строки для вас до тех пор, пока статус работы не изменится. Другие пользователи по-прежнему будут видеть их.
  • Закрыть для всех (владельцы и администраторы) архивирует планы, отменяет Задачи, ожидающие проверки, и удаляет остальные элементы (неудачную работу, тестовые задачи, запросы) для всей организации до тех пор, пока их статус не изменится. Coroid сначала запросит ваше подтверждение, и ничего не будет удалено.

Принятие решения об объединении

План, готовый к объединению, открывается для принятия решения: сколько времени он ожидал обработки, что произойдёт при объединении («Объединение поместит его в основную ветку coroid-expo»), список фактов (его Задачи, проверки, pull request) и закрытые разделы с описанием изменений, важной информацией, доказательствами и историей его создания. Утвердить и объединить ещё раз запросит ваше подтверждение перед объединением; Другие варианты предлагает варианты «Запросить изменения», «Задать вопрос по этому», указание pull request и имени ветки.

Как прошла та или иная часть работы

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

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

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

Работа, которая была остановлена, отмечается красным цветом, с указанием того, что безопасно («Безопасно: основная ветка не изменена»), причин остановки (последние сообщения и зафиксированная ошибка) и Повторить сейчас.

В конце истории вы можете:

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

Наблюдение за выполнением задачи

Откройте запущенную задачу, чтобы следить за её ходом в реальном времени: выполняемые шаги, вызываемые инструменты, изменяемые файлы и результаты тестов по мере их накопления.

Стоит сделать это несколько раз в начале работы. Наблюдение за полным циклом выполнения двух-трех задач поможет лучше понять, как составлять качественные спецификации, чем любая документация — вы увидите точно, где агенту пришлось делать предположения.

После этого прекратите наблюдение. Уведомления сообщат вам, когда потребуется ваше вмешательство.

Вмешательство

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

Автоматизация

Работа начинается не только после того, как кто-то введет описание:

  • Автоматизации запускают работу по расписанию или при возникновении определенных событий, например, при открытии pull request. Они перечислены в разделе «Автоматизации».
  • Расписания выполняют работу на регулярной основе.
  • Хуки реагируют на события платформы.
  • Отчеты составляют сводку произошедшего по расписанию.

В этом разделе