O que é o relatório de Open PRs?
O Open PRs Dashboard fornece uma visão clara dos pull requests que ainda estão abertos e aguardando merge ou fechamento. Ele rastreia quanto tempo cada PR permanece aberto, destacando a eficiência de merge e revisão da equipe. Um PR desaparece automaticamente deste dashboard quando é mergeado ou fechado, garantindo que a visualização sempre represente apenas trabalho ativo e em progresso.
Métricas
Tempo Aberto Dentro do Limite
- O quê:
Este indicador visual e contador de sequência exibem o desempenho da equipe em revisar pull requests dentro do limite de tempo configurado.
O limite padrão é 1 dia, mas você pode ajustá-lo por repositório nas Configurações de Limite de Revisão ⚙️.
Cada dia no calendário representa se todos os PRs foram revisados dentro desse limite:
- Marca Verde (✅) – todos os PRs atenderam o limite naquele dia.
- Cruz Vermelha (❌) – um ou mais PRs excederam o limite.
- Ponto Cinza (•) – nenhum PR foi aberto naquele dia.
Os contadores de Maior Sequência e Sequência Atual mostram dias consecutivos em que sua equipe atingiu a meta em todos os repositórios, ajudando a rastrear consistência e confiabilidade de revisão ao longo do tempo.
- Como usar:
Monitore regularmente o indicador para manter revisões de PR em movimento eficientemente. Use limites para definir metas realistas por repositório. Incentive a equipe a manter ou superar as sequências. Combine com o botão Sync 🔄 para verificar os dados mais recentes de sequência após atualizações de PR. Uma sequência consistente sinaliza ciclos de feedback rápidos e cultura saudável de code review.
- Interface:
PRs Novos
- O quê: Lista PRs recém-criados que estão atualmente abertos, incluindo detalhes-chave como nome do PR, repositório, contribuidores, revisores, tempo aberto e última atualização.
- Como usar: Use esta seção para monitorar PRs abertos recentemente e priorizar revisões para quaisquer PRs que estejam abertos por mais tempo do que o esperado.
- Interface:
PRs Anteriormente Mergeados
- O quê:
Exibe pull requests que foram mergeados ou fechados, mostrando detalhes como nome do PR, repositório, contribuidores, revisores, tempo aberto, data de fechamento e data de merge.
Esta seção ajuda as equipes a analisar trabalho concluído e entender quanto tempo os PRs ficaram abertos antes da resolução.
- Como usar:
Revise esta seção para confirmar que PRs mergeados ou fechados estão se movendo suavemente pelo pipeline.
Procure padrões recorrentes em PRs com tempos abertos mais longos para identificar possíveis melhorias em práticas de revisão e merge.
- Interface:
Botão Sync
O botão Sync busca manualmente dados dos seus repositórios conectados quando você suspeita que alguns pull requests podem estar faltando no relatório.
Esta ação recupera dados de serviços externos e pode levar alguns minutos para completar. Geralmente você não precisa executá-lo manualmente, pois o dashboard atualiza automaticamente em intervalos regulares.
Use Sync apenas quando:
- pull requests recentes não estão aparecendo na lista,
- dados de sequência parecem desatualizados,
- ou novos repositórios acabaram de ser adicionados ao squad.
Isso garante que o dashboard sempre reflita o estado mais recente dos pull requests abertos.
Configurações de Limite de Merge
As Configurações de Limite de Merge permitem que cada equipe defina quantos dias um pull request pode permanecer aberto — independentemente de ser eventualmente mergeado ou fechado — antes de ser considerado atrasado. Isso faz com que a métrica de sequência se alinhe com as metas reais de merge ou fechamento da sua equipe em vez de uma regra fixa de 24 horas.
Como definir Limites de Merge
- Insira o número desejado de dias em Máximo de dias aguardando merge.
- Selecione um ou mais repositórios.
- Clique em Aplicar aos Repositórios Selecionados para salvar.
Uma vez aplicado, o DevStats rastreará suas sequências com base nesses limites.
Por exemplo, se você definir 2 dias como limite, apenas PRs mergeados ou fechados dentro de dois dias da abertura contarão para sua sequência de Tempo Aberto Dentro do Limite.
Filtros
Use o Filtro de Squad para visualizar os Open PRs para squads individuais. Se quiser uma visão mais ampla de todas as equipes, selecione o filtro "Todos" para ver os Open PRs de todos os squads de uma vez.
Use o Filtro de Repositório para focar em repositórios específicos ou visualizar Open PRs em todos os repositórios. Isso é particularmente útil quando você quer analisar Open PRs em repositórios individuais, como focar em um repositório-chave. Filtrando neste nível, você pode rastrear Open PRs dentro do contexto de bases de código específicas.
O Filtro de Tipo de Issue permite restringir dados por tipos de issues, como Features, Bugs, Melhorias ou Hotfixes. Este filtro é útil para rastrear quanto tempo um PR permanece aberto para tipos específicos de issues.
Explore Melhores Práticas
Conclusão
O Open PRs Dashboard é essencial para manter um processo de desenvolvimento eficiente, garantindo que pull requests sejam prontamente integrados (mergeados ou fechados). Mantendo um olho atento nos tempos abertos, promovendo uma cultura de feedback rápido e rastreando progresso ao longo do tempo, as equipes podem melhorar a colaboração, reduzir atrasos e manter alta velocidade de desenvolvimento.