@things-factory/operato-dataset 9.0.9 → 9.0.11

package/schema.graphql

@@ -3453,6 +3453,621 @@ A field whose value is a JSON Web Token (JWT): https://jwt.io/introduction.
 """
 scalar JWT
 
+"""
+KPI entity. Represents a key performance indicator with calculation formula, target, category, and other attributes.
+"""
+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
+
+  """Timestamp when this KPI was created."""
+  createdAt: DateTimeISO
+
+  """User who created this KPI."""
+  creator: User
+
+  """ID of the user who created this KPI."""
+  creatorId: String
+
+  """Timestamp when this KPI was deleted (soft delete)."""
+  deletedAt: DateTimeISO
+
+  """Detailed description of the KPI."""
+  description: String
+
+  """Domain (tenant) to which this KPI belongs."""
+  domain: Domain
+
+  """ID of the domain (tenant) for this KPI."""
+  domainId: String
+
+  """
+  Calculation formula for the KPI. Expressed as a string using metric codes and operators, e.g., "defect_count / total_count * 100".
+  """
+  formula: String
+
+  """List of grades for this KPI."""
+  grades: [KpiGrade!]
+  histories(limit: Int): [KpiHistory!]
+
+  """Unique identifier for this KPI."""
+  id: ID!
+
+  """Name of the KPI."""
+  name: String
+
+  """
+  Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
+  """
+  schedule: String
+
+  """Schedule ID for the KPI (used for scheduler registration)."""
+  scheduleId: String
+
+  """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
+  state: String
+  targetValue: Float
+
+  """Thumbnail image or file path for this KPI."""
+  thumbnail: String
+
+  """Timezone for the KPI schedule."""
+  timezone: String
+  unit: String
+
+  """Timestamp when this KPI was last updated."""
+  updatedAt: DateTimeISO
+
+  """User who last updated this KPI."""
+  updater: User
+
+  """ID of the user who last updated this KPI."""
+  updaterId: String
+  value: 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.
+  """
+  version: Float
+
+  """
+  Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.
+  """
+  vizMeta: Object
+
+  """
+  Visualization type for this KPI (e.g., bar, line, gauge, progress, card, table, icon, badge, text).
+  """
+  vizType: String
+}
+
+"""KPI 경고/알림 엔티티. KPI 실적, 등급, 목표 미달 등 경고/알림 정보를 제공."""
+type KpiAlert {
+  """경고/알림 발생 시각."""
+  createdAt: DateTimeISO!
+  id: ID!
+
+  """경고/알림이 발생한 KPI."""
+  kpi: Kpi
+
+  """경고 레벨(예: warning, critical, info 등)."""
+  level: String!
+
+  """경고/알림 메시지."""
+  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
+
+  """Unique identifier for this KPI category."""
+  id: ID!
+
+  """List of KPIs belonging to this category."""
+  kpis: [Kpi!]
+
+  """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
+
+  """User who last updated this KPI category."""
+  updater: User
+
+  """ID of the user who last updated this KPI category."""
+  updaterId: String
+}
+
+type KpiCategoryList {
+  items: [KpiCategory!]!
+  total: Int!
+}
+
+"""
+Input type for updating an existing KPI category. Used in mutations to patch category details.
+"""
+input KpiCategoryPatch {
+  """Custom flag for update operations (internal use)."""
+  cuFlag: String
+
+  """Detailed description of this KPI category."""
+  description: 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
+}
+
+"""
+KPI grade entity. Represents a grade/section for a KPI version, with value range, score, color, and description.
+"""
+type KpiGrade {
+  """Indicates whether this KPI grade is active and usable."""
+  active: Boolean
+
+  """Color code for this grade (for visualization purposes)."""
+  color: String
+
+  """Timestamp when this KPI grade was created."""
+  createdAt: DateTimeISO
+
+  """User who created this KPI grade."""
+  creator: User
+
+  """ID of the user who created this KPI grade."""
+  creatorId: String
+
+  """Detailed description of this KPI grade."""
+  description: String
+
+  """Domain (tenant) to which this KPI grade belongs."""
+  domain: Domain
+
+  """ID of the domain (tenant) for this KPI grade."""
+  domainId: String
+
+  """Unique identifier for this KPI grade."""
+  id: ID!
+
+  """Reference to the KPI to which this grade belongs."""
+  kpi: Kpi!
+
+  """ID of the referenced KPI."""
+  kpiId: String!
+
+  """Maximum value for this grade section."""
+  maxValue: Float!
+
+  """Minimum value for this grade section."""
+  minValue: Float!
+
+  """Name of the grade or section for this KPI."""
+  name: String
+
+  """Score or weight for this grade (optional)."""
+  score: Float
+
+  """Timestamp when this KPI grade was last updated."""
+  updatedAt: DateTimeISO
+
+  """User who last updated this KPI grade."""
+  updater: User
+
+  """ID of the user who last updated this KPI grade."""
+  updaterId: String
+
+  """Version of the KPI definition to which this grade belongs."""
+  version: Int!
+}
+
+type KpiGradeList {
+  items: [KpiGrade!]!
+  total: Int!
+}
+
+"""
+Input type for updating an existing KPI grade. Used in mutations to patch grade details.
+"""
+input KpiGradePatch {
+  """Indicates whether this KPI grade is active and usable."""
+  active: Boolean
+
+  """Color code for this grade (for visualization purposes)."""
+  color: String
+
+  """Custom flag for update operations (internal use)."""
+  cuFlag: String
+
+  """Detailed description of this KPI grade."""
+  description: String
+
+  """ID of the KPI grade to update."""
+  id: ID
+
+  """ID of the KPI to which this grade belongs."""
+  kpiId: ID
+
+  """Maximum value for this grade section."""
+  maxValue: Int
+
+  """Minimum value for this grade section."""
+  minValue: Int
+
+  """Name of the grade or section for this KPI."""
+  name: String
+
+  """Score or weight for this grade (optional)."""
+  score: Int
+
+  """Version of the KPI definition to which this grade belongs."""
+  version: Int
+}
+
+"""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
+  description: String
+  domain: Domain
+
+  """Calculation formula for the KPI."""
+  formula: String
+  id: ID!
+  name: String!
+
+  """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
+  state: String
+
+  """Thumbnail image or file path for this KPI."""
+  thumbnail: String
+  updatedAt: DateTimeISO
+  updater: User
+  version: Float
+}
+
+type KpiList {
+  items: [Kpi!]!
+  total: Int!
+}
+
+"""KPI metric entity. Represents a source data item used in KPI formulas."""
+type KpiMetric {
+  """Indicates whether this metric is active and usable."""
+  active: Boolean
+
+  """Timestamp when this KPI metric was created."""
+  createdAt: DateTimeISO
+
+  """User who created this KPI metric."""
+  creator: User
+
+  """ID of the user who created this KPI metric."""
+  creatorId: String
+
+  """Reference to the source dataset for this metric."""
+  dataSet: DataSet
+
+  """ID of the referenced source dataset."""
+  dataSetId: String
+
+  """Timestamp when this KPI metric was deleted (soft delete)."""
+  deletedAt: DateTimeISO
+
+  """User-friendly name or description of the metric."""
+  description: String
+
+  """Domain (tenant) to which this KPI metric belongs."""
+  domain: Domain
+
+  """ID of the domain (tenant) for this KPI metric."""
+  domainId: String
+
+  """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
+
+  """Schedule ID for the registered cron job."""
+  scheduleId: String
+
+  """Source of the metric data (e.g., system, method, dataset)."""
+  source: String
+
+  """Thumbnail image or file path for this KPI metric."""
+  thumbnail: String
+
+  """Timezone for the schedule."""
+  timezone: String
+
+  """Unit of measurement for this metric (e.g., %, count, hours)."""
+  unit: String
+
+  """Timestamp when this KPI metric was last updated."""
+  updatedAt: DateTimeISO
+
+  """User who last updated this KPI metric."""
+  updater: User
+
+  """ID of the user who last updated this KPI metric."""
+  updaterId: String
+}
+
+type KpiMetricList {
+  items: [KpiMetric!]!
+  total: Int!
+}
+
+input KpiMetricPatch {
+  active: Boolean
+  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
+
+  """
+  Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
+  """
+  schedule: String
+
+  """Schedule ID for the registered cron job."""
+  scheduleId: String
+  source: String
+  thumbnail: Upload
+
+  """Timezone for the schedule."""
+  timezone: String
+  unit: String
+}
+
+"""
+Input type for updating an existing KPI. Used in mutations to patch KPI details.
+"""
+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
+
+  """Detailed description of the KPI."""
+  description: String
+
+  """Calculation formula for the KPI, using metric codes and operators."""
+  formula: String
+
+  """ID of the KPI to update."""
+  id: ID
+
+  """Name of the KPI."""
+  name: String
+
+  """
+  Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
+  """
+  schedule: String
+
+  """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
+  state: KpiStatus
+
+  """Thumbnail image or file for this KPI."""
+  thumbnail: Upload
+
+  """Timezone for the KPI schedule."""
+  timezone: String
+
+  """
+  Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.
+  """
+  vizMeta: Object
+
+  """
+  Visualization type for this KPI (e.g., bar, line, gauge, progress, card, table, icon, badge, text).
+  """
+  vizType: String
+}
+
+"""State enumeration of a KPI (DRAFT, RELEASED, ARCHIVED)"""
+enum KpiStatus {
+  ARCHIVED
+  DRAFT
+  RELEASE
+}
+
+"""Entity for KpiValue"""
+type KpiValue {
+  """Timestamp when this KPI value record was created."""
+  createdAt: DateTimeISO
+
+  """User who created this KPI value record."""
+  creator: User
+
+  """ID of the user who created this KPI value record."""
+  creatorId: String
+
+  """Domain (tenant) to which this KPI value belongs."""
+  domain: Domain
+
+  """ID of the domain (tenant) for this KPI value."""
+  domainId: 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
+
+  """Unique identifier for this KPI value record."""
+  id: ID!
+
+  """
+  Indicates whether this value was entered manually or generated automatically.
+  """
+  inputType: String
+
+  """Reference to the KPI definition for which this value is calculated."""
+  kpi: Kpi
+
+  """ID of the referenced KPI."""
+  kpiId: String!
+
+  """
+  Extended or non-numeric information related to this KPI value, stored as JSON5. Can include grade, status, comments, or other metadata.
+  """
+  meta: Object
+
+  """Source of the value (e.g., system, user, external integration)."""
+  source: String
+
+  """Timestamp when this KPI value record was last updated."""
+  updatedAt: DateTimeISO
+
+  """User who last updated this KPI value record."""
+  updater: User
+
+  """ID of the user who last updated this KPI value record."""
+  updaterId: String
+
+  """The calculated numeric value for this KPI and period."""
+  value: Float!
+
+  """
+  Date or period for which this KPI value is recorded (e.g., day, month, quarter).
+  """
+  valueDate: String!
+
+  """Version of the KPI definition at the time this value was calculated."""
+  version: Int!
+}
+
+"""Type of the input (Manual or Auto)"""
+enum KpiValueInputType {
+  AUTO
+  MANUAL
+}
+
+type KpiValueList {
+  items: [KpiValue!]!
+  total: Int!
+}
+
+"""
+Input type for updating an existing KPI value. Used in mutations to patch KPI value details.
+"""
+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
+
+  """ID of the KPI value to update."""
+  id: ID
+
+  """
+  Indicates whether this value was entered manually or generated automatically.
+  """
+  inputType: KpiValueInputType
+
+  """ID of the KPI to which this value belongs."""
+  kpiId: ID
+
+  """
+  Extended or non-numeric information related to this KPI value, stored as JSON5. Can include grade, status, comments, or other metadata.
+  """
+  meta: Object
+
+  """Source of the value (e.g., system, user, external integration)."""
+  source: String
+
+  """The calculated numeric value for this KPI and period."""
+  value: Float
+
+  """
+  Date or period for which this KPI value is recorded (e.g., day, month, quarter).
+  """
+  valueDate: String
+
+  """Version of the KPI definition at the time this value is calculated."""
+  version: Int
+}
+
 """Entity for LiteMenu"""
 type LiteMenu {
   active: Boolean
@@ -4073,6 +4688,36 @@ type Mutation {
   """Creates a new board group."""
   createGroup(group: NewGroup!): Group
 
+  """Create a new KPI with the provided details."""
+  createKpi(
+    """Input object containing details for the new KPI."""
+    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 grade with the provided details."""
+  createKpiGrade(
+    """Input object containing details for the new KPI grade."""
+    grade: NewKpiGrade!
+  ): KpiGrade!
+
+  """Create a new KPI metric with the provided details."""
+  createKpiMetric(
+    """Input object containing details for the new KPI metric."""
+    metric: NewKpiMetric!
+  ): KpiMetric!
+
+  """Create a new KPI value with the provided details."""
+  createKpiValue(
+    """Input object containing details for the new KPI value."""
+    kpiValue: NewKpiValue!
+  ): KpiValue!
+
   """To create new LiteMenu"""
   createLiteMenu(liteMenu: NewLiteMenu!): LiteMenu!
 
@@ -4349,6 +4994,36 @@ type Mutation {
   """Deletes a board group."""
   deleteGroup(id: String!): Boolean!
 
+  """To delete Kpi"""
+  deleteKpi(id: String!): Boolean!
+
+  """To delete multiple KpiCategories"""
+  deleteKpiCategories(ids: [String!]!): Boolean!
+
+  """To delete KpiCategory"""
+  deleteKpiCategory(id: String!): Boolean!
+
+  """To delete KpiGrade"""
+  deleteKpiGrade(id: String!): Boolean!
+
+  """To delete multiple KpiGrades"""
+  deleteKpiGrades(ids: [String!]!): Boolean!
+
+  """To delete KpiMetric"""
+  deleteKpiMetric(id: String!): Boolean!
+
+  """To delete multiple KpiMetrics"""
+  deleteKpiMetrics(ids: [String!]!): Boolean!
+
+  """To delete KpiValue"""
+  deleteKpiValue(id: String!): Boolean!
+
+  """To delete multiple KpiValues"""
+  deleteKpiValues(ids: [String!]!): Boolean!
+
+  """To delete multiple Kpis"""
+  deleteKpis(ids: [String!]!): Boolean!
+
   """To delete LiteMenu"""
   deleteLiteMenu(id: String!): Boolean!
 
@@ -4612,6 +5287,21 @@ type Mutation {
   """
   importEmployees(employees: [EmployeePatch!]!): Boolean!
 
+  """To import multiple KpiCategories"""
+  importKpiCategories(kpiCategories: [KpiCategoryPatch!]!): Boolean!
+
+  """To import multiple KpiGrades"""
+  importKpiGrades(kpiGrades: [KpiGradePatch!]!): Boolean!
+
+  """To import multiple KpiMetrics"""
+  importKpiMetrics(kpiMetrics: [KpiMetricPatch!]!): Boolean!
+
+  """To import multiple KpiValues"""
+  importKpiValues(kpiValues: [KpiValuePatch!]!): Boolean!
+
+  """To import multiple Kpis"""
+  importKpis(kpis: [KpiPatch!]!): Boolean!
+
   """To import multiple MenuButtons"""
   importMenuButtons(menuButtons: [MenuButtonPatch!]!): Boolean!
 
@@ -4724,6 +5414,9 @@ type Mutation {
 
   """Releases a board, making it public and creating a version history."""
   releaseBoard(id: String!): Board!
+
+  """Release a KPI and create a version history."""
+  releaseKpi(id: String!): Kpi!
   renewApplicationAccessToken(id: String!, scope: String!): AccessToken!
 
   """Sets the custom playback order for boards in a play group."""
@@ -4743,6 +5436,9 @@ type Mutation {
   """Reverts a board to a specific historical version."""
   revertBoardVersion(id: String!, version: Float!): Board!
 
+  """Revert a KPI to a specific historical version."""
+  revertKpiVersion(id: String!, version: Float!): Kpi!
+
   """
   Runs a new scenario instance once and returns the result after it finishes.
   """
@@ -4924,6 +5620,21 @@ type Mutation {
   """Updates an existing board group."""
   updateGroup(id: String!, patch: GroupPatch!): Group!
 
+  """To modify Kpi information"""
+  updateKpi(id: String!, patch: KpiPatch!): Kpi!
+
+  """To modify KpiCategory information"""
+  updateKpiCategory(id: String!, patch: KpiCategoryPatch!): KpiCategory!
+
+  """To modify KpiGrade information"""
+  updateKpiGrade(id: String!, patch: KpiGradePatch!): KpiGrade!
+
+  """To modify KpiMetric information"""
+  updateKpiMetric(id: String!, patch: KpiMetricPatch!): KpiMetric!
+
+  """To modify KpiValue information"""
+  updateKpiValue(id: String!, patch: KpiValuePatch!): KpiValue!
+
   """To modify LiteMenu information"""
   updateLiteMenu(id: String!, patch: LiteMenuPatch!): LiteMenu!
 
@@ -5012,6 +5723,21 @@ type Mutation {
   """To modify multiple Entitys' information"""
   updateMultipleEntityColumn(patches: [EntityColumnPatch!]!): [EntityColumn!]!
 
+  """To modify multiple Kpis' information"""
+  updateMultipleKpi(patches: [KpiPatch!]!): Boolean!
+
+  """To modify multiple KpiCategories' information"""
+  updateMultipleKpiCategory(patches: [KpiCategoryPatch!]!): [KpiCategory!]!
+
+  """To modify multiple KpiGrades' information"""
+  updateMultipleKpiGrade(patches: [KpiGradePatch!]!): [KpiGrade!]!
+
+  """To modify multiple KpiMetrics' information"""
+  updateMultipleKpiMetric(patches: [KpiMetricPatch!]!): [KpiMetric!]!
+
+  """To modify multiple KpiValues' information"""
+  updateMultipleKpiValue(patches: [KpiValuePatch!]!): [KpiValue!]!
+
   """To modify multiple Menus' information"""
   updateMultipleMenu(patches: [MenuPatch!]!): [Menu!]!
 
@@ -5687,6 +6413,183 @@ input NewGroup {
   name: String!
 }
 
+"""
+Input type for creating a new KPI. Used in mutations to provide KPI details.
+"""
+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
+
+  """Name of the KPI."""
+  name: String!
+
+  """
+  Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
+  """
+  schedule: String
+
+  """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
+  state: KpiStatus
+
+  """Thumbnail image or file for this KPI."""
+  thumbnail: Upload
+
+  """Timezone for the KPI schedule."""
+  timezone: String
+
+  """
+  Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.
+  """
+  vizMeta: Object
+
+  """
+  Visualization type for this KPI (e.g., bar, line, gauge, progress, card, table, icon, badge, text).
+  """
+  vizType: String
+}
+
+"""
+Input type for creating a new KPI category. Used in mutations to provide category details.
+"""
+input NewKpiCategory {
+  active: Boolean
+
+  """Detailed description of this KPI category."""
+  description: String
+
+  """Name of the KPI category."""
+  name: String!
+
+  """ID of the parent category, if any."""
+  parentId: ID
+}
+
+"""
+Input type for creating a new KPI grade. Used in mutations to provide grade details.
+"""
+input NewKpiGrade {
+  """Indicates whether this KPI grade is active and usable."""
+  active: Boolean
+
+  """Color code for this grade (for visualization purposes)."""
+  color: String
+
+  """Detailed description of this KPI grade."""
+  description: String
+
+  """ID of the KPI to which this grade belongs."""
+  kpiId: ID!
+
+  """Maximum value for this grade section."""
+  maxValue: Int!
+
+  """Minimum value for this grade section."""
+  minValue: Int!
+
+  """Name of the grade or section for this KPI."""
+  name: String!
+
+  """Score or weight for this grade (optional)."""
+  score: Int
+
+  """Version of the KPI definition to which this grade belongs."""
+  version: Int!
+}
+
+"""
+Input type for creating a new KPI metric. Used in mutations to provide metric details.
+"""
+input NewKpiMetric {
+  """Indicates whether this metric is active and usable."""
+  active: Boolean
+
+  """ID of the source dataset for this metric."""
+  dataSetId: ID
+
+  """User-friendly name or description of the metric."""
+  description: String
+
+  """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!
+
+  """
+  Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
+  """
+  schedule: String
+
+  """Schedule ID for the registered cron job."""
+  scheduleId: String
+
+  """Source of the metric data (e.g., system, method, dataset)."""
+  source: String
+
+  """Thumbnail image or file for this metric."""
+  thumbnail: Upload
+
+  """Timezone for the schedule."""
+  timezone: String
+
+  """Unit of measurement for this metric (e.g., %, count, hours)."""
+  unit: String
+}
+
+"""
+Input type for creating a new KPI value. Used in mutations to provide KPI value details.
+"""
+input NewKpiValue {
+  """
+  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
+
+  """
+  Indicates whether this value was entered manually or generated automatically.
+  """
+  inputType: KpiValueInputType
+
+  """ID of the KPI to which this value belongs."""
+  kpiId: ID!
+
+  """
+  Extended or non-numeric information related to this KPI value, stored as JSON5. Can include grade, status, comments, or other metadata.
+  """
+  meta: Object
+
+  """Source of the value (e.g., system, user, external integration)."""
+  source: String
+
+  """The calculated numeric value for this KPI and period."""
+  value: Float!
+
+  """
+  Date or period for which this KPI value is recorded (e.g., day, month, quarter).
+  """
+  valueDate: String!
+
+  """Version of the KPI definition at the time this value is calculated."""
+  version: Int!
+}
+
 input NewLiteMenu {
   active: Boolean
   appName: String
@@ -7975,6 +8878,114 @@ type Query {
   invitation(email: EmailAddress!, reference: String!, type: String!): Invitation!
   invitations(reference: String!, type: String!): InvitationList!
 
+  """Fetch a single KPI by its unique identifier."""
+  kpi(
+    """Unique identifier of the KPI to fetch."""
+    id: String!
+  ): Kpi
+
+  """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 a single KPI grade by its unique identifier."""
+  kpiGrade(
+    """Unique identifier of the KPI grade to fetch."""
+    id: String!
+  ): KpiGrade
+
+  """To fetch multiple KpiGrades"""
+  kpiGrades(
+    """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!]
+  ): KpiGradeList!
+
+  """Fetch a single KPI metric by its unique identifier."""
+  kpiMetric(
+    """Unique identifier of the KPI metric to fetch."""
+    id: String!
+  ): KpiMetric
+
+  """To fetch multiple KpiMetrics"""
+  kpiMetrics(
+    """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!]
+  ): KpiMetricList!
+
+  """Fetch a single KPI value by its unique identifier."""
+  kpiValue(
+    """Unique identifier of the KPI value to fetch."""
+    id: String!
+  ): KpiValue
+
+  """To fetch multiple KpiValues"""
+  kpiValues(
+    """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!]
+  ): KpiValueList!
+
+  """To fetch multiple Kpis"""
+  kpis(
+    """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!]
+  ): KpiList!
+
   """To fetch a LiteMenu"""
   liteMenu(id: String!): LiteMenu!