Repository navigation
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.
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.
| 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) |
cypress/fixtures/registerUsers.json tem três perfis usados no register.cy.js: validUser, existingEmail e invalidPassword.
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.
-
beforeeafter: chamamcy.cancelActiveSubscription(), que cancela imediatamente qualquer assinaturabd_proouchatbotque 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,stagingoudevelopment; - o browser é chromium e não é Electron (o iframe do Stripe é preenchido via Chrome DevTools Protocol).
Fora disso, o teste aparece como skipped.
- a URL base contém
-
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".
| 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 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á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).
Use o Node da versão do next/.nvmrc (20.18.1): cd next && nvm use.
-
Suba o site (ou aponte
NEXT_PUBLIC_BASE_URL_FRONTENDpara o staging):source .env cd next npm run dev
-
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:electronroda 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())")"-
Dispara em PR para
mainque alteranext/**ou o próprio workflow. - Usa o GitHub Environment
staging(vars e secrets, incluindoCRYPRESS_AUTH_*), instala o Chrome for Testing via Puppeteer e rodacypress-io/github-actioncombaseUrl=${{ 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 paramainpode 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.
- 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.interceptcom resposta mockada; use o backend real só quando o objetivo é testar a integração, como nopayment.cy.js. - Novos specs vão em
next/cypress/e2e/com o sufixo.cy.js. Ações repetidas viram comando emcommands.js. - Testes que mexem em dados reais devem deixar o usuário de teste como encontraram (veja o
before/afterdopayment.cy.js).