Indicadores de Qualidade - Work Item Dashboard
Extensão Azure DevOps para exibir uma visão executiva de qualidade dentro do formulário do Work Item, em uma aba chamada Indicadores de Qualidade.
Esta versão mantém somente o dashboard executivo: cards, velocímetros e barra de progresso. Os velocímetros são movimentados pelos campos percentuais próprios, e os ponteiros foram refinados com desenho SVG mais limpo e executivo.
Campos customizados obrigatórios
Crie os campos abaixo no processo herdado do Azure DevOps e adicione ao(s) tipo(s) de Work Item que usarão o dashboard, por exemplo Epic, Feature ou User Story.
| Nome do campo no Azure DevOps |
Reference name esperado |
Tipo sugerido |
Uso no dashboard |
| Quality Test Cases |
Custom.QualityTestCases |
Integer |
Total do card Testes |
| Quality FTR |
Custom.QualityFtr |
Integer |
Quantidade exibida no pill FTR |
| Quality Reteste |
Custom.QualityReteste |
Integer |
Quantidade exibida no pill Retestes |
| Quality Total Executions |
Custom.QualityTotalExecutions |
Integer |
Texto Total de Execuções |
| Quality Conformity Test |
Custom.QualityConformityTest |
Integer |
Texto Testes de Conformidade no card Testes |
| Quality TestCases With Conformity Test |
Custom.QualityTestCasesWithConformityTest |
Integer |
Denominador/total da barra de progresso |
| Quality Success Test Cases |
Custom.QualitySuccessTestCases |
Integer |
Numerador da barra de progresso |
| Quality Bugs Open |
Custom.QualityBugsOpen |
Integer |
Quantidade de bugs em aberto |
| Quality Bugs Resolved |
Custom.QualityBugsResolved |
Integer |
Quantidade de bugs resolvidos |
| Quality %FTR |
Custom.QualityPercentFtr |
Integer |
Valor e agulha do velocímetro % First Time Right |
| Quality %Reteste |
Custom.QualityPercentReteste |
Integer |
Valor e agulha do velocímetro % Reteste |
| Quality %Esforço |
Custom.QualityPercentEsforco |
String |
Valor e agulha do velocímetro % Esforço |
Se o Azure DevOps gerar algum reference name diferente, ajuste o objeto FIELDS no arquivo src/dashboard.ts.
Regras dos indicadores
Cards
- Testes exibe
Custom.QualityTestCases.
- FTR exibe
Custom.QualityFtr.
- Retestes exibe
Custom.QualityReteste.
- Testes de Conformidade exibe
Custom.QualityConformityTest.
- Total de Execuções exibe
Custom.QualityTotalExecutions.
- Bugs exibe
Custom.QualityBugsOpen + Custom.QualityBugsResolved.
- Em aberto exibe
Custom.QualityBugsOpen.
- Resolvidos exibe
Custom.QualityBugsResolved.
Velocímetros
Os velocímetros são controlados diretamente pelos campos abaixo:
% First Time Right usa Custom.QualityPercentFtr.% Reteste usa Custom.QualityPercentReteste.% Esforço usa Custom.QualityPercentEsforco.
O campo Custom.QualityPercentEsforco aceita valores em string como 111.44, 111,44, 111.44% ou 111,44%.
Barra de progresso
Progresso com sucesso = Custom.QualitySuccessTestCases / Custom.QualityTestCasesWithConformityTest * 100- Escala visual:
0 a 100
- Quando o valor for
0.00%, o badge fica no início da barra.
- Quando o valor for
100.00%, a barra fica completamente preenchida e o badge fica no final.
- Valores intermediários posicionam o badge conforme a evolução real.
Limites dos velocímetros
% First Time Right
- Escala visual:
0 a 100
- Vermelho:
0 a 70
- Amarelo:
70 a 85
- Verde:
85 a 100
% Reteste
- Escala visual:
0 a 100
- Verde:
0 a 10
- Amarelo:
10 a 20
- Vermelho:
20 a 100
% Esforço
- Escala visual:
100 a 500
- Verde:
100 a 120
- Amarelo:
120 a 150
- Vermelho:
150 a 500
- O valor real do campo é exibido, mas a agulha é limitada visualmente entre
100 e 500 para não quebrar o velocímetro.
Atualização em tempo real
A extensão escuta o evento onFieldChanged do Work Item Form. Quando qualquer campo configurado em FIELDS é alterado no formulário aberto, os cards, velocímetros e barra de progresso são recalculados automaticamente.
Como buildar e empacotar
npm install
npm run build
npm run package
Para publicar:
npx tfx-cli extension publish --publisher csu-digital-quality --manifest-globs vss-extension.json --share-with CSU-Digital --token <PAT>
Arquivos principais
src/dashboard.ts: leitura dos campos, eventos do Work Item, regras dos indicadores e renderização.src/dashboard.css: layout executivo, responsividade, cards, velocímetros e barra de progresso.vss-extension.json: manifesto da extensão e contribuição da aba no Work Item.
