O que são Squads?
Squads no DevStats são grupos personalizados de desenvolvedores que permitem rastrear métricas de engenharia no nível da equipe. Você pode usar squads para representar:
- Equipes de produto
- Grupos multifuncionais
- Sub-equipes dentro de um departamento
- Qualquer agrupamento personalizado que se encaixe na sua organização
Squads oferecem uma maneira flexível de filtrar, comparar e analisar métricas para grupos específicos de desenvolvedores, melhorando a visibilidade e a tomada de decisões no nível da equipe.
Adicione Seu Primeiro Squad
Proprietários e administradores do workspace podem criar squads.
Abra Squads e clique em Add first squad (ou Add squad se já houver squads).

Conecte os repositórios e projetos da equipe ao criar o squad para que o DevStats possa coletar os dados usados nas métricas de engenharia.
No formulário Add squad:
- Preencha Squad name. O nome é obrigatório, deve ter de 2 a 255 caracteres e ser único no workspace.
- Selecione os Git repositories da equipe para conectar ao squad.
- Selecione os Projects da equipe para conectar ao squad.
- Clique em Create squad. O DevStats cria o squad e retorna à lista de squads.
Use os campos de busca para encontrar as fontes disponíveis. Se uma fonte não estiver na lista, use Import more repositories ou Import more projects para escolher o provedor e seguir suas etapas de conexão e seleção.
Recomendamos conectar os repositórios e projetos durante a criação do squad. Se precisar concluir essa etapa depois, você pode continuar a criação e adicionar as conexões na aba Integrações. As fontes disponíveis para seleção dependem das suas contas conectadas e permissões de acesso.

Próximo passo? Adicionar Integrações
Para adicionar outras fontes após criar o squad, abra-o e navegue até a aba Integrações. Aqui, você verá todas as integrações disponíveis que permitem ao DevStats coletar dados para seu squad.
Você pode conectar:
- Sistemas de controle de versão, como repositórios Git
- Ferramentas de gerenciamento de projetos
Todas as integrações estão nas configurações em Integrações do Squad. Selecione a integração que deseja adicionar e um guia rápido explicará como fazer isso.

Após salvar a integração, o DevStats começará a processar seus dados.
O tempo de processamento varia dependendo do tamanho e histórico do seu repositório e pode levar de uma hora a mais de um dia.
FAQ
Como Mover um Player de um Squad para Outro?
Um player pode estar em dois ou mais squads simultaneamente!
Passo 1: Acessar a Página de Players do Squad
- Navegue até o squad em que o player está atualmente
- Clique no botão "Gerenciar players"

Passo 2: Remover Player do Squad Atual
- Na barra lateral de gerenciamento de players, pesquise e desmarque o player que deseja mover
- Clique em "Salvar" para removê-lo do squad atual

Passo 3: Adicionar Player ao Novo Squad
- Navegue até a página de players do squad de destino
- Clique em "Gerenciar players"
- Pesquise e marque o player que deseja adicionar
- Clique em "Salvar" para adicioná-lo ao novo squad

Como Recuperar ou Adicionar um Player que Não Apareceu Durante o Processo de Integração?
Cenário 1: Player está em um Novo Repositório que Não Foi Integrado
O player pode ser novo e seu repositório ainda não foi integrado.
Solução: Integre o novo repositório para tornar o player disponível.
Cenário 2: Player está Desabilitado
Verificar Status do Player
O player pode estar desabilitado na tabela pivô squad-colaborador.
Reabilitar o Player
- Navegue até o squad.
- Clique na aba Players.
- Selecione Gerenciar players e pesquise pelo player desabilitado.
- Marque o player.
- Clique em Salvar.
Cenário 3: Repositório com Credenciais Expiradas
O repositório em que o player está trabalhando tem credenciais expiradas e não está aparecendo.
Solução: Navegue até Configurações → Repositórios e clique no ícone de escudo para reautorizar o repositório do squad.
