---

Visão Geral dos Modelos

Blue suporta dois tipos de modelos:

• Modelos de Empresa: Criados pela sua organização para uso interno
• Modelos Oficiais: Criados pela Blue para todos os usuários (modelos padrão da indústria)

Os modelos preservam toda a estrutura do projeto, incluindo tarefas, listas, campos personalizados, automações e mais.

Listar Modelos

Usando a Consulta de Modelos

query GetTemplates {
  templates(
    companyId: "company-123"
    isOfficialTemplate: false
    category: MARKETING
  ) {
    id
    name
    description
    category
    isOfficialTemplate
    icon
    color
    image {
      thumbnail
      small
    }
  }
}

Usando projectList com Filtro de Modelo

query ListTemplates {
  projectList(
    filter: {
      companyIds: ["company-id"]
      isTemplate: true
    }
    sort: [updatedAt_DESC]
    take: 20
    skip: 0
  ) {
    items {
      id
      slug
      name
      description
      category
      isTemplate
      isOfficialTemplate
      color
      icon
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      totalItems
    }
    totalCount
  }
}

Criar Projeto a Partir de um Modelo

Para criar um novo projeto a partir de um modelo existente:

mutation CreateFromTemplate {
  createProject(
    input: {
      templateId: "template-id-or-slug"
      name: "Q1 Marketing Campaign"
      companyId: "company-id"
      description: "Marketing initiatives for Q1"
      color: "#10B981"
    }
  ) {
    id
    name
    slug
  }
}

Converter Projeto em Modelo

Transforme um projeto existente em um modelo reutilizável:

mutation ConvertToTemplate {
  convertProjectToTemplate(
    input: {
      projectId: "project-123"
      isOfficialTemplate: false
    }
  ) {
    id
    name
    isTemplate
    isOfficialTemplate
  }
}

Remover Status de Modelo

Converta um modelo de volta para um projeto regular:

mutation RemoveTemplateStatus {
  removeProjectFromTemplates(projectId: "template-123") {
    id
    name
    isTemplate
  }
}

Obter Modelo Único

Recupere detalhes sobre um modelo específico:

query GetTemplate {
  template(templateId: "template-123") {
    id
    name
    description
    category
    isOfficialTemplate
    todoLists {
      name
      todos {
        title
      }
    }
  }
}

Parâmetros da Consulta

Consulta de modelos

Parâmetro	Tipo	Obrigatório	Descrição
companyId	String	Não	Filtrar modelos por empresa. Omitir para ver modelos oficiais.
isOfficialTemplate	Boolean	Não	Mostrar apenas modelos oficiais da Blue
category	ProjectCategory	Não	Filtrar por categoria de projeto

Entrada convertProjectToTemplate

Parâmetro	Tipo	Obrigatório	Descrição
projectId	String!	✅ Sim	O projeto a ser convertido em um modelo
isOfficialTemplate	Boolean!	✅ Sim	Marcar como modelo oficial (apenas para funcionários da Blue)

Categorias de Modelos

Valor	Descrição
CRM	Gestão de Relacionamento com o Cliente
CROSS_FUNCTIONAL	Projetos de equipe multifuncional
CUSTOMER_SUCCESS	Iniciativas de sucesso do cliente
DESIGN	Projetos de design e criativos
ENGINEERING	Engenharia e desenvolvimento
GENERAL	Projetos gerais (padrão)
HR	Recursos Humanos
IT	Tecnologia da Informação
MARKETING	Campanhas de marketing
OPERATIONS	Operações e logística
PRODUCT	Gestão de produtos
SALES	Vendas e desenvolvimento de negócios

O Que é Copiado dos Modelos

Ao criar um projeto a partir de um modelo, o seguinte é copiado:

• ✅ Estrutura: Todas as listas de tarefas e tarefas com suas posições
• ✅ Conteúdo: Descrições, comentários e anexos
• ✅ Organização: Tags, rótulos e campos personalizados
• ✅ Automação: Todas as regras e fluxos de automação
• ✅ Formulários: Formulários de projeto e suas configurações
• ✅ Documentos: Páginas de wiki e documentação
• ✅ Configurações: Configurações de capa e preferências de exibição
• ✅ Funções: Definições de funções de usuário (mas não atribuições de usuários)

Não copiado:

• ❌ Atribuições de usuários (exceto o criador)
• ❌ Histórico de atividades
• ❌ Dados de rastreamento de tempo
• ❌ Status concluído das tarefas

Permissões Necessárias

Criando Modelos

Ação	Função Necessária
Convert project to template	Project OWNER or ADMIN
Create official template	Blue employee only
Remove template status	Project OWNER or ADMIN

Usando Modelos

Tipo de Modelo	Quem Pode Usar
Company templates	Users in the same company
Official templates	All Blue users

Respostas de Erro

Modelo Não Encontrado

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "TEMPLATE_NOT_FOUND"
    }
  }]
}

Muitos Todos

{
  "errors": [{
    "message": "This project has more than 250,000 todos and cannot be used as a template",
    "extensions": {
      "code": "TOO_MANY_TODOS"
    }
  }]
}

Notas Importantes

• Limite de Tamanho: Projetos com mais de 250.000 tarefas não podem ser usados como modelos
• Cópia Assíncrona: O conteúdo do modelo é copiado em segundo plano via fila de trabalho
• Status de Arquivo: Converter em modelo automaticamente desarquiva o projeto
• Remoção de Pasta: Modelos são removidos de pastas quando convertidos
• Controle de Acesso: Modelos oficiais são visíveis para todos, modelos de empresa apenas para membros
• Atualizações em Tempo Real: Inscreva-se nas alterações do modelo usando a assinatura subscribeToProject