Геннадий Никитин
EN RU

Демо-проект: HECHO

HECHO показывает весь цикл QA на одном проекте: сначала требования и документация, три слоя тестов с ревью перед ними и отчёты, которые после них остаются.

Что это

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

hecho-demo — это продукт и его документация: SPA на React 19 + TypeScript, API на NestJS со Swagger/OpenAPI, PostgreSQL + Prisma, SeaweedFS и Docker Compose. Требования, роли, жизненный цикл заказа, контракт API и схема БД лежат в разделе документации в репозитории проекта, есть форма для баг-репортов и CI, который собирает и выкатывает стенд.

hecho-e2e — это репозиторий системных тестов: Playwright на живом стеке (web, API, PostgreSQL, SeaweedFS), каталог Qase, который обязан совпадать со спеками, система под тестом, закреплённая по коммиту, HTML-отчёты и публичный дашборд.

На чём я сфокусировался как QA

Процесс
Сначала требования и схема, потом черновик кейсов, потом спека. У каждого автоматизированного кейса есть ключ Qase и точное название, и сьют отказывается собираться, если чего-то не хватает. Нашли ошибку — поправили отдельным коммитом, покрыли регрессионным кейсом и влили в главную ветку отдельным pull request.
Форма слоёв: песочные часы, а не пирамида
Широкая база из дешёвых unit-проверок, узкий средний слой из кейсов «HTTP против базы» и широкий верх из пользовательских сценариев на двух вьюпортах. В среднем слое то, что с большей вероятностью сломает это приложение, а сверху — пользовательские сценарии. Важно было избегать дублирования: что покрыто на более низком слое, не покрывается на слоях выше.
Классификация, из которой каталог становится деревом
У каждого кейса есть слой, путь в сьюте, приоритет, серьёзность, тип, теги и статус автоматизации.
Инварианты проверяются там, где живут
Правила, которые нельзя нарушать, — это правила базы (частичные уникальные индексы, check-констрейнты, атомарная годовая нумерация счетов), поэтому интеграционный слой доказывает их один раз на живом PostgreSQL, а не повторяет на каждом эндпоинте. Тот же слой доказывает и гонку: например compare-and-set по заявке отвечает 409 тому исполнителю, кто проиграл.
E2E-сценарии, которым можно верить
Локаторы — это контракт: только data-testid, а не CSS или XPath. Каждый прогон начинается со сброса, готовит данные через API и прогоняет исключительно актуальную сборку, закреплённую по коммиту.
Границы проекта
На данный момент отсутствуют скриншот-тесты, нет тестов производительности, доступности, нет проверок почтовых сценариев; каждая из них исключена с причиной в документе по стратегии, а не забыта. Так что всё ещё остаётся поле для дальнейших улучшений — помимо перечисленных выше можно добавить контрактные тесты на каждый эндпоинт, общий сервис тестовых данных.

Как это строилось

Порядок ниже — тот, в котором я работал бы на реальном продукте, и именно в нём шло это демо.

  1. Сначала требования, потом код. Цель, три роли, жизненный цикл заказа, правила выставления счетов, технические ограничения, открытые вопросы и бэклог легли в документацию как первый артефакт проекта, и схема писалась под них. Изменение поведения приходит вместе с изменением документа.
  2. Стек, подобранный под снятие рисков. NestJS + Swagger делают API контрактом, который можно ревьюить, Prisma + PostgreSQL держат схему и её инварианты, тонкая SPA на React рисует состояние, SeaweedFS убирает файлы из базы, а Docker Compose даёт одноразовый стек на каждый прогон.
  3. Один путь записи для всех правил. Всё живёт в API: браузер не может выдумать статус, пропустить валидацию или выдать себе роль. Тестовые данные приходят из devtools-API.
  4. Схема делает работу охранника. Частичные уникальные индексы, check-констрейнты, снапшоты счетов и append-only история делают невозможные состояния невозможными, а не маловероятными (схема, описание схемы).
  5. Тесты пишутся из каталога. 194 unit-кейсов, 33 интеграционных против живого стека и 65 e2e на двух вьюпортах, и каждый — кейс Qase с ключом, поэтому спека, требование и результат прогона прослеживаются друг к другу.
  6. Агенты работают по записанным правилам. В каждом репозитории лежит то, что агент обязан соблюдать: где фиксируется решение, как пишется кейс, что нельзя редактировать никогда и что изменение предлагается, а не пушится (working agreement, конвенции кейсов).
  7. Доказательства приходят из CI. Типы, линт, unit, сборка и интеграционные тесты блокируют мерж; e2e-сьют запускается из pull request самого продукта на том коммите, который ревьюят; результаты приземляются на публичный дашборд Qase.

Дашборд Qase

Публичная доска Qase для e2e-сьюта: процент прохождений, история прогонов и распределение по слоям, как есть из инструмента.

Доска встроена на свою полную высоту, поэтому внутри неё ничего не нужно прокручивать. Если она осталась пустой, её блокирует сетевой фильтр или расширение; доска публичная, аккаунт не нужен.

Доска рассчитана на широкий экран, поэтому здесь она не встроена. Открыть дашборд в Qase ↗, аккаунт не нужен.

Тест-кейсы

Весь каталог, выгруженный из Qase: 295 тест-кейсов. 194 unit, 33 API, 65 e2e и 3 setup; все автоматизированы. Высокого приоритета — 190, типа security — 67.

Кейсы по слоям
СлойКейсов
unit194
api33
e2e65
setup3
Всего295

Открыть полный каталог кейсов (на английском) →