QA Деск. Инструкция по эксплуатации

1. Вход в систему

Кабинет доступен по адресу https://app.qadesk.ru. Способы входа:

• адрес электронной почты и пароль (адрес должен быть подтверждён по ссылке из письма);
• Яндекс ID;
• сквозной вход с портала Битрикс24 — из установленного приложения;
• доменная учётная запись LDAP / Active Directory — в экземпляре на своей инфраструктуре, если вход настроен администратором (раздел 4.4 документа «Установка»).

Забытый пароль восстанавливается по ссылке «Забыли пароль?» на экране входа: на почту приходит одноразовая ссылка для задания нового.

2. Рабочие пространства и участники

Пространство QA Деск объединяет участников, проекты и данные. Личное пространство создаётся при регистрации, командное пополняется приглашениями на почту; участник может состоять в нескольких пространствах. Роль участника — одна из 6: администратор, тестировщик, разработчик, менеджер, аналитик, наблюдатель.

• При регистрации создаётся личное пространство. Командное пространство пополняется приглашениями: администратор отправляет приглашение на почту, приглашённый принимает его по ссылке.
• Переключение между пространствами — переключателем в кабинете.
• Администратор меняет роли участников и исключает их из пространства; участник может выйти сам. Роли и их права перечислены в функциональных характеристиках.

3. Проекты

Создайте проект и задайте буквенный ключ (например, SHOP) — дефекты проекта получат номера SHOP-1, SHOP-2… По номеру дефект находится глобальным поиском и открывается по прямой ссылке.

4. Работа с дефектами

Дефект заводится кнопкой «Завести баг» с обязательными окружением и платформой и проходит 5 основных стадий: Новый, В работе, Устранён, На повторной проверке, Закрыт. Для блокирующих и критичных дефектов обязательно вложение — снимок экрана или лог.

4.1. Заведение дефекта

1. Нажмите «Завести баг», выберите проект.
2. Заполните название и описание; выберите тип записи (дефект / вопрос / предложение).
3. Обязательно укажите, где воспроизведено: окружение и платформу. Эти поля не заполняются автоматически.
4. При необходимости укажите серьёзность и приоритет. Для блокирующих и критичных дефектов приложите подтверждение (снимок экрана, лог) — без вложения такой дефект не сохранится.

4.2. Стадии и переходы

Дефект движется по стадиям: Новый → В работе → Устранён → На повторной проверке → Закрыт; в любой момент возможны «Не баг» и «Отложен» по правилам воркфлоу, возврат закрытого — через «Переоткрыт». Кнопки на карточке показывают только допустимые из текущей стадии переходы; для «Не бага», «Отложен» и возвратов система запросит причину. Полная матрица переходов — в функциональных характеристиках.

4.3. Доска и список

• Доска показывает открытые дефекты по стадиям; карточки переносятся между колонками перетаскиванием — перенос равносилен переходу и подчиняется тем же правилам.
• Список — фильтры, сортировка, постраничная навигация и экспорт текущей выборки в CSV.
• Поиск в шапке кабинета ищет по всем проектам пространства и подсказывает совпадения по мере ввода; понимает ключи вида QAD-17.

4.4. Связи, комментарии, история

• Дубликат связывается с оригиналом; дефект связывается с тест-кейсами.
• Комментарии и вложения — на карточке; там же полная история изменений: кто, когда и что поменял, с причинами переходов.
• Удаление дефекта — архивирование: номер сохраняется, внешние ссылки (например, из задач Битрикс24) не ломаются.

5. Тест-кейсы

Тест-кейс в QA Деск — шаги с ожидаемыми результатами и версиями: прогон ссылается на версию, по которой выполнялся. Кейс проходит 3 статуса — черновик, актуален, архив; библиотека раскладывается по папкам, импортируется из CSV и Test IT.

• Кейс состоит из шагов с ожидаемыми результатами. Изменения образуют версии: прогон всегда ссылается на ту версию, по которой выполнялся.
• Статусы кейса: черновик → актуален → архив.
• Кейсы раскладываются по дереву папок; кейс можно продублировать.
• Импорт: CSV по шаблону (система показывает ошибки построчно) и перенос из Test IT (выгрузка XLSX/CSV). Экспорт: CSV.

6. Тест-планы и прогоны

Ручной прогон в QA Деск запускается из тест-плана, собранного из кейсов библиотеки. Результат ставится по каждому шагу — пройден, упал, пропущен; из упавшего шага дефект заводится со связью с кейсом и прогоном.

1. Соберите план из кейсов библиотеки.
2. Запустите прогон. На экране прогона отмечайте результат каждого шага: пройден, упал, пропущен.
3. Из упавшего шага заводится дефект — связь с кейсом и прогоном устанавливается автоматически.
4. Сводка прогона показывает метрики: сколько пройдено, упало, пропущено.

7. Автотесты: приём отчётов из CI

QA Деск принимает отчёты автотестов в 2 форматах — JUnit XML и Allure — по HTTP с токеном проекта. Повторная отправка того же запуска CI дублей не создаёт; для конвейера есть утилита qadesk-cli.

Адреса приёма:

POST https://api.qadesk.ru/ingest/v1/junit?name=…&environment=…&platform=…&ciRunId=…&attempt=…
POST https://api.qadesk.ru/ingest/v1/allure?name=…&environment=…&platform=…&ciRunId=…&attempt=…

• Форматы: JUnit XML и Allure (NDJSON).
• Повторная отправка того же отчёта (совпадают запуск CI и номер попытки) не создаёт дублей.
• Результаты сопоставляются с кейсами библиотеки по ключам; прогон появляется в кабинете как автоматический.
• Для отправки из конвейера CI удобна консольная утилита qadesk-cli — бинарники для Linux, macOS и Windows, флаги и примеры пайплайнов на странице qadesk.ru/cli.

8. Работа из Битрикс24

В Битрикс24 QA Деск работает во вкладке «Баги» карточки задачи: там видны связанные дефекты и заводится новый. Исполнитель выбирается из участников задачи, связь дефекта с задачей ставится автоматически, переход в кабинет — без отдельного пароля.

• В карточке задачи портала — вкладка «Баги»: связанные дефекты и форма заведения нового прямо из задачи.
• Исполнитель нового дефекта выбирается из участников задачи; дефект и задача связываются автоматически.
• Из вкладки доступен переход к дефекту в кабинете — вход выполняется сквозным образом, без отдельного пароля.

9. Подключение ИИ-агента (MCP)

ИИ-агент (Claude Code, Claude Desktop, Cursor) подключается к QA Деск по MCP за 3 шага: токен qdpt_… в «Настройки → MCP», адрес https://api.qadesk.ru/mcp в клиенте, работа в правах владельца токена.

1. В кабинете откройте Настройки → MCP и выпустите персональный токен. Секрет qdpt_… показывается один раз — сохраните его сразу; утерянный токен отзывается и выпускается заново.
2. Подключите MCP-клиент (Claude Code, Claude Desktop, Cursor и другие): тип сервера — Streamable HTTP, адрес https://api.qadesk.ru/mcp, заголовок Authorization: Bearer qdpt_….
3. Агент действует от вашего имени и строго в ваших правах: ищет дефекты, отвечает по карточкам, заводит новые, переводит по стадиям, комментирует.

9.1. Агент как отдельный участник

Автоматику можно завести отдельным участником пространства — агентом, чтобы в прогонах и дефектах была подпись «кем проверено», а не имя выпустившего токен. Агента заводит администратор во вкладке настроек «Агенты»: имя, назначение, роль и владелец-человек.

• У агента нет почты и пароля; он действует только своими токенами MCP (qdpt_…) и токенами приёма отчётов.
• Роль агента — любая, кроме администратора. Агент не занимает место редактора тарифа.
• Агента нельзя удалить — только выключить: его токены перестают приниматься, а история сохраняет подпись. Включение возвращает токены в работу.

10. Ошибки из Sentry — в дефекты

Ошибка уровня error или fatal в проекте Sentry становится дефектом выбранного проекта QA Деск — со ссылкой на issue, типом исключения и местом возникновения. Одна ошибка — один дефект: повторные срабатывания правила дефект не дублируют.

1. В Sentry выпустите Auth Token: Settings → Auth Tokens → Create New Token, право project:read. Это не «Security Token» из раздела Security & Privacy — тот нужен только для скачивания карт источников и здесь не используется.
2. В кабинете откройте Настройки → Sentry (право управления пространством). В поле «Инсталляция» вставьте ссылку на проект из адресной строки Sentry целиком — например https://sentry.example.com/organizations/acme/projects/shop/?project=4509; адрес установки, организация и проект разберутся сами. Вставьте токен, выберите проект QA Деск для дефектов и нажмите «Проверить и подключить». Подключение сохраняется только после того, как Sentry принял токен и показал ему проект; отказ приходит с причиной и с названием поля.
3. Скопируйте с карточки подключения адрес вебхука — он содержит секрет, не публикуйте его. Новый адрес можно выпустить в любой момент, старый перестаёт приниматься сразу.
4. В Sentry включите плагин WebHooks: проект → Settings → Integrations → WebHooks → Enable, затем Configure plugin (прямой адрес: /settings/<организация>/projects/<проект>/plugins/webhooks/). В поле Callback URLs вставьте адрес вебхука, сохраните.
5. Создайте правило оповещений: Alerts → Create Alert → Issues, условие «A new issue is created», действие «Send a notification via WebHooks». Без правила плагин ничего не отправляет.
6. Проверьте: Test Plugin на странице плагина или Send Test Notification в правиле. В проекте появится дефект с пометкой источника, на карточке подключения — время последнего вебхука и число заведённых дефектов. Тестовый дефект можно удалить — связка уйдёт вместе с ним.

Строже: Settings → Developer Settings → Internal Integration с Webhook URL, галочкой «Alert Rule Action», правом Issue & Event: Read и вебхуком issue: created. Его Client Secret впишите на карточке подключения («Заменить токен» → Client Secret, поле токена оставьте пустым) — тогда каждая доставка проверяется по подписи.

В карточке дефекта блок «Ошибки Sentry» показывает связанные issue; существующую ошибку можно привязать по id или ссылке. Среда, платформа и серьёзность заводимых дефектов задаются на карточке подключения; blocker/critical недоступны — у них обязательно вложение, а вебхук его не несёт.

11. Поддержка

Вопросы по работе системы, внедрению и переносу данных: hello@qadesk.ru. Поддержка ведётся на русском языке.