---

Excluir Painel

Exclua permanentemente um painel que você criou. Esta operação não pode ser desfeita e removerá todos os gráficos, segmentos de gráficos e configurações de compartilhamento do painel.

Exemplo Básico

mutation DeleteDashboard {
  deleteDashboard(id: "dashboard_123") {
    success
    message
  }
}

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
id	String!	✅ Sim	Identificador único do painel a ser excluído

Campos de Resposta

MutationResult

Campo	Tipo	Descrição
success	Boolean!	Se a exclusão foi bem-sucedida
message	String	Mensagem de status sobre a operação

Permissões Necessárias

Somente Criador

• Somente o criador do painel pode excluir um painel
• Usuários com acesso de EDITOR não podem excluir painéis
• Administradores da empresa não podem excluir painéis criados por outros

Autenticação

• Deve estar autenticado e ter acesso à empresa do painel

O Que é Excluído

Quando você exclui um painel, os seguintes dados são removidos permanentemente:

Dados do Painel

• Título e metadados do painel
• Carimbos de data e hora de criação e modificação
• Configurações de compartilhamento de usuários do painel

Dados do Gráfico

• Todos os gráficos dentro do painel
• Segmentos de gráficos e suas configurações
• Valores e cálculos de segmentos de gráficos
• Configurações de exibição e formatação do gráfico

Dados Relacionados

• Atribuições de função de usuário do painel
• Quaisquer assinaturas de painel ou conexões em tempo real

Respostas de Erro

Painel Não Encontrado

{
  "errors": [{
    "message": "Dashboard not found",
    "extensions": {
      "code": "DASHBOARD_NOT_FOUND"
    }
  }]
}

Permissão Negada

{
  "errors": [{
    "message": "Only the creator of a dashboard can delete it",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

Autenticação Necessária

{
  "errors": [{
    "message": "You must be authenticated to perform this action",
    "extensions": {
      "code": "UNAUTHENTICATED"
    }
  }]
}

Considerações Importantes

Ação Permanente

• Não pode ser desfeita: Uma vez excluído, o painel e todos os seus dados não podem ser recuperados
• Sem exclusão suave: O painel é removido permanentemente do banco de dados
• Efeito imediato: A exclusão ocorre imediatamente

Impacto em Outros Usuários

• Usuários compartilhados perdem acesso: Usuários que tinham acesso de VISUALIZADOR ou EDITOR não poderão mais acessar o painel
• Sessões ativas: Usuários que estão visualizando o painel atualmente perderão a conexão
• Assinaturas: Quaisquer assinaturas em tempo real para o painel serão encerradas

Dependências de Dados

• Sem dependências externas: Excluir um painel não afeta projetos, tarefas ou outros dados da empresa
• Autônomo: Somente dados específicos do painel são removidos

Melhores Práticas

Antes da Exclusão

• Exporte dados importantes: Salve quaisquer configurações ou insights críticos de gráficos
• Notifique usuários compartilhados: Informe os membros da equipe que têm acesso ao painel
• Considere copiar: Use o recurso de copiar painel para criar um backup, se necessário
• Documente insights: Salve quaisquer insights ou descobertas comerciais importantes

Ações Alternativas

• Remover compartilhamento: Considere remover usuários do painel em vez de excluir
• Abordagem de arquivamento: Não há um recurso de arquivamento embutido, mas você pode renomear o painel para indicar que está arquivado

Casos de Uso Comuns

Limpeza de Painéis Não Utilizados

# First, list dashboards to identify unused ones
query FindUnusedDashboards {
  dashboards(filter: { companyId: "company_123" }) {
    items {
      id
      title
      updatedAt
      dashboardUsers {
        id
      }
    }
  }
}

# Then delete specific dashboard
mutation CleanupDashboard {
  deleteDashboard(id: "old_dashboard_id") {
    success
    message
  }
}

Remover Painéis de Teste

mutation RemoveTestDashboard {
  deleteDashboard(id: "test_dashboard_123") {
    success
    message
  }
}

Notas de Segurança

Verificação do Criador

• O sistema verifica se o usuário solicitante é o criador original
• O ID do usuário é verificado em relação ao campo createdById do painel
• Nenhuma substituição baseada em função é permitida (mesmo os proprietários da empresa não podem excluir painéis de outros)

Registro de Auditoria

• Eventos de exclusão de painel são registrados para fins de auditoria
• O carimbo de data e hora da exclusão e o usuário solicitante são registrados
• Administradores da empresa podem visualizar os registros de exclusão

Operações Relacionadas

• Listar Painéis - Visualizar painéis disponíveis
• Copiar Painel - Criar backup antes da exclusão
• Criar Painel - Criar novo painel (documentação pendente)
• Editar Painel - Modificar painel em vez de excluir (documentação pendente)