QA Hub: с чего начать

QA Hub объединяет ручные проверки, автоматических агентов и приложенные доказательства в один воспроизводимый тестовый прогон. Это не система исполнения произвольного кода: Hub хранит задания и результаты, а runner исполняет известный ему сценарий в своем доверенном окружении.

Открыть QA Hub

Что решает система

Без QA Hub результат проверки обычно распределен между сообщениями в чате, скриншотами, CI и памятью тестировщика. Hub фиксирует четыре связанные сущности:

  1. Окружение — адрес проверяемой установки и ссылка на секрет.
  2. Набор — версионируемый список тест-кейсов.
  3. Прогон — запуск набора на конкретном окружении и сборке.
  4. Доказательства — ручные результаты, события агентов и файлы.

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

Выберите свой путь

Задача Куда перейти
Пройти чек-лист вручную Ручной прогон
Подключить Playwright, HTTP или media runner Агенты и runner-ы
Добавить новый тест-кейс Наборы и тест-кейсы
Выгрузить результат для CI Артефакты и отчеты
Настроить backup, TLS и обновление Эксплуатация
Интегрироваться напрямую HTTP API

Быстрый ручной flow

Новый прогон
  -> выбрать suite, environment, mode и build
  -> выполнить шаги каждого кейса
  -> отметить: Пройден / Провален / Пропущен
  -> приложить логи, screenshot или diagnostics
  -> завершить прогон
  -> отправить ссылку или выгрузить Markdown / JUnit / JSON

Для обычной проверки человеком выбирайте режим Ручной. Режим Ручной + агенты создает еще и agent jobs. Если runner-ы не запускались, после ручной части используйте Завершить без агентов: ожидающие jobs будут отменены и честно отмечены как skipped.

Быстрый agent flow

Администратор         QA Hub                    Runner
      |                  |                         |
      |-- регистрация -->|                         |
      |<-- token один раз|                         |
      |                  |<-- claim job -----------|
      |                  |--- payload ------------>|
      |                  |<-- heartbeat / events --|
      |                  |<-- artifacts -----------|
      |                  |<-- complete ------------|
      |                  |                         |

Hub не открывает входящее соединение к runner-у. Агент сам опрашивает /api/v1/agent/jobs/claim по HTTPS, поэтому его можно запускать в CI, закрытом контуре или рядом с тестовой установкой без дополнительного входящего порта.

Базовые правила

Один прогон — один проверяемый build

Указывайте версию web-клиента и сервера в поле Версия / сборка. Не продолжайте тот же прогон после обновления окружения.

Секреты не хранятся в окружении

В environment.secret_ref записывается только ссылка вроде vault://qa/stage1/videograce. Runner получает реальный секрет напрямую из secret manager под собственной identity.

Финализация блокирует результат

До нажатия Завершить прогон статусы можно исправлять. После финализации результат становится неизменяемым и считается готовым отчетом.

Роли

Роль Назначение
viewer Просмотр наборов, прогонов и артефактов
tester Ручные прогоны, результаты и файлы
devops Окружения, агенты и запуск прогонов
qa_lead Ручные прогоны и управление каталогом
admin Полное управление, включая аккаунты

Подробная матрица доступа и модель данных описаны в модели системы.