환경은 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	환경이 소프트 삭제되었지만 데이터는 보존됨