---

Eliminar Tablero

Elimina permanentemente un tablero que has creado. Esta operación no se puede deshacer y eliminará todos los gráficos, segmentos de gráficos y configuraciones de compartición del tablero.

Ejemplo Básico

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

Parámetros de Entrada

Parámetro	Tipo	Requerido	Descripción
id	String!	✅ Sí	Identificador único del tablero a eliminar

Campos de Respuesta

MutationResult

Campo	Tipo	Descripción
success	Boolean!	Indica si la eliminación fue exitosa
message	String	Mensaje de estado sobre la operación

Permisos Requeridos

Solo para Creadores

• Solo el creador del tablero puede eliminar un tablero
• Los usuarios con acceso de EDITOR no pueden eliminar tableros
• Los administradores de la empresa no pueden eliminar tableros creados por otros

Autenticación

• Debe estar autenticado y tener acceso a la empresa del tablero

Qué Se Elimina

Cuando eliminas un tablero, los siguientes datos se eliminan permanentemente:

Datos del Tablero

• Título y metadatos del tablero
• Tiempos de creación y modificación
• Configuraciones de compartición de usuarios del tablero

Datos del Gráfico

• Todos los gráficos dentro del tablero
• Segmentos de gráficos y sus configuraciones
• Valores y cálculos de segmentos de gráficos
• Configuraciones de visualización y formato del gráfico

Datos Relacionados

• Asignaciones de roles de usuario del tablero
• Cualquier suscripción al tablero o conexiones en tiempo real

Respuestas de Error

Tablero No Encontrado

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

Permiso Denegado

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

Autenticación Requerida

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

Consideraciones Importantes

Acción Permanente

• No se puede deshacer: Una vez eliminado, el tablero y todos sus datos no se pueden recuperar
• Sin eliminación suave: El tablero se elimina permanentemente de la base de datos
• Efecto inmediato: La eliminación se lleva a cabo de inmediato

Impacto en Otros Usuarios

• Usuarios compartidos pierden acceso: Los usuarios que tenían acceso de VISUALIZADOR o EDITOR ya no podrán acceder al tablero
• Sesiones activas: Los usuarios que actualmente están viendo el tablero perderán la conexión
• Suscripciones: Cualquier suscripción en tiempo real al tablero será terminada

Dependencias de Datos

• Sin dependencias externas: Eliminar un tablero no afecta proyectos, tareas o otros datos de la empresa
• Autónomo: Solo se eliminan los datos específicos del tablero

Mejores Prácticas

Antes de la Eliminación

• Exportar datos importantes: Guarda cualquier configuración de gráfico o información crítica
• Notificar a los usuarios compartidos: Informa a los miembros del equipo que tienen acceso al tablero
• Considerar copiar: Usa la función de copiar tablero para crear una copia de seguridad si es necesario
• Documentar información: Guarda cualquier información o hallazgos comerciales importantes

Acciones Alternativas

• Eliminar compartición: Considera eliminar usuarios del tablero en lugar de eliminarlo
• Enfoque de archivo: No hay una función de archivo incorporada, pero podrías renombrar el tablero para indicar que está archivado

Casos de Uso Comunes

Limpieza de Tableros No 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
  }
}

Eliminar Tableros de Prueba

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

Notas de Seguridad

Verificación del Creador

• El sistema verifica que el usuario que solicita sea el creador original
• Se verifica el ID de usuario contra el campo createdById del tablero
• No se permiten sobrescrituras basadas en roles (incluso los propietarios de la empresa no pueden eliminar tableros de otros)

Registro de Auditoría

• Los eventos de eliminación de tableros se registran para fines de auditoría
• Se registra la marca de tiempo de eliminación y el usuario que solicita
• Los administradores de la empresa pueden ver los registros de eliminación

Operaciones Relacionadas

• Listar Tableros - Ver tableros disponibles
• Copiar Tablero - Crear copia de seguridad antes de la eliminación
• Crear Tablero - Crear un nuevo tablero (documentación pendiente)
• Editar Tablero - Modificar el tablero en lugar de eliminarlo (documentación pendiente)