---

Удалить панель инструментов

Постоянно удалите панель инструментов, которую вы создали. Эта операция не может быть отменена и удалит все графики, сегменты графиков и настройки совместного использования панели инструментов.

Основной пример

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

Входные параметры

Параметр	Тип	Обязательный	Описание
id	String!	✅ Да	Уникальный идентификатор панели инструментов для удаления

Поля ответа

MutationResult

Поле	Тип	Описание
success	Boolean!	Успешно ли прошло удаление
message	String	Сообщение о статусе операции

Необходимые разрешения

Только для создателя

• Только создатель панели инструментов может удалить панель инструментов
• Пользователи с доступом EDITOR не могут удалять панели инструментов
• Администраторы компании не могут удалять панели инструментов, созданные другими

Аутентификация

• Необходимо пройти аутентификацию и иметь доступ к компании, связанной с панелью инструментов

Что будет удалено

Когда вы удаляете панель инструментов, следующие данные удаляются навсегда:

Данные панели инструментов

• Заголовок панели инструментов и метаданные
• Временные метки создания и изменения
• Настройки совместного использования панели инструментов

Данные графиков

• Все графики в панели инструментов
• Сегменты графиков и их настройки
• Значения и вычисления сегментов графиков
• Настройки отображения графиков и форматирование

Связанные данные

• Назначения ролей пользователей панели инструментов
• Любые подписки на панель инструментов или подключения в реальном времени

Ответы на ошибки

Панель инструментов не найдена

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

Доступ запрещен

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

Требуется аутентификация

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

Важные соображения

Постоянное действие

• Не может быть отменено: После удаления панель инструментов и все ее данные не могут быть восстановлены
• Нет мягкого удаления: Панель инструментов навсегда удаляется из базы данных
• Немедленный эффект: Удаление происходит немедленно

Влияние на других пользователей

• Пользователи, с которыми делились, теряют доступ: Пользователи, имевшие доступ VIEWER или EDITOR, больше не смогут получить доступ к панели инструментов
• Активные сессии: Пользователи, которые в данный момент просматривают панель инструментов, потеряют соединение
• Подписки: Любые подписки на панель инструментов в реальном времени будут прекращены

Зависимости данных

• Нет внешних зависимостей: Удаление панели инструментов не влияет на проекты, задачи или другие данные компании
• Самодостаточно: Удаляются только данные, специфичные для панели инструментов

Лучшие практики

Перед удалением

• Экспортируйте важные данные: Сохраните любые критически важные настройки графиков или выводы
• Уведомите пользователей, с которыми делились: Сообщите членам команды, имеющим доступ к панели инструментов
• Рассмотрите возможность копирования: Используйте функцию копирования панели инструментов для создания резервной копии, если это необходимо
• Документируйте выводы: Сохраните любые важные бизнес-выводы или находки

Альтернативные действия

• Удалите совместное использование: Рассмотрите возможность удаления пользователей панели инструментов вместо удаления
• Архивный подход: Нет встроенной функции архивации, но вы можете переименовать панель инструментов, чтобы указать, что она архивирована

Распространенные случаи использования

Очистка неиспользуемых панелей инструментов

# 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
  }
}

Удаление тестовых панелей инструментов

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

Примечания по безопасности

Проверка создателя

• Система проверяет, что запрашивающий пользователь является оригинальным создателем
• Идентификатор пользователя проверяется по полю панели инструментов createdById
• Переопределения на основе ролей не допускаются (даже владельцы компании не могут удалять панели инструментов других)

Аудиторский след

• События удаления панели инструментов регистрируются для аудиторских целей
• Временная метка удаления и запрашивающий пользователь записываются
• Администраторы компании могут просматривать журналы удаления

Связанные операции

• Список панелей инструментов - Просмотреть доступные панели инструментов
• Копировать панель инструментов - Создать резервную копию перед удалением
• Создать панель инструментов - Создать новую панель инструментов (документация в процессе)
• Редактировать панель инструментов - Изменить панель инструментов вместо удаления (документация в процессе)