MCP - Massa de Teste
Servidor MCP (QAForge) para geração e apoio à criação de massa de teste. Consulte o repositório para instalação, configuração e uso com agentes compatíveis com Model Context Protocol.
Dashboard
QA Workspace
Central de Relatórios e Cenários
Visão operacional da sprint, riscos de QA e atalhos para as rotinas do dia.
📊 Dashboard
Com conexão e contexto configurados, o Dashboard exibe gráficos da sprint, riscos de QA e itens que precisam de atenção.
Painel de Cards
Métricas da sprint, itens que precisam de atenção e sincronização com o Azure DevOps.
ROT
Registro operacional de testes com data e versão do ambiente.
Relatório de Entrega
Gere o relatório de entrega a partir da WIQL e do contexto configurado.
Cenários de Teste
Pipeline Estrutura QA com agente Cursor — análise, planejamento e publicação no Azure.
Configuração
Conexão Azure DevOps, time, sprint, responsável e queries.
📍 Contexto da operação
Carregando...
Configuração
Azure DevOps e contexto da operação
Conecte à organização, defina o contexto operacional e, para o ROT, configure um ou mais projetos/times/sprints.
PAT: Azure DevOps → User settings → Personal access tokens → New token (
Work Items Read).
Tudo é salvo localmente em config.json.
🔌 Conexão
🤖 Agente Cursor
Conecte sua conta Cursor para estruturar escopos QA (Fase 1+) com as skills Produto/N3. Login via browser; a chave fica em %USERPROFILE%\.cursor\sdk\auth.json.
Pré-requisitos: pip install cursor-sdk e, na pasta scripts/cursor-auth, npm install.
📋 Contexto operacional
Como QA Lead, escolha o analista no campo Responsável para ver o painel e relatórios de outro QA. QAs comuns veem apenas os próprios dados.
Sprint e time são definidos pelo administrador. Você visualiza apenas work items em que é responsável (atribuído, criado ou alterado).
Usado pelo Dashboard e Painel de Cards. O ROT e o Relatório de Entrega usam os Contextos do ROT abaixo (vários projetos/times/sprints). Se a lista estiver vazia, usam este contexto.
Ao carregar, seleciona automaticamente a última sprint ativa (hoje dentro do intervalo de datas).
Opcional. Quando preenchido, filtra itens atribuídos ou criados por essa pessoa.
🧭 Contextos do ROT e Relatório de Entrega
O ROT e o Relatório de Entrega consultam todos os contextos habilitados (podem ser projetos, times e sprints diferentes na mesma organização). Se a lista estiver vazia, usam o contexto operacional acima.
As alterações são salvas automaticamente em config.json na pasta do aplicativo.
Administração
Usuários e permissões
Gerencie contas QA, QA Lead e Super Admin. A senha inicial de exemplo é changeme — altere após o primeiro acesso.
➕ Criar / editar usuário
👥 Usuários cadastrados
| Usuário | Nome | Perfil | Status |
|---|
Configuração de Dados
Consultas WIQL
Duas consultas independentes: relatório de entrega (sprint/período) e ROT (dia do relatório).
Relatório de entrega e cenários usam
queries.report (sprint + período em Filtros Padrão).
O ROT usa queries.rot (data e sprint da tela ROT). O filtro por QA é aplicado depois da consulta.
▶️ Relatório de entrega
Teste, Bug e Test Case no período da sprint. Placeholders: {iteration_path}, {sprint_start}, {sprint_finish}.
📝 ROT (operacional diário)
Itens alterados no dia do ROT. Placeholders: {iteration_path}, {report_date}, {report_date_start}, {report_date_end}.
📜 Histórico de consultas
Cada salvamento registra uma versão para consulta ou restauração posterior (até 40 entradas).
📦 Campos extras da API (avançado)
Campos custom geralmente têm prefixo Custom.. Se o processo já está funcionando, o ideal é manter este bloco como está.
Mapeamento Avançado
Mapeamentos de Colunas e States
Ajuste esta área somente se o seu projeto usar nomes diferentes do padrão esperado pela aplicação.
Se o projeto usa os nomes padrão do Azure DevOps, normalmente
não é necessário alterar estes campos.
📊 Nomes internos de colunas
🏁 Estados de referência
Execução
Relatório de Entrega
Busca os dados do Azure DevOps e gera o HTML do relatório consolidado do período selecionado.
Usa os Contextos do ROT em Configuração (vários projetos/sprints).
Se nenhum contexto extra estiver cadastrado, usa o contexto operacional.
📡 Status da execução
Aguardando configuração...
Aguardando...
Tasks / Testes
Bugs
Cenários de teste
Montando relatório
✅ Relatório gerado com sucesso!
Operação diária
ROT - Relatório Operacional de Teste
Gere o ROT no formato padrão Techne, revise o texto abaixo e use Copiar para e-mail para colar no Outlook com gráficos.
Usa os Contextos do ROT em Configuração (vários projetos/times/sprints).
A data do relatório filtra o dia; a sprint de cada contexto define o escopo WIQL.
🗂️ Gerar ROT
Aguardando configuração...
Dia do relatório. Padrão: hoje.
Acompanhamento
Painel de Cards Azure
Meus cards, sem PBI, bugs, bloqueados, Done sem reteste e alterados hoje — com status e sprint de cada item.
Aguardando configuração...
Estrutura QA
Cenários e estruturação QA
Análise por agente Cursor (skills Produto/N3) e estruturação sequencial do escopo QA no Azure DevOps.
🧠 Estrutura QA — Pipeline
Informe squad e card → Salvar contexto. Execute uma fase por vez; revise o resultado em leitura → Editar se necessário → Aprovar para habilitar a próxima. Fases 2–3 publicam no Azure somente na aprovação.
Filtrado pela sprint e responsável em Configuração.
Pipeline
1
Análise
2
Planejamento
3
Individuais
4
Cenários
5
Publicar
Operação
Ferramentas
Utilitários e integrações disponíveis para apoiar a operação de QA. Links externos abrem em nova aba.
Ferramentas listadas aqui são mantidas pelos responsáveis indicados em cada card. Requerem internet para acesso ao repositório ou documentação.
Referências
Guias de QA
Material de apoio sobre roteiro de testes, ROT diário, métricas e registro de bugs. Guias internos abrem em página dedicada; os do Gamma abrem em nova aba.
Guias externos (Gamma) requerem internet. O guia Como criar bugs abre em página exclusiva neste workspace.
Roteiro de Teste Funcional
Template para testes manuais: identificação do caso, pré-condições, passos, resultados esperados, status e evidências. Inclui estrutura Dado / Quando / Então.
Template de ROT
Relatório Operacional de Teste diário: o que foi feito, pontos de atenção, histórico e resoluções. Padroniza a comunicação com Dev, PO e stakeholders.
Métricas de Teste
Indicadores de qualidade: cobertura de teste, defeitos críticos, densidade de defeitos, MTTR e benchmarks de mercado para gestão baseada em dados.
Como criar bugs
Padrão de título, descrição estruturada (reprodução, esperado, atual, evidência) e boas práticas para registrar defeitos no Azure DevOps.
Abrir guia
Guia de uso
Tutorial
Passo a passo para configurar o QA Workspace e usar Painel de Cards, ROT, relatório de entrega e cenários de teste.
📌 Neste guia
🚀 Primeiros passos
-
1
Inicie a aplicação
No Windows, execute
iniciar.batou rodepython app.py. O navegador abrirá emhttp://localhost:5000. -
2
Configure uma vez
Em Configuração, informe organização, projeto e PAT do Azure DevOps. Escolha time, sprint e, se quiser, o responsável QA. Clique em Salvar configuração.
-
3
Use as rotinas do menu Operação
Com a conexão salva, acesse Painel de Cards Azure, ROT, Relatório de Entrega ou Cenários de Teste conforme a necessidade do dia.
⚙️ Configuração (Azure + contexto)
-
1
Criar o PAT no Azure DevOps
- User settings → Personal access tokens → New Token
- Permissões mínimas:
Work Items (Read) - Para publicar cenários em Test Plans: inclua
Test Management (Read & Write)
-
2
Preencher conexão
Organização é o nome em
dev.azure.com/NOME. Projeto deve ser exatamente como aparece no Azure (maiúsculas/minúsculas importam). Cole o PAT e clique em Testar conexão. -
3
Contexto padrão
- Time: opcional; ajuda a listar membros do time.
- Sprint: ao carregar as listas, a última sprint ativa (hoje dentro do intervalo de datas) é selecionada automaticamente.
- Responsável: QA do dia; usado pelo Painel de Cards, ROT e relatórios. O painel exige sprint e responsável preenchidos.
- O período do relatório de entrega é calculado pelas datas da sprint; não é necessário informar manualmente.
-
4
Salvar
Clique em Salvar configuração. Os dados ficam em
config.jsonna pasta do projeto (não são enviados para a internet além do Azure).
📋 Painel de Cards Azure
Visão da sprint com métricas clicáveis e lista ordenada por importância (10 itens por página).
-
1
Configure o escopo
Em Configuração, defina projeto, sprint e responsável. O painel usa esse contexto; não há filtros separados na tela.
-
2
Sincronizar
Ao abrir o menu, o painel sincroniza automaticamente quando possível. Use Sincronizar no canto superior direito para atualizar manualmente. O auto-refresh ocorre a cada 60 segundos com a página aberta.
-
3
Métricas principais
- Meus Cards: atribuídos ou criados pelo responsável configurado.
- Bugs s/ Reteste: bug concluído sem card de reteste vinculado.
- Testes s/ Planejamento / Execução: cards Teste seus sem planejamento ou execução vinculados.
- Test Cases criados s/ Executar: Test Cases criados pelo responsável no período da sprint, com Outcome vazio ou não executado no Test Plan.
- Status de Test Case: exibido pela coluna Outcome do Test Plan (Ok, Falha, Criados, Não executado), não pelo System.State do work item.
- Criados s/ PBI: cards criados pelo responsável sem Product Backlog Item vinculado (exceto Test Cases).
Clique em uma métrica para filtrar a lista abaixo. Use Anterior / Próxima para paginar.
-
4
Itens em destaque
Cards bloqueados, sem vínculos esperados ou sem atualização há dias aparecem com destaque e maior prioridade na ordenação.
📝 ROT: Relatório Operacional de Teste
Use no fim do dia para consolidar o que aconteceu e copiar o texto para e-mail.
-
1
Abra o menu ROT
Confirme que a configuração já foi salva. Se os dropdowns estiverem vazios, volte em Configuração e teste a conexão.
-
2
Parâmetros do ROT
Projeto, time, sprint e responsável vêm de Configuração (resumo exibido no topo da tela). Na tela do ROT, informe apenas:
- Data: dia do relatório (padrão: hoje). A sprint do ROT é inferida pela data quando possível.
- Versão do ambiente: opcional (ex.: V12, V11).
-
3
Gerar ROT
Clique em Gerar ROT. O arquivo segue o template Techne: cabeçalho, O Que Foi Feito Hoje, Pontos de Atenção e Histórico e Resoluções, com linhas-guia entre colchetes para o que o Azure não cobrir.
-
4
Baixar ou copiar
Edite o texto se precisar. Para e-mail, prefira Copiar para e-mail (links clicáveis). Use Baixar .md para arquivo ou versionamento.
▶️ Relatório de Entrega
Consolida tasks, bugs e cenários da sprint para entrega formal (HTML).
-
1
Revise a configuração
Time, sprint e responsável em Configuração definem o recorte dos dados. Salve antes de gerar.
-
2
Gerar relatório
Em Relatório de Entrega, clique em Gerar Relatório de Entrega. Acompanhe o progresso nos passos (query unificada → separação por tipo → cenários).
-
3
Baixar HTML
Após o sucesso, use Baixar Relatório HTML e abra o arquivo no navegador para apresentar ou anexar à entrega da sprint.
🧪 Cenários de Teste — Estrutura QA
Pipeline por fases com agente Cursor: análise, planejamento, individuais, cenários e publicação no Test Plan 36030.
-
1
Contexto
Em Configuração, defina sprint e responsável. Na aba Cenários, escolha Squad e Card, informe o PR se houver e clique em Salvar contexto.
-
2
Executar fases
Execute uma fase por vez (1 a 5). O agente gera o resultado; revise em modo leitura, edite se necessário e Aprovar para avançar.
-
3
Publicação no Azure
Fases 2 e 3 publicam planejamento e individuais na aprovação. Fase 5 publica Test Cases no Plan 36030 após dedupe e confirmação.
💡 Dicas e problemas comuns
-
!
Erro 401 na conexão
PAT expirado ou sem permissão. Gere um novo token com acesso a Work Items.
-
!
Painel de Cards não carrega
Confira sprint e responsável em Configuração e clique em Atualizar listas se os dropdowns estiverem vazios. Abra o painel novamente ou use Sincronizar.
-
!
ROT com erro de JSON / tela vazia
Reinicie o servidor (
python app.py) após atualizar o código. Versões antigas podem não ter o endpoint do ROT. -
!
Pipeline Estrutura QA não avança
Salve o contexto (squad + card), conecte o agente Cursor em Configuração e aprove cada fase antes de executar a próxima.
-
!
Configuração avançada (WIQL, painel, mapeamentos)
Consultas, bloco
card_panele mapeamentos ficam emconfig.json. Detalhes emdocs/CARD_PANEL.mdedocs/DECISOES_E_HISTORICO.md.
Guia
Como criar bugs no Azure DevOps
Padrão de título e descrição para registrar defeitos com qualidade e rastreabilidade.
Use este padrão ao registrar defeitos encontrados em testes manuais, automatizados ou homologação. Um bug bem descrito reduz ida e volta com Dev/PO e aparece corretamente nos relatórios de entrega (origem, criticidade, densidade).
Título do work item
Formato obrigatório: [Feature] + descrição curta e objetiva do problema.
A tag [Feature] identifica o módulo ou área funcional afetada (ex.: evento, tela, fluxo).
Bom
[R-2060] Botão Importar Arquivo habilitado para usuário sem permissão[Perfil de Acesso] Sistema permite salvar evento duplicado em status 3 - Validado
Evite
Erro na tela · Não funciona · Bug encontrado no teste
Descrição (corpo do bug)
Copie o template abaixo e preencha cada seção. Mantenha passos numerados, linguagem neutra e evidência anexada ou linkada.
📋 Passos para reproduzir:
✅ Resultado esperado:
🔴 Resultado atual:
📎 Evidência:
Título do work item (campo separado): [Feature] descrição curta do problema
Exemplo preenchido
[R-9000] Sistema exibe mensagem genérica ao bloquear cadastro manual duplicado
📋 Passos para reproduzir:
1. Acessar o ambiente ESO_PROD com usuário admin
2. Abrir a tela R-9000 - Exclusão de Eventos (eso0150)
3. Clicar em Novo Evento e preencher os campos com chave lógica já existente
4. Garantir que já existe evento com status 3 - Evento validado para a mesma chave
5. Clicar em Salvar
✅ Resultado esperado:
O sistema deve bloquear o cadastro manual e exibir a mensagem padrão de duplicidade, informando que não é possível concluir o salvamento por conflito de chave lógica.
🔴 Resultado atual:
O sistema bloqueia a operação, porém exibe mensagem técnica sem contexto (“Erro ao gravar registro”), dificultando entendimento pelo usuário e pelo PO.
📎 Evidência:
Print da tela após Salvar + ID do evento existente (#68421) + data/hora do teste (27/05/2026 14:32).
Dicas por seção
- Passos para reproduzir: inclua ambiente, usuário/perfil, tela (código eso), dados de entrada e ordem exata dos cliques.
- Resultado esperado: descreva o comportamento correto conforme regra de negócio, critério de aceite ou especificação.
- Resultado atual: descreva o que acontece de fato — mensagem exibida, bloqueio indevido, dado gravado errado, etc.
- Evidência: print, gravação de tela, XML, log ou protocolo. Se houver work item relacionado (Test Case, Task), cite o ID.
Criando o bug no Azure DevOps
-
1
Novo work item
Board ou Backlog → New work item → tipo Bug (ou fluxo equivalente do projeto).
-
2
Título e descrição
Cole o título no formato
[Feature] …e a descrição com as quatro seções do template. -
3
Campos complementares
- Iteration Path / Sprint: sprint em que o defeito foi encontrado
- Assigned To: dev responsável ou vazio até triagem
- Origem (
Custom.Origem): ex. Funcionalidade, Layout, Usabilidade — usado nos relatórios de entrega - Priority: Critical / High quando impacta entrega ou bloqueia testes
-
4
Vínculos
Relacione ao Test Case ou Task de QA em que o defeito foi encontrado. Se veio de reteste, vincule ao bug original.
-
5
Evidência
Anexe arquivos no bug ou cole links. Comentários com print também ajudam, mas a descrição principal deve bastar para reproduzir sem call.
Checklist antes de salvar
- Título começa com
[Feature]e descreve o problema em uma linha - Passos permitem reproduzir sem perguntar “qual usuário?” ou “qual tela?”
- Esperado vs. atual estão claros e comparáveis
- Há evidência ou referência rastreável
- Sprint, origem e vínculo com teste/atividade preenchidos quando aplicável
Institucional
Sobre
Informações institucionais, autoria e condições de uso desta solução.
📘 Apresentação
O Gerador de Relatório QA Azure DevOps foi desenvolvido para apoiar a operação de qualidade de software com foco em produtividade, padronização e rastreabilidade. A solução centraliza a geração de relatórios, a análise de cenários de teste e o apoio à preparação de publicações no Azure DevOps, oferecendo uma experiência orientada a consistência operacional e ganho de eficiência no processo de QA.
👥 Autoria
Esta solução foi criada por e , com o objetivo de prover uma ferramenta profissional para suporte às rotinas de validação, acompanhamento técnico e organização do fluxo de testes dentro do contexto corporativo.
🔒 Licença e Uso
Este software é disponibilizado sob licença proprietária de uso interno restrito, destinada única e exclusivamente à Techne Eng e Sistemas Ltda. Seu uso é autorizado apenas no âmbito das atividades internas da organização, vedada a utilização por terceiros, a reprodução não autorizada, a cessão, o sublicenciamento, a distribuição, a comercialização ou qualquer forma de exploração fora da Techne sem autorização formal e expressa dos responsáveis.
Ao utilizar esta aplicação, entende-se que o uso deve observar as diretrizes internas da empresa, bem como os princípios de confidencialidade, segurança da informação e preservação dos ativos intelectuais associados à solução e aos processos que ela apoia.