Демо-проект: 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 и прогоняет исключительно актуальную сборку, закреплённую по коммиту. - Границы проекта
- На данный момент отсутствуют скриншот-тесты, нет тестов производительности, доступности, нет проверок почтовых сценариев; каждая из них исключена с причиной в документе по стратегии, а не забыта. Так что всё ещё остаётся поле для дальнейших улучшений — помимо перечисленных выше можно добавить контрактные тесты на каждый эндпоинт, общий сервис тестовых данных.
Как это строилось
- Сначала требования, потом код. Цель, три роли, жизненный цикл заказа, правила выставления счетов, технические ограничения, открытые вопросы и бэклог легли в документацию как первый артефакт проекта, и схема писалась под них. Изменение поведения приходит вместе с изменением документа.
- Стек, подобранный под снятие рисков. NestJS + Swagger делают API контрактом, который можно ревьюить, Prisma + PostgreSQL держат схему и её инварианты, тонкая SPA на React рисует состояние, SeaweedFS убирает файлы из базы, а Docker Compose даёт одноразовый стек на каждый прогон.
- Один путь записи для всех правил. Всё живёт в API: браузер не может выдумать статус, пропустить валидацию или выдать себе роль. Тестовые данные приходят из devtools-API.
- Схема делает работу охранника. Частичные уникальные индексы, check-констрейнты, снапшоты счетов и append-only история делают невозможные состояния невозможными, а не маловероятными (схема, описание схемы).
- Тесты пишутся из каталога. 194 unit-кейсов, 33 интеграционных против живого стека и 65 e2e на двух вьюпортах, и каждый — кейс Qase с ключом, поэтому спека, требование и результат прогона прослеживаются друг к другу.
- Агенты работают по записанным правилам. В каждом репозитории лежит то, что агент обязан соблюдать: где фиксируется решение, как пишется кейс, что нельзя редактировать никогда и что изменение предлагается, а не пушится (working agreement, конвенции кейсов).
- Доказательства приходят из CI. Типы, линт, unit, сборка и интеграционные тесты блокируют мерж; e2e-сьют запускается из pull request самого продукта на том коммите, который ревьюят; результаты приземляются на публичный дашборд Qase.
Дашборд Qase
Публичная доска Qase для e2e-сьюта: процент прохождений, история прогонов и распределение по слоям, как есть из инструмента.
Тест-кейсы
Весь каталог, выгруженный из Qase: 295 тест-кейсов. 194 unit, 33 API, 65 e2e и 3 setup; все автоматизированы. Высокого приоритета — 190, типа security — 67.
| Слой | Кейсов |
|---|---|
| unit | 194 |
| api | 33 |
| e2e | 65 |
| setup | 3 |
| Всего | 295 |