@things-factory/operato-dataset 9.0.18 → 9.0.19

package/schema.graphql

@@ -3517,6 +3517,9 @@ type Kpi {
   """Name of the KPI."""
   name: String
 
+  """Aggregation period type for this KPI."""
+  periodType: KpiPeriodType!
+
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
   """
@@ -3560,6 +3563,9 @@ type Kpi {
   Visualization type for this KPI (e.g., CARD, GAUGE, PROGRESS, BAR, LINE, etc.).
   """
   vizType: KpiVizType
+
+  """Weight for aggregation in parent category."""
+  weight: Float
 }
 
 """KPI 경고/알림 엔티티. KPI 실적, 등급, 목표 미달 등 경고/알림 정보를 제공."""
@@ -3603,6 +3609,9 @@ type KpiCategory {
   """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!
 
@@ -3612,12 +3621,6 @@ type KpiCategory {
   """Name of the KPI category."""
   name: String!
 
-  """Parent category for hierarchical category structure."""
-  parent: KpiCategory
-
-  """ID of the parent category, if any."""
-  parentId: String
-
   """Timestamp when this KPI category was last updated."""
   updatedAt: DateTimeISO
 
@@ -3626,6 +3629,9 @@ type KpiCategory {
 
   """ID of the user who last updated this KPI category."""
   updaterId: String
+
+  """Weight for aggregation in higher-level summary."""
+  weight: Float
 }
 
 type KpiCategoryList {
@@ -3646,14 +3652,17 @@ input KpiCategoryPatch {
   """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
 
-  """ID of the parent category, if any."""
-  parentId: ID
+  """Weight for aggregation in higher-level summary."""
+  weight: Float
 }
 
 """History Entity of Kpi"""
@@ -3676,6 +3685,7 @@ type KpiHistory {
   grades: Object
   id: ID!
   name: String!
+  periodType: KpiPeriodType
 
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: String
@@ -3685,6 +3695,9 @@ type KpiHistory {
   updatedAt: DateTimeISO
   updater: User
   version: Float
+
+  """Weight for aggregation in parent category."""
+  weight: Float
 }
 
 type KpiList {
@@ -3697,6 +3710,9 @@ type KpiMetric {
   """Indicates whether this metric is active and usable."""
   active: Boolean
 
+  """데이터 수집 방식"""
+  collectType: KpiMetricCollectType!
+
   """Timestamp when this KPI metric was created."""
   createdAt: DateTimeISO
 
@@ -3727,21 +3743,14 @@ type KpiMetric {
   """Name of the field in the dataset this metric maps to."""
   fieldName: String
 
-  """
-  Calculation formula for the metric, using other metric codes and operators.
-  """
-  formula: String
-
   """Unique identifier for this KPI metric."""
   id: ID!
 
   """Metric code, unique within the domain, used in KPI formulas."""
   name: String!
 
-  """
-  Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
-  """
-  schedule: String
+  """Aggregation period type for this metric."""
+  periodType: KpiMetricPeriodType!
 
   """Schedule ID for the registered cron job."""
   scheduleId: String
@@ -3768,6 +3777,14 @@ type KpiMetric {
   updaterId: String
 }
 
+"""방식: AUTO(자동), MANUAL(수동), IMPORT(임포트), EXTERNAL(외부API)"""
+enum KpiMetricCollectType {
+  AUTO
+  EXTERNAL
+  IMPORT
+  MANUAL
+}
+
 type KpiMetricList {
   items: [KpiMetric!]!
   total: Int!
@@ -3775,18 +3792,19 @@ type KpiMetricList {
 
 input KpiMetricPatch {
   active: Boolean
+
+  """데이터 수집 방식"""
+  collectType: KpiMetricCollectType
   cuFlag: String
   dataSetId: ID
   description: String
   fieldName: String
-
-  """
-  Calculation formula for the metric, using other metric codes and operators.
-  """
-  formula: String
   id: ID
   name: String
 
+  """Aggregation period type for this metric."""
+  periodType: KpiMetricPeriodType
+
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
   """
@@ -3802,6 +3820,85 @@ 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).
+"""
+type KpiMetricValue {
+  createdAt: DateTimeISO
+  creator: User
+  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!
+  periodType: KpiPeriodType!
+  unit: String
+  updatedAt: DateTimeISO
+  updater: User
+  updaterId: String
+  value: Float!
+
+  """
+  Date or period for which this metric value is recorded (e.g., day: YYYY-MM-DD, month: YYYY-MM, range: YYYY-MM-DD~YYYY-MM-DD).
+  """
+  valueDate: String!
+}
+
+type KpiMetricValueList {
+  items: [KpiMetricValue!]!
+  total: Int!
+}
+
+"""
+Input type for updating an existing metric value. Used in mutations to patch metric value details.
+"""
+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
+
+  """
+  Extended or non-numeric information related to this metric value, stored as JSON. Can include status, comments, or other metadata.
+  """
+  meta: Object
+
+  """ID of the metric to which this value belongs."""
+  metricId: ID
+
+  """Aggregation period type for this metric value."""
+  periodType: KpiPeriodType
+
+  """Unit of measurement for this metric value."""
+  unit: String
+
+  """The value for this metric and period."""
+  value: Float
+
+  """
+  Date or period for which this metric value is recorded (e.g., day, month, quarter, range).
+  """
+  valueDate: String
+}
+
 """
 Input type for updating an existing KPI. Used in mutations to patch KPI details.
 """
@@ -3853,6 +3950,18 @@ input KpiPatch {
   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)"""
+enum KpiPeriodType {
+  DAY
+  MONTH
+  QUARTER
+  RANGE
+  WEEK
 }
 
 """State enumeration of a KPI (DRAFT, RELEASED, ARCHIVED)"""
@@ -3880,13 +3989,8 @@ type KpiValue {
   domainId: String
   grade: GradeInfo
 
-  """
-  ID of the group (organization, department, project, etc.) this value is associated with.
-  """
-  groupId: String
-
-  """Type of the group (e.g., USER, DEPT, PROJECT) for this value."""
-  groupType: String
+  """Group key for this value (organization, line, user, etc.)"""
+  group: String
 
   """Unique identifier for this KPI value record."""
   id: ID!
@@ -3907,6 +4011,9 @@ type KpiValue {
   """
   meta: Object
 
+  """Aggregation period type for this KPI value."""
+  periodType: KpiPeriodType!
+
   """Source of the value (e.g., system, user, external integration)."""
   source: String
 
@@ -3923,7 +4030,7 @@ type KpiValue {
   value: Float!
 
   """
-  Date or period for which this KPI value is recorded (e.g., day, month, quarter).
+  Date or period for which this KPI value is recorded (e.g., day: YYYY-MM-DD, month: YYYY-MM, quarter: YYYY-Qn, range: YYYY-MM-DD~YYYY-MM-DD).
   """
   valueDate: String!
 
@@ -3949,13 +4056,8 @@ input KpiValuePatch {
   """Custom flag for update operations (internal use)."""
   cuFlag: String
 
-  """
-  ID of the group (organization, department, project, etc.) this value is associated with.
-  """
-  groupId: String
-
-  """Type of the group (e.g., USER, DEPT, PROJECT) for this value."""
-  groupType: String
+  """Group key for this value (organization, line, user, etc.)"""
+  group: String
 
   """ID of the KPI value to update."""
   id: ID
@@ -4642,9 +4744,15 @@ type Mutation {
   """Create a new KPI metric with the provided details."""
   createKpiMetric(
     """Input object containing details for the new KPI metric."""
-    metric: NewKpiMetric!
+    kpiMetric: NewKpiMetric!
   ): KpiMetric!
 
+  """Create a new metric value with the provided details."""
+  createKpiMetricValue(
+    """Input object containing details for the new metric value."""
+    metricValue: NewKpiMetricValue!
+  ): KpiMetricValue!
+
   """Create a new KPI value with the provided details."""
   createKpiValue(
     """Input object containing details for the new KPI value."""
@@ -4939,6 +5047,12 @@ type Mutation {
   """To delete KpiMetric"""
   deleteKpiMetric(id: String!): Boolean!
 
+  """To delete KpiMetricValue"""
+  deleteKpiMetricValue(id: String!): Boolean!
+
+  """To delete multiple KpiMetricValues"""
+  deleteKpiMetricValues(ids: [String!]!): Boolean!
+
   """To delete multiple KpiMetrics"""
   deleteKpiMetrics(ids: [String!]!): Boolean!
 
@@ -5217,6 +5331,9 @@ type Mutation {
   """To import multiple KpiCategories"""
   importKpiCategories(kpiCategories: [KpiCategoryPatch!]!): Boolean!
 
+  """To import multiple KpiMetricValues"""
+  importKpiMetricValues(metricValues: [KpiMetricValuePatch!]!): Boolean!
+
   """To import multiple KpiMetrics"""
   importKpiMetrics(kpiMetrics: [KpiMetricPatch!]!): Boolean!
 
@@ -5307,6 +5424,21 @@ type Mutation {
   """Recalculate grades for all KpiValues of a specific KPI"""
   recalculateGradesForKpi(kpiId: String!): Boolean!
 
+  """Record a metric value by metric name, value, meta, and group."""
+  recordKpiMetricValue(
+    """Group key for this value (organization, line, user, etc.)"""
+    group: String
+
+    """Extended or non-numeric information (JSON)."""
+    meta: Object
+
+    """Metric code/name."""
+    metricName: String!
+
+    """Metric value (number)."""
+    value: Float
+  ): KpiMetricValue!
+
   """To refresh oauth2 access token"""
   refreshOauth2AccessToken(id: String!): Oauth2Client!
 
@@ -5556,6 +5688,9 @@ type Mutation {
   """To modify KpiMetric information"""
   updateKpiMetric(id: String!, patch: KpiMetricPatch!): KpiMetric!
 
+  """To modify KpiMetricValue information"""
+  updateKpiMetricValue(id: String!, patch: KpiMetricValuePatch!): KpiMetricValue!
+
   """To modify KpiValue information"""
   updateKpiValue(id: String!, patch: KpiValuePatch!): KpiValue!
 
@@ -5648,7 +5783,7 @@ type Mutation {
   updateMultipleEntityColumn(patches: [EntityColumnPatch!]!): [EntityColumn!]!
 
   """To modify multiple Kpis' information"""
-  updateMultipleKpi(patches: [KpiPatch!]!): Boolean!
+  updateMultipleKpi(patches: [KpiPatch!]!): [Kpi!]!
 
   """To modify multiple KpiCategories' information"""
   updateMultipleKpiCategory(patches: [KpiCategoryPatch!]!): [KpiCategory!]!
@@ -5656,6 +5791,9 @@ type Mutation {
   """To modify multiple KpiMetrics' information"""
   updateMultipleKpiMetric(patches: [KpiMetricPatch!]!): [KpiMetric!]!
 
+  """To modify multiple KpiMetricValues' information"""
+  updateMultipleKpiMetricValue(patches: [KpiMetricValuePatch!]!): [KpiMetricValue!]!
+
   """To modify multiple KpiValues' information"""
   updateMultipleKpiValue(patches: [KpiValuePatch!]!): [KpiValue!]!
 
@@ -6379,6 +6517,9 @@ input NewKpi {
   Visualization type for this KPI (e.g., CARD, GAUGE, PROGRESS, BAR, LINE, etc.).
   """
   vizType: KpiVizType
+
+  """Weight for aggregation in parent category."""
+  weight: Float
 }
 
 """
@@ -6391,11 +6532,14 @@ input NewKpiCategory {
   """Detailed description of this KPI category."""
   description: String
 
+  """Aggregation formula using child KPI codes."""
+  formula: String
+
   """Name of the KPI category."""
   name: String!
 
-  """ID of the parent category, if any."""
-  parentId: ID
+  """Weight for aggregation in higher-level summary."""
+  weight: Float
 }
 
 """
@@ -6405,6 +6549,9 @@ input NewKpiMetric {
   """Indicates whether this metric is active and usable."""
   active: Boolean
 
+  """데이터 수집 방식"""
+  collectType: KpiMetricCollectType
+
   """ID of the source dataset for this metric."""
   dataSetId: ID
 
@@ -6414,14 +6561,12 @@ input NewKpiMetric {
   """Name of the field in the dataset this metric maps to."""
   fieldName: String
 
-  """
-  Calculation formula for the metric, using other metric codes and operators.
-  """
-  formula: String
-
   """Metric code, unique within the domain, used in KPI formulas."""
   name: String!
 
+  """Aggregation period type for this metric."""
+  periodType: KpiMetricPeriodType
+
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
   """
@@ -6444,16 +6589,41 @@ input NewKpiMetric {
 }
 
 """
-Input type for creating a new KPI value. Used in mutations to provide KPI value details.
+Input type for creating a new metric value. Used in mutations to provide metric value details.
 """
-input NewKpiValue {
+input NewKpiMetricValue {
+  """Group key for this value (organization, line, user, etc.)"""
+  group: String
+
   """
-  ID of the group (organization, department, project, etc.) this value is associated with.
+  Extended or non-numeric information related to this metric value, stored as JSON. Can include status, comments, or other metadata.
   """
-  groupId: String
+  meta: Object
+
+  """ID of the metric to which this value belongs."""
+  metricId: ID!
 
-  """Type of the group (e.g., USER, DEPT, PROJECT) for this value."""
-  groupType: String
+  """Aggregation period type for this metric value."""
+  periodType: KpiPeriodType!
+
+  """Unit of measurement for this metric value."""
+  unit: String
+
+  """The value for this metric and period."""
+  value: Float!
+
+  """
+  Date or period for which this metric value is recorded (e.g., day, month, quarter, range).
+  """
+  valueDate: String!
+}
+
+"""
+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: String
 
   """
   Indicates whether this value was entered manually or generated automatically.
@@ -8807,6 +8977,27 @@ type Query {
     id: String!
   ): KpiMetric
 
+  """Fetch a single metric value by its unique identifier."""
+  kpiMetricValue(
+    """Unique identifier of the metric value to fetch."""
+    id: String!
+  ): KpiMetricValue
+
+  """To fetch multiple KpiMetricValues"""
+  kpiMetricValues(
+    """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!]
+  ): KpiMetricValueList!
+
   """To fetch multiple KpiMetrics"""
   kpiMetrics(
     """An array of filter conditions to apply to the list query."""