Documentation Index
Fetch the complete documentation index at: https://docs.synkrony.ai/llms.txt
Use this file to discover all available pages before exploring further.
Status do Kanban
Os Status representam as colunas visuais do kanban, organizando o fluxo das tarefas desde o planejamento até a entrega. No Synkrony, cada status possui configurações que afetam desde a visualização do board até o cálculo de performance da equipe.
Tipos de Status
Todos os status são agrupados em três categorias principais (status_type):
| Tipo | Descrição | Uso típico |
|---|
| Backlog | Tarefas planejadas, aguardando priorização ou início | Backlog, Icebox, Arquivo |
| Ongoing | Tarefas em algum estágio de desenvolvimento ativo | A Fazer, Em Progresso, Revisão, Code Review |
| Done | Tarefas finalizadas e entregues | Concluído, Done, Deployed |
Regra: Cada empresa deve ter pelo menos um status de cada tipo (backlog, ongoing, done).
Status Padrão
Ao criar uma nova empresa, o Synkrony configura automaticamente os seguintes status:
| Nome | Tipo | Pontuação | Cor |
|---|
| Backlog | Backlog | - | #8F9FAD |
| A Fazer | Ongoing | 0% | #E5B85C |
| Em Andamento | Ongoing | 25% | #69A0E8 |
| Aguardando Revisão | Ongoing | 50% | #8C85F1 |
| Alterações Requisitadas | Ongoing | 75% | #8C85F1 |
| Done | Done | 100% | #33D391 |
Nota: Esta configuração é global (nível empresa). Todos os projetos compartilham os mesmos status.
Personalizando Status
O que você pode configurar
Através de Configurações → GitHub, os administradores podem:
- Adicionar novos status: Criar etapas intermediárias ou específicas para seu processo
- Renomear status existentes: Usar a terminologia do seu time
- Alterar cores: Personalizar a identidade visual do kanban
- Definir pontuação: Configurar quanto cada status vale no cálculo de performance
- Mapeamento GitHub: Configurar qual status corresponde a cada evento de PR
Reordenando Status
A ordem dos status define a sequência visual das colunas no kanban. Arraste os status na tela de configuração para reorganizá-los conforme seu fluxo de trabalho.
Pontuação (Average Score)
A pontuação de cada status (0-100%) é usada para calcular a eficiência nos relatórios de performance:
- 0%: Tarefas que ainda não começaram
- 25-75%: Tarefas em progresso (quanto maior, mais próxima da conclusão)
- 100%: Tarefas concluídas
Regra: Pelo menos um status do tipo “done” deve ter pontuação 100%.
Cada status pode ter um GitHub Status Type que define como eventos de Pull Request afetam automaticamente a tarefa:
| GitHub Status Type | Descrição |
|---|
none | Status sem mapeamento específico com GitHub |
review | PR aberto e aguardando revisão |
changes_requested | PR precisa de alterações solicitadas pelo revisor |
done | PR foi mergeado (tarefa concluída) |
approved | PR foi aprovado pelo revisor |
others | Interações gerais/comentários |
Mapeamento Padrão
| Status | GitHub Status Type |
|---|
| Backlog | none |
| A Fazer | none |
| Em Andamento | none |
| Aguardando Revisão | review |
| Alterações Requisitadas | changes_requested |
| Done | done |
Regra: Apenas um status por empresa pode ter cada tipo de mapeamento GitHub.
Fluxos de Trabalho Comuns
Fluxo Simples
Backlog → A Fazer → Em Andamento → Done
Ideal para times pequenos ou projetos simples.
Backlog → A Fazer → Em Andamento → Aguardando Revisão → Done
Adiciona uma etapa de revisão antes da conclusão.
Backlog → A Fazer → Em Andamento → Aguardando Revisão → Aprovado → Done
↓ (se necessário)
Alterações Requisitadas
Fluxo completo com aprovação explícita e ciclo de ajustes.
Backlog → A Fazer → Em Andamento → Code Review → Aprovado → QA → Deploy → Done
Inclui etapas de QA e deploy antes da conclusão final.
Boas Práticas
1. Mantenha Simples
Comece com poucos status e adicione conforme necessário. Muitas colunas podem dificultar a visualização.
Os status devem espelhar como o time realmente trabalha, não o contrário.
❓ FAQ
Posso ter diferentes status por projeto?
Não. Os status são configurados em nível de empresa, garantindo consistência em todos os projetos.
O que acontece se eu excluir um status que está em uso?
As tarefas naquele status serão movidas para outro status do mesmo tipo (backlog/ongoing/done).
Por que não posso ter dois status com o mesmo github_status_type?
Para garantir clareza na automação. Quando um PR é aprovado, o sistema precisa saber exatamente para qual status mover a tarefa.
A pontuação afeta algo além dos relatórios de performance?
Não. A pontuação é usada apenas nos cálculos de eficiência dos relatórios de sprint.
Posso alterar a ordem dos status depois de criados?
Sim! Basta arrastar os status na tela de configuração. A alteração é imediata e afeta apenas a visualização.