---

刪除儀表板

永久刪除您創建的儀表板。此操作無法撤消，將刪除所有圖表、圖表段和儀表板共享配置。

基本示例

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

輸入參數

參數	類型	必需	描述
id	String!	✅ 是	要刪除的儀表板的唯一標識符

回應字段

MutationResult

字段	類型	描述
success	Boolean!	刪除是否成功
message	String	有關該操作的狀態消息

所需權限

僅限創建者

• 只有儀表板創建者可以刪除儀表板
• 擁有編輯者訪問權限的用戶無法刪除儀表板
• 公司管理員無法刪除其他人創建的儀表板

認證

• 必須經過身份驗證並擁有訪問儀表板所在公司的權限

刪除的內容

當您刪除儀表板時，以下數據將被永久移除：

儀表板數據

• 儀表板標題和元數據
• 創建和修改時間戳
• 儀表板用戶共享配置

圖表數據

• 儀表板中的所有圖表
• 圖表段及其配置
• 圖表段值和計算
• 圖表顯示設置和格式

相關數據

• 儀表板用戶角色分配
• 任何儀表板訂閱或實時連接

錯誤回應

找不到儀表板

{
  "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"
    }
  }]
}

重要考慮事項

永久性操作

• 無法撤消：一旦刪除，儀表板及其所有數據將無法恢復
• 無軟刪除：儀表板將永久從數據庫中移除
• 立即生效：刪除操作立即生效

對其他用戶的影響

• 共享用戶失去訪問權限：曾經擁有查看者或編輯者訪問權限的用戶將無法再訪問該儀表板
• 活動會話：當前正在查看儀表板的用戶將失去連接
• 訂閱：任何對該儀表板的實時訂閱將被終止

數據依賴性

• 無外部依賴：刪除儀表板不會影響項目、待辦事項或其他公司數據
• 自包含：僅刪除儀表板特定的數據

最佳實踐

刪除前

• 導出重要數據：保存任何關鍵的圖表配置或見解
• 通知共享用戶：告知有權訪問該儀表板的團隊成員
• 考慮複製：如果需要，使用複製儀表板功能創建備份
• 記錄見解：保存任何重要的商業見解或發現

替代行動

• 移除共享：考慮移除儀表板用戶而不是刪除
• 存檔方法：雖然沒有內建的存檔功能，但您可以重命名儀表板以表示其已存檔

常見用例

清理未使用的儀表板

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

安全注意事項

創建者驗證

• 系統驗證請求用戶是否為原始創建者
• 用戶 ID 將與儀表板的 createdById 字段進行檢查
• 不允許基於角色的覆蓋（即使是公司所有者也無法刪除其他人的儀表板）

審計跟蹤

• 儀表板刪除事件會被記錄以供審計
• 記錄刪除時間戳和請求用戶
• 公司管理員可以查看刪除日誌

相關操作

• 列出儀表板 - 查看可用的儀表板
• 複製儀表板 - 刪除前創建備份
• 創建儀表板 - 創建新儀表板（文檔待定）
• 編輯儀表板 - 修改儀表板而不是刪除（文檔待定）