تنظم البيئات في تسلسل هرمي أب-ابن، مكونة بنية شجرية متجذرة في بيئة master. هذه الشجرة مفيدة لتصور النسب وفهم البيئات التي تم التفرع منها ومن أين، وتخطيط استراتيجيات merge.

---

بنية الشجرة

تحتوي كل عقدة بيئة على المعلومات التالية:

• الاسم: معرف البيئة (مثل master أو staging أو feature-auth).
• الحالة: حالة دورة الحياة الحالية (active أو branching أو merging أو error أو archived).
• الأصل: البيئة التي تم إنشاء هذا الفرع منها.
• وضع الفرع: ما إذا تم إنشاء الفرع كـ full (schema + بيانات) أو system (schema فقط).
• وقت التفرع: الطابع الزمني عند إنشاء هذه البيئة.
• الأبناء: قائمة البيئات التي تم التفرع منها من هذه البيئة.

---

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	تم حذف البيئة بشكل منطقي ولكن تم الحفاظ على بياناتها