Introdução ao QANode

O QANode é uma plataforma de automação de testes que permite criar, executar e gerenciar testes automatizados através de um editor visual de fluxos baseado em nós. Com uma interface intuitiva de arrastar e conectar, você pode construir cenários de teste complexos sem escrever código — o QANode através da sua extensabilidade com custom nodes está preparado para executar qualquer tipo de teste.

O que é o QANode?

O QANode foi projetado para equipes de QA, desenvolvedores e engenheiros de teste que precisam de uma ferramenta moderna e visual para automação de testes. A plataforma cobre as principais áreas de teste:

Automação Web

Teste interfaces de usuário usando o Playwright, o framework de automação mais moderno do mercado. O QANode oferece dois nós especializados:

• Web Flow — Automação baseada em seletores CSS, XPath, data-testid e texto
• Smart Locators — Automação com localizadores semânticos (getByRole, getByLabel, getByPlaceholder, etc.)

Ambos suportam o chromium, modo headless, captura de screenshots e reuso de sessão.

Testes de API

Execute requisições HTTP com suporte completo a:

• Métodos GET, POST, PUT, PATCH e DELETE
• Autenticação Bearer, Basic e API Key
• Headers customizados e corpo da requisição
• Integração com credenciais salvas

Banco de Dados

Conecte-se e valide dados em:

• PostgreSQL, MySQL, MariaDB, Oracle — com query builder visual ou SQL direto
• MongoDB — com operações find, insert, update, delete e aggregation pipeline

Infraestrutura

Execute comandos remotos via SSH com suporte a múltiplos passos, autenticação por senha ou chave privada, e captura de saída.

Extensibilidade

Crie nós customizados em qualquer linguagem de programação (Node.js, Python, Java, C#, Go, etc.) através do sistema de provedores HTTP. (Community Edition apenas em javascript)

Características Principais

Arquitetura

O QANode é composto por quatro componentes principais:

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  Frontend    │    │  API Server  │    │   Worker     │
│  (React)     │◄──►│  (Fastify)   │◄──►│  (Executor)  │
│  Vite + TS   │    │  REST API    │    │  Playwright  │
└─────────────┘    └──────┬───────┘    └─────────────┘
                          │
                   ┌──────▼───────┐
                   │  PostgreSQL   │
                   │  (Prisma ORM) │
                   └──────────────┘

• Frontend — Interface de usuário em React com TypeScript, construída com Vite
• API Server — Servidor REST em Fastify com autenticação JWT
• Worker — Motor de execução que processa os fluxos e controla Playwright
• PostgreSQL — Banco de dados relacional para armazenamento de dados (via Prisma ORM)

Versão Desktop

A versão desktop empacota todos os componentes em um único aplicativo Electron, incluindo um PostgreSQL embutido. Basta instalar e usar — sem necessidade de configuração de infraestrutura.

Community Edition vs Enterprise

Esta documentação cobre a Community Edition, que é gratuita. A tabela abaixo resume as diferenças:

Próximos Passos

• Instalação — Configure o QANode no seu ambiente
• Início Rápido — Crie seu primeiro teste em minutos
• Conceitos Fundamentais — Entenda a estrutura da plataforma