QA Overview

A structured E2E test suite lives in qa/ and uses Playwright to validate production pages.

Quick Start

cd qa
npm install
npx playwright install chromium

# Critical path only (fast, ~12 tests)
npm run test:critical

# Sampled regional coverage (~150 tests)
npm run test:sampled

# Full suite
npm run test:full

From Project Root

# Via Makefile
cd site && make qa-critical
cd site && make qa-sampled
cd site && make qa-full

Test Structure

Directory	Purpose
tests/critical-path/	P1 pages: home, scopes, topics, special pages
tests/regional/	State index and city sample pages
tests/seo/	SEO meta validation
tests/performance/	Lighthouse budgets
src/pages/	Page Object Models
src/helpers/	Reusable assertion helpers
src/fixtures/	Page catalog and sampling config

Configuration

Copy .env.example to .env:

Variable	Default	Description
BASE_URL	https://redecasas.com.br	Target environment
QA_MODE	critical	critical, sampled, full, or custom
CITY_SAMPLE_SIZE	3	Cities per state to test

Reports

# HTML report
npm run report:html

# JSON results
cat reports/json/test-results.json

# LLM-readable summary
cat reports/llm-report.txt