Skip to content
AldemirLucas edited this page Oct 26, 2026 · 1 revision

Testes

Como o website é testado: testes end-to-end (E2E) com Cypress em next/cypress/ e um checklist para testes manuais. Para subir o projeto, veja Setup local.

Estrutura

next/
├── cypress.config.js          # baseUrl, viewport 1920x1080, retries, flags do Chrome
└── cypress/
    ├── e2e/*.cy.js            # specs
    ├── fixtures/registerUsers.json
    └── support/
        ├── e2e.js             # importa commands, cypress-plugin-stripe-elements e cypress-real-events
        └── commands.js        # comandos customizados

Em cypress.config.js: baseUrl vem de NEXT_PUBLIC_BASE_URL_FRONTEND, defaultCommandTimeout de 10 s, pageLoadTimeout de 120 s e retries de 1 no cypress run (0 no cypress open). Em browsers chromium que não sejam Electron, o config desliga o isolamento de sites (--disable-site-isolation-trials, --disable-web-security), o que permite preencher o iframe do Stripe.

Specs (next/cypress/e2e/)

Spec O que cobre Backend
check-email.cy.js /user/check-email: redireciona para a home sem registration_email_bd no sessionStorage, mostra o e-mail pendente e reenvia a ativação mockado (cy.intercept)
login.cy.js /user/login: formulário, link de recuperação, visibilidade da senha, redirecionamentos (home, survey quando workDataTool é null), erros (e-mail inválido, campos vazios, credenciais inválidas, conta inativa, falha ao buscar o usuário). Um teste faz login real com o usuário do Cypress e é pulado sem as credenciais mockado, exceto o login real
password-recovery.cy.js /user/password-recovery: pedido do e-mail (usuário inexistente, envio) e nova senha (?q=...&p=...): validações, sucesso e volta ao pedido quando a confirmação falha mockado
register.cy.js /user/register: validações de campos, senha, confirmação e celular; registro com sucesso e e-mail já cadastrado mockado, dados do fixture
payment.cy.js /user?plans_and_payment: bloqueio sem login, plano grátis ativo, modal de planos, checkout do BD Pro, preços e troca de plano no modal, cupons (25off, 20off, 15off e inválido), checkout do chatbot com cupom da URL e, em ambiente seguro, a assinatura e o cancelamento reais real (usuário do Cypress)

Fixtures

cypress/fixtures/registerUsers.json tem três perfis usados no register.cy.js: validUser, existingEmail e invalidPassword.

Spec de pagamento

payment.cy.js usa o backend e o Stripe de verdade, com o usuário definido em CRYPRESS_AUTH_EMAIL/CRYPRESS_AUTH_PASSWORD. A sessão é criada com cy.session + loginAndSetCookies.

  • before e after: chamam cy.cancelActiveSubscription(), que cancela imediatamente qualquer assinatura bd_pro ou chatbot que tenha sobrado de uma execução anterior.

  • Fluxo real de assinatura: os testes "Fazer fluxo de assinatura BDPro" e "Verificar se BDPro está ativo e cancelar" só rodam quando as duas condições valem:

    • a URL base contém localhost, 127.0.0.1, staging ou development;
    • o browser é chromium e não é Electron (o iframe do Stripe é preenchido via Chrome DevTools Protocol).

    Fora disso, o teste aparece como skipped.

  • O fluxo assina o BD Pro mensal com o cartão de teste 4242 4242 4242 4242, confirma o pagamento no Stripe (modo teste), verifica o plano ativo, cancela pela interface e depois remove a assinatura com /api/stripe/removeSubscriptionImmediately. Há esperas fixas de 30 e 60 s para o backend sincronizar.

Se o usuário de teste ficar com assinatura presa, veja Stripe, seção "Cancelamento não encontra a assinatura".

Comandos customizados (cypress/support/commands.js)

Comando O que faz
login(email, password) Preenche e envia o formulário de login
mockAuthApi, mockRegisterApi, mockGetIdUser cy.intercept nas rotas /api/user/* (e account_activate)
fillRegisterForm(userData) Preenche o formulário de cadastro com um perfil do fixture
loginAndSetCookies() Autentica via /api/user/getUserTestCypress e grava os cookies token e userBD
parseUserBdCookie() Lê e faz o parse do cookie userBD
cancelActiveSubscription(types) Para cada tipo (padrão ['bd_pro', 'chatbot']), busca a assinatura ativa com getSubscriptionActive e cancela com removeSubscriptionImmediately
openPlansModal() Clica em "Comparar planos" e espera o modal com o BD Pro
arrivingAtCheckout(button) Clica em assinar, passa pelo modal do e-mail do BigQuery (mockado) e chega em "Confirme seu plano"
proceedToPaymentStep() Avança para a etapa "Pagamento" e espera o iframe do Stripe
fillStripeCard(opts) / confirmStripePayment() Preenche o cartão via CDP e confirma, exigindo status succeeded na resposta do Stripe
applyCoupon(coupon, text) Aplica um cupom e espera o texto de confirmação
verifyElement(text) Confere que o texto está visível dentro da viewport

e2e.js também sobrescreve cy.visit para esperar o body ficar visível e ignora o erro loaderUi Element didn't mount normally.

Rota pages/api/user/getUserTestCypress.js

Rota POST que recebe e-mail e senha em base64 (?a=...&p=...), pega o token com a mutation authToken do GraphQL e devolve { authToken, user }, com os dados da conta e as assinaturas internas ativas (BD Pro primeiro). Existe para o Cypress logar sem passar pela interface.

Variáveis

Variável Uso
NEXT_PUBLIC_BASE_URL_FRONTEND baseUrl dos testes (onde o site está rodando) e decisão de "ambiente seguro" no spec de pagamento
CRYPRESS_AUTH_EMAIL / CRYPRESS_AUTH_PASSWORD Usuário de teste real. O nome tem mesmo o typo CRYPRESS: é assim que o config e os specs leem

O cypress.config.js lê essas variáveis de process.env, então elas precisam estar exportadas no shell (por exemplo, source .env).

Rodando localmente

Use o Node da versão do next/.nvmrc (20.18.1): cd next && nvm use.

  1. Suba o site (ou aponte NEXT_PUBLIC_BASE_URL_FRONTEND para o staging):

    source .env
    cd next
    npm run dev
  2. Em outro terminal, com as mesmas variáveis carregadas:

    cd next
    npm run cypress        # interface gráfica (cypress open)
    npm run cypress:run    # headless, com --browser chrome
    npx cypress run --spec cypress/e2e/login.cy.js --browser chrome   # um spec só

    npm run cypress:run:electron roda no Electron, mas aí o fluxo real de pagamento é pulado.

Sem Chrome no sistema: instale o Chrome for Testing com o Puppeteer (já é dependência do projeto) e passe o caminho do binário:

cd next
npx puppeteer browsers install chrome
npx cypress run --browser "$(node -e "process.stdout.write(require('puppeteer').executablePath())")"

CI: .github/workflows/cypress-tests.yml

  • Dispara em PR para main que altera next/** ou o próprio workflow.
  • Usa o GitHub Environment staging (vars e secrets, incluindo CRYPRESS_AUTH_*), instala o Chrome for Testing via Puppeteer e roda cypress-io/github-action com baseUrl=${{ vars.NEXT_PUBLIC_BASE_URL_FRONTEND }}.
  • Roda contra o staging deployado, não contra o código do PR. O workflow não faz build nem sobe o site. Consequência: uma mudança em rota de API ou página só se reflete no teste depois de chegar em staging. Um PR para main pode falhar (ou passar) por causa do que está em staging, não do que o PR muda.
  • Em falha, as screenshots sobem como artifact cypress-screenshots.

Boas práticas

  • Antes de testar, liste o que pode dar errado e transforme cada item num check (automatizado no Cypress, quando der).
  • Rode todos os checks a cada mudança. Um teste que passou antes não garante que vai passar de novo.
  • Abra issue para cada problema encontrado e, ao perceber um novo risco, crie um check para ele.
  • Prefira cy.intercept com resposta mockada; use o backend real só quando o objetivo é testar a integração, como no payment.cy.js.
  • Novos specs vão em next/cypress/e2e/ com o sufixo .cy.js. Ações repetidas viram comando em commands.js.
  • Testes que mexem em dados reais devem deixar o usuário de teste como encontraram (veja o before/after do payment.cy.js).

Clone this wiki locally