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 do Time
Visão da gestora: cards, bugs e analistas da squad no período.
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
Contexto operacional, conexão Azure, ROT e agente Cursor.
📍 Contexto da operação
Carregando...
Configuração
Azure DevOps e contexto da operação
Comece pelo contexto operacional. Depois a conexão Azure, os contextos do ROT e Relatório de Entrega, e por último o agente Cursor.
Com login Microsoft, o EspaçoQA lista organizações e projetos da sua conta.
Escolha organização, projeto, time e sprint. O responsável fica no seu usuário
(QA comum) ou pode ser escolhido (QA Lead / Super Admin).
PAT é opcional (modo local sem OAuth).
📋 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.
Escolha organização, projeto, time e sprint. A sprint ativa vem pré-selecionada
quando dá para identificar uma só; você pode trocar.
O responsável fica no seu usuário. Você vê 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.
Todos os times do projeto selecionado. Super Admin pode escolher Todos para listar times de todos os projetos. Se o time não aparecer, confira o projeto acima.
Pré-seleciona a sprint ativa quando houver uma só no período. Você pode escolher outra na lista.
Opcional. Quando preenchido, filtra itens atribuídos ou criados por essa pessoa.
Atualizar listas recarrega as opções do Azure sem trocar o que você já escolheu.
As alterações são salvas automaticamente.
🔌 Conexão
Com login Microsoft, organização e projeto são escolhidos nos dropdowns do contexto operacional. PAT só no modo local sem OAuth.
🧭 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.
Seu perfil não grava o config.json compartilhado. Os contextos valem nesta sessão e nas gerações de ROT/relatório.
As alterações são salvas automaticamente em config.json na pasta do aplicativo.
🤖 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.
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.
Gestão
Painel do Time
Visão do time no período: cards, bugs e volume observado por analista. Não é julgamento de produtividade.
—
·
—
verde passou · vermelho falhou
Preenchimento QA
1 linha por card Teste — colunas A–W da planilha Performance QA (01_Preenchimento_QA)
| Nº PBI | ID card | QA | Título | Tipo | Projeto / squad | Link ADO | Complex. | Papel QA | Recebe QA | Entrega QA | Resultado | Dias bloq. | Motivo bloq. | Cen. elabor. | Cen. exec. | Bugs válidos | Bugs P1 | Reteste | TC no ADO | Ambiente | H. est. | H. reais | Observações |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Execute Analisar qualidade para carregar os cards do período. | |||||||||||||||||||||||
Classificação dos bugs
severidade no escopo- Crítico —
- Alto —
- Médio —
- Baixo —
- Melhoria —
Indicador crítico
bugs críticos / bugsPercentual de bugs críticos no recorte.
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.
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.
MCP - Bug Issue Creator
Servidor MCP (BugIssueCreator) para apoio à criação de bugs e issues no Azure DevOps. Consulte o repositório para instalação, configuração e uso com agentes compatíveis com Model Context Protocol.
Atualiza Ambiente QA eSocial
Utilitário para atualização do ambiente de QA eSocial. Consulte o repositório para instalação, configuração e uso.
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
Entre com Microsoft. O EspaçoQA lista organizações e projetos da sua conta. Se houver vários, escolha nos dropdowns de Configuração. Time e sprint são todos os times do projeto selecionado.
-
3
Use as rotinas do menu Operação
Com a conexão salva, acesse Painel do Time, 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 e Projeto são dropdowns com as contas e projetos do Azure DevOps. Com OAuth, não é necessário PAT. Clique em Testar conexão (Super Admin) se quiser validar.
-
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 do Time
Visão da squad no período (QA, QA Lead ou Super Admin). Não usa o responsável individual nem a sprint selecionada na barra lateral.
-
1
Recorte do time
Em Configuração, escolha projeto e time. Abra Operação → Painel do Time.
-
2
Analisar qualidade
Informe Data início e Data fim (podem vir sugeridas pela sprint) e clique em Analisar qualidade. A coleta traz cards e PBIs criados ou alterados pelos QAs nesse intervalo, em toda a squad. Fonte indisponível aparece como N/A, não como zero.
📋 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
Sessão Microsoft expirada ou sem permissão no projeto. Saia e entre de novo. No modo local, verifique o PAT.
-
!
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.