Documentação do QAMind

Guia completo para automatizar seus testes com linguagem natural.

Início Rápido

Configure o QAMind em poucos minutos e comece a criar testes automatizados.

Pré-requisitos

  • Node.js 18+ e pnpm instalados
  • Python 3.10+ para o daemon de execução
  • ADB (Android Debug Bridge) para testes mobile
  • Conta no Supabase para persistência de dados
  • API Key da Anthropic para a IA generativa

Instalação

1

Clone o repositório

bash
git clone https://github.com/qamind/qamind.git
cd qamind
2

Configure as variáveis de ambiente

Copie os arquivos .env.example e preencha suas credenciais:

bash
# apps/web/.env.local
NEXT_PUBLIC_SUPABASE_URL=sua_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=sua_key
NEXT_PUBLIC_DAEMON_URL=http://localhost:8001
ANTHROPIC_API_KEY=sua_api_key

# apps/daemon/.env
SUPABASE_URL=sua_url
SUPABASE_KEY=sua_key
DAEMON_PORT=8001
ANTHROPIC_API_KEY=sua_api_key
3

Execute o startup

O script start.sh cuida de tudo: cria o venv Python, instala dependências e inicia todos os serviços.

bash
chmod +x start.sh
./start.sh

Serviços iniciados:

  • Web Dashboard: http://localhost:3000
  • API (Fastify): http://localhost:8000
  • Daemon (Python): http://localhost:8001

Projetos

Projetos são a forma de organizar seus testes por contexto de negócio, aplicação ou equipe.

Criar um Projeto

1

Acesse a página de Projetos

No menu lateral, clique em Projetos.

2

Clique em Novo Projeto

Preencha o nome, descrição, plataforma (Android, iOS, Web ou Multi) e status.

3

Gerencie seus projetos

Use os botões de Editar e Excluir que aparecem ao passar o mouse sobre o card. Clique em Gerenciar → para ver os testes vinculados.

Criar Testes com IA

O diferencial do QAMind é a criação de testes em linguagem natural. Descreva o que quer testar e a IA gera os passos automaticamente.

Passo a Passo

1

Abra o Editor de Testes

Clique em Testes → Novo Teste no dashboard.

2

Conecte um dispositivo

Clique no indicador de dispositivo na parte inferior para conectar via ADB.

3

Escolha o modelo de IA

No combobox ao lado do botão de geração, selecione o modelo LLM desejado:

  • Sonnet 4.6 — Recomendado. Melhor equilíbrio entre qualidade e velocidade
  • Sonnet 4 — Alta capacidade de raciocínio
  • Sonnet 3.5 — Rápido e eficiente para testes simples
  • Haiku 3 — Ultra-rápido para prompts curtos
4

Escreva seu prompt

Descreva em português o cenário de teste. Seja específico:

text
"Abra o app WasteZero, na tela de login informe
isaias@gmail.com no campo de email e senha123 no
campo de senha, clique em Entrar e verifique se
aparece a tela de Dashboard com o texto Portfólio"
5

Clique em Gerar Tests

A IA processará o prompt e gerará passos estruturados com ações (TAP, TYPE, ASSERT, etc.) e estratégias de localização (resource-id, text, xpath).

Dicas de Prompt

Mencione o nome exato de botões e campos

Inclua valores específicos para dados de entrada

Descreva a validação esperada (texto que deve aparecer)

Use um fluxo por prompt (login, checkout, cadastro)

Dispositivos

O QAMind conecta a dispositivos Android reais via ADB para execução de testes mobile.

Configuração Android

1

Ative o Modo Desenvolvedor

No aparelho Android, vá em Configurações → Sobre o telefone e toque 7 vezes em "Número da versão".

2

Ative a Depuração USB

Em Configurações → Opções do desenvolvedor, ative "Depuração USB".

3

Conecte via cabo USB

Conecte o dispositivo ao computador e autorize a conexão RSA na tela do celular.

4

Verifique a conexão

bash
adb devices
# Deve mostrar algo como:
# dcc71c7d    device
5

Escaneie no QAMind

Na página Dispositivos, clique em "Conectar Dispositivo" → "Escanear Novamente".

Conexão Wi-Fi (opcional)

bash
# Conecte via USB primeiro, depois:
adb tcpip 5555
adb connect <IP_DO_DISPOSITIVO>:5555
# Agora pode desconectar o cabo USB

Execução de Testes

Após gerar os passos com IA, execute o teste no dispositivo conectado.

1

Revise os passos gerados

Edite, reordene (drag & drop), duplique ou remova passos conforme necessário.

2

Clique em Executar Teste

O daemon enviará cada ação ao dispositivo via UIAutomator2 em tempo real.

3

Acompanhe em real-time

O device preview mostra a tela do aparelho via WebSocket streaming. Cada passo fica verde (sucesso) ou vermelho (erro).

Quando um passo falha

A IA analisa o erro e mostra:

  • Mensagem de erro detalhada
  • Estratégias tentadas (resource-id, text, xpath...)
  • Sugestão de correção gerada pela IA

Modelos de IA

O QAMind usa a API da Anthropic para gerar testes. Você pode escolher o modelo conforme sua necessidade:

Sonnet 4.6

Recomendado

Modelo padrão. Melhor equilíbrio entre qualidade, velocidade e custo.

Sonnet 4

Premium

Alta capacidade de raciocínio para testes complexos com muitas validações.

Sonnet 3.5

Rápido

Rápido e eficiente. Ideal para fluxos simples como login e cadastro.

Haiku 3

Econômico

Ultra-rápido e barato. Bom para prompts curtos e testes triviais.

Relatórios

Cada execução de teste gera um relatório completo acessível via dashboard.

O que está incluído

  • Status de cada passo — sucesso, falha ou ignorado
  • Screenshots de erro — capturados automaticamente no momento da falha
  • Estratégias de localização — quais seletores foram tentados e seu resultado
  • Sugestões de IA — correções automáticas propostas pela IA
  • Duração — tempo total de execução e por passo

API Reference

O daemon expõe endpoints REST para integração com CI/CD e ferramentas externas.

Endpoints Principais

GET/health

Verifica se o daemon está ativo e quantos dispositivos estão conectados.

GET/devices

Lista todos os dispositivos online detectados via ADB.

GET/devices/scan

Força um scan imediato de dispositivos ADB.

POST/api/tests/parse-prompt-stream

Gera passos de teste a partir de prompt em linguagem natural (SSE stream).

json
{
  "prompt": "Abra o app e faça login",
  "platform": "android",
  "model": "claude-sonnet-4-6"
}
POST/api/runs

Inicia a execução de um teste no dispositivo conectado.

WS/ws/{client_id}

WebSocket para receber eventos de execução em tempo real (step_started, step_completed, step_failed, etc).

WS/stream/{udid}

WebSocket de streaming de tela do dispositivo (JPEG frames via arraybuffer).

Pronto para começar?

Crie sua conta e automatize seus testes em minutos.

Criar Conta Grátis Ir ao Dashboard