环境以父子层次结构组织，形成以 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	环境已被软删除但其数据已保留