@things-factory/operato-dataset 9.0.40 → 9.0.42

package/schema.graphql

@@ -910,6 +910,7 @@ enum AttributeSetItemType {
   datetime
   file
   number
+  secret
   select
   text
 }
@@ -1444,9 +1445,7 @@ input CommonCodePatch {
 
 """Represents a configured connection to an external system or service."""
 type Connection {
-  """
-  Indicates whether the connection is currently active and should be maintained.
-  """
+  """Whether to automatically connect when the application starts"""
   active: Boolean
 
   """The timestamp when the connection was created."""
@@ -1473,6 +1472,11 @@ type Connection {
   """The name of the connection."""
   name: String!
 
+  """
+  When true, connection is created on-demand when needed and cleaned up after use.
+  """
+  onDemand: Boolean
+
   """A key-value map of parameters for the connection."""
   params: Object
 
@@ -1500,7 +1504,7 @@ type ConnectionList {
 
 """Input for updating (patching) an existing connection."""
 input ConnectionPatch {
-  """The new active status for the connection."""
+  """Whether to automatically connect when the application starts"""
   active: Boolean
 
   """
@@ -1523,6 +1527,11 @@ input ConnectionPatch {
   """The new name for the connection."""
   name: String
 
+  """
+  When true, connection is created on-demand when needed and cleaned up after use.
+  """
+  onDemand: Boolean
+
   """The new parameters for the connection."""
   params: Object
 
@@ -1547,6 +1556,11 @@ type ConnectionState {
   """The name of the connection."""
   name: String
 
+  """
+  When true, connection is created on-demand when needed and cleaned up after use.
+  """
+  onDemand: Boolean
+
   """The current status of the connection."""
   state: String
 
@@ -2723,6 +2737,9 @@ type Domain {
   """A description of the domain."""
   description: String
 
+  """The environment variables associated with the domain."""
+  envVars: [EnvVar!]
+
   """The external type of the domain, if applicable."""
   extType: String
 
@@ -3229,6 +3246,68 @@ type EntityRelationMetadata {
   relationType: Boolean
 }
 
+"""Environment variable entity for storing key-value pairs."""
+type EnvVar {
+  """Indicates whether this environment variable is currently active."""
+  active: Boolean!
+
+  """The timestamp when the environment variable was created."""
+  createdAt: DateTimeISO
+
+  """A detailed description of the environment variable."""
+  description: String
+
+  """The domain to which this environment variable belongs."""
+  domain: Domain
+
+  """The domain ID to which this environment variable belongs."""
+  domainId: String!
+
+  """Unique identifier for the environment variable."""
+  id: ID!
+
+  """The name of the environment variable."""
+  name: String!
+
+  """The timestamp when the environment variable was last updated."""
+  updatedAt: DateTimeISO
+
+  """The value of the environment variable (encrypted)."""
+  value: String
+}
+
+"""List of environment variables."""
+type EnvVarList {
+  """The list of environment variable items."""
+  items: [EnvVar!]!
+
+  """The total number of environment variables."""
+  total: Int!
+}
+
+"""Input type for updating an existing environment variable."""
+input EnvVarPatch {
+  """The new active status for the environment variable."""
+  active: Boolean
+
+  """
+  A flag indicating whether the environment variable is being created, updated, or deleted.
+  """
+  cuFlag: String
+
+  """The new description for the environment variable."""
+  description: String
+
+  """The unique identifier of the environment variable to update."""
+  id: ID
+
+  """The new name for the environment variable."""
+  name: String
+
+  """The new value for the environment variable."""
+  value: String
+}
+
 """Entity for Favorite"""
 type Favorite {
   createdAt: DateTimeISO
@@ -3291,21 +3370,6 @@ input FontPatch {
   uri: String
 }
 
-"""Grade information for KPI value"""
-type GradeInfo {
-  """Color code for visualization"""
-  color: String
-
-  """Grade description"""
-  description: String
-
-  """Grade name (e.g., A, B, C, 우수, 양호)"""
-  name: String!
-
-  """Grade score or performance value"""
-  score: Float
-}
-
 """Represents a role that is granted to a specific domain."""
 type GrantedRole {
   """The domain to which the role is granted."""
@@ -3475,11 +3539,8 @@ type Kpi {
   """Indicates whether this KPI is active and usable."""
   active: Boolean
 
-  """Category to which this KPI belongs."""
-  category: KpiCategory
-
-  """ID of the category for this KPI."""
-  categoryId: String
+  """Child KPIs in hierarchical structure."""
+  children: [Kpi!]
 
   """Timestamp when this KPI was created."""
   createdAt: DateTimeISO
@@ -3507,16 +3568,29 @@ type Kpi {
   """
   formula: String
 
-  """Grade configuration for this KPI version"""
+  """
+  Performance index lookup table for complex transformations. @deprecated 향후 제거 예정. performanceFormula 사용 권장.
+  """
   grades: Object
   histories(limit: Int): [KpiHistory!]
 
   """Unique identifier for this KPI."""
   id: ID!
 
+  """
+  Indicates whether this KPI is a leaf node (has actual measured values).
+  """
+  isLeaf: Boolean
+
   """Name of the KPI."""
   name: String
 
+  """Parent KPI in hierarchical structure."""
+  parent: Kpi
+
+  """ID of the parent KPI."""
+  parentId: String
+
   """Aggregation period type for this KPI."""
   periodType: KpiPeriodType!
 
@@ -3528,6 +3602,11 @@ type Kpi {
   """Schedule ID for the KPI (used for scheduler registration)."""
   scheduleId: String
 
+  """
+  Score calculation formula for this KPI. Converts KPI value to performance score (0-100). For complex mappings, use grades lookup table instead. Example: "if(value >= 90, 100, if(value >= 80, 85, 70))" or "value * 0.8 + 20"
+  """
+  scoreFormula: String
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: String
   targetValue: Float
@@ -3547,7 +3626,10 @@ type Kpi {
 
   """ID of the user who last updated this KPI."""
   updaterId: String
-  value: KpiValue
+  value(
+    """Organization scope filter for value"""
+    orgScope: String
+  ): KpiValue
 
   """
   Version number of the KPI. Increments on each modification. When the KPI is released, a snapshot is saved in kpi-history and the status becomes RELEASED. Editing after release increases the version and sets status to DRAFT.
@@ -3584,94 +3666,10 @@ type KpiAlert {
   message: String!
 }
 
-"""
-KPI category entity. Represents a classification or group for KPIs. Supports hierarchical (tree) structure.
-"""
-type KpiCategory {
-  """Whether this category is active (usable) or not."""
-  active: Boolean
-
-  """Timestamp when this KPI category was created."""
-  createdAt: DateTimeISO
-
-  """User who created this KPI category."""
-  creator: User
-
-  """ID of the user who created this KPI category."""
-  creatorId: String
-
-  """Detailed description of this KPI category."""
-  description: String
-
-  """Domain (tenant) to which this KPI category belongs."""
-  domain: Domain
-
-  """ID of the domain (tenant) for this KPI category."""
-  domainId: String
-
-  """Aggregation formula using child KPI codes."""
-  formula: String
-
-  """Unique identifier for this KPI category."""
-  id: ID!
-
-  """List of KPIs belonging to this category."""
-  kpis: [Kpi!]
-
-  """Name of the KPI category."""
-  name: String!
-
-  """Timestamp when this KPI category was last updated."""
-  updatedAt: DateTimeISO
-
-  """User who last updated this KPI category."""
-  updater: User
-
-  """ID of the user who last updated this KPI category."""
-  updaterId: String
-
-  """Weight for aggregation in higher-level summary."""
-  weight: Float
-}
-
-type KpiCategoryList {
-  items: [KpiCategory!]!
-  total: Int!
-}
-
-"""
-Input type for updating an existing KPI category. Used in mutations to patch category details.
-"""
-input KpiCategoryPatch {
-  """Whether this category is active (usable) or not."""
-  active: Boolean
-
-  """Custom flag for update operations (internal use)."""
-  cuFlag: String
-
-  """Detailed description of this KPI category."""
-  description: String
-
-  """Aggregation formula using child KPI codes."""
-  formula: String
-
-  """ID of the KPI category to update."""
-  id: ID
-
-  """Name of the KPI category."""
-  name: String
-
-  """Weight for aggregation in higher-level summary."""
-  weight: Float
-}
-
 """History Entity of Kpi"""
 type KpiHistory {
   """Whether this KPI is active (usable) or not."""
   active: Boolean
-
-  """Category to which this KPI belongs."""
-  category: KpiCategory
   createdAt: DateTimeISO
   creator: User
   deletedAt: DateTimeISO
@@ -3750,7 +3748,7 @@ type KpiMetric {
   name: String!
 
   """Aggregation period type for this metric."""
-  periodType: KpiMetricPeriodType!
+  periodType: KpiPeriodType!
 
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
@@ -3808,7 +3806,7 @@ input KpiMetricPatch {
   name: String
 
   """Aggregation period type for this metric."""
-  periodType: KpiMetricPeriodType
+  periodType: KpiPeriodType
 
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
@@ -3825,15 +3823,6 @@ input KpiMetricPatch {
   unit: String
 }
 
-"""Aggregation period type for metric (DAY, WEEK, MONTH, QUARTER, RANGE)"""
-enum KpiMetricPeriodType {
-  DAY
-  MONTH
-  QUARTER
-  RANGE
-  WEEK
-}
-
 """
 Current value for each KPI metric (can be used for both state and history).
 """
@@ -3843,13 +3832,15 @@ type KpiMetricValue {
   creatorId: String
   domain: Domain
   domainId: String
-
-  """Group key for this value (organization, line, user, etc.)"""
-  group: String
   id: ID!
   meta: Object
   metric: KpiMetric!
   metricId: String!
+
+  """
+  Organizational unit for this value (project, department, company, employee, etc.)
+  """
+  org: String
   periodType: KpiPeriodType!
   unit: String
   updatedAt: DateTimeISO
@@ -3875,9 +3866,6 @@ input KpiMetricValuePatch {
   """Custom flag for update operations (internal use)."""
   cuFlag: String
 
-  """Group key for this value (organization, line, user, etc.)"""
-  group: String
-
   """ID of the metric value to update."""
   id: ID
 
@@ -3889,6 +3877,11 @@ input KpiMetricValuePatch {
   """ID of the metric to which this value belongs."""
   metricId: ID
 
+  """
+  Organizational unit for this value (project, department, company, employee, etc.)
+  """
+  org: String
+
   """Aggregation period type for this metric value."""
   periodType: KpiPeriodType
 
@@ -3904,6 +3897,108 @@ input KpiMetricValuePatch {
   valueDate: String
 }
 
+"""
+KPI organization scope mapping entity. Maps business entities to various scope dimensions for KPI analysis using generic reference pattern.
+"""
+type KpiOrgScope {
+  """Timestamp when this org-scope mapping was created."""
+  createdAt: DateTimeISO
+
+  """User who created this org-scope mapping."""
+  creator: User
+
+  """ID of the user who created this org-scope mapping."""
+  creatorId: String
+
+  """Domain (tenant) to which this org-scope mapping belongs."""
+  domain: Domain
+
+  """ID of the domain (tenant) for this org-scope mapping."""
+  domainId: String
+
+  """ID of the referenced business entity"""
+  entityId: String!
+
+  """
+  Name of the referenced business entity (denormalized for performance and convenience)
+  """
+  entityName: String!
+
+  """
+  Type of the referenced business entity (e.g., Project, Department, Company, Employee)
+  """
+  entityType: String!
+
+  """Unique identifier for this org-scope mapping."""
+  id: ID!
+
+  """Legacy org field for backward compatibility"""
+  org: String
+
+  """First scope dimension (e.g., geographical region, business unit)"""
+  scope01: String
+
+  """Second scope dimension (e.g., product line, customer segment)"""
+  scope02: String
+
+  """Third scope dimension (e.g., process type, technology stack)"""
+  scope03: String
+
+  """Fourth scope dimension (e.g., cost center, profit center)"""
+  scope04: String
+
+  """Fifth scope dimension (e.g., risk level, priority tier)"""
+  scope05: String
+
+  """Timestamp when this org-scope mapping was last updated."""
+  updatedAt: DateTimeISO
+
+  """User who last updated this org-scope mapping."""
+  updater: User
+
+  """ID of the user who last updated this org-scope mapping."""
+  updaterId: String
+}
+
+"""List of KPI org-scope mappings with pagination"""
+type KpiOrgScopeList {
+  """Array of KPI org-scope mappings"""
+  items: [KpiOrgScope!]!
+
+  """Total count of items"""
+  total: Int!
+}
+
+"""Input type for updating an existing KPI org-scope mapping"""
+input KpiOrgScopePatch {
+  """Active status"""
+  active: Boolean
+
+  """Human-readable name or description"""
+  displayName: String
+
+  """ID of the org-scope mapping to update"""
+  id: ID!
+
+  """Organizational unit identifier"""
+  org: String
+
+  """First scope dimension"""
+  scope01: String
+
+  """Second scope dimension"""
+  scope02: String
+
+  """Third scope dimension"""
+  scope03: String
+
+  """Fourth scope dimension"""
+  scope04: String
+
+  """Fifth scope dimension"""
+  scope05: String
+}
+
 """
 Input type for updating an existing KPI. Used in mutations to patch KPI details.
 """
@@ -3911,9 +4006,6 @@ input KpiPatch {
   """Indicates whether this KPI is active and usable."""
   active: Boolean
 
-  """ID of the category to which this KPI belongs."""
-  categoryId: ID
-
   """Custom flag for update operations (internal use)."""
   cuFlag: String
 
@@ -3923,20 +4015,33 @@ input KpiPatch {
   """Calculation formula for the KPI, using metric codes and operators."""
   formula: String
 
-  """Grade configuration for this KPI version"""
+  """Score lookup table for this KPI version"""
   grades: Object
 
   """ID of the KPI to update."""
   id: ID
 
+  """
+  Indicates whether this KPI is a leaf node (has actual measured values).
+  """
+  isLeaf: Boolean
+
   """Name of the KPI."""
   name: String
 
+  """Reference to the parent KPI in hierarchical structure."""
+  parent: ObjectRef
+
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
   """
   schedule: String
 
+  """
+  Score calculation formula for this KPI. Converts KPI value to performance score (0-1).
+  """
+  scoreFormula: String
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: KpiStatus
 
@@ -3952,21 +4057,244 @@ input KpiPatch {
   vizMeta: Object
 
   """
-  Visualization type for this KPI (e.g., CARD, GAUGE, PROGRESS, BAR, LINE, etc.).
+  Visualization type for this KPI (e.g., CARD, GAUGE, PROGRESS, BAR, LINE, etc.).
+  """
+  vizType: KpiVizType
+
+  """Weight for aggregation in parent category."""
+  weight: Float
+}
+
+"""
+Aggregation period type for KPI (DAY, WEEK, MONTH, QUARTER, RANGE, ALLTIME)
+"""
+enum KpiPeriodType {
+  ALLTIME
+  DAY
+  MONTH
+  QUARTER
+  RANGE
+  WEEK
+  YEAR
+}
+
+"""
+Defines the meaning and metadata for each scope level (scope01~05) in KpiOrgScope
+"""
+type KpiScope {
+  """Whether this scope definition is active and should be used"""
+  active: Boolean!
+  createdAt: DateTimeISO
+  creator: User
+
+  """Detailed description of what this scope dimension represents"""
+  description: String
+
+  """Order/priority for display and processing"""
+  displayOrder: Int!
+
+  """Domain this scope definition belongs to"""
+  domain: Domain
+  id: ID!
+
+  """Whether this scope should be included in statistical calculations"""
+  includeInStatistics: Boolean!
+
+  """Scope level (1-5) corresponding to scope01-scope05 in KpiOrgScope"""
+  level: Int!
+
+  """Additional metadata for this scope dimension (colors, icons, etc.)"""
+  metadata: Object
+
+  """Display name for this scope dimension (e.g., "지역", "회사", "프로젝트규모")"""
+  name: String!
+
+  """Parent scope level if this forms a hierarchy"""
+  parentLevel: Int
+
+  """Type category of this scope dimension"""
+  scopeType: ScopeType!
+
+  """Whether this scope should be displayed in dashboard visualizations"""
+  showInDashboard: Boolean!
+  updatedAt: DateTimeISO
+  updater: User
+
+  """
+  List of valid values for this scope (e.g., ["서울", "부산", "대구"] for regions)
+  """
+  validValues: Object
+
+  """Regex pattern for validating values in this scope dimension"""
+  validationPattern: String
+}
+
+type KpiScopeList {
+  items: [KpiScope!]!
+  total: Float!
+}
+
+input KpiScopePatch {
+  """Whether this scope definition is active and should be used"""
+  active: Boolean! = true
+  cuFlag: String
+
+  """Detailed description of what this scope dimension represents"""
+  description: String
+
+  """Order/priority for display and processing"""
+  displayOrder: Int! = 1
+  id: ID
+
+  """Whether this scope should be included in statistical calculations"""
+  includeInStatistics: Boolean! = true
+
+  """Scope level (1-5) corresponding to scope01-scope05 in KpiOrgScope"""
+  level: Int!
+
+  """Additional metadata for this scope dimension"""
+  metadata: Object
+
+  """Display name for this scope dimension (e.g., "지역", "회사", "프로젝트규모")"""
+  name: String!
+
+  """Parent scope level if this forms a hierarchy"""
+  parentLevel: Int
+
+  """Type category of this scope dimension"""
+  scopeType: ScopeType!
+
+  """Whether this scope should be displayed in dashboard visualizations"""
+  showInDashboard: Boolean! = false
+
+  """List of valid values for this scope"""
+  validValues: [String!]
+
+  """Regex pattern for validating values in this scope dimension"""
+  validationPattern: String
+}
+
+"""
+KPI Statistics Entity - Stores comprehensive statistical information for KPIs and Categories including central tendency measures (mean, median), dispersion metrics (standard deviation, variance), range indicators (min, max), and percentile distributions (25th, 75th percentiles, IQR). Supports both KPI and Category targets with flexible period-based aggregation (daily, weekly, monthly, yearly). Includes extensible JSON fields for additional metrics and metadata for calculation tracking.
+"""
+type KpiStatistic {
+  """Additional statistical metrics stored as key-value pairs"""
+  additionalStatistics: Object
+
+  """Number of data points used in calculation"""
+  count: Float
+
+  """Timestamp when this statistic was created"""
+  createdAt: DateTimeISO
+
+  """User who created this statistic"""
+  creator: User
+
+  """Domain this statistic belongs to"""
+  domain: Domain
+  id: ID!
+
+  """Interquartile range (75th percentile - 25th percentile)"""
+  iqr: Float
+
+  """Reference to the KPI definition for which this value is calculated."""
+  kpi: Kpi
+
+  """Organization scope for scoped statistics. Null for overall statistics."""
+  kpiOrgScope: KpiOrgScope
+
+  """Lower fence for outlier detection (Q1 - 1.5 * IQR)"""
+  lowerFence: Float
+
+  """Maximum value in the dataset"""
+  maximum: Float
+
+  """Arithmetic mean of all values"""
+  mean: Float
+
+  """Middle value when data is sorted (50th percentile)"""
+  median: Float
+
+  """
+  Calculation metadata including method, timestamp, and data quality information
+  """
+  metadata: Object
+
+  """Minimum value in the dataset"""
+  minimum: Float
+
+  """25th percentile - 25% of data is below this value"""
+  percentile25: Float
+
+  """75th percentile - 75% of data is below this value"""
+  percentile75: Float
+
+  """Aggregation period type for this statistic."""
+  periodType: KpiPeriodType!
+
+  """Range of values (maximum - minimum)"""
+  range: Float
+
+  """
+  Legacy scope field - use kpiOrgScope instead. Statistical scope - null for overall statistics, category value for scoped statistics (e.g., "서울", "부장", "대규모")
+  """
+  scope: String
+
+  """Standard deviation - measure of data dispersion"""
+  standardDeviation: Float
+
+  """Sum of all values in the dataset"""
+  sum: Float
+
+  """Timestamp when this statistic was last updated"""
+  updatedAt: DateTimeISO
+
+  """User who last updated this statistic"""
+  updater: User
+
+  """Upper fence for outlier detection (Q3 + 1.5 * IQR)"""
+  upperFence: Float
+
+  """
+  Date or period for which this statistic is calculated (e.g., day: YYYY-MM-DD, month: YYYY-MM, quarter: YYYY-Qn, range: YYYY-MM-DD~YYYY-MM-DD).
   """
-  vizType: KpiVizType
+  valueDate: String!
 
-  """Weight for aggregation in parent category."""
-  weight: Float
+  """Variance - square of standard deviation"""
+  variance: Float
 }
 
-"""Aggregation period type for KPI (DAY, WEEK, MONTH, QUARTER, RANGE)"""
-enum KpiPeriodType {
-  DAY
-  MONTH
-  QUARTER
-  RANGE
-  WEEK
+type KpiStatisticList {
+  items: [KpiStatistic!]!
+  total: Int!
+}
+
+input KpiStatisticPatch {
+  additionalStatistics: Object
+  count: Float
+  cuFlag: String
+  id: ID
+  iqr: Float
+  kpi: ObjectRef
+  lowerFence: Float
+  maximum: Float
+  mean: Float
+  median: Float
+  metadata: Object
+  minimum: Float
+  percentile25: Float
+  percentile75: Float
+  periodType: KpiPeriodType
+  range: Float
+  standardDeviation: Float
+  sum: Float
+  upperFence: Float
+
+  """
+  Date or period for which this statistic is calculated (e.g., day: YYYY-MM-DD, month: YYYY-MM, quarter: YYYY-Qn, range: YYYY-MM-DD~YYYY-MM-DD).
+  """
+  valueDate: String
+  variance: Float
 }
 
 """State enumeration of a KPI (DRAFT, RELEASED, ARCHIVED)"""
@@ -3992,9 +4320,8 @@ type KpiValue {
 
   """ID of the domain (tenant) for this KPI value."""
   domainId: String
-  grade: GradeInfo
 
-  """Group key for this value (organization, line, user, etc.)"""
+  """Group key for this value (organization, line, user, project, etc.)"""
   group: String
 
   """Unique identifier for this KPI value record."""
@@ -4011,6 +4338,12 @@ type KpiValue {
   """ID of the referenced KPI."""
   kpiId: String!
 
+  """Reference to the organization scope mapping for this KPI value."""
+  kpiOrgScope: KpiOrgScope
+
+  """ID of the referenced KPI organization scope."""
+  kpiOrgScopeId: String
+
   """
   Extended or non-numeric information related to this KPI value, stored as JSON5. Can include grade, status, comments, or other metadata.
   """
@@ -4019,6 +4352,11 @@ type KpiValue {
   """Aggregation period type for this KPI value."""
   periodType: KpiPeriodType!
 
+  """
+  Performance score calculated from KPI value using scoreFormula or grades lookup table. Range: 0-1.
+  """
+  score: Float
+
   """Source of the value (e.g., system, user, external integration)."""
   source: String
 
@@ -4061,7 +4399,7 @@ input KpiValuePatch {
   """Custom flag for update operations (internal use)."""
   cuFlag: String
 
-  """Group key for this value (organization, line, user, etc.)"""
+  """Group key for this value (organization, line, user, project, etc.)"""
   group: String
 
   """ID of the KPI value to update."""
@@ -4075,11 +4413,22 @@ input KpiValuePatch {
   """ID of the KPI to which this value belongs."""
   kpiId: ID
 
+  """ID of the KPI organization scope for this value."""
+  kpiOrgScopeId: ID
+
   """
   Extended or non-numeric information related to this KPI value, stored as JSON5. Can include grade, status, comments, or other metadata.
   """
   meta: Object
 
+  """Legacy organizational unit identifier (for backward compatibility)"""
+  org: String
+
+  """
+  Performance score calculated from KPI value using scoreFormula or grades lookup table. Range: 0-1.
+  """
+  score: Float
+
   """Source of the value (e.g., system, user, external integration)."""
   source: String
 
@@ -4600,6 +4949,28 @@ type Mutation {
   Attaches an existing contact to an employee. The contact is identified by its ID and the employee is identified by their ID.
   """
   attachContact(contactId: String!, id: String!): Employee!
+
+  """Bulk create or update KPI org-scope mappings."""
+  bulkUpsertKpiOrgScopes(
+    """Array of org-scope mapping data for bulk upsert."""
+    orgScopes: [NewKpiOrgScope!]!
+  ): [KpiOrgScope!]!
+
+  """
+  Calculate statistics for all KPIs in a specific period from KpiValue data
+  """
+  calculateAllKpiStatistics(periodType: KpiPeriodType!, valueDate: String!): [KpiStatistic!]!
+
+  """Calculate statistics for a specific KPI and period from KpiValue data"""
+  calculateKpiStatistics(kpiId: String!, periodType: KpiPeriodType!, valueDate: String!): [KpiStatistic!]!
+
+  """KPI 기준으로 formula 계산 및 KPI Value upsert"""
+  calculateKpiValue(kpiId: String!, org: String, valueDate: String): KpiValue!
+
+  """
+  Recalculate statistics for dashboard regions (scope02-based statistics)
+  """
+  calculateRegionalStatistics(periodType: KpiPeriodType! = MONTH, valueDate: String!): [KpiStatistic!]!
   cancelInvitation(email: EmailAddress!, reference: String!, type: String!): Boolean!
 
   """To clear translations cache"""
@@ -4725,6 +5096,9 @@ type Mutation {
   """To create new EntityColumn"""
   createEntityColumn(entityColumn: NewEntityColumn!): EntityColumn!
 
+  """To create new EnvVar"""
+  createEnvVar(envVar: NewEnvVar!): EnvVar!
+
   """To create new Favorite"""
   createFavorite(favorite: NewFavorite!): Favorite!
 
@@ -4740,12 +5114,6 @@ type Mutation {
     kpi: NewKpi!
   ): Kpi!
 
-  """Create a new KPI category with the provided details."""
-  createKpiCategory(
-    """Input object containing details for the new KPI category."""
-    category: NewKpiCategory!
-  ): KpiCategory!
-
   """Create a new KPI metric with the provided details."""
   createKpiMetric(
     """Input object containing details for the new KPI metric."""
@@ -4758,6 +5126,18 @@ type Mutation {
     metricValue: NewKpiMetricValue!
   ): KpiMetricValue!
 
+  """Create a new KPI org-scope mapping with the provided details."""
+  createKpiOrgScope(
+    """Input object containing details for the new org-scope mapping."""
+    kpiOrgScope: NewKpiOrgScope!
+  ): KpiOrgScope!
+
+  """Create a new scope dimension definition"""
+  createKpiScope(kpiScope: NewKpiScope!): KpiScope!
+
+  """To create new KpiStatistic"""
+  createKpiStatistic(kpiStatistic: NewKpiStatistic!): KpiStatistic!
+
   """Create a new KPI value with the provided details."""
   createKpiValue(
     """Input object containing details for the new KPI value."""
@@ -4785,6 +5165,12 @@ type Mutation {
   """To create new MenuDetailColumn"""
   createMenuDetailColumn(menuDetailColumn: NewMenuDetailColumn!): MenuDetailColumn!
 
+  """Create multiple KPI values with the provided details."""
+  createMultipleKpiValue(
+    """Array of input objects containing details for the new KPI values."""
+    values: [NewKpiValue!]!
+  ): [KpiValue!]!
+
   """To create new ApprovalLine for current user"""
   createMyApprovalLine(approvalLine: NewApprovalLine!): ApprovalLine!
 
@@ -5031,6 +5417,12 @@ type Mutation {
   """To delete multiple EntityColumns"""
   deleteEntityColumns(ids: [String!]!): Boolean!
 
+  """To delete EnvVar"""
+  deleteEnvVar(id: String!): Boolean!
+
+  """To delete multiple EnvVars"""
+  deleteEnvVars(ids: [String!]!): Boolean!
+
   """To delete Favorite"""
   deleteFavorite(routing: String!): Boolean!
 
@@ -5043,12 +5435,6 @@ type Mutation {
   """To delete Kpi"""
   deleteKpi(id: String!): Boolean!
 
-  """To delete multiple KpiCategories"""
-  deleteKpiCategories(ids: [String!]!): Boolean!
-
-  """To delete KpiCategory"""
-  deleteKpiCategory(id: String!): Boolean!
-
   """To delete KpiMetric"""
   deleteKpiMetric(id: String!): Boolean!
 
@@ -5061,6 +5447,24 @@ type Mutation {
   """To delete multiple KpiMetrics"""
   deleteKpiMetrics(ids: [String!]!): Boolean!
 
+  """Delete KPI org-scope mappings by their IDs."""
+  deleteKpiOrgScopes(
+    """Array of org-scope mapping IDs to delete."""
+    ids: [String!]!
+  ): Boolean!
+
+  """Delete a scope dimension definition"""
+  deleteKpiScope(id: String!): Boolean!
+
+  """Delete multiple scope dimension definitions"""
+  deleteKpiScopes(ids: [String!]!): Boolean!
+
+  """To delete KpiStatistic"""
+  deleteKpiStatistic(id: String!): Boolean!
+
+  """To delete multiple KpiStatistics"""
+  deleteKpiStatistics(ids: [String!]!): Boolean!
+
   """To delete KpiValue"""
   deleteKpiValue(id: String!): Boolean!
 
@@ -5333,15 +5737,15 @@ type Mutation {
   """
   importEmployees(employees: [EmployeePatch!]!): Boolean!
 
-  """To import multiple KpiCategories"""
-  importKpiCategories(kpiCategories: [KpiCategoryPatch!]!): Boolean!
-
   """To import multiple KpiMetricValues"""
   importKpiMetricValues(metricValues: [KpiMetricValuePatch!]!): Boolean!
 
   """To import multiple KpiMetrics"""
   importKpiMetrics(kpiMetrics: [KpiMetricPatch!]!): Boolean!
 
+  """To import KpiStatistics"""
+  importKpiStatistics(kpiStatistics: [KpiStatisticPatch!]!): Boolean!
+
   """To import multiple KpiValues"""
   importKpiValues(kpiValues: [KpiValuePatch!]!): Boolean!
 
@@ -5426,20 +5830,25 @@ type Mutation {
   """
   pickActivityInstance(id: String!): ActivityThread
 
-  """Recalculate grades for all KpiValues of a specific KPI"""
-  recalculateGradesForKpi(kpiId: String!): Boolean!
+  """기존 KPI Value 인스턴스를 현재 formula/metric 값으로 재계산"""
+  recalculateKpiValue(id: String!): KpiValue!
 
-  """Record a metric value by metric name, value, meta, and group."""
-  recordKpiMetricValue(
-    """Group key for this value (organization, line, user, etc.)"""
-    group: String
+  """Recalculate scores for all KpiValues of a specific KPI"""
+  recalculateScoresForKpi(kpiId: String!): Boolean!
 
+  """Record a metric value by metric name, value, meta, and org."""
+  recordKpiMetricValue(
     """Extended or non-numeric information (JSON)."""
     meta: Object
 
     """Metric code/name."""
     metricName: String!
 
+    """
+    Organizational unit for this value (project, department, company, employee, etc.)
+    """
+    org: String
+
     """Metric value (number)."""
     value: Float
   ): KpiMetricValue!
@@ -5536,7 +5945,7 @@ type Mutation {
   startDataSummarySchedule(dataSetId: String!): DataSet!
 
   """Starts a new scenario instance, which will run in the background."""
-  startScenario(instanceName: String, scenarioName: String!, variables: Object): ScenarioInstance!
+  startScenario(instanceName: String, scenarioName: String!, variables: Object): ScenarioInstanceStartResult!
 
   """Starts the schedule for a specific scenario, if one is defined."""
   startScenarioSchedule(scenarioId: String!): Scenario!
@@ -5678,6 +6087,9 @@ type Mutation {
   """To modify EntityColumn information"""
   updateEntityColumn(id: String!, patch: EntityColumnPatch!): EntityColumn!
 
+  """To modify EnvVar information"""
+  updateEnvVar(envVar: EnvVarPatch!, id: String!): EnvVar!
+
   """To modify Font information"""
   updateFont(id: String!, patch: FontPatch!): Font!
 
@@ -5687,15 +6099,18 @@ type Mutation {
   """To modify Kpi information"""
   updateKpi(id: String!, patch: KpiPatch!): Kpi!
 
-  """To modify KpiCategory information"""
-  updateKpiCategory(id: String!, patch: KpiCategoryPatch!): KpiCategory!
-
   """To modify KpiMetric information"""
   updateKpiMetric(id: String!, patch: KpiMetricPatch!): KpiMetric!
 
   """To modify KpiMetricValue information"""
   updateKpiMetricValue(id: String!, patch: KpiMetricValuePatch!): KpiMetricValue!
 
+  """Update a scope dimension definition"""
+  updateKpiScope(id: String!, patch: KpiScopePatch!): KpiScope!
+
+  """To modify KpiStatistic information"""
+  updateKpiStatistic(id: String!, patch: KpiStatisticPatch!): KpiStatistic!
+
   """To modify KpiValue information"""
   updateKpiValue(id: String!, patch: KpiValuePatch!): KpiValue!
 
@@ -5787,18 +6202,30 @@ type Mutation {
   """To modify multiple Entitys' information"""
   updateMultipleEntityColumn(patches: [EntityColumnPatch!]!): [EntityColumn!]!
 
+  """To modify multiple EnvVars' information"""
+  updateMultipleEnvVars(patches: [EnvVarPatch!]!): [EnvVar!]!
+
   """To modify multiple Kpis' information"""
   updateMultipleKpi(patches: [KpiPatch!]!): [Kpi!]!
 
-  """To modify multiple KpiCategories' information"""
-  updateMultipleKpiCategory(patches: [KpiCategoryPatch!]!): [KpiCategory!]!
-
   """To modify multiple KpiMetrics' information"""
   updateMultipleKpiMetric(patches: [KpiMetricPatch!]!): [KpiMetric!]!
 
   """To modify multiple KpiMetricValues' information"""
   updateMultipleKpiMetricValue(patches: [KpiMetricValuePatch!]!): [KpiMetricValue!]!
 
+  """Update multiple KPI org-scope mappings with the provided patches."""
+  updateMultipleKpiOrgScope(
+    """Array of patch objects for updating org-scope mappings."""
+    patches: [KpiOrgScopePatch!]!
+  ): [KpiOrgScope!]!
+
+  """Update multiple scope dimension definitions"""
+  updateMultipleKpiScope(patches: [KpiScopePatch!]!): [KpiScope!]!
+
+  """To modify multiple KpiStatistics' information"""
+  updateMultipleKpiStatistic(patches: [KpiStatisticPatch!]!): [KpiStatistic!]!
+
   """To modify multiple KpiValues' information"""
   updateMultipleKpiValue(patches: [KpiValuePatch!]!): [KpiValue!]!
 
@@ -6160,6 +6587,9 @@ input NewCommonCodeDetail {
 
 """Input for creating a new connection."""
 input NewConnection {
+  """Whether to automatically connect when the application starts"""
+  active: Boolean
+
   """A detailed description for the new connection."""
   description: String
 
@@ -6172,6 +6602,11 @@ input NewConnection {
   """The name for the new connection."""
   name: String!
 
+  """
+  When true, connection is created on-demand when needed and cleaned up after use.
+  """
+  onDemand: Boolean
+
   """A key-value map of parameters for the new connection."""
   params: Object
 
@@ -6455,6 +6890,21 @@ input NewEntityColumn {
   virtualField: Boolean
 }
 
+"""Input type for creating a new environment variable."""
+input NewEnvVar {
+  """Indicates whether this environment variable is active."""
+  active: Boolean
+
+  """A detailed description for the new environment variable."""
+  description: String
+
+  """The name for the new environment variable."""
+  name: String!
+
+  """The value for the new environment variable."""
+  value: String
+}
+
 input NewFavorite {
   routing: String!
 }
@@ -6484,26 +6934,36 @@ input NewKpi {
   """Indicates whether this KPI is active and usable."""
   active: Boolean
 
-  """ID of the category to which this KPI belongs."""
-  categoryId: ID
-
   """Detailed description of the KPI."""
   description: String
 
   """Calculation formula for the KPI, using metric codes and operators."""
   formula: String
 
-  """Grade configuration for this KPI version"""
+  """Score lookup table for this KPI version"""
   grades: Object
 
+  """
+  Indicates whether this KPI is a leaf node (has actual measured values).
+  """
+  isLeaf: Boolean
+
   """Name of the KPI."""
   name: String!
 
+  """Reference to the parent KPI in hierarchical structure."""
+  parent: ObjectRef
+
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
   """
   schedule: String
 
+  """
+  Score calculation formula for this KPI. Converts KPI value to performance score (0-1).
+  """
+  scoreFormula: String
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: KpiStatus
 
@@ -6527,26 +6987,6 @@ input NewKpi {
   weight: Float
 }
 
-"""
-Input type for creating a new KPI category. Used in mutations to provide category details.
-"""
-input NewKpiCategory {
-  """Whether this category is active (usable) or not."""
-  active: Boolean
-
-  """Detailed description of this KPI category."""
-  description: String
-
-  """Aggregation formula using child KPI codes."""
-  formula: String
-
-  """Name of the KPI category."""
-  name: String!
-
-  """Weight for aggregation in higher-level summary."""
-  weight: Float
-}
-
 """
 Input type for creating a new KPI metric. Used in mutations to provide metric details.
 """
@@ -6570,7 +7010,7 @@ input NewKpiMetric {
   name: String!
 
   """Aggregation period type for this metric."""
-  periodType: KpiMetricPeriodType
+  periodType: KpiPeriodType
 
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
@@ -6597,9 +7037,6 @@ input NewKpiMetric {
 Input type for creating a new metric value. Used in mutations to provide metric value details.
 """
 input NewKpiMetricValue {
-  """Group key for this value (organization, line, user, etc.)"""
-  group: String
-
   """
   Extended or non-numeric information related to this metric value, stored as JSON. Can include status, comments, or other metadata.
   """
@@ -6608,6 +7045,11 @@ input NewKpiMetricValue {
   """ID of the metric to which this value belongs."""
   metricId: ID!
 
+  """
+  Organizational unit for this value (project, department, company, employee, etc.)
+  """
+  org: String
+
   """Aggregation period type for this metric value."""
   periodType: KpiPeriodType!
 
@@ -6623,11 +7065,102 @@ input NewKpiMetricValue {
   valueDate: String!
 }
 
+"""Input type for creating a new KPI org-scope mapping"""
+input NewKpiOrgScope {
+  """Active status"""
+  active: Boolean
+
+  """Human-readable name or description"""
+  displayName: String
+
+  """Organizational unit identifier"""
+  org: String!
+
+  """First scope dimension"""
+  scope01: String
+
+  """Second scope dimension"""
+  scope02: String
+
+  """Third scope dimension"""
+  scope03: String
+
+  """Fourth scope dimension"""
+  scope04: String
+
+  """Fifth scope dimension"""
+  scope05: String
+}
+
+input NewKpiScope {
+  """Whether this scope definition is active and should be used"""
+  active: Boolean! = true
+
+  """Detailed description of what this scope dimension represents"""
+  description: String
+
+  """Order/priority for display and processing"""
+  displayOrder: Int! = 1
+
+  """Whether this scope should be included in statistical calculations"""
+  includeInStatistics: Boolean! = true
+
+  """Scope level (1-5) corresponding to scope01-scope05 in KpiOrgScope"""
+  level: Int!
+
+  """Additional metadata for this scope dimension"""
+  metadata: Object
+
+  """Display name for this scope dimension (e.g., "지역", "회사", "프로젝트규모")"""
+  name: String!
+
+  """Parent scope level if this forms a hierarchy"""
+  parentLevel: Int
+
+  """Type category of this scope dimension"""
+  scopeType: ScopeType!
+
+  """Whether this scope should be displayed in dashboard visualizations"""
+  showInDashboard: Boolean! = false
+
+  """List of valid values for this scope"""
+  validValues: [String!]
+
+  """Regex pattern for validating values in this scope dimension"""
+  validationPattern: String
+}
+
+input NewKpiStatistic {
+  additionalStatistics: Object
+  count: Float
+  iqr: Float
+  kpi: ObjectRef
+  lowerFence: Float
+  maximum: Float
+  mean: Float
+  median: Float
+  metadata: Object
+  minimum: Float
+  percentile25: Float
+  percentile75: Float
+  periodType: KpiPeriodType!
+  range: Float
+  standardDeviation: Float
+  sum: Float
+  upperFence: Float
+
+  """
+  Date or period for which this statistic is calculated (e.g., day: YYYY-MM-DD, month: YYYY-MM, quarter: YYYY-Qn, range: YYYY-MM-DD~YYYY-MM-DD).
+  """
+  valueDate: String!
+  variance: Float
+}
+
 """
 Input type for creating a new KPI value. Used in mutations to provide KPI value details.
 """
 input NewKpiValue {
-  """Group key for this value (organization, line, user, etc.)"""
+  """Group key for this value (organization, line, user, project, etc.)"""
   group: String
 
   """
@@ -6638,11 +7171,22 @@ input NewKpiValue {
   """ID of the KPI to which this value belongs."""
   kpiId: ID!
 
+  """ID of the KPI organization scope for this value."""
+  kpiOrgScopeId: ID
+
   """
   Extended or non-numeric information related to this KPI value, stored as JSON5. Can include grade, status, comments, or other metadata.
   """
   meta: Object
 
+  """Legacy organizational unit identifier (for backward compatibility)"""
+  org: String
+
+  """
+  Performance score calculated from KPI value using scoreFormula or grades lookup table. Range: 0-1.
+  """
+  score: Float
+
   """Source of the value (e.g., system, user, external integration)."""
   source: String
 
@@ -6931,6 +7475,9 @@ input NewScenario {
   """A detailed description for the new scenario."""
   description: String
 
+  """Iteration for scenario execution: SELF, CHILDREN, or SELF & CHILDREN."""
+  iteration: String
+
   """The name of the new scenario."""
   name: String!
 
@@ -7760,8 +8307,15 @@ type PropertySpec {
   """CSS styles to be applied to the input field."""
   styles: Object
 
-  """The data type of the property (e.g., text, number, boolean, select)."""
+  """
+  The data type of the property (e.g., text, number, boolean, select, password).
+  """
   type: String!
+
+  """
+  Whether this property should use Domain attributes for secure storage instead of direct params.
+  """
+  useDomainAttribute: Boolean
 }
 
 type Query {
@@ -8299,6 +8853,9 @@ type Query {
   ): ContactList!
   customers: [Domain!]!
 
+  """Get aggregated statistics by scope02 (regional level) for dashboard"""
+  dashboardRegionalStatistics(periodType: KpiPeriodType! = MONTH, valueDate: String!): [KpiStatistic!]!
+
   """
   Retrieves a single data archive by its unique identifier. This query fetches detailed information about a data archive request including its status, download URL, and associated dataset information for data export purposes.
   """
@@ -8840,6 +9397,20 @@ type Query {
 
   """To fetch a EntityMetadata"""
   entityMetadata(name: String!): EntityMetadata!
+  envVar(id: String!): EnvVar
+  envVars(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): EnvVarList!
 
   """To fetch a Favorite"""
   favorite(id: String!): Favorite!
@@ -8955,26 +9526,11 @@ type Query {
   """KPI 실적/등급/목표 미달 등 경고/알림 리스트 반환"""
   kpiAlerts: [KpiAlert!]!
 
-  """To fetch multiple KpiCategories"""
-  kpiCategories(
-    """An array of filter conditions to apply to the list query."""
-    filters: [Filter!]
-
-    """Inherited value type for the list query."""
-    inherited: InheritedValueType
-
-    """Pagination options for the list query."""
-    pagination: Pagination
-
-    """Sorting options for the list query."""
-    sortings: [Sorting!]
-  ): KpiCategoryList!
-
-  """Fetch a single KPI category by its unique identifier."""
-  kpiCategory(
-    """Unique identifier of the KPI category to fetch."""
-    id: String!
-  ): KpiCategory
+  """Fetch child KPIs of a given parent KPI"""
+  kpiChildren(
+    """ID of the parent KPI"""
+    parentId: String!
+  ): [Kpi!]!
 
   """Fetch a single KPI metric by its unique identifier."""
   kpiMetric(
@@ -9018,6 +9574,87 @@ type Query {
     sortings: [Sorting!]
   ): KpiMetricList!
 
+  """Fetch a single KPI org-scope mapping by its unique identifier."""
+  kpiOrgScope(
+    """Unique identifier of the org-scope mapping to fetch."""
+    id: String!
+  ): KpiOrgScope
+
+  """Find org-scope mapping by org identifier"""
+  kpiOrgScopeByOrg(
+    """Organization identifier to search for"""
+    org: String!
+  ): KpiOrgScope
+
+  """Get distinct values for a specific scope field"""
+  kpiOrgScopeValues(
+    """Scope field to get distinct values from"""
+    scopeField: String!
+
+    """Optional search term to filter values"""
+    searchTerm: String
+  ): [String!]!
+
+  """Fetch multiple KPI org-scope mappings with filters and pagination"""
+  kpiOrgScopes(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): KpiOrgScopeList!
+
+  """Get distinct org values"""
+  kpiOrgValues(
+    """Optional search term to filter org values"""
+    searchTerm: String
+  ): [String!]!
+
+  """Fetch a scope dimension definition by ID"""
+  kpiScope(id: String!): KpiScope
+
+  """Fetch multiple scope dimension definitions"""
+  kpiScopes(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): KpiScopeList!
+
+  """To fetch a KpiStatistic"""
+  kpiStatistic(id: String!): KpiStatistic
+
+  """To fetch multiple KpiStatistics"""
+  kpiStatistics(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): KpiStatisticList!
+
+  """Fetch KPIs in hierarchical tree structure"""
+  kpiTree: [Kpi!]!
+
   """Fetch a single KPI value by its unique identifier."""
   kpiValue(
     """Unique identifier of the KPI value to fetch."""
@@ -9054,6 +9691,19 @@ type Query {
     sortings: [Sorting!]
   ): KpiList!
 
+  """Fetch root KPIs (KPIs without parent)"""
+  kpisLevel0: [Kpi!]!
+
+  """
+  Fetch first level child KPIs. If rootId is provided, get children of that parent. If not, get all level 1 KPIs (children of root KPIs)
+  """
+  kpisLevel1(
+    """
+    ID of the parent KPI to get level 1 children. If not provided, returns all level 1 KPIs
+    """
+    rootId: String
+  ): [Kpi!]!
+
   """To fetch a LiteMenu"""
   liteMenu(id: String!): LiteMenu!
 
@@ -9481,6 +10131,9 @@ type Query {
   """To query data in S3 using Amazon Athena SDK"""
   queryFromAthena(queryData: Object!): Any!
 
+  """Get regional statistics for dashboard map visualization"""
+  regionalKpiStatistics(periodType: KpiPeriodType! = MONTH, regions: [String!], valueDate: String!): [KpiStatistic!]!
+
   """To fetch role"""
   role(name: String!): Role!
 
@@ -9929,7 +10582,7 @@ type SPCSpecLimits {
 """Represents a sequence of steps designed to automate a task or process."""
 type Scenario {
   """
-  Indicates if the scenario should be automatically started when the server starts. [will be deprecated]
+  Indicates if the scenario should be automatically started when the server starts.
   """
   active: Boolean
   connectionNames: [Connection!]!
@@ -9950,6 +10603,9 @@ type Scenario {
   id: ID!
   instances: [ScenarioInstance!]
 
+  """Iteration for scenario execution: SELF, CHILDREN, or SELF & CHILDREN."""
+  iteration: String
+
   """The name of the scenario."""
   name: String!
 
@@ -10079,6 +10735,18 @@ type ScenarioInstanceRunResult {
   variables: Object
 }
 
+"""Contains the final result of a completed scenario instance start."""
+type ScenarioInstanceStartResult {
+  """A final message from the run (e.g., success or failure reason)."""
+  message: String
+
+  """The final state of the instance after the run."""
+  state: String
+
+  """The timestamp when the instance started."""
+  timestamp: DateTimeISO
+}
+
 """
 Represents the complete state of a scenario instance at a point in time.
 """
@@ -10131,7 +10799,9 @@ type ScenarioList {
 
 """Input for updating (patching) an existing scenario."""
 input ScenarioPatch {
-  """The new active status for the scenario."""
+  """
+  Indicates if the scenario should be automatically started when the server starts.
+  """
   active: Boolean
 
   """
@@ -10145,6 +10815,11 @@ input ScenarioPatch {
   """The unique identifier of the scenario to update."""
   id: ID
 
+  """
+  The new iteration for scenario execution: SELF, CHILDREN, or SELF & CHILDREN.
+  """
+  iteration: String
+
   """The new name for the scenario."""
   name: String
 
@@ -10371,6 +11046,16 @@ input ScheduleTaskInput {
   type: String!
 }
 
+"""Types of organizational scope dimensions"""
+enum ScopeType {
+  BUSINESS
+  CUSTOM
+  GEOGRAPHIC
+  ORGANIZATIONAL
+  TECHNICAL
+  TEMPORAL
+}
+
 """Entity for Setting"""
 type Setting {
   category: String!