Pular para o conteúdo principal

Configurar o pipeline de projetos

O que é / Para que serve

As configurações de Projetos definem a estrutura que todos os projetos da organização compartilham. São três áreas:

  • Colunas — os estágios do quadro Kanban (o pipeline macro dos projetos).
  • Modelos — estruturas reutilizáveis de fases e tarefas aplicadas ao criar um projeto.
  • Etiquetas — o catálogo de etiquetas usado para rotular e filtrar projetos.

Antes de começar

  • Estas configurações são exclusivas de admin e owner. Outros papéis veem um aviso de sem acesso.
  • Acesse por Menu lateral > Projetos > Colunas (botão no topo da página de Projetos) ou diretamente pela rota de configurações do módulo.
  • A tela organiza as três áreas em abas: Colunas, Modelos e Etiquetas. A aba ativa fica salva na URL (via ?tab).

📷 Captura: tela de Configurações de projetos com as abas Colunas, Modelos e Etiquetas.

Configuração

Colunas do Kanban

As colunas são os estágios do pipeline no quadro. Cada organização começa com quatro colunas padrão: Escopo, Em andamento, Entregue e Encerrado — todas renomeáveis, reordenáveis e removíveis.

Na aba Colunas:

  • Adicionar coluna — clique em Adicionar coluna, informe um Nome (ex.: Em andamento) e escolha uma Cor (ou Sem cor). Confirme em Adicionar.
  • Editar — renomeia a coluna ou muda a cor.
  • Reordenar — use Mover para cima / Mover para baixo.
  • Excluir — remove a coluna.

Cada coluna mostra a contagem de projetos ({{count}} projeto(s)).

Limites e regras:

  • Máximo de 20 colunas por organização.
  • Não é possível excluir uma coluna que ainda tem projetos — mova-os para outra coluna primeiro.
  • Não é possível excluir a última coluna — sempre deve existir pelo menos uma.

Modelos de projeto

Modelos são plantas (blueprints) de fases e tarefas que você aplica ao criar um novo projeto, evitando montar tudo do zero toda vez.

Na aba Modelos:

  1. Clique em Novo modelo.
  2. Informe um Nome (ex.: Onboarding padrão) e uma Descrição opcional. Clique em Criar.
  3. Clique em Editar estrutura para montar as fases e tarefas do modelo:
    • Adicione fases e reordene-as.
    • Dentro de cada fase, adicione tarefas com título, descrição e a flag Visível para o cliente.
    • Reordene tarefas dentro da fase.
  4. Ao terminar, clique em Concluir.

📷 Captura: editor de estrutura de um modelo, com fases e tarefas pré-definidas.

Como o modelo é aplicado:

  • Ao criar um projeto, escolha o modelo no campo Modelo do formulário.
  • No momento da criação, uma cópia das fases e tarefas do modelo é gravada no novo projeto (cópia no ato / copy-on-apply).
  • A partir daí, o projeto é independente do modelo: editar o modelo depois não afeta projetos já criados. Excluir o modelo também não afeta projetos existentes — eles mantêm suas cópias.

Diferença em relação às fases do projeto: no editor de modelos, excluir uma fase também remove as tarefas dela (é o comportamento esperado ao desenhar a planta). Já em um projeto ao vivo, uma fase com tarefas não pode ser excluída.

Etiquetas

O catálogo de etiquetas é definido aqui; a aplicação nos projetos é feita por qualquer participante.

Na aba Etiquetas:

  • Adicionar etiqueta — informe um Rótulo (ex.: Prioridade) e escolha uma Cor (ou Sem cor). Confirme em Adicionar.
  • Editar — renomeia ou muda a cor.
  • Excluir — remove a etiqueta de todos os projetos onde estiver aplicada.

Os rótulos são únicos por organização (sem diferenciar maiúsculas/minúsculas) — não é possível criar duas etiquetas com o mesmo rótulo.

Depois de criadas, as etiquetas aparecem no filtro Etiqueta da página de Projetos e podem ser aplicadas em cada projeto pela barra de etiquetas no cabeçalho.

Integrações com outros módulos

  • Projetos — colunas, modelos e etiquetas alimentam diretamente o quadro e o formulário de criação. Veja Gerenciar um projeto.
  • Portal do cliente — a flag Visível para o cliente nas tarefas de um modelo determina o que o cliente verá quando o projeto for criado a partir dele.

Dicas e limitações

  • Todas as três áreas são admin/owner apenas.
  • Colunas: máximo 20, não exclua a última nem colunas com projetos.
  • Modelos: são cópia no ato — sem versionamento; edições futuras no modelo não retroagem a projetos existentes.
  • Etiquetas: rótulo único por organização; excluir remove de todos os projetos.

Perguntas frequentes

Se eu editar um modelo, os projetos criados com ele mudam? Não. O modelo é copiado no momento da criação do projeto. Alterações posteriores no modelo não afetam projetos já existentes.

Posso excluir um modelo em uso? Sim. Os projetos que já foram criados a partir dele mantêm suas próprias fases e tarefas.

Por que não consigo excluir uma coluna? Porque ela ainda tem projetos, ou porque é a última coluna. Mova os projetos para outra coluna antes de excluir.

Quantas colunas posso ter? Até 20 por organização.

Quem aplica etiquetas nos projetos? O catálogo é gerenciado por admin/owner, mas qualquer participante (além de gestor/admin/owner) pode aplicar e remover etiquetas em um projeto.