GitHub

Привязка запросов изменений к задачам и смена статуса задачи после слияния.

Когда GitHub подключен, Otdano сам находит запросы изменений (pull request) по номеру задачи и показывает их в карточке задачи. Если все связанные запросы влиты, задача переходит в статус, который выбрала область.

Otdano только читает GitHub: не пушит коммиты, не пишет комментарии и не ставит проверки.

Подключить GitHub

Подключает владелец или администратор области. Остальные участники видят состояние подключения, но менять его не могут.

В GitHub создайте токен доступа с правом чтения репозиториев и запросов изменений. Ссылка Создать доступ GitHub в форме подключения ведет на нужную страницу GitHub.
В Otdano откройте Настройки → Код и в строке GitHub нажмите Подключить GitHub.
Вставьте токен в поле Доступ GitHub и нажмите Подключить. Если токен уже сохранен в области, выберите его в списке Подключение GitHub.
В разделе Репозитории нажмите Добавить репозиторий и выберите Выбрать из GitHub или Добавить вручную (владелец/репозиторий).

Otdano проверяет токен в GitHub и хранит его в зашифрованном виде. После подключения в строке GitHub видно Подключен и имя учетной записи GitHub.

Otdano следит только за репозиториями из списка Репозитории. Этот же список агенты получают как репозитории для работы с кодом.

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

Настройки

Раздел Запросы изменений и задачи в Настройках → Код. Менять их могут владелец и администраторы области.

Настройка	Что делает
Запросы изменений в задаче	Показывает связанные запросы в боковой панели задачи. Выключение только прячет блок, связи сохраняются.
Автосвязь задач и запросов изменений	Привязывает запрос к задаче по номеру в названии, ветке или описании. Ручную привязку не отключает.
Подпись соавтора	Просит агентов добавлять в свои коммиты `Co-authored-by: otdano-agent <agent@otdano.ru>`.
После слияния перевести задачу в	Статус задачи после того, как все ее запросы влиты: Готово (так в новой области), На проверке, В работе или Не менять статус.

Привязать запрос к задаче

Проще всего указать номер задачи в названии запроса или в названии ветки. Для задачи OTDA-123:

otda-123-fix-login-redirect

OTDA-123: исправить переход после входа

Номер можно писать в любом регистре или в виде №123. Otdano ищет только номера с префиксом своей области. Один запрос может закрывать несколько задач.

В описании запроса номер работает только сразу после ключевого слова:

Closes OTDA-123
Fixes OTDA-123
Resolves OTDA-123

Подходят и формы close, closed, fix, fixed, resolve, resolved. Одно ключевое слово привязывает один номер: для двух задач напишите Closes OTDA-1, closes OTDA-2. Простое упоминание вроде «связано с OTDA-123» запрос не привязывает. Сообщения коммитов Otdano не читает.

Привязать вручную можно в карточке задачи. В блоке Запросы изменений нажмите +, вставьте ссылку вида https://github.com/владелец/репозиторий/pull/номер и нажмите Привязать. Чтобы убрать запрос из задачи, нажмите крестик Убрать из задачи в его строке.

Запросы в задаче

В блоке Запросы изменений у каждого запроса видны название, репозиторий с номером и состояние: Открыт, Черновик, Влит или Закрыт. Строка ведет на запрос в GitHub.

Если Otdano еще не получил данные запроса, вместо состояния написано «состояние не проверено». Так остается и для запросов из репозиториев, которых нет в списке Репозитории. Если данные не обновлялись больше часа, рядом указана дата последнего обновления.

Когда задача меняет статус после слияния

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

Задача переходит в выбранный статус, когда:

все связанные с ней запросы влиты. Открытый запрос или черновик держит задачу. Запрос, закрытый без слияния, тоже держит ее, пока его не уберут из задачи;
задача не в «Готово» и не в «Отменено», еще не в целевом статусе, и для нее не включено Не менять статус при слиянии PR;
слияние случилось после того, как область выбрала текущее значение настройки. Смена настройки не трогает задачи, чьи запросы влили раньше.

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

Если запрос закрывает только часть работы или после слияния нужна проверка, в блоке Запросы изменений откройте меню ⋯ и выберите Не менять статус при слиянии PR. Пункт Настройки слияния PR в том же меню ведет в Настройки → Рабочие процессы: там переключатель Закрывать задачи, когда их PR слиты включает переход в «Готово» или выключает его.

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

Отключить GitHub

В Настройках → Код нажмите Отключить в строке GitHub. Otdano перестает забирать запросы, новые связи не появляются. Список репозиториев и уже привязанные запросы остаются в задачах, но их состояние больше не обновляется.

Чтобы GitHub перестал принимать сам токен, отзовите его в настройках GitHub.

Если запрос не привязался

Запроса нет в задаче. Проверьте, что GitHub подключен, репозиторий есть в списке Репозитории, а Автосвязь задач и запросов изменений включена. Номер должен быть с префиксом этой области. Подождите минуту: Otdano забирает изменения не сразу.
Номер только в описании. Поставьте его сразу после Closes, Fixes или Resolves, перенесите в название или ветку либо привяжите запрос вручную.
Задача не сменила статус после слияния. Проверьте, что все ее запросы влиты, а закрытые без слияния убраны из задачи. Посмотрите, не включено ли для задачи Не менять статус при слиянии PR и не стоит ли в настройке Не менять статус.

Связанные страницы

Задачи — статусы и исполнители.
Рабочие процессы — как статус задачи передает ее следующему исполнителю.