@things-factory/kpi 9.2.5 → 10.0.0-beta.10

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

@@ -1,146 +0,0 @@
-import { Resolver, Query, FieldResolver, Root, Args, Arg, Ctx, Directive } from 'type-graphql'
-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 { KpiStatistic } from './kpi-statistic.js'
-import { KpiStatisticList } from './kpi-statistic-type.js'
-import { Kpi, KpiPeriodType } from '../kpi/kpi.js'
-import { KpiOrgScope } from '../kpi-org-scope/kpi-org-scope.js'
-
-@Resolver(KpiStatistic)
-export class KpiStatisticQuery {
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => KpiStatistic!, { nullable: true, description: 'To fetch a KpiStatistic' })
-  async kpiStatistic(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<KpiStatistic> {
-    const { domain } = context.state
-
-    return await getRepository(KpiStatistic).findOne({
-      where: { domain: { id: domain.id }, id }
-    })
-  }
-
-  @Query(returns => KpiStatisticList, { description: 'To fetch multiple KpiStatistics' })
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  async kpiStatistics(
-    @Args(type => ListParam) params: ListParam,
-    @Ctx() context: ResolverContext
-  ): Promise<KpiStatisticList> {
-    const { domain } = context.state
-
-    const queryBuilder = getQueryBuilderFromListParams({
-      domain,
-      params,
-      repository: await getRepository(KpiStatistic),
-      searchables: ['kpi', 'valueDate'],
-      filtersMap: {
-        kpi: { columnName: 'id', relationColumn: 'kpi' },
-        kpiOrgScope: { columnName: 'id', relationColumn: 'kpiOrgScope' },
-        periodType: { columnName: 'periodType' },
-        valueDate: { columnName: 'valueDate' },
-        scope02: { 
-          columnName: 'scope02', 
-          relationColumn: 'kpiOrgScope'
-        }
-      }
-    })
-
-    const [items, total] = await queryBuilder.getManyAndCount()
-
-    return { items, total }
-  }
-
-  @FieldResolver(type => Kpi)
-  async kpi(@Root() kpiStatistic: KpiStatistic): Promise<Kpi> {
-    return kpiStatistic.kpiId && (await getRepository(Kpi).findOneBy({ id: kpiStatistic.kpiId }))
-  }
-
-  @FieldResolver(type => Domain)
-  async domain(@Root() kpiStatistic: KpiStatistic): Promise<Domain> {
-    return kpiStatistic.domainId && (await getRepository(Domain).findOneBy({ id: kpiStatistic.domainId }))
-  }
-
-  @FieldResolver(type => User)
-  async updater(@Root() kpiStatistic: KpiStatistic): Promise<User> {
-    return kpiStatistic.updaterId && (await getRepository(User).findOneBy({ id: kpiStatistic.updaterId }))
-  }
-
-  @FieldResolver(type => User)
-  async creator(@Root() kpiStatistic: KpiStatistic): Promise<User> {
-    return kpiStatistic.creatorId && (await getRepository(User).findOneBy({ id: kpiStatistic.creatorId }))
-  }
-
-  @FieldResolver(type => KpiOrgScope)
-  async kpiOrgScope(@Root() kpiStatistic: KpiStatistic): Promise<KpiOrgScope> {
-    return kpiStatistic.kpiOrgScopeId && (await getRepository(KpiOrgScope).findOneBy({ id: kpiStatistic.kpiOrgScopeId }))
-  }
-
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => [KpiStatistic], { 
-    description: 'Get regional statistics for dashboard map visualization' 
-  })
-  async regionalKpiStatistics(
-    @Arg('valueDate') valueDate: string,
-    @Arg('periodType', type => KpiPeriodType, { defaultValue: KpiPeriodType.MONTH }) periodType: KpiPeriodType,
-    @Arg('regions', type => [String], { nullable: true }) regions: string[] | undefined,
-    @Ctx() context: ResolverContext
-  ): Promise<KpiStatistic[]> {
-    const { domain } = context.state
-    
-    const queryBuilder = getRepository(KpiStatistic)
-      .createQueryBuilder('stat')
-      .leftJoinAndSelect('stat.kpi', 'kpi')
-      .leftJoinAndSelect('stat.kpiOrgScope', 'orgScope')
-      .where('stat.domain = :domainId', { domainId: domain.id })
-      .andWhere('stat.periodType = :periodType', { periodType })
-      .andWhere('stat.valueDate = :valueDate', { valueDate })
-      .andWhere('orgScope.scope02 IS NOT NULL') // 지역 정보가 있는 것만
-      
-    if (regions && regions.length > 0) {
-      queryBuilder.andWhere('orgScope.scope02 IN (:...regions)', { regions })
-    }
-      
-    queryBuilder.orderBy('orgScope.scope02', 'ASC')
-      .addOrderBy('kpi.name', 'ASC')
-    
-    return await queryBuilder.getMany()
-  }
-
-  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
-  @Query(returns => [KpiStatistic], { 
-    description: 'Get aggregated statistics by scope02 (regional level) for dashboard' 
-  })
-  async dashboardRegionalStatistics(
-    @Arg('valueDate') valueDate: string,
-    @Arg('periodType', type => KpiPeriodType, { defaultValue: KpiPeriodType.MONTH }) periodType: KpiPeriodType,
-    @Ctx() context: ResolverContext
-  ): Promise<KpiStatistic[]> {
-    const { domain } = context.state
-    
-    // 지역별로 평균을 내서 하나의 통계로 합침
-    const query = `
-      SELECT 
-        'regional-aggregate-' || orgScope.scope02 as id,
-        kpi.id as kpiId,
-        kpi.name as kpiName,
-        orgScope.scope02 as region,
-        AVG(stat.mean) as avgMean,
-        AVG(stat.median) as avgMedian,
-        MIN(stat.minimum) as overallMin,
-        MAX(stat.maximum) as overallMax,
-        AVG(stat.standardDeviation) as avgStdDev,
-        SUM(stat.count) as totalCount,
-        COUNT(*) as orgCount
-      FROM kpi_statistic stat
-      LEFT JOIN kpi ON stat.kpiId = kpi.id
-      LEFT JOIN kpi_org_scope orgScope ON stat.kpiOrgScopeId = orgScope.id
-      WHERE stat.domainId = ?
-        AND stat.periodType = ?
-        AND stat.valueDate = ?
-        AND orgScope.scope02 IS NOT NULL
-      GROUP BY kpi.id, orgScope.scope02
-      ORDER BY orgScope.scope02, kpi.name
-    `
-    
-    return await getRepository(KpiStatistic).query(query, [domain.id, periodType, valueDate])
-  }
-}

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

@@ -1,152 +0,0 @@
-import { ObjectType, Field, InputType, Int, ID } from 'type-graphql'
-
-import { ObjectRef, ScalarObject } from '@things-factory/shell'
-import { KpiPeriodType } from '../kpi/kpi'
-
-import { KpiStatistic } from './kpi-statistic.js'
-
-@InputType()
-export class NewKpiStatistic {
-  @Field({ nullable: true })
-  kpi?: ObjectRef
-
-  @Field({
-    description:
-      '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
-
-  @Field(type => KpiPeriodType)
-  periodType: KpiPeriodType
-
-  // 핵심 통계 필드들
-  @Field({ nullable: true })
-  count?: number
-
-  @Field({ nullable: true })
-  sum?: number
-
-  @Field({ nullable: true })
-  range?: number
-
-  @Field({ nullable: true })
-  mean?: number
-
-  @Field({ nullable: true })
-  median?: number
-
-  @Field({ nullable: true })
-  minimum?: number
-
-  @Field({ nullable: true })
-  maximum?: number
-
-  @Field({ nullable: true })
-  standardDeviation?: number
-
-  @Field({ nullable: true })
-  variance?: number
-
-  @Field({ nullable: true })
-  percentile25?: number
-
-  @Field({ nullable: true })
-  percentile75?: number
-
-  @Field({ nullable: true })
-  iqr?: number
-
-  @Field({ nullable: true })
-  lowerFence?: number
-
-  @Field({ nullable: true })
-  upperFence?: number
-
-  // 확장 필드들
-  @Field(type => ScalarObject, { nullable: true })
-  additionalStatistics?: { [metricName: string]: number }
-
-  @Field(type => ScalarObject, { nullable: true })
-  metadata?: { [key: string]: any }
-}
-
-@InputType()
-export class KpiStatisticPatch {
-  @Field(type => ID, { nullable: true })
-  id?: string
-
-  @Field({ nullable: true })
-  kpi?: ObjectRef
-
-  @Field({
-    nullable: true,
-    description:
-      '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
-
-  @Field(type => KpiPeriodType, { nullable: true })
-  periodType?: KpiPeriodType
-
-  // 핵심 통계 필드들
-  @Field({ nullable: true })
-  count?: number
-
-  @Field({ nullable: true })
-  sum?: number
-
-  @Field({ nullable: true })
-  range?: number
-
-  @Field({ nullable: true })
-  mean?: number
-
-  @Field({ nullable: true })
-  median?: number
-
-  @Field({ nullable: true })
-  minimum?: number
-
-  @Field({ nullable: true })
-  maximum?: number
-
-  @Field({ nullable: true })
-  standardDeviation?: number
-
-  @Field({ nullable: true })
-  variance?: number
-
-  @Field({ nullable: true })
-  percentile25?: number
-
-  @Field({ nullable: true })
-  percentile75?: number
-
-  @Field({ nullable: true })
-  iqr?: number
-
-  @Field({ nullable: true })
-  lowerFence?: number
-
-  @Field({ nullable: true })
-  upperFence?: number
-
-  // 확장 필드들
-  @Field(type => ScalarObject, { nullable: true })
-  additionalStatistics?: { [metricName: string]: number }
-
-  @Field(type => ScalarObject, { nullable: true })
-  metadata?: { [key: string]: any }
-
-  @Field({ nullable: true })
-  cuFlag?: string
-}
-
-@ObjectType()
-export class KpiStatisticList {
-  @Field(type => [KpiStatistic])
-  items: KpiStatistic[]
-
-  @Field(type => Int)
-  total: number
-}

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

@@ -1,199 +0,0 @@
-import {
-  CreateDateColumn,
-  UpdateDateColumn,
-  Entity,
-  Index,
-  Column,
-  RelationId,
-  ManyToOne,
-  PrimaryGeneratedColumn
-} from 'typeorm'
-import { ObjectType, Field, Int, ID } from 'type-graphql'
-
-import { Domain, ScalarObject } from '@things-factory/shell'
-import { User } from '@things-factory/auth-base'
-import { Kpi, KpiPeriodType } from '../kpi/kpi'
-import { KpiOrgScope } from '../kpi-org-scope/kpi-org-scope'
-
-@Entity()
-@Index('ix_kpi_statistic_target', (kpiStatistic: KpiStatistic) => [kpiStatistic.domain, kpiStatistic.kpi])
-@Index('ix_kpi_statistic_period', (kpiStatistic: KpiStatistic) => [
-  kpiStatistic.domain,
-  kpiStatistic.valueDate,
-  kpiStatistic.periodType
-])
-@Index('ix_kpi_statistic_scope', (kpiStatistic: KpiStatistic) => [
-  kpiStatistic.domain,
-  kpiStatistic.kpi,
-  kpiStatistic.kpiOrgScope,
-  kpiStatistic.valueDate
-])
-@Index('ix_kpi_statistic_legacy_scope', (kpiStatistic: KpiStatistic) => [
-  kpiStatistic.domain,
-  kpiStatistic.kpi,
-  kpiStatistic.scope,
-  kpiStatistic.valueDate
-])
-@ObjectType({
-  description:
-    '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.'
-})
-export class KpiStatistic {
-  @PrimaryGeneratedColumn('uuid')
-  @Field(type => ID)
-  readonly id: string
-
-  // === 대상 정보 ===
-
-  @ManyToOne(() => Kpi)
-  @Field(type => Kpi, {
-    nullable: true,
-    description: 'Reference to the KPI definition for which this value is calculated.'
-  })
-  kpi: Kpi
-
-  @RelationId((kpiStatistic: KpiStatistic) => kpiStatistic.kpi)
-  kpiId: string
-
-  // === 통계 기간 ===
-  @Column()
-  @Field({
-    description:
-      '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
-
-  @Column({ default: 'DAY' })
-  @Field(type => KpiPeriodType, { description: 'Aggregation period type for this statistic.' })
-  periodType: KpiPeriodType
-
-  // === 스코프 정보 ===
-  
-  @ManyToOne(() => KpiOrgScope, { nullable: true })
-  @Field(type => KpiOrgScope, {
-    nullable: true,
-    description: 'Organization scope for scoped statistics. Null for overall statistics.'
-  })
-  kpiOrgScope?: KpiOrgScope
-
-  @RelationId((kpiStatistic: KpiStatistic) => kpiStatistic.kpiOrgScope)
-  kpiOrgScopeId?: string
-
-  @Column({ nullable: true })
-  @Field({ 
-    nullable: true, 
-    description: 'Legacy scope field - use kpiOrgScope instead. Statistical scope - null for overall statistics, category value for scoped statistics (e.g., "서울", "부장", "대규모")'
-  })
-  scope?: string
-
-  // === 핵심 통계 필드 (14개) ===
-
-  // 1. 기본 정보 (3개)
-  @Column({ nullable: true })
-  @Field({ nullable: true, description: 'Number of data points used in calculation' })
-  count?: number // 데이터 개수
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Sum of all values in the dataset' })
-  sum?: number // 합계
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Range of values (maximum - minimum)' })
-  range?: number // 범위
-
-  // 2. 중심 경향 (2개)
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Arithmetic mean of all values' })
-  mean?: number // 평균
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Middle value when data is sorted (50th percentile)' })
-  median?: number // 중앙값
-
-  // 3. 범위 (2개)
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Minimum value in the dataset' })
-  minimum?: number // 최소값
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Maximum value in the dataset' })
-  maximum?: number // 최대값
-
-  // 4. 분산 (2개)
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Standard deviation - measure of data dispersion' })
-  standardDeviation?: number // 표준편차
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Variance - square of standard deviation' })
-  variance?: number // 분산
-
-  // 5. 분위수 (5개)
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: '25th percentile - 25% of data is below this value' })
-  percentile25?: number // 25분위수
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: '75th percentile - 75% of data is below this value' })
-  percentile75?: number // 75분위수
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Interquartile range (75th percentile - 25th percentile)' })
-  iqr?: number // 사분위수 범위
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Lower fence for outlier detection (Q1 - 1.5 * IQR)' })
-  lowerFence?: number // 하위 울타리
-
-  @Column({ type: 'float', nullable: true })
-  @Field({ nullable: true, description: 'Upper fence for outlier detection (Q3 + 1.5 * IQR)' })
-  upperFence?: number // 상위 울타리
-
-  // === 확장 가능한 필드 (JSON) ===
-  @Column('simple-json', { nullable: true })
-  @Field(type => ScalarObject, {
-    nullable: true,
-    description: 'Additional statistical metrics stored as key-value pairs'
-  })
-  additionalStatistics: {
-    [metricName: string]: number
-  }
-
-  // === 메타데이터 (JSON) ===
-  @Column('simple-json', { nullable: true })
-  @Field(type => ScalarObject, {
-    nullable: true,
-    description: 'Calculation metadata including method, timestamp, and data quality information'
-  })
-  metadata: { [key: string]: any }
-
-  // === 표준 필드들 ===
-  @ManyToOne(type => Domain)
-  @Field({ nullable: true, description: 'Domain this statistic belongs to' })
-  domain?: Domain
-
-  @RelationId((kpiStatistic: KpiStatistic) => kpiStatistic.domain)
-  domainId?: string
-
-  @CreateDateColumn()
-  @Field({ nullable: true, description: 'Timestamp when this statistic was created' })
-  createdAt?: Date
-
-  @UpdateDateColumn()
-  @Field({ nullable: true, description: 'Timestamp when this statistic was last updated' })
-  updatedAt?: Date
-
-  @ManyToOne(type => User, { nullable: true })
-  @Field(type => User, { nullable: true, description: 'User who created this statistic' })
-  creator?: User
-
-  @RelationId((kpiStatistic: KpiStatistic) => kpiStatistic.creator)
-  creatorId?: string
-
-  @ManyToOne(type => User, { nullable: true })
-  @Field(type => User, { nullable: true, description: 'User who last updated this statistic' })
-  updater?: User
-
-  @RelationId((kpiStatistic: KpiStatistic) => kpiStatistic.updater)
-  updaterId?: string
-}

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

@@ -1,7 +0,0 @@
-import { KpiValue } from './kpi-value'
-import { KpiValueQuery } from './kpi-value-query'
-import { KpiValueMutation } from './kpi-value-mutation'
-
-export const entities = [KpiValue]
-export const resolvers = [KpiValueQuery, KpiValueMutation]
-export const subscribers = []