Como Executar

Este é o caminho mínimo para uma primeira execução local. Os guias técnicos do repositório continuam sendo a fonte para opções, diagnóstico e limitações.

Pré-requisitos

• Docker com Docker Compose;
• Node.js 22 ou superior, conforme o package.json atual;
• Chromium do Playwright;
• k6 2.1.0 para cenários de performance.

1. Inicie o ambiente de referência

Na raiz do repositório:

docker compose -f sut/docker-compose.yml up -d --wait

Acesse http://localhost:3000. Para detalhes, usuário administrativo e reset local, consulte o guia do ambiente.

2. Prepare a automação

cd quality
npm ci
npx playwright install chromium
npm run typecheck

Credenciais administrativas são locais e opcionais para parte dos cenários. Nunca versione .env, senhas, tokens ou estado autenticado.

3. Escolha a validação

npm test                       # suíte Playwright completa
npm run test:smoke             # recorte funcional rápido
npm run test:post-merge-smoke  # saúde read-only
npm run performance:smoke      # performance curta

4. Leia o resultado

• npm run report: abre o HTML Reporter técnico;
• npm run report:summary: gera o Quality Report executivo quando resultados Playwright e k6 estão disponíveis;
• falha obrigatória significa bloqueio, não pontuação parcial.

5. Encerre

docker compose -f sut/docker-compose.yml down

Próximos detalhes: automação, performance e experimentos.