Projetos

Projetos agrupam issues relacionadas com um workflow específico. Cada projeto tem seu próprio conjunto de status, um identificador único para as chaves das issues e um lead responsável.

Criando um projeto

1. No sidebar, clique em + Novo projeto (ou acesse Projetos → Novo projeto)
2. Preencha o formulário:
   • Nome: nome do projeto (ex: "Frontend", "API v2", "Mobile")
   • Identificador: 2–10 letras maiúsculas usadas como prefixo das chaves (ex: FE, API, MOB). Gerado automaticamente a partir do nome. Após criar o primeiro issue, o identificador não pode ser alterado
   • Cor: cor exibida no ícone do projeto no sidebar
   • Lead: membro responsável principal (opcional)
   • Descrição: descrição curta do projeto (opcional)
3. Clique em Criar projeto

Identificador do projeto

O identificador é permanente após a criação das primeiras issues. Escolha com cuidado:

• Deve ser único dentro da organização
• Use siglas claras: BACK para backend, FE para frontend, INFRA para infraestrutura
• Máximo 10 caracteres — mais curto é melhor para as chaves (ex: CT-1 vs CLOUDTASKS-1)

Status padrão

Todo projeto novo é criado com estes status:

Nome	Cor	Categoria
Backlog	Cinza (#6b7280)	backlog
A fazer	Azul (#3b82f6)	todo
Em progresso	Amarelo (#f59e0b)	in_progress
Em revisão	Roxo (#8b5cf6)	review
Concluído	Verde (#10b981)	done

Customizando status

Acesse Projeto → Configurações → Status para:

• Adicionar status: defina nome, cor e categoria
• Reordenar: arraste para definir a ordem de exibição no quadro Kanban
• Editar: altere nome ou cor (categoria não pode ser alterada após criação)
• Deletar: só é possível se não há issues com esse status. Migre as issues antes de deletar

Categorias de status

As categorias são fixas e controlam o comportamento do sistema:

Categoria	Comportamento
backlog	Issues não priorizadas para o ciclo atual
todo	Priorizadas, aguardando início
in_progress	Em andamento
review	Aguardando revisão, QA ou aprovação
done	Concluídas — contam como entregues
cancelled	Canceladas — não contam como entregues

Você pode ter múltiplos status na mesma categoria. Por exemplo, dois status in_progress: "Em desenvolvimento" e "Em teste".

Configurações do projeto

Acesse Projeto → Configurações:

• Geral: nome, identificador (se ainda não há issues), cor, lead, descrição
• Status: gerenciar status
• Membros: definir quais membros do workspace têm acesso ao projeto e seus papéis específicos (em desenvolvimento)
• Integrações: webhooks por projeto (MVP5)

Arquivar projeto

Projetos arquivados ficam ocultos no sidebar por padrão mas não são deletados. Issues arquivadas não contam para os limites do plano.

Para arquivar: Configurações do projeto → Zona de perigo → Arquivar projeto.

Para ver projetos arquivados: clique em Projetos → Mostrar arquivados.

Deletar projeto

Deletar é irreversível e remove todas as issues, status e configurações do projeto. Issues com URLs curtas associadas terão os redirects desativados.

Apenas admins e owners do workspace podem deletar projetos.