Bem-vindo ao DevStats. Este guia apresenta tudo o que você precisa para ter seus primeiros insights funcionando: desde a criação do seu squad até a exploração dos seus dashboards.
✅ Pré-requisitos
Antes de começar, certifique-se de ter:
- Uma conta em um provedor Git suportado: GitHub, GitLab, GitLab Self-Managed, Bitbucket, Bitbucket Data Center ou Azure Repos.
- Acesso a um repositório com alguma atividade de desenvolvimento: quanto mais histórico disponível, mais ricos serão seus dashboards.
- Permissões para autenticar o DevStats nas plataformas escolhidas.
Passo 1: Cadastre-se
Crie sua conta no DevStats visitando a página inicial e clicando em Cadastrar. Siga as instruções para registrar e verificar sua conta.
Passo 2: Crie Seu Primeiro Squad
Um Squad é a unidade central do DevStats. Ele representa sua equipe de desenvolvimento (ou um subconjunto dela) e define quais desenvolvedores e repositórios são monitorados.
Para criar um squad:
- Acesse a aba Squads no seu dashboard.
- Clique em Adicionar Primeiro Squad.
- Preencha os detalhes do squad:
- Nome: um nome claro e descritivo para a equipe.
- Gerente: atribua um gerente (você mesmo pode ser selecionado).
- Logo: opcional. Faça upload de uma imagem para o seu squad.
- Clique em Salvar.
Passo 3: Conecte Suas Fontes de Dados
Com o squad criado, é hora de trazer os dados. O DevStats suporta três tipos de integrações — conecte quantas forem aplicáveis à sua equipe para ter uma visão mais completa.
🔗 Provedor Git (Obrigatório)
Conecte sua plataforma de código-fonte para que o DevStats possa rastrear pull requests, commits, cycle time e atividade de deploy.
| Provedor | Documentação |
|---|---|
| GitHub | Ver guia |
| GitLab | Ver guia |
| GitLab Self-Managed | Ver guia |
| Bitbucket | Ver guia |
| Bitbucket Data Center | Ver guia |
| Azure Repos | Ver guia |
As capturas de tela abaixo mostram um exemplo geral do fluxo de conexão. Para instruções específicas por provedor, consulte o guia individual na tabela acima.
1. Na visão geral do squad, abra a aba Integrações e clique em Adicionar Integração.
2. Selecione seu provedor Git e clique para autenticar.
3. Faça login e autorize o acesso do DevStats.
4. Conceda ao DevStats acesso à sua conta/organização.
5. Selecione os repositórios que deseja monitorar e clique em Salvar Integração.
Após a conexão, o DevStats começará a importar seus dados históricos. Isso pode levar de alguns minutos a alguns dias, dependendo do tamanho do repositório. Você receberá um email quando seus dashboards estiverem prontos.
📋 Issue Tracker (Recomendado)
Conectar um issue tracker permite que o DevStats leia labels de tickets, estados de issues e dados de cycle time — melhorando significativamente a precisão das suas métricas.
| Tracker | Documentação |
|---|---|
| Jira Cloud | Ver guia |
| Jira Data Center | Ver guia |
| Linear | Ver guia |
| Azure Boards | Ver guia |
| GitHub Projects | Ver guia |
| ClickUp | Ver guia |
Na visão geral do squad, abra a aba Integrações, clique em Adicionar Integração, selecione seu issue tracker e siga as etapas de autenticação. Para instruções específicas por provedor, consulte o guia individual na tabela acima.
🤖 Ferramentas de IA (Opcional)
Conecte suas ferramentas de IA para rastrear o uso e medir o impacto na produtividade da sua equipe.
| Ferramenta | Documentação |
|---|---|
| GitHub Copilot | Ver guia |
| Claude | Ver guia |
Passo 4: Explore Seus Dashboards
Assim que os dados começarem a fluir, seus dashboards serão preenchidos automaticamente. Áreas principais para começar:
- PR Cycle Time: Entenda com que rapidez seus pull requests se movem da criação ao deploy.
- Deploy Frequency: Meça com que frequência sua equipe faz deploy de código.
- Issue Cycle Time: Rastreie com que eficiência sua equipe resolve tarefas.