@things-factory/kpi 9.1.19 → 10.0.0-beta.2

package/server/service/kpi/kpi-query.ts

@@ -1,224 +0,0 @@
-import { IsNull } from 'typeorm'
-import { Resolver, Query, FieldResolver, Root, Args, Arg, Ctx, Directive } from 'type-graphql'
-import { Attachment } from '@things-factory/attachment-base'
-import { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'
-import { User } from '@things-factory/auth-base'
-import type ResolverContext from '@things-factory/auth-base'
-import { Kpi } from './kpi'
-import { KpiList } from './kpi-type'
-import { KpiValue } from '../kpi-value/kpi-value'
-import { KpiHistory } from './kpi-history'
-import { Int } from 'type-graphql'
-
-@Resolver(Kpi)
-export class KpiQuery {
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => [Kpi], { description: 'Fetch root KPIs (KPIs without parent)' })
-  async kpisLevel0(@Ctx() context: ResolverContext): Promise<Kpi[]> {
-    const { domain } = context.state
-
-    return await getRepository(Kpi).find({
-      where: { domain: { id: domain.id }, parent: null },
-      order: { name: 'ASC' }
-    })
-  }
-
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => [Kpi], {
-    description:
-      '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)'
-  })
-  async kpisLevel1(
-    @Arg('rootId', {
-      nullable: true,
-      description: 'ID of the parent KPI to get level 1 children. If not provided, returns all level 1 KPIs'
-    })
-    rootId: string,
-    @Ctx() context: ResolverContext
-  ): Promise<Kpi[]> {
-    const { domain } = context.state
-
-    let whereCondition: any = { domain: { id: domain.id } }
-
-    if (rootId) {
-      // 특정 부모의 자식들
-      whereCondition.parent = { id: rootId }
-    } else {
-      // 모든 level 1 KPI들 (root KPI들의 직계 자식들)
-      // 부모가 있으면서 부모의 부모가 null인 KPI들
-      const kpis = await getRepository(Kpi)
-        .createQueryBuilder('kpi')
-        .leftJoinAndSelect('kpi.parent', 'parent')
-        .leftJoinAndSelect('kpi.children', 'children')
-        .leftJoinAndSelect('children.children', 'grandchildren')
-        .where('kpi.domain = :domainId', { domainId: domain.id })
-        .andWhere('parent.id IS NOT NULL')
-        .andWhere('parent.parent IS NULL')
-        .orderBy('kpi.name', 'ASC')
-        .getMany()
-
-      return kpis
-    }
-
-    // rootId 제공된 경우
-    const kpis = await getRepository(Kpi).find({
-      where: whereCondition,
-      relations: ['children', 'children.children'],
-      order: { name: 'ASC' }
-    })
-
-    return kpis
-  }
-
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => Kpi!, { nullable: true, description: 'Fetch a single KPI by its unique identifier.' })
-  async kpi(
-    @Arg('id', { description: 'Unique identifier of the KPI to fetch.' }) id: string,
-    @Ctx() context: ResolverContext
-  ): Promise<Kpi> {
-    const { domain } = context.state
-
-    return await getRepository(Kpi).findOne({
-      where: { domain: { id: domain.id }, id }
-    })
-  }
-
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => KpiList, { description: 'To fetch multiple Kpis' })
-  async kpis(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<KpiList> {
-    const { domain } = context.state
-
-    const queryBuilder = getQueryBuilderFromListParams({
-      domain,
-      params,
-      repository: await getRepository(Kpi),
-      searchables: ['name', 'description'],
-      filtersMap: {
-        parent: { columnName: 'id', relationColumn: 'parent' }
-      }
-    })
-
-    const [items, total] = await queryBuilder.getManyAndCount()
-
-    return { items, total }
-  }
-
-  @FieldResolver(type => [Kpi])
-  children(@Root() kpi: Kpi): Promise<Kpi[]> {
-    return getRepository(Kpi).find({
-      where: { parent: { id: kpi.id } }
-    })
-  }
-
-  @FieldResolver(type => String)
-  async thumbnail(@Root() kpi: Kpi): Promise<string | undefined> {
-    const attachment: Attachment = await getRepository(Attachment).findOne({
-      where: {
-        domain: { id: kpi.domainId },
-        refType: Kpi.name,
-        refBy: kpi.id
-      }
-    })
-
-    return attachment?.fullpath
-  }
-
-  @FieldResolver(type => Domain)
-  async domain(@Root() kpi: Kpi): Promise<Domain> {
-    return kpi.domainId && (await getRepository(Domain).findOneBy({ id: kpi.domainId }))
-  }
-
-  @FieldResolver(type => User)
-  async updater(@Root() kpi: Kpi): Promise<User> {
-    return kpi.updaterId && (await getRepository(User).findOneBy({ id: kpi.updaterId }))
-  }
-
-  @FieldResolver(type => User)
-  async creator(@Root() kpi: Kpi): Promise<User> {
-    return kpi.creatorId && (await getRepository(User).findOneBy({ id: kpi.creatorId }))
-  }
-
-  @FieldResolver(type => KpiValue, { nullable: true })
-  async value(
-    @Root() kpi: Kpi,
-    @Ctx() context,
-    @Arg('orgScope', { nullable: true, description: 'Organization scope filter for value' }) orgScope?: string
-  ): Promise<KpiValue | null> {
-    const { domain } = context.state
-
-    let whereCondition: any = {
-      domain: { id: domain.id },
-      kpi: { id: kpi.id }
-    }
-
-    // orgScope 필터가 있으면 KpiOrgScope로 필터링
-    if (orgScope) {
-      whereCondition.kpiOrgScope = { org: orgScope }
-    }
-
-    return await getRepository(KpiValue).findOne({
-      where: whereCondition,
-      relations: ['kpiOrgScope'],
-      order: { valueDate: 'DESC' }
-    })
-  }
-
-  @FieldResolver(type => Number, { nullable: true })
-  targetValue(@Root() kpi: Kpi): number | undefined {
-    return kpi.vizMeta?.targetValue
-  }
-
-  @FieldResolver(type => String, { nullable: true })
-  unit(@Root() kpi: Kpi): string | undefined {
-    return kpi.vizMeta?.unit
-  }
-
-  @FieldResolver(type => Kpi, { nullable: true })
-  async parent(@Root() kpi: Kpi): Promise<Kpi | null> {
-    if (!kpi.parentId) return null
-    return await getRepository(Kpi).findOneBy({ id: kpi.parentId })
-  }
-
-  @FieldResolver(type => [KpiHistory], { nullable: true })
-  async histories(
-    @Root() kpi: Kpi,
-    @Ctx() context,
-    @Arg('limit', type => Int, { nullable: true }) limit?: number
-  ): Promise<KpiHistory[]> {
-    const { domain } = context.state
-    const qb = getRepository(KpiHistory)
-      .createQueryBuilder('history')
-      .where('history.domain = :domainId', { domainId: domain.id })
-      .andWhere('history.originalId = :kpiId', { kpiId: kpi.id })
-      .orderBy('history.updatedAt', 'DESC')
-    if (limit) qb.limit(limit)
-    else qb.limit(1)
-    return await qb.getMany()
-  }
-
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => [Kpi], { description: 'Fetch KPIs in hierarchical tree structure' })
-  async kpiTree(@Ctx() context: ResolverContext): Promise<Kpi[]> {
-    const { domain } = context.state
-
-    return await getRepository(Kpi).find({
-      where: { domain: { id: domain.id }, parent: IsNull() },
-      relations: ['children', 'children.children', 'children.children.children'],
-      order: { name: 'ASC' }
-    })
-  }
-
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => [Kpi], { description: 'Fetch child KPIs of a given parent KPI' })
-  async kpiChildren(
-    @Arg('parentId', { description: 'ID of the parent KPI' }) parentId: string,
-    @Ctx() context: ResolverContext
-  ): Promise<Kpi[]> {
-    const { domain } = context.state
-
-    return await getRepository(Kpi).find({
-      where: { domain: { id: domain.id }, parent: { id: parentId } },
-      order: { name: 'ASC' }
-    })
-  }
-}

package/server/service/kpi/kpi-type.ts

@@ -1,151 +0,0 @@
-import type { FileUpload } from 'graphql-upload/GraphQLUpload.js'
-import GraphQLUpload from 'graphql-upload/GraphQLUpload.js'
-import { ObjectType, Field, InputType, Int, ID, registerEnumType } from 'type-graphql'
-
-import { ObjectRef, ScalarObject } from '@things-factory/shell'
-
-import { Kpi, KpiStatus, KpiVizType } from './kpi'
-import { KpiScores } from './kpi-grade.types'
-
-@InputType({ description: 'Input type for creating a new KPI. Used in mutations to provide KPI details.' })
-export class NewKpi {
-  @Field({ description: 'Name of the KPI.' })
-  name: string
-
-  @Field({ nullable: true, description: 'Detailed description of the KPI.' })
-  description?: string
-
-  @Field(type => ObjectRef, { nullable: true, description: 'Reference to the parent KPI in hierarchical structure.' })
-  parent?: ObjectRef
-
-  @Field({ nullable: true, description: 'Indicates whether this KPI is a leaf node (has actual measured values).' })
-  isLeaf?: boolean
-
-  @Field({ nullable: true, description: 'Calculation formula for the KPI, using metric codes and operators.' })
-  formula?: string
-
-  @Field({ nullable: true, description: 'Indicates whether this KPI is active and usable.' })
-  active?: boolean
-
-  @Field(type => KpiStatus, { nullable: true, description: 'Current state of the KPI (DRAFT, RELEASED, ARCHIVED).' })
-  state?: KpiStatus
-
-  @Field(type => GraphQLUpload, { nullable: true, description: 'Thumbnail image or file for this KPI.' })
-  thumbnail?: FileUpload
-
-  @Field(type => KpiVizType, {
-    nullable: true,
-    description: 'Visualization type for this KPI (e.g., CARD, GAUGE, PROGRESS, BAR, LINE, etc.).'
-  })
-  vizType?: KpiVizType
-
-  @Field(type => ScalarObject, {
-    nullable: true,
-    description:
-      'Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.'
-  })
-  vizMeta?: any
-
-  @Field({
-    nullable: true,
-    description: 'Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).'
-  })
-  schedule?: string
-
-  @Field({ nullable: true, description: 'Timezone for the KPI schedule.' })
-  timezone?: string
-
-  @Field({ nullable: true, description: 'Weight for aggregation in parent category.' })
-  weight?: number
-
-  @Field(type => ScalarObject, {
-    nullable: true,
-    description: 'Score lookup table for this KPI version'
-  })
-  grades?: KpiScores
-
-  @Field({
-    nullable: true,
-    description: 'Score calculation formula for this KPI. Converts KPI value to performance score (0-1).'
-  })
-  scoreFormula?: string
-}
-
-@InputType({ description: 'Input type for updating an existing KPI. Used in mutations to patch KPI details.' })
-export class KpiPatch {
-  @Field(type => ID, { nullable: true, description: 'ID of the KPI to update.' })
-  id?: string
-
-  @Field({ nullable: true, description: 'Name of the KPI.' })
-  name?: string
-
-  @Field({ nullable: true, description: 'Detailed description of the KPI.' })
-  description?: string
-
-  @Field(type => ObjectRef, { nullable: true, description: 'Reference to the parent KPI in hierarchical structure.' })
-  parent?: ObjectRef
-
-  @Field({ nullable: true, description: 'Indicates whether this KPI is a leaf node (has actual measured values).' })
-  isLeaf?: boolean
-
-  @Field({ nullable: true, description: 'Calculation formula for the KPI, using metric codes and operators.' })
-  formula?: string
-
-  @Field({ nullable: true, description: 'Indicates whether this KPI is active and usable.' })
-  active?: boolean
-
-  @Field(type => KpiStatus, { nullable: true, description: 'Current state of the KPI (DRAFT, RELEASED, ARCHIVED).' })
-  state?: KpiStatus
-
-  @Field(type => GraphQLUpload, { nullable: true, description: 'Thumbnail image or file for this KPI.' })
-  thumbnail?: FileUpload
-
-  @Field(type => KpiVizType, {
-    nullable: true,
-    description: 'Visualization type for this KPI (e.g., CARD, GAUGE, PROGRESS, BAR, LINE, etc.).'
-  })
-  vizType?: KpiVizType
-
-  @Field(type => ScalarObject, {
-    nullable: true,
-    description:
-      'Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.'
-  })
-  vizMeta?: any
-
-  @Field({ nullable: true, description: 'Custom flag for update operations (internal use).' })
-  cuFlag?: string
-
-  @Field({
-    nullable: true,
-    description: 'Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).'
-  })
-  schedule?: string
-
-  @Field({ nullable: true, description: 'Timezone for the KPI schedule.' })
-  timezone?: string
-
-  @Field({ nullable: true, description: 'Weight for aggregation in parent category.' })
-  weight?: number
-
-  @Field(type => ScalarObject, {
-    nullable: true,
-    description: 'Score lookup table for this KPI version'
-  })
-  grades?: KpiScores
-
-  @Field({
-    nullable: true,
-    description: 'Score calculation formula for this KPI. Converts KPI value to performance score (0-1).'
-  })
-  scoreFormula?: string
-}
-
-@ObjectType()
-export class KpiList {
-  @Field(type => [Kpi])
-  items: Kpi[]
-
-  @Field(type => Int)
-  total: number
-}

package/server/service/kpi/kpi.ts

@@ -1,254 +0,0 @@
-import {
-  CreateDateColumn,
-  UpdateDateColumn,
-  DeleteDateColumn,
-  Entity,
-  Index,
-  Column,
-  RelationId,
-  ManyToOne,
-  OneToMany,
-  VersionColumn,
-  PrimaryGeneratedColumn
-} from 'typeorm'
-import { ObjectType, Field, Int, ID, registerEnumType } from 'type-graphql'
-
-import { Domain } from '@things-factory/shell'
-import { User } from '@things-factory/auth-base'
-import { config } from '@things-factory/env'
-import { ScalarObject } from '@things-factory/shell'
-
-import { KpiScores } from './kpi-grade.types'
-
-const ORMCONFIG = config.get('ormconfig', {})
-const DATABASE_TYPE = ORMCONFIG.type
-
-export enum KpiStatus {
-  DRAFT = 'DRAFT',
-  RELEASE = 'RELEASE',
-  ARCHIVED = 'ARCHIVED'
-}
-
-export enum KpiVizType {
-  CARD = 'CARD',
-  GAUGE = 'GAUGE',
-  PROGRESS = 'PROGRESS',
-  BAR = 'BAR',
-  LINE = 'LINE',
-  PIE = 'PIE',
-  DONUT = 'DONUT',
-  RADAR = 'RADAR',
-  BULLET = 'BULLET',
-  THERMOMETER = 'THERMOMETER',
-  SPEEDOMETER = 'SPEEDOMETER',
-  ICON = 'ICON',
-  BADGE = 'BADGE',
-  TEXT = 'TEXT',
-  TABLE = 'TABLE'
-}
-
-export enum KpiPeriodType {
-  DAY = 'DAY',
-  WEEK = 'WEEK',
-  MONTH = 'MONTH',
-  QUARTER = 'QUARTER',
-  YEAR = 'YEAR',
-  RANGE = 'RANGE',
-  ALLTIME = 'ALLTIME'
-}
-
-registerEnumType(KpiStatus, {
-  name: 'KpiStatus',
-  description: 'State enumeration of a KPI (DRAFT, RELEASED, ARCHIVED)'
-})
-
-registerEnumType(KpiVizType, {
-  name: 'KpiVizType',
-  description: 'Visualization type for KPI display (CARD, GAUGE, PROGRESS, etc.)'
-})
-
-registerEnumType(KpiPeriodType, {
-  name: 'KpiPeriodType',
-  description: 'Aggregation period type for KPI (DAY, WEEK, MONTH, QUARTER, RANGE, ALLTIME)'
-})
-
-@Entity()
-@Index('ix_kpi_0', (kpi: Kpi) => [kpi.domain, kpi.name], {
-  where: '"deleted_at" IS NULL',
-  unique: true
-})
-@Index('ix_kpi_hierarchy', (kpi: Kpi) => [kpi.domain, kpi.parent], {
-  where: '"deleted_at" IS NULL'
-})
-@ObjectType({
-  description:
-    'KPI entity. Represents a key performance indicator with calculation formula, target, category, and other attributes.'
-})
-export class Kpi {
-  @PrimaryGeneratedColumn('uuid')
-  @Field(type => ID, { description: 'Unique identifier for this KPI.' })
-  readonly id: string
-
-  @VersionColumn()
-  @Field({
-    nullable: true,
-    description:
-      '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?: number = 1
-
-  @ManyToOne(type => Domain)
-  @Field({ nullable: true, description: 'Domain (tenant) to which this KPI belongs.' })
-  domain?: Domain
-
-  @RelationId((kpi: Kpi) => kpi.domain)
-  @Field({ nullable: true, description: 'ID of the domain (tenant) for this KPI.' })
-  domainId?: string
-
-  @Column()
-  @Field({ nullable: true, description: 'Name of the KPI.' })
-  name?: string
-
-  @Column({ nullable: true })
-  @Field({ nullable: true, description: 'Detailed description of the KPI.' })
-  description?: string
-
-  @ManyToOne(() => Kpi, { nullable: true })
-  @Field(type => Kpi, { nullable: true, description: 'Parent KPI in hierarchical structure.' })
-  parent?: Kpi
-
-  @RelationId((kpi: Kpi) => kpi.parent)
-  @Field({ nullable: true, description: 'ID of the parent KPI.' })
-  parentId?: string
-
-  @OneToMany(() => Kpi, kpi => kpi.parent)
-  @Field(type => [Kpi], { nullable: true, description: 'Child KPIs in hierarchical structure.' })
-  children?: Kpi[]
-
-  @Column({ nullable: false, default: true })
-  @Field({ nullable: true, description: 'Indicates whether this KPI is a leaf node (has actual measured values).' })
-  isLeaf?: boolean
-
-  @Column({
-    nullable: true,
-    type:
-      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
-        ? 'longtext'
-        : DATABASE_TYPE == 'oracle'
-          ? 'clob'
-          : DATABASE_TYPE == 'mssql'
-            ? 'nvarchar'
-            : 'varchar',
-    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined
-  })
-  @Field({
-    nullable: true,
-    description:
-      'Calculation formula for the KPI. Expressed as a string using metric codes and operators, e.g., "defect_count / total_count * 100".'
-  })
-  formula?: string
-
-  @Column({ nullable: false, default: false })
-  @Field({ nullable: true, description: 'Indicates whether this KPI is active and usable.' })
-  active?: boolean
-
-  @Column({ nullable: true })
-  @Field({ nullable: true, description: 'Current state of the KPI (DRAFT, RELEASED, ARCHIVED).' })
-  state?: KpiStatus
-
-  @Column({ nullable: true })
-  @Field(type => KpiVizType, {
-    nullable: true,
-    description: 'Visualization type for this KPI (e.g., CARD, GAUGE, PROGRESS, BAR, LINE, etc.).'
-  })
-  vizType?: KpiVizType
-
-  @Column({ type: 'json', nullable: true })
-  @Field(type => ScalarObject, {
-    nullable: true,
-    description:
-      'Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, min/max values, etc.'
-  })
-  vizMeta?: any
-
-  @Column({ nullable: true })
-  @Field({
-    nullable: true,
-    description: 'Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).'
-  })
-  schedule?: string
-
-  @Column({ nullable: true })
-  @Field({ nullable: true, description: 'Schedule ID for the KPI (used for scheduler registration).' })
-  scheduleId?: string
-
-  @Column({ nullable: true })
-  @Field({ nullable: true, description: 'Timezone for the KPI schedule.' })
-  timezone?: string
-
-  @Column({ default: 'DAY' })
-  @Field(type => KpiPeriodType, { description: 'Aggregation period type for this KPI.' })
-  periodType: KpiPeriodType
-
-  @Column({ type: 'float', nullable: true, default: 1 })
-  @Field({ nullable: true, description: 'Weight for aggregation in parent category.' })
-  weight?: number
-
-  @Column({ type: 'simple-json', nullable: true })
-  @Field(type => ScalarObject, {
-    nullable: true,
-    description:
-      'Performance index lookup table for complex transformations. @deprecated 향후 제거 예정. performanceFormula 사용 권장.'
-  })
-  grades?: KpiScores
-
-  @Column({
-    nullable: true,
-    type:
-      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
-        ? 'longtext'
-        : DATABASE_TYPE == 'oracle'
-          ? 'clob'
-          : DATABASE_TYPE == 'mssql'
-            ? 'nvarchar'
-            : 'varchar',
-    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined
-  })
-  @Field({
-    nullable: true,
-    description:
-      '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
-
-  @CreateDateColumn()
-  @Field({ nullable: true, description: 'Timestamp when this KPI was created.' })
-  createdAt?: Date
-
-  @UpdateDateColumn()
-  @Field({ nullable: true, description: 'Timestamp when this KPI was last updated.' })
-  updatedAt?: Date
-
-  @DeleteDateColumn()
-  @Field({ nullable: true, description: 'Timestamp when this KPI was deleted (soft delete).' })
-  deletedAt?: Date
-
-  @ManyToOne(type => User, { nullable: true })
-  @Field(type => User, { nullable: true, description: 'User who created this KPI.' })
-  creator?: User
-
-  @RelationId((kpi: Kpi) => kpi.creator)
-  @Field({ nullable: true, description: 'ID of the user who created this KPI.' })
-  creatorId?: string
-
-  @ManyToOne(type => User, { nullable: true })
-  @Field(type => User, { nullable: true, description: 'User who last updated this KPI.' })
-  updater?: User
-
-  @RelationId((kpi: Kpi) => kpi.updater)
-  @Field({ nullable: true, description: 'ID of the user who last updated this KPI.' })
-  updaterId?: string
-
-  @Field(type => String, { nullable: true, description: 'Thumbnail image or file path for this KPI.' })
-  thumbnail?: string
-}

package/server/service/kpi-alert/index.ts

@@ -1,3 +0,0 @@
-import { KpiAlertQuery } from './kpi-alert-query'
-
-export const resolvers = [KpiAlertQuery]

package/server/service/kpi-alert/kpi-alert-query.ts

@@ -1,59 +0,0 @@
-import { Directive, Resolver, Query, Ctx } from 'type-graphql'
-import { getRepository } from '@things-factory/shell'
-import { Kpi } from '../kpi/kpi'
-import { KpiValue } from '../kpi-value/kpi-value'
-import { KpiAlert } from './kpi-alert-type'
-
-@Resolver()
-export class KpiAlertQuery {
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => [KpiAlert], { description: 'KPI 실적/등급/목표 미달 등 경고/알림 리스트 반환' })
-  async kpiAlerts(@Ctx() context): Promise<KpiAlert[]> {
-    const { domain } = context.state
-    // 1. KPI 전체 조회
-    const kpis = await getRepository(Kpi).find({ where: { domain: { id: domain.id } } })
-    // 2. KPI별 최신 실적값 조회
-    const alerts: KpiAlert[] = []
-    for (const kpi of kpis) {
-      const value = await getRepository(KpiValue).findOne({
-        where: { domain: { id: domain.id }, kpi: { id: kpi.id } },
-        order: { valueDate: 'DESC' }
-      })
-      if (!value) {
-        alerts.push({
-          id: `${kpi.id}-no-value`,
-          kpi,
-          message: `${kpi.name} 실적값 미입력`,
-          level: 'info',
-          createdAt: new Date()
-        })
-        continue
-      }
-      // 목표값(예: kpi.vizMeta?.targetValue) 기준 경고
-      const target = kpi.vizMeta?.targetValue
-      if (target !== undefined && value.value < target) {
-        alerts.push({
-          id: `${kpi.id}-target-miss`,
-          kpi,
-          message: `${kpi.name} 실적(${value.value})이 목표(${target}) 미달`,
-          level: 'warning',
-          createdAt: new Date()
-        })
-      }
-      // 등급 기준 경고(예: 최하위 등급)
-      // if (kpi.grades?.length) {
-      //   const grade = kpi.grades.find(g => value.value >= g.minValue && value.value <= g.maxValue)
-      //   if (grade && grade.score !== undefined && grade.score <= 2) {
-      //     alerts.push({
-      //       id: `${kpi.id}-grade-low`,
-      //       kpi,
-      //       message: `${kpi.name} 등급(${grade.name})(${grade.score}점)`,
-      //       level: 'critical',
-      //       createdAt: new Date()
-      //     })
-      //   }
-      // }
-    }
-    return alerts
-  }
-}