環境は親子階層で編成され、master環境をルートとするツリー構造を形成します。このツリーは、系譜の可視化、どの環境がどこからブランチされたかの理解、マージ戦略の計画に役立ちます。

---

ツリー構造

各環境ノードには以下の情報が含まれます：

• 名前: 環境識別子（例：master、staging、feature-auth）。
• ステータス: 現在のライフサイクル状態（active、branching、merging、error、archived）。
• 親: このブランチが作成された環境。
• ブランチモード: ブランチがfull（スキーマ+データ）またはsystem（スキーマのみ）として作成されたかどうか。
• ブランチ日時: この環境が作成されたタイムスタンプ。
• 子: この環境からブランチされた環境のリスト。

---

GraphQL API

Query: environmentTree

query EnvironmentTree($projectId: String!) {
  environmentTree(projectId: $projectId) {
    success
    message
    tree {
      environment {
        id
        name
        status
        parentName
        branchMode
        branchedAt
      }
      children {
        environment {
          id
          name
          status
          parentName
          branchMode
          branchedAt
        }
        children {
          environment {
            id
            name
            status
          }
        }
      }
    }
  }
}

Query: projectEnvironments

ツリーのネストなしで全環境のフラットリストを取得するには：

query GetProjectEnvironments($projectId: String!) {
  projectEnvironments(projectId: $projectId) {
    success
    message
    environments {
      id
      name
      parentId
      parentName
      branchMode
      branchedAt
      status
      createdAt
      updatedAt
    }
  }
}

---

環境ステータスライフサイクル

ステータス	説明
active	環境は完全に動作しており使用可能
branching	環境が作成中（データベースクローン進行中）
merging	この環境にマージ操作が適用されている
error	操作が失敗した；環境は不整合な状態にある可能性
archived	環境はソフト削除されたがデータは保持されている