---

ダッシュボードの削除

作成したダッシュボードを永久に削除します。この操作は元に戻すことができず、すべてのチャート、チャートセグメント、およびダッシュボードの共有設定が削除されます。

基本的な例

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アクセスを持つユーザーはダッシュボードにアクセスできなくなります
• アクティブセッション: 現在ダッシュボードを表示しているユーザーは接続を失います
• サブスクリプション: ダッシュボードへのリアルタイムサブスクリプションは終了します

データの依存関係

• 外部依存関係なし: ダッシュボードを削除してもプロジェクト、TODO、または他の会社データには影響しません
• 自己完結型: ダッシュボード固有のデータのみが削除されます

ベストプラクティス

削除前

• 重要なデータをエクスポート: 重要なチャート設定や洞察を保存します
• 共有ユーザーに通知: ダッシュボードにアクセスできるチームメンバーに知らせます
• コピーを検討: 必要に応じて、ダッシュボードのコピー機能を使用してバックアップを作成します
• 洞察を文書化: 重要なビジネスの洞察や発見を保存します

代替アクション

• 共有を削除: 削除する代わりにダッシュボードユーザーを削除することを検討します
• アーカイブアプローチ: 組み込みのアーカイブ機能はありませんが、ダッシュボードの名前を変更してアーカイブされたことを示すことができます

一般的なユースケース

未使用のダッシュボードのクリーンアップ

# 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 フィールドと照合されます
• 役割に基づくオーバーライドは許可されません（会社の所有者でさえ他のユーザーのダッシュボードを削除できません）

監査証跡

• ダッシュボード削除イベントは監査目的でログに記録されます
• 削除のタイムスタンプとリクエストを行ったユーザーが記録されます
• 会社の管理者は削除ログを表示できます

関連操作

• ダッシュボードの一覧 - 利用可能なダッシュボードを表示
• ダッシュボードのコピー - 削除前にバックアップを作成
• ダッシュボードの作成 - 新しいダッシュボードを作成（ドキュメントは保留中）
• ダッシュボードの編集 - 削除する代わりにダッシュボードを変更（ドキュメントは保留中）