סביבות מאורגנות בהיררכיה של הורה-ילד, ויוצרות מבנה עץ שמשורש בסביבת master. העץ הזה שימושי להמחשת השושלת, להבנת אילו סביבות התפצלו מאיפה, ולתכנון אסטרטגיות merge.

---

מבנה העץ

כל צומת סביבה מכיל את המידע הבא:

• שם: מזהה הסביבה (למשל 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	פעולת merge מתבצעת על סביבה זו
error	פעולה נכשלה; הסביבה עשויה להיות במצב לא עקבי
archived	הסביבה נמחקה באופן רך אך הנתונים שלה נשמרו