Validador de QA de Produção

Execute as fases em ordem. Corrija falhas antes de passar para a próxima.

Quando Usar

• Use antes de enviar ou promover um aplicativo Next.js fullstack para produção.
• Use após grandes alterações de UI, SEO, autenticação, API, banco de dados ou dependências que necessitem de uma verificação concreta de prontidão para lançamento.
• Use quando precisar de uma lista de verificação compacta e orientada por comando para verificações de build, rota, metadados, desempenho, segurança e limpeza.

export PROD_URL="https://yourdomain.com"
export QA_AUTH_HEADER=""       # optional: "Bearer eyJ..."
export PAGESPEED_API_KEY=""    # optional: for auto PageSpeed API

Executador Consolidado

qa:all() { qa:code && qa:build && qa:routes / /about /contact /privacy /terms /faq /sitemap.xml /robots.txt /api/health && qa:seo && qa:api /api/health /api/tools && qa:git && qa:smoke; }
qa:full() { qa:all && qa:auth && qa:auth:cookies && qa:lazyload && qa:heavyload && qa:vulns && qa:cleanup && qa:ux:cards && qa:ux:boundaries && qa:ux:animation && qa:database && qa:secure; }

Fase 1: Integridade do Código

• npx tsc --noEmit
• npx eslint . --ext .js,.jsx,.ts,.tsx --max-warnings 0
• npm test -- --runInBand --passWithNoTests

qa:code() { npx tsc --noEmit && npx eslint . --ext .js,.jsx,.ts,.tsx --max-warnings 0 && npm test -- --runInBand --passWithNoTests; }

Fase 2: Verificação de Build

• npm run build é bem-sucedido
• Páginas de SEO mostram ○/● e não λ
• Log de build não contém erros

qa:build() { local log; log="$(mktemp "${TMPDIR:-/tmp}/qa-build.XXXXXX.log")" || return 1; set -o pipefail; npm run build 2>&1 | tee "$log"; local rc=$?; set +o pipefail; [ "$rc" -eq 0 ] && ! grep -qi "error\|failed" "$log"; local ok=$?; rm -f "$log"; return "$ok"; }

Fase 3: Sessão de API e Autenticação

• Endpoints de autenticação respondem (login, sessão, logout)
• Rotas protegidas retornam 401/403
• Cookie de sessão: HttpOnly + Secure + SameSite
• Cookie não expirado, Path/Domain corretos
• Sem bypass de limitação de taxa

qa:auth() {
  local F=0
  for ep in /api/auth/login /api/auth/session /api/auth/logout; do
    curl -so /dev/null -w "%{http_code}" "$PROD_URL$ep" | grep -q "200\|401" || { echo "  ✗ $ep unreachable"; ((F++)); }
  done
  curl -so /dev/null -w "%{http_code}" "$PROD_URL/api/protected" | grep -q "401\|403" || echo "  ⚠ Protected route not denying unauthenticated"
  return $F
}
qa:auth:cookies() {
  for ep in /api/auth/session /api/auth/login; do
    curl -sI "$PROD_URL$ep" | grep -i "^set-cookie:" | while IFS= read -r c; do
      echo "  $ep: $(echo "$c" | cut -d= -f1)"
      echo "$c" | grep -qi "HttpOnly" || echo "    ✗ Missing HttpOnly"
      echo "$c" | grep -qi "Secure" || echo "    ✗ Missing Secure"
      echo "$c" | grep -qi "SameSite" || echo "    ⚠ Missing SameSite"
    done
  done
}

Fase 4: Regressão de Rota

• Páginas principais, sitemap, robots.txt todos 200
• URLs usam kebab-case, sem slugs duplicados
• robots.txt permite indexação
• Sitemap XML válido, todas as URLs resolvem 200

qa:routes() { local F=0; for p; do local C=$(curl -so /dev/null -w "%{http_code}" "$PROD_URL$p"); echo "$C $p"; [ "$C" = "200" ] || ((F++)); done; return $F; }
qa:robots() { curl -s "$PROD_URL/robots.txt" | grep -qi "Disallow: /$" && echo "  ✗ Blocks all crawlers" || echo "  ✓ OK"; }
qa:sitemap() { curl -s "$PROD_URL/sitemap.xml" | python3 -c "import sys,xml.etree.ElementTree as ET; ET.parse(sys.stdin); print('✓ Valid XML')"; }

Fase 5: SEO — Tags, Imagens, Favicon, Slugs

• <title> 30–60 caracteres, único por página
• <meta name="description"> no HTML bruto
• og:title corresponde a <title>, og:url corresponde ao canônico
• og:image ≥ 1200×630px, URL absoluta, carrega 200
• twitter:card = summary_large_image
• Canônico autorreferenciado, sem duplicatas
• /favicon.ico 200, apple-touch-icon presente
• hreflang tags se multilíngue
• Dados estruturados JSON-LD presentes
• Slugs: kebab-case, < 80 caracteres, sem stop words

qa:seo() {
  local H=$(curl -s "$PROD_URL"); local F=0
  for t in "og:title" "og:description" "og:image" "twitter:card" "canonical" "description"; do echo "$H" | grep -qi "$t" || { echo "  ✗ $t"; ((F++)); }; done
  echo "$H" | grep -qi "<title>" || { echo "  ✗ <title>"; ((F++)); }

…