Продукт читает GitHub. Компания устанавливает приложение Quevell на свою учетную запись или организацию, выбирает репозитории, и задачи начинают показывать ветки, коммиты и пул-реквесты.
Права приложения
Все четыре права только на чтение:
| Право | Зачем |
|---|---|
| Metadata | Список репозиториев установки |
| Contents | Ветки и коммиты |
| Pull requests | Пул-реквесты, их заголовки, авторы и состояния |
| Checks | Итог проверок пул-реквеста |
Что хранится
- Подключение: учетная запись, номер установки, кто и когда подключил.
- Репозитории установки: имя и номер каждого.
- Связи на задачах: вид (ветка, коммит, пул-реквест), номер или имя, заголовок, автор, состояние, итог проверок, адрес.
- Журнал доставок: время, вид события, репозиторий, итог и причина, если событие не пригодилось.
Тело доставки не хранится: оно стирается сразу после чтения. Токен человека, которым проверяется право на установку, не сохраняется нигде.
Как подключить
Администрирование, вкладка "Интеграции", кнопка "Подключить GitHub". Право "Настраивать компанию".
Дальше GitHub спросит, на какую учетную запись ставить приложение и какие репозитории ему показывать, и вернет обратно. Подключение остается у той компании, из которой нажали кнопку; одна установка принадлежит одной компании.
Репозитории проекта
Настройки проекта, секция "Разработка". Право "Управлять доступом к проекту".
Проект выбирает из того, что подключила компания. У каждого выбранного репозитория есть переключатель "Связывать по ключу задачи": с ним ветка, пул-реквест или коммит, где написан ключ задачи проекта, к которому привязан этот репозиторий, показывается на этой задаче; без него показываются только связи, добавленные руками.
Связывание по ключу
Ключ ищется в имени ветки, в заголовке пул-реквеста и в тексте коммита. Найденный ключ должен принадлежать проекту, к которому привязан этот репозиторий, иначе связь не заводится.
Если в названии есть что-то похожее на ключ, но такого проекта в компании нет (например, ветка release-2026), связь не заводится и в журнал доставок это не попадает.
Блок "Разработка"
На задаче блок показывает ветки, коммиты и пул-реквесты. Пул-реквест показывается словом состояния: черновик, открыт, нужны правки, одобрен, слит, закрыт, и отдельно итог проверок.
Если GitHub еще не сообщил состояние пул-реквеста (например, он привязан вручную), блок так и пишет. Состояние появится после следующего события или проверки.
Привязать и убрать руками
Ссылка на пул-реквест, вставленная в поле блока, заводит связь. Репозиторий должен быть подключен компанией.
Кнопка "Убрать связь" есть у любой связи, включая заведенные продуктом по ключу. Право "Править задачи". Снятая связь сама не возвращается: события по этому пул-реквесту или этой ветке к этой задаче больше не привязываются, и коммиты снятой ветки тоже. Привязка по ссылке возвращает связь и снимает запрет.
Отметки на доске
Карточка задачи на доске отмечается, если у задачи есть пул-реквест: открытый важнее слитого, закрытый не отмечается никак.
События для автоматизации
Правила автоматизации могут срабатывать на события: создана ветка, привязан коммит, пул-реквест открыт, готов к ревью, одобрен, запрошены изменения, слит, закрыт.
Обновить список репозиториев
Карточка подключения, кнопка "Обновить". Право "Настраивать компанию". Продукт спрашивает у GitHub список репозиториев установки и приводит список компании к нему: новые добавляются, снятые убираются.
Если снимается репозиторий, на который смотрит проект, продукт сначала показывает окно: какие репозитории уйдут и у скольких проектов пропадет привязка. Связи на задачах в эти репозитории уходят вместе с ними.
Не чаще раза в минуту на подключение.
Состояние связи
На карточке подключения три состояния: связь есть, событий нет дольше суток, установка удалена. Рядом время последней проверки состояний и сколько пул-реквестов проверено.
Отключение
Кнопка "Отключить" на карточке подключения. Перед отключением показывается, сколько привязок проектов уйдет и у скольких задач пропадут связи с GitHub.
Вместе с подключением уходят репозитории, привязки проектов к ним и связи на задачах. Запись о подключении и об отключении остается в журнале изменений компании.
Если после GitHub открылось сообщение
"Возврат больше не действует". Прошло больше пятнадцати минут или менялись настройки приложения. Откройте Администрирование, Интеграции и нажмите "Подключить GitHub" еще раз.
"Это окно можно закрыть". Сюда приводит сохранение настроек установки на стороне GitHub. Здесь ничего не менялось, подключение начинается кнопкой в Администрировании.