Configurando Labels em Toda a Organização

Labels inconsistentes entre projetos criam confusão e tornam relatórios entre projetos impossíveis. Labels em toda a organização no GitScrum garantem que todos usem o mesmo vocabulário, permitindo filtragem poderosa, automação e relatórios que funcionam em todo lugar.

Caos vs Ordem de Labels

Taxonomia de Labels

Estrutura Recomendada

ESTRUTURA DE LABELS DA ORGANIZAÇÃO
═══════════════════════════════════

PRIORIDADE:
├── priority:critical  (🔴 Red)
├── priority:high      (🟠 Orange)
├── priority:medium    (🟡 Yellow)
└── priority:low       (🔵 Blue)

TIPO:
├── type:bug           (🔴 Red)
├── type:feature       (🟢 Green)
├── type:improvement   (🔵 Blue)
├── type:chore         (⚪ Gray)
├── type:docs          (📘 Purple)
└── type:security      (🟣 Purple)

STATUS:
├── status:blocked     (🔴 Red)
├── status:needs-review (🟡 Yellow)
├── status:in-progress  (🔵 Blue)
└── status:on-hold     (⚪ Gray)

ÁREA:
├── area:frontend      (🔵 Blue)
├── area:backend       (🟢 Green)
├── area:api           (🟣 Purple)
├── area:infrastructure (🟠 Orange)
└── area:mobile        (🩵 Cyan)

ESFORÇO:
├── effort:xs          (tiny)
├── effort:s           (small)
├── effort:m           (medium)
├── effort:l           (large)
└── effort:xl          (extra large)

Convenções de Nomenclatura

REGRAS DE NOMENCLATURA DE LABELS
═════════════════════════════════

FORMATO: categoria:valor

DIRETRIZES:
├── Usar minúsculo
├── Usar hífens para múltiplas palavras
├── Prefixar com categoria
├── Manter valores curtos
├── Ser descritivo
└── Evitar abreviações

BOM:
├── priority:high
├── type:bug
├── status:needs-review
├── area:user-auth
└── team:platform

RUIM:
├── HIGH PRIORITY
├── BUG
├── NR
├── auth
└── Platform Team

Configuração de Setup

Configurações da Organização

CONFIG DE LABELS DA ORGANIZAÇÃO
═══════════════════════════════

SETTINGS → ORGANIZATION → LABELS

Grupos de Label:
┌───────────────────────────────────────────────┐
│  Grupo: Priority                              │
│  ─────────────────                            │
│  Required: Yes (one per task)                 │
│  Default: priority:medium                     │
│                                               │
│  Labels:                                      │
│  ├── 🔴 priority:critical                    │
│  ├── 🟠 priority:high                        │
│  ├── 🟡 priority:medium                      │
│  └── 🔵 priority:low                         │
│                                               │
│  [Add Label] [Edit Group]                     │
└───────────────────────────────────────────────┘

Sincronizando para Projetos

CONFIGURAÇÃO DE SINC DE LABELS
══════════════════════════════

OPÇÕES DE SINC:
├── Automático: Labels sinc para todos projetos
├── Seletivo: Escolher quais projetos
└── Override: Projeto pode adicionar labels locais

CONFIGURAÇÕES DO PROJETO:
┌───────────────────────────────────────────────┐
│  Organization Labels                          │
│  ─────────────────                            │
│  ✓ Sync organization labels                   │
│  ✓ Allow project-specific labels              │
│  ✗ Allow editing organization labels          │
│                                               │
│  Active Organization Labels: 23               │
│  Project-Specific Labels: 3                   │
└───────────────────────────────────────────────┘

Usando Labels Eficazmente

Filtragem e Busca

FILTRAGEM BASEADA EM LABELS
════════════════════════════

LABEL ÚNICO:
└── label:priority:high

MÚLTIPLOS LABELS (AND):
└── label:priority:high label:type:bug

MÚLTIPLOS LABELS (OR):
└── label:priority:high,priority:critical

EXCLUIR:
└── -label:status:on-hold

QUERY COMBINADO:
└── label:type:bug label:priority:high -label:status:blocked

FILTROS SALVOS:
├── "Bugs Críticos" → type:bug + priority:critical
├── "Meu Trabalho" → assignee:me + status:in-progress
└── "Itens Bloqueados" → status:blocked

Relatórios Entre Projetos

RELATÓRIOS EM TODA A ORGANIZAÇÃO
═════════════════════════════════

QUERY DO DASHBOARD:
"Todos bugs de alta prioridade na organização"

Filtro:
├── Organização: Todos projetos
├── Labels: type:bug + priority:high
└── Status: Não feito

RESULTADO:
┌────────────────────────────────────────────────┐
│  Bugs de Alta Prioridade na Org                │
├────────────────────────────────────────────────┤
│  Projeto Alpha  │  5 bugs   │  Mais antigo: 3 dias │
│  Projeto Beta   │  2 bugs   │  Mais antigo: 1 dia  │
│  Projeto Gamma  │  8 bugs   │  Mais antigo: 7 dias │
│  ────────────────────────────────────────────  │
│  Total          │  15 bugs  │                  │
└────────────────────────────────────────────────┘

Regras de Automação

AUTOMAÇÃO BASEADA EM LABELS
════════════════════════════

REGRA 1: Escalação de Prioridade
─────────────────────────────────────
Trigger: Tarefa labeled priority:critical
Actions:
├── Atribuir para equipe on-call
├── Notificar #critical-alerts
├── Definir SLA para 4 horas
└── Adicionar ao Dashboard de Prioridade

REGRA 2: Triagem de Bug
─────────────────────────────────────
Trigger: Tarefa labeled type:bug
Actions:
├── Adicionar ao quadro de Triagem
├── Definir prioridade padrão:medium
├── Notificar equipe QA
└── Adicionar checklist de triagem

REGRA 3: Revisão Necessária
─────────────────────────────────────
Trigger: Tarefa labeled needs-review
Actions:
├── Notificar revisores
├── Adicionar à fila de revisão
└── Definir lembrete de 24h

Governança

Gerenciamento de Labels

GOVERNANÇA DE LABELS
═════════════════════

ADICIONANDO NOVOS LABELS:
├── Solicitar via form/issue
├── Revisar por admin
├── Verificar duplicatas
├── Nomenclatura consistente
└── Anunciar para org

DEPRECIANDO LABELS:
├── Marcar como deprecated
├── Período de migração
├── Auto-substituir se possível
├── Remover após 30 dias
└── Atualizar documentação

PROPRIETÁRIOS DE LABEL:
├── Cada categoria tem proprietário
├── Proprietário aprova mudanças
├── Proprietário treina uso
└── Revisão trimestral

Documentação

DOCUMENTAÇÃO DE LABELS
══════════════════════

ESTRUTURA DO GUIA DE LABEL:
├── Visão geral da categoria
├── Quando usar cada label
├── Exemplos
├── Combinações comuns
└── O que NÃO usar

EXEMPLO:
─────────────────────────────────────
## priority:critical

Usar quando:
- Produção está down
- Vulnerabilidade de segurança
- Perda de dados possível
- Impactando receita

Não usar para:
- Pedidos de cliente "urgentes"
- Importância pessoal
- Nice-to-haves

SLA: 4 horas resposta, 24 horas resolução
─────────────────────────────────────

Melhores Práticas

Para Labels de Organização

1. Comece minimal — Adicione labels conforme necessário
2. Documente tudo — Labels são inúteis se indefinidos
3. Imponha consistência — Revise uso regularmente
4. Habilite automação — Labels devem disparar ações
5. Treine a equipe — Onboarding inclui guia de labels

Anti-Padrões

ERROS DE LABEL:
✗ Labels demais (>50)
✗ Sem convenção de nomenclatura
✗ Significados duplicados
✗ Labels que ninguém usa
✗ Sem documentação
✗ Variações por projeto
✗ Sem processo de governança

Soluções Relacionadas

• Automatizando transições de workflow com labels
• Criando sistemas de filtragem eficazes
• Gerenciando trabalho entre múltiplos projetos