Projetos
Projetos são a unidade principal de organização no QANode. Cada projeto agrupa cenários de teste (fluxos), suítes, documentação e execuções relacionados a um sistema, funcionalidade ou equipe.
Criando um Projeto
- No menu lateral, clique em Projetos
- Clique em + Novo Projeto
- Preencha os campos:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | Sim | Nome do projeto |
| Descrição | Não | Descrição detalhada |
| Status | Sim | Status atual do projeto |
| Data de Início | Não | Data planejada de início |
| Data de Término | Não | Data planejada de conclusão |
- Clique em Criar
Imagem: Modal de criação de projeto com todos os campos preenchidos
Status do Projeto
| Status | Descrição |
|---|---|
| Ativo | Projeto em andamento |
| Concluído | Projeto finalizado com sucesso |
| Cancelado | Projeto cancelado |
| Arquivado | Projeto arquivado (não aparece na lista principal) |
Para alterar o status, acesse o projeto e use as opções no cabeçalho:
- Concluir → Marca como concluído
- Cancelar → Marca como cancelado
- Arquivar → Move para arquivados
Página do Projeto
A página de detalhe do projeto possui as seguintes abas:
Visão Geral
Exibe estatísticas e resumo do projeto:
- Total de Cenários — Quantidade de fluxos de teste
- Total de Suítes — Quantidade de suítes
- Cenários Pendentes/Aprovados/Reprovados — Status dos cenários
- Execuções Recentes — Lista das últimas execuções
- Progresso — Comparação entre tempo decorrido e cenários executados
Imagem: Página de visão geral mostrando cards de estatísticas, execuções recentes e barra de progresso
Cenários
Lista todos os cenários (fluxos) do projeto:
| Informação | Descrição |
|---|---|
| Nome | Nome do cenário |
| Status | Último resultado (pendente, sucesso, falha) |
| Data de Criação | Quando foi criado |
Ações:
- + Novo Cenário — Cria um novo fluxo e abre o editor
- Executar — Executa o cenário rapidamente
- Editar — Abre o editor de fluxos
- Excluir — Remove o cenário
Quando um cenário do projeto é criado ou atualizado por MCP, a lista do projeto recebe a atualização em tempo real para evitar que usuários trabalhando na tela vejam dados desatualizados.
No QANode Enterprise, esses cenários também podem ser executados por pipeline com o @qanode/cli usando:
- ID
- nome do cenário + nome do projeto
Para detalhes, veja CLI e API do CI/CD.
Suítes
Lista as suítes do projeto com informações de agendamento e último resultado.
Para detalhes sobre suítes, veja Suítes de Teste.
Variáveis
A aba Variáveis permite criar valores reutilizáveis apenas dentro daquele projeto.
Use variáveis de projeto para dados que não devem ser globais, como URL do ambiente, usuários de teste, chaves de massa ou flags específicas daquele produto.
| Informação | Descrição |
|---|---|
| Nome | Identificador usado nas expressões |
| Tipo | String, Number, Boolean ou JSON |
| Valor | Valor salvo ou mascarado, quando secreto |
| Última atualização | Data da última alteração |
Nos cenários vinculados ao projeto, essas variáveis ficam disponíveis no painel Variáveis do editor e podem ser usadas com a mesma sintaxe:
{{ variables.NOME_DA_VARIAVEL }}
A lista principal do menu Variáveis mostra apenas variáveis globais. Variáveis de projeto são gerenciadas dentro do próprio projeto.
Execuções
Histórico de todas as execuções do projeto:
| Informação | Descrição |
|---|---|
| Cenário/Suíte | Nome do que foi executado |
| Status | Resultado (sucesso, falha, executando) |
| Duração | Tempo de execução |
| Data | Data e hora da execução |
Defeitos — Enterprise
Lista os defeitos vinculados ao projeto. Para cada cenário da lista é possível ver se ele está bloqueado por um defeito ativo, com link direto para o defeito responsável pelo bloqueio.
Ações disponíveis na lista de cenários:
| Ação | Descrição |
|---|---|
| Bloquear por Defeito | Associa um defeito existente como bloqueador do cenário |
| Desbloquear | Remove a associação de bloqueio |
Um cenário bloqueado por defeito aparece com indicação visual na lista e é contabilizado na métrica Cenários Bloqueados dos relatórios.
Para abrir um novo defeito, use a execução com falha do cenário ou acesse diretamente a aba Defeitos no menu lateral.
Documentação
Gerenciamento de arquivos do projeto:
- Upload — Faça upload de documentos (requisitos, especificações, etc.)
- Download — Baixe documentos anexados
- Excluir — Remova documentos
Os documentos do projeto também podem ser lidos por integrações MCP, respeitando as permissões do usuário. Isso permite que uma IA entenda requisitos antes de criar ou ajustar cenários.
Em projetos com muitos anexos ou documentos grandes, a integração MCP pode pesquisar trechos relevantes antes de abrir o arquivo completo. Isso ajuda a encontrar uma regra, requisito, tela ou termo específico sem carregar todo o documento de uma vez.
Formatos suportados para leitura:
| Tipo | Como o QANode trata |
|---|---|
| Extrai texto; permite escolher página única, intervalo ou todas as páginas | |
| PDF escaneado / imagem | Usa OCR quando não há texto digital disponível |
| DOCX | Extrai conteúdo textual |
| TXT / JSON / CSV | Lê diretamente como texto/dados |
| XLSX | Mostra prévia das planilhas e linhas |
| Outros arquivos | Retorna metadados ou permite download, quando o usuário tem permissão |
Para documentos grandes, prefira pesquisar termos, ler páginas ou intervalos específicos em vez de carregar tudo de uma vez.
Filtragem e Busca
Na lista de projetos, você pode:
- Buscar por nome — Campo de busca no topo
- Filtrar por status — Dropdown de filtro (Ativo, Concluído, etc.)
Duplicar Projeto
Para criar uma cópia de um projeto existente:
- Na lista de projetos, clique nas opções (⋮) do projeto
- Selecione Duplicar
- Um novo projeto será criado com os mesmos cenários
Dicas
- Use status para acompanhar o ciclo de vida dos projetos
- Arquive projetos antigos para manter a lista limpa
- Datas de início e término ajudam a acompanhar o progresso vs. planejamento
- Use a aba de Documentação para manter requisitos e especificações junto ao projeto