@things-factory/kpi 10.1.248 → 10.1.250

package/dist-server/service/kpi-statistic/kpi-statistic-batch.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-statistic-batch.service.js","sourceRoot":"","sources":["../../../server/service/kpi-statistic/kpi-statistic-batch.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository } from '@things-factory/shell'\nimport type ResolverContext from '@things-factory/auth-base'\nimport { KpiStatisticCalculationService } from './kpi-statistic-calculation.service'\nimport { KpiPeriodType } from '../kpi/kpi'\nimport { Domain } from '@things-factory/shell'\n\n/**\n * KPI 통계 배치 계산 서비스\n * 정기적으로 실행하여 KpiValue 데이터를 집계해서 KpiStatistic을 생성/업데이트\n */\nexport class KpiStatisticBatchService {\n  \n  /**\n   * 일일 배치: 어제 날짜의 모든 통계 계산\n   */\n  static async runDailyBatch(domainId?: string): Promise<void> {\n    console.log('[KPI Statistics] Starting daily batch calculation...')\n    \n    const yesterday = new Date()\n    yesterday.setDate(yesterday.getDate() - 1)\n    const valueDate = yesterday.toISOString().split('T')[0] // YYYY-MM-DD\n    \n    await this.calculateForAllDomains(KpiPeriodType.DAY, valueDate, domainId)\n    \n    console.log(`[KPI Statistics] Daily batch completed for ${valueDate}`)\n  }\n  \n  /**\n   * 월간 배치: 지난 달의 모든 통계 계산\n   */\n  static async runMonthlyBatch(domainId?: string): Promise<void> {\n    console.log('[KPI Statistics] Starting monthly batch calculation...')\n    \n    const lastMonth = new Date()\n    lastMonth.setMonth(lastMonth.getMonth() - 1)\n    const valueDate = lastMonth.toISOString().substring(0, 7) // YYYY-MM\n    \n    await this.calculateForAllDomains(KpiPeriodType.MONTH, valueDate, domainId)\n    \n    console.log(`[KPI Statistics] Monthly batch completed for ${valueDate}`)\n  }\n  \n  /**\n   * 분기 배치: 지난 분기의 모든 통계 계산\n   */\n  static async runQuarterlyBatch(domainId?: string): Promise<void> {\n    console.log('[KPI Statistics] Starting quarterly batch calculation...')\n    \n    const now = new Date()\n    const currentQuarter = Math.floor(now.getMonth() / 3) + 1\n    const lastQuarter = currentQuarter === 1 ? 4 : currentQuarter - 1\n    const year = currentQuarter === 1 ? now.getFullYear() - 1 : now.getFullYear()\n    const valueDate = `${year}-Q${lastQuarter}`\n    \n    await this.calculateForAllDomains(KpiPeriodType.QUARTER, valueDate, domainId)\n    \n    console.log(`[KPI Statistics] Quarterly batch completed for ${valueDate}`)\n  }\n  \n  /**\n   * 연간 배치: 작년의 모든 통계 계산\n   */\n  static async runYearlyBatch(domainId?: string): Promise<void> {\n    console.log('[KPI Statistics] Starting yearly batch calculation...')\n    \n    const lastYear = new Date().getFullYear() - 1\n    const valueDate = lastYear.toString()\n    \n    await this.calculateForAllDomains(KpiPeriodType.YEAR, valueDate, domainId)\n    \n    console.log(`[KPI Statistics] Yearly batch completed for ${valueDate}`)\n  }\n  \n  /**\n   * 대시보드용 지역별 통계 계산\n   */\n  static async runDashboardBatch(\n    periodType: KpiPeriodType = KpiPeriodType.MONTH,\n    valueDate?: string,\n    domainId?: string\n  ): Promise<void> {\n    console.log('[KPI Statistics] Starting dashboard batch calculation...')\n    \n    if (!valueDate) {\n      const now = new Date()\n      if (periodType === KpiPeriodType.MONTH) {\n        now.setMonth(now.getMonth() - 1)\n        valueDate = now.toISOString().substring(0, 7) // YYYY-MM\n      } else {\n        now.setDate(now.getDate() - 1)\n        valueDate = now.toISOString().split('T')[0] // YYYY-MM-DD\n      }\n    }\n    \n    await this.calculateForAllDomains(periodType, valueDate, domainId)\n    \n    console.log(`[KPI Statistics] Dashboard batch completed for ${valueDate} (${periodType})`)\n  }\n  \n  /**\n   * 모든 도메인에 대해 통계 계산\n   */\n  private static async calculateForAllDomains(\n    periodType: KpiPeriodType,\n    valueDate: string,\n    domainId?: string\n  ): Promise<void> {\n    try {\n      const domains = domainId \n        ? await getRepository(Domain).find({ where: { id: domainId } })\n        : await getRepository(Domain).find()\n      \n      for (const domain of domains) {\n        try {\n          await this.calculateForDomain(domain, periodType, valueDate)\n        } catch (error) {\n          console.error(`[KPI Statistics] Domain ${domain.name} calculation failed, continuing with next domain:`, error)\n          // 개별 도메인 실패가 전체 배치를 중단시키지 않도록 계속 진행\n          continue\n        }\n      }\n    } catch (error) {\n      console.error('[KPI Statistics] Batch calculation failed:', error)\n      throw error\n    }\n  }\n  \n  /**\n   * 특정 도메인에 대해 통계 계산\n   */\n  private static async calculateForDomain(\n    domain: Domain,\n    periodType: KpiPeriodType,\n    valueDate: string\n  ): Promise<void> {\n    console.log(`[KPI Statistics] Calculating for domain: ${domain.name} (${domain.id})`)\n    \n    // 가짜 ResolverContext 생성 (배치 작업용)\n    const context: ResolverContext = {\n      state: {\n        domain,\n        user: { id: 'system', name: 'System Batch' }, // 시스템 사용자\n        tx: null // 트랜잭션 없음 (각 계산마다 개별 트랜잭션)\n      }\n    } as any\n    \n    try {\n      const statistics = await KpiStatisticCalculationService.calculateAllStatistics(\n        periodType,\n        valueDate,\n        context\n      )\n      \n      console.log(`[KPI Statistics] Generated ${statistics.length} statistics for domain ${domain.name}`)\n      \n      // 성공 로깅\n      this.logBatchResult(domain.id, periodType, valueDate, statistics.length, 'SUCCESS')\n      \n    } catch (error) {\n      console.error(`[KPI Statistics] Failed to calculate for domain ${domain.name}:`, error)\n      \n      // 실패 로깅\n      this.logBatchResult(domain.id, periodType, valueDate, 0, 'FAILED', error.message)\n      \n      // 에러를 던져서 상위에서 처리\n      throw error\n    }\n  }\n  \n  /**\n   * 배치 실행 결과 로깅\n   */\n  private static logBatchResult(\n    domainId: string,\n    periodType: KpiPeriodType,\n    valueDate: string,\n    statisticsCount: number,\n    status: 'SUCCESS' | 'FAILED',\n    errorMessage?: string\n  ): void {\n    const logData = {\n      timestamp: new Date().toISOString(),\n      domainId,\n      periodType,\n      valueDate,\n      statisticsCount,\n      status,\n      errorMessage\n    }\n    \n    // 실제 운영에서는 로깅 시스템에 저장\n    console.log('[KPI Statistics Batch Log]', JSON.stringify(logData))\n  }\n  \n  /**\n   * 배치 작업 스케줄링 설정 예시\n   */\n  static setupBatchSchedule(): void {\n    // 실제 구현시에는 cron 등의 스케줄러 사용\n    console.log('[KPI Statistics] Batch schedule setup example:')\n    console.log('Daily batch: Run at 02:00 AM every day')\n    console.log('Monthly batch: Run at 03:00 AM on 1st of every month') \n    console.log('Quarterly batch: Run at 04:00 AM on 1st of every quarter')\n    console.log('Yearly batch: Run at 05:00 AM on January 1st')\n    \n    /*\n    // Node-cron 사용 예시:\n    import cron from 'node-cron'\n    \n    // 매일 새벽 2시\n    cron.schedule('0 2 * * *', () => {\n      this.runDailyBatch()\n    })\n    \n    // 매월 1일 새벽 3시\n    cron.schedule('0 3 1 * *', () => {\n      this.runMonthlyBatch()\n    })\n    \n    // 매 분기 첫날 새벽 4시 (1, 4, 7, 10월)\n    cron.schedule('0 4 1 1,4,7,10 *', () => {\n      this.runQuarterlyBatch()\n    })\n    \n    // 매년 1월 1일 새벽 5시\n    cron.schedule('0 5 1 1 *', () => {\n      this.runYearlyBatch()\n    })\n    */\n  }\n}"]}

package/dist-server/service/kpi-statistic/kpi-statistic-calculation.service.d.ts

@@ -0,0 +1,50 @@
+import { KpiStatistic } from './kpi-statistic';
+import { KpiPeriodType } from '../kpi/kpi';
+import { KpiOrgScope } from '../kpi-org-scope/kpi-org-scope';
+import { KpiScope } from '../kpi-scope/kpi-scope';
+/**
+ * KPI 통계 계산 서비스
+ * KpiValue 데이터로부터 통계값을 계산하여 KpiStatistic에 저장
+ */
+export declare class KpiStatisticCalculationService {
+    /**
+     * 전체 KPI에 대해 통계를 계산
+     */
+    static calculateAllStatistics(periodType: KpiPeriodType, valueDate: string, context: ResolverContext): Promise<KpiStatistic[]>;
+    /**
+     * 특정 KPI의 통계를 계산
+     */
+    static calculateKpiStatistics(kpiId: string, periodType: KpiPeriodType, valueDate: string, kpiOrgScope: KpiOrgScope | null, context: ResolverContext): Promise<KpiStatistic | null>;
+    /**
+     * 스코프별 통계 계산 (KpiScope 기반)
+     */
+    static calculateScopedStatistics(kpiId: string, periodType: KpiPeriodType, valueDate: string, context: ResolverContext): Promise<KpiStatistic[]>;
+    /**
+     * 특정 스코프 차원별 통계 계산
+     */
+    static calculateStatisticsByScope(kpiId: string, periodType: KpiPeriodType, valueDate: string, kpiScope: KpiScope, context: ResolverContext): Promise<KpiStatistic[]>;
+    /**
+     * 스코프 값별 집계 통계 계산 (예: 서울 전체 평균)
+     */
+    private static calculateAggregatedScopeStatistics;
+    /**
+     * 특정 스코프 필드의 유니크한 값들 조회
+     */
+    private static getDistinctScopeValues;
+    /**
+     * 통계값 계산 로직
+     */
+    private static calculateStatistics;
+    /**
+     * 왜도 계산
+     */
+    private static calculateSkewness;
+    /**
+     * 첨도 계산
+     */
+    private static calculateKurtosis;
+    /**
+     * 기간 타입에 따른 날짜 필터 생성
+     */
+    private static buildDateFilter;
+}

package/dist-server/service/kpi-statistic/kpi-statistic-calculation.service.js

@@ -0,0 +1,324 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KpiStatisticCalculationService = void 0;
+const shell_1 = require("@things-factory/shell");
+const kpi_statistic_1 = require("./kpi-statistic");
+const kpi_value_1 = require("../kpi-value/kpi-value");
+const kpi_1 = require("../kpi/kpi");
+const kpi_org_scope_1 = require("../kpi-org-scope/kpi-org-scope");
+const kpi_scope_1 = require("../kpi-scope/kpi-scope");
+/**
+ * KPI 통계 계산 서비스
+ * KpiValue 데이터로부터 통계값을 계산하여 KpiStatistic에 저장
+ */
+class KpiStatisticCalculationService {
+    /**
+     * 전체 KPI에 대해 통계를 계산
+     */
+    static async calculateAllStatistics(periodType, valueDate, context) {
+        const { domain } = context.state;
+        // Leaf KPI들만 대상으로 함 (실제 값을 가진 KPI)
+        const leafKpis = await (0, shell_1.getRepository)(kpi_1.Kpi).find({
+            where: { domain: { id: domain.id }, isLeaf: true }
+        });
+        const results = [];
+        for (const kpi of leafKpis) {
+            // 1. 전체 통계 (scope 없음)
+            const overallStats = await this.calculateKpiStatistics(kpi.id, periodType, valueDate, null, // kpiOrgScope 없음 = 전체 통계
+            context);
+            if (overallStats)
+                results.push(overallStats);
+            // 2. 스코프별 통계
+            const scopedStats = await this.calculateScopedStatistics(kpi.id, periodType, valueDate, context);
+            results.push(...scopedStats);
+        }
+        return results;
+    }
+    /**
+     * 특정 KPI의 통계를 계산
+     */
+    static async calculateKpiStatistics(kpiId, periodType, valueDate, kpiOrgScope, context) {
+        const { domain, user, tx } = context.state;
+        // KPI 값들 조회
+        const whereCondition = {
+            kpi: { id: kpiId },
+            domain: { id: domain.id },
+            valueDate: this.buildDateFilter(valueDate, periodType)
+        };
+        if (kpiOrgScope) {
+            whereCondition.kpiOrgScope = { id: kpiOrgScope.id };
+        }
+        const kpiValues = await (0, shell_1.getRepository)(kpi_value_1.KpiValue, tx).find({
+            where: whereCondition,
+            relations: ['kpi', 'kpiOrgScope']
+        });
+        if (kpiValues.length === 0) {
+            return null;
+        }
+        // 통계 계산
+        const statistics = this.calculateStatistics(kpiValues.map(v => v.value).filter(v => v !== null));
+        // KpiStatistic 엔티티 생성/업데이트
+        const kpiStatisticRepo = (0, shell_1.getRepository)(kpi_statistic_1.KpiStatistic, tx);
+        // 기존 통계 조회
+        const existingWhere = {
+            kpi: { id: kpiId },
+            domain: { id: domain.id },
+            periodType,
+            valueDate
+        };
+        if (kpiOrgScope) {
+            existingWhere.kpiOrgScope = { id: kpiOrgScope.id };
+        }
+        else {
+            existingWhere.kpiOrgScope = null;
+        }
+        let kpiStatistic = await kpiStatisticRepo.findOne({ where: existingWhere });
+        if (!kpiStatistic) {
+            kpiStatistic = kpiStatisticRepo.create();
+            kpiStatistic.kpi = kpiValues[0].kpi;
+            kpiStatistic.kpiId = kpiId;
+            kpiStatistic.domain = { id: domain.id };
+            kpiStatistic.periodType = periodType;
+            kpiStatistic.valueDate = valueDate;
+            kpiStatistic.creator = user;
+            kpiStatistic.kpiOrgScope = kpiOrgScope;
+            kpiStatistic.kpiOrgScopeId = kpiOrgScope?.id;
+        }
+        // 통계값 적용
+        Object.assign(kpiStatistic, statistics);
+        kpiStatistic.updater = user;
+        kpiStatistic.metadata = {
+            ...kpiStatistic.metadata,
+            calculationMethod: 'auto-calculated',
+            lastCalculated: new Date(),
+            dataCount: kpiValues.length,
+            calculatedFrom: 'kpi-values'
+        };
+        return await kpiStatisticRepo.save(kpiStatistic);
+    }
+    /**
+     * 스코프별 통계 계산 (KpiScope 기반)
+     */
+    static async calculateScopedStatistics(kpiId, periodType, valueDate, context) {
+        const { domain } = context.state;
+        // 통계 계산에 사용할 스코프 정의 조회
+        const kpiScopes = await (0, shell_1.getRepository)(kpi_scope_1.KpiScope).find({
+            where: {
+                domain: { id: domain.id },
+                active: true,
+                includeInStatistics: true
+            },
+            order: { displayOrder: 'ASC' }
+        });
+        const results = [];
+        for (const kpiScope of kpiScopes) {
+            const scopedStats = await this.calculateStatisticsByScope(kpiId, periodType, valueDate, kpiScope, context);
+            results.push(...scopedStats);
+        }
+        return results;
+    }
+    /**
+     * 특정 스코프 차원별 통계 계산
+     */
+    static async calculateStatisticsByScope(kpiId, periodType, valueDate, kpiScope, context) {
+        const { domain } = context.state;
+        const scopeLevel = kpiScope.level;
+        const fieldName = `scope${scopeLevel.toString().padStart(2, '0')}`;
+        // 해당 스코프 레벨의 유니크한 값들 조회
+        const scopeValues = kpiScope.validValues || (await this.getDistinctScopeValues(fieldName, domain.id));
+        const results = [];
+        for (const scopeValue of scopeValues) {
+            // 해당 스코프 값을 가진 KpiOrgScope들 조회
+            const kpiOrgScopes = await (0, shell_1.getRepository)(kpi_org_scope_1.KpiOrgScope).find({
+                where: {
+                    domain: { id: domain.id },
+                    [fieldName]: scopeValue
+                }
+            });
+            // 각 KpiOrgScope에 대해 통계 계산
+            for (const orgScope of kpiOrgScopes) {
+                const statistic = await this.calculateKpiStatistics(kpiId, periodType, valueDate, orgScope, context);
+                if (statistic) {
+                    results.push(statistic);
+                }
+            }
+            // 스코프 값별 집계 통계도 생성 (선택적)
+            if (kpiOrgScopes.length > 1) {
+                const aggregatedStats = await this.calculateAggregatedScopeStatistics(kpiId, periodType, valueDate, kpiScope, scopeValue, kpiOrgScopes, context);
+                if (aggregatedStats) {
+                    results.push(aggregatedStats);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * 스코프 값별 집계 통계 계산 (예: 서울 전체 평균)
+     */
+    static async calculateAggregatedScopeStatistics(kpiId, periodType, valueDate, kpiScope, scopeValue, kpiOrgScopes, context) {
+        const { domain, user, tx } = context.state;
+        // 모든 KpiOrgScope에서 KpiValue들 수집
+        const allValues = [];
+        for (const orgScope of kpiOrgScopes) {
+            const kpiValues = await (0, shell_1.getRepository)(kpi_value_1.KpiValue, tx).find({
+                where: {
+                    kpi: { id: kpiId },
+                    domain: { id: domain.id },
+                    kpiOrgScope: { id: orgScope.id },
+                    valueDate: this.buildDateFilter(valueDate, periodType)
+                }
+            });
+            allValues.push(...kpiValues.map(v => v.value).filter(v => v !== null));
+        }
+        if (allValues.length === 0)
+            return null;
+        // 집계 통계 계산
+        const statistics = this.calculateStatistics(allValues);
+        // 가상의 KpiOrgScope 생성 (집계용)
+        const aggregatedOrgScope = {
+            id: `aggregated-${kpiScope.level}-${scopeValue}`,
+            entityType: 'AGGREGATED',
+            entityName: `${kpiScope.name}: ${scopeValue}`,
+            org: scopeValue,
+            [`scope${kpiScope.level.toString().padStart(2, '0')}`]: scopeValue
+        };
+        // KpiStatistic 생성
+        const kpiStatisticRepo = (0, shell_1.getRepository)(kpi_statistic_1.KpiStatistic, tx);
+        const kpiStatistic = kpiStatisticRepo.create();
+        const kpi = await (0, shell_1.getRepository)(kpi_1.Kpi).findOneBy({ id: kpiId });
+        kpiStatistic.kpi = kpi;
+        kpiStatistic.kpiId = kpiId;
+        kpiStatistic.domain = { id: domain.id };
+        kpiStatistic.periodType = periodType;
+        kpiStatistic.valueDate = valueDate;
+        kpiStatistic.creator = user;
+        kpiStatistic.updater = user;
+        // 통계값 적용
+        Object.assign(kpiStatistic, statistics);
+        kpiStatistic.metadata = {
+            ...kpiStatistic.metadata,
+            calculationMethod: 'scope-aggregated',
+            lastCalculated: new Date(),
+            dataCount: allValues.length,
+            kpiScope: {
+                id: kpiScope.id,
+                name: kpiScope.name,
+                level: kpiScope.level,
+                scopeType: kpiScope.scopeType
+            },
+            aggregatedScopeValue: scopeValue,
+            orgScopeCount: kpiOrgScopes.length
+        };
+        return await kpiStatisticRepo.save(kpiStatistic);
+    }
+    /**
+     * 특정 스코프 필드의 유니크한 값들 조회
+     */
+    static async getDistinctScopeValues(fieldName, domainId) {
+        const query = `
+      SELECT DISTINCT ${fieldName} as value 
+      FROM kpi_org_scope 
+      WHERE domainId = ? AND ${fieldName} IS NOT NULL 
+      ORDER BY ${fieldName}
+    `;
+        const results = await (0, shell_1.getRepository)(kpi_org_scope_1.KpiOrgScope).query(query, [domainId]);
+        return results.map((r) => r.value).filter(Boolean);
+    }
+    /**
+     * 통계값 계산 로직
+     */
+    static calculateStatistics(values) {
+        if (values.length === 0)
+            return {};
+        const sortedValues = [...values].sort((a, b) => a - b);
+        const count = values.length;
+        const sum = values.reduce((acc, val) => acc + val, 0);
+        const mean = sum / count;
+        // 중앙값
+        const median = count % 2 === 0
+            ? (sortedValues[Math.floor(count / 2) - 1] + sortedValues[Math.floor(count / 2)]) / 2
+            : sortedValues[Math.floor(count / 2)];
+        // 분산 및 표준편차
+        const variance = values.reduce((acc, val) => acc + Math.pow(val - mean, 2), 0) / count;
+        const standardDeviation = Math.sqrt(variance);
+        // 최소/최대값 및 범위
+        const minimum = Math.min(...values);
+        const maximum = Math.max(...values);
+        const range = maximum - minimum;
+        // 분위수 계산
+        const q1Index = Math.floor(count * 0.25);
+        const q3Index = Math.floor(count * 0.75);
+        const percentile25 = sortedValues[q1Index];
+        const percentile75 = sortedValues[q3Index];
+        const iqr = percentile75 - percentile25;
+        // 이상치 감지를 위한 fence
+        const lowerFence = percentile25 - 1.5 * iqr;
+        const upperFence = percentile75 + 1.5 * iqr;
+        return {
+            count,
+            sum,
+            range,
+            mean,
+            median,
+            minimum,
+            maximum,
+            standardDeviation,
+            variance,
+            percentile25,
+            percentile75,
+            iqr,
+            lowerFence,
+            upperFence,
+            additionalStatistics: {
+                coefficientOfVariation: standardDeviation / mean,
+                skewness: this.calculateSkewness(values, mean, standardDeviation),
+                kurtosis: this.calculateKurtosis(values, mean, standardDeviation)
+            }
+        };
+    }
+    /**
+     * 왜도 계산
+     */
+    static calculateSkewness(values, mean, stdDev) {
+        if (stdDev === 0)
+            return 0;
+        const n = values.length;
+        const sum = values.reduce((acc, val) => acc + Math.pow((val - mean) / stdDev, 3), 0);
+        return (n / ((n - 1) * (n - 2))) * sum;
+    }
+    /**
+     * 첨도 계산
+     */
+    static calculateKurtosis(values, mean, stdDev) {
+        if (stdDev === 0)
+            return 0;
+        const n = values.length;
+        const sum = values.reduce((acc, val) => acc + Math.pow((val - mean) / stdDev, 4), 0);
+        const kurtosis = ((n * (n + 1)) / ((n - 1) * (n - 2) * (n - 3))) * sum;
+        const adjustment = (3 * Math.pow(n - 1, 2)) / ((n - 2) * (n - 3));
+        return kurtosis - adjustment;
+    }
+    /**
+     * 기간 타입에 따른 날짜 필터 생성
+     */
+    static buildDateFilter(valueDate, periodType) {
+        switch (periodType) {
+            case kpi_1.KpiPeriodType.DAY:
+                return valueDate; // 정확한 날짜 매치
+            case kpi_1.KpiPeriodType.WEEK:
+                return `${valueDate.substring(0, 8)}%`; // YYYY-MM-DD% -> 주 단위
+            case kpi_1.KpiPeriodType.MONTH:
+                return `${valueDate.substring(0, 7)}%`; // YYYY-MM%
+            case kpi_1.KpiPeriodType.QUARTER:
+                const year = valueDate.substring(0, 4);
+                const quarter = valueDate.substring(5, 7); // Q1, Q2, Q3, Q4
+                return `${year}-${quarter}%`;
+            case kpi_1.KpiPeriodType.YEAR:
+                return `${valueDate.substring(0, 4)}%`; // YYYY%
+            default:
+                return valueDate;
+        }
+    }
+}
+exports.KpiStatisticCalculationService = KpiStatisticCalculationService;
+//# sourceMappingURL=kpi-statistic-calculation.service.js.map

package/dist-server/service/kpi-statistic/kpi-statistic-calculation.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-statistic-calculation.service.js","sourceRoot":"","sources":["../../../server/service/kpi-statistic/kpi-statistic-calculation.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository } from '@things-factory/shell'\nimport type ResolverContext from '@things-factory/auth-base'\nimport { KpiStatistic } from './kpi-statistic'\nimport { KpiValue } from '../kpi-value/kpi-value'\nimport { Kpi, KpiPeriodType } from '../kpi/kpi'\nimport { KpiOrgScope } from '../kpi-org-scope/kpi-org-scope'\nimport { KpiScope } from '../kpi-scope/kpi-scope'\n\n/**\n * KPI 통계 계산 서비스\n * KpiValue 데이터로부터 통계값을 계산하여 KpiStatistic에 저장\n */\nexport class KpiStatisticCalculationService {\n  /**\n   * 전체 KPI에 대해 통계를 계산\n   */\n  static async calculateAllStatistics(\n    periodType: KpiPeriodType,\n    valueDate: string,\n    context: ResolverContext\n  ): Promise<KpiStatistic[]> {\n    const { domain } = context.state\n\n    // Leaf KPI들만 대상으로 함 (실제 값을 가진 KPI)\n    const leafKpis = await getRepository(Kpi).find({\n      where: { domain: { id: domain.id }, isLeaf: true }\n    })\n\n    const results: KpiStatistic[] = []\n\n    for (const kpi of leafKpis) {\n      // 1. 전체 통계 (scope 없음)\n      const overallStats = await this.calculateKpiStatistics(\n        kpi.id,\n        periodType,\n        valueDate,\n        null, // kpiOrgScope 없음 = 전체 통계\n        context\n      )\n      if (overallStats) results.push(overallStats)\n\n      // 2. 스코프별 통계\n      const scopedStats = await this.calculateScopedStatistics(kpi.id, periodType, valueDate, context)\n      results.push(...scopedStats)\n    }\n\n    return results\n  }\n\n  /**\n   * 특정 KPI의 통계를 계산\n   */\n  static async calculateKpiStatistics(\n    kpiId: string,\n    periodType: KpiPeriodType,\n    valueDate: string,\n    kpiOrgScope: KpiOrgScope | null,\n    context: ResolverContext\n  ): Promise<KpiStatistic | null> {\n    const { domain, user, tx } = context.state\n\n    // KPI 값들 조회\n    const whereCondition: any = {\n      kpi: { id: kpiId },\n      domain: { id: domain.id },\n      valueDate: this.buildDateFilter(valueDate, periodType)\n    }\n\n    if (kpiOrgScope) {\n      whereCondition.kpiOrgScope = { id: kpiOrgScope.id }\n    }\n\n    const kpiValues = await getRepository(KpiValue, tx).find({\n      where: whereCondition,\n      relations: ['kpi', 'kpiOrgScope']\n    })\n\n    if (kpiValues.length === 0) {\n      return null\n    }\n\n    // 통계 계산\n    const statistics = this.calculateStatistics(kpiValues.map(v => v.value).filter(v => v !== null))\n\n    // KpiStatistic 엔티티 생성/업데이트\n    const kpiStatisticRepo = getRepository(KpiStatistic, tx)\n\n    // 기존 통계 조회\n    const existingWhere: any = {\n      kpi: { id: kpiId },\n      domain: { id: domain.id },\n      periodType,\n      valueDate\n    }\n\n    if (kpiOrgScope) {\n      existingWhere.kpiOrgScope = { id: kpiOrgScope.id }\n    } else {\n      existingWhere.kpiOrgScope = null\n    }\n\n    let kpiStatistic = await kpiStatisticRepo.findOne({ where: existingWhere })\n\n    if (!kpiStatistic) {\n      kpiStatistic = kpiStatisticRepo.create()\n      kpiStatistic.kpi = kpiValues[0].kpi\n      kpiStatistic.kpiId = kpiId\n      kpiStatistic.domain = { id: domain.id } as any\n      kpiStatistic.periodType = periodType\n      kpiStatistic.valueDate = valueDate\n      kpiStatistic.creator = user\n      kpiStatistic.kpiOrgScope = kpiOrgScope\n      kpiStatistic.kpiOrgScopeId = kpiOrgScope?.id\n    }\n\n    // 통계값 적용\n    Object.assign(kpiStatistic, statistics)\n    kpiStatistic.updater = user\n    kpiStatistic.metadata = {\n      ...kpiStatistic.metadata,\n      calculationMethod: 'auto-calculated',\n      lastCalculated: new Date(),\n      dataCount: kpiValues.length,\n      calculatedFrom: 'kpi-values'\n    }\n\n    return await kpiStatisticRepo.save(kpiStatistic)\n  }\n\n  /**\n   * 스코프별 통계 계산 (KpiScope 기반)\n   */\n  static async calculateScopedStatistics(\n    kpiId: string,\n    periodType: KpiPeriodType,\n    valueDate: string,\n    context: ResolverContext\n  ): Promise<KpiStatistic[]> {\n    const { domain } = context.state\n\n    // 통계 계산에 사용할 스코프 정의 조회\n    const kpiScopes = await getRepository(KpiScope).find({\n      where: {\n        domain: { id: domain.id },\n        active: true,\n        includeInStatistics: true\n      },\n      order: { displayOrder: 'ASC' }\n    })\n\n    const results: KpiStatistic[] = []\n\n    for (const kpiScope of kpiScopes) {\n      const scopedStats = await this.calculateStatisticsByScope(kpiId, periodType, valueDate, kpiScope, context)\n      results.push(...scopedStats)\n    }\n\n    return results\n  }\n\n  /**\n   * 특정 스코프 차원별 통계 계산\n   */\n  static async calculateStatisticsByScope(\n    kpiId: string,\n    periodType: KpiPeriodType,\n    valueDate: string,\n    kpiScope: KpiScope,\n    context: ResolverContext\n  ): Promise<KpiStatistic[]> {\n    const { domain } = context.state\n    const scopeLevel = kpiScope.level\n    const fieldName = `scope${scopeLevel.toString().padStart(2, '0')}`\n\n    // 해당 스코프 레벨의 유니크한 값들 조회\n    const scopeValues = kpiScope.validValues || (await this.getDistinctScopeValues(fieldName, domain.id))\n\n    const results: KpiStatistic[] = []\n\n    for (const scopeValue of scopeValues) {\n      // 해당 스코프 값을 가진 KpiOrgScope들 조회\n      const kpiOrgScopes = await getRepository(KpiOrgScope).find({\n        where: {\n          domain: { id: domain.id },\n          [fieldName]: scopeValue\n        }\n      })\n\n      // 각 KpiOrgScope에 대해 통계 계산\n      for (const orgScope of kpiOrgScopes) {\n        const statistic = await this.calculateKpiStatistics(kpiId, periodType, valueDate, orgScope, context)\n        if (statistic) {\n          results.push(statistic)\n        }\n      }\n\n      // 스코프 값별 집계 통계도 생성 (선택적)\n      if (kpiOrgScopes.length > 1) {\n        const aggregatedStats = await this.calculateAggregatedScopeStatistics(\n          kpiId,\n          periodType,\n          valueDate,\n          kpiScope,\n          scopeValue,\n          kpiOrgScopes,\n          context\n        )\n        if (aggregatedStats) {\n          results.push(aggregatedStats)\n        }\n      }\n    }\n\n    return results\n  }\n\n  /**\n   * 스코프 값별 집계 통계 계산 (예: 서울 전체 평균)\n   */\n  private static async calculateAggregatedScopeStatistics(\n    kpiId: string,\n    periodType: KpiPeriodType,\n    valueDate: string,\n    kpiScope: KpiScope,\n    scopeValue: string,\n    kpiOrgScopes: KpiOrgScope[],\n    context: ResolverContext\n  ): Promise<KpiStatistic | null> {\n    const { domain, user, tx } = context.state\n\n    // 모든 KpiOrgScope에서 KpiValue들 수집\n    const allValues: number[] = []\n    for (const orgScope of kpiOrgScopes) {\n      const kpiValues = await getRepository(KpiValue, tx).find({\n        where: {\n          kpi: { id: kpiId },\n          domain: { id: domain.id },\n          kpiOrgScope: { id: orgScope.id },\n          valueDate: this.buildDateFilter(valueDate, periodType)\n        }\n      })\n      allValues.push(...kpiValues.map(v => v.value).filter(v => v !== null))\n    }\n\n    if (allValues.length === 0) return null\n\n    // 집계 통계 계산\n    const statistics = this.calculateStatistics(allValues)\n\n    // 가상의 KpiOrgScope 생성 (집계용)\n    const aggregatedOrgScope = {\n      id: `aggregated-${kpiScope.level}-${scopeValue}`,\n      entityType: 'AGGREGATED',\n      entityName: `${kpiScope.name}: ${scopeValue}`,\n      org: scopeValue,\n      [`scope${kpiScope.level.toString().padStart(2, '0')}`]: scopeValue\n    }\n\n    // KpiStatistic 생성\n    const kpiStatisticRepo = getRepository(KpiStatistic, tx)\n    const kpiStatistic = kpiStatisticRepo.create()\n\n    const kpi = await getRepository(Kpi).findOneBy({ id: kpiId })\n    kpiStatistic.kpi = kpi\n    kpiStatistic.kpiId = kpiId\n    kpiStatistic.domain = { id: domain.id } as any\n    kpiStatistic.periodType = periodType\n    kpiStatistic.valueDate = valueDate\n    kpiStatistic.creator = user\n    kpiStatistic.updater = user\n\n    // 통계값 적용\n    Object.assign(kpiStatistic, statistics)\n    kpiStatistic.metadata = {\n      ...kpiStatistic.metadata,\n      calculationMethod: 'scope-aggregated',\n      lastCalculated: new Date(),\n      dataCount: allValues.length,\n      kpiScope: {\n        id: kpiScope.id,\n        name: kpiScope.name,\n        level: kpiScope.level,\n        scopeType: kpiScope.scopeType\n      },\n      aggregatedScopeValue: scopeValue,\n      orgScopeCount: kpiOrgScopes.length\n    }\n\n    return await kpiStatisticRepo.save(kpiStatistic)\n  }\n\n  /**\n   * 특정 스코프 필드의 유니크한 값들 조회\n   */\n  private static async getDistinctScopeValues(fieldName: string, domainId: string): Promise<string[]> {\n    const query = `\n      SELECT DISTINCT ${fieldName} as value \n      FROM kpi_org_scope \n      WHERE domainId = ? AND ${fieldName} IS NOT NULL \n      ORDER BY ${fieldName}\n    `\n\n    const results = await getRepository(KpiOrgScope).query(query, [domainId])\n    return results.map((r: any) => r.value).filter(Boolean)\n  }\n\n  /**\n   * 통계값 계산 로직\n   */\n  private static calculateStatistics(values: number[]) {\n    if (values.length === 0) return {}\n\n    const sortedValues = [...values].sort((a, b) => a - b)\n    const count = values.length\n    const sum = values.reduce((acc, val) => acc + val, 0)\n    const mean = sum / count\n\n    // 중앙값\n    const median =\n      count % 2 === 0\n        ? (sortedValues[Math.floor(count / 2) - 1] + sortedValues[Math.floor(count / 2)]) / 2\n        : sortedValues[Math.floor(count / 2)]\n\n    // 분산 및 표준편차\n    const variance = values.reduce((acc, val) => acc + Math.pow(val - mean, 2), 0) / count\n    const standardDeviation = Math.sqrt(variance)\n\n    // 최소/최대값 및 범위\n    const minimum = Math.min(...values)\n    const maximum = Math.max(...values)\n    const range = maximum - minimum\n\n    // 분위수 계산\n    const q1Index = Math.floor(count * 0.25)\n    const q3Index = Math.floor(count * 0.75)\n    const percentile25 = sortedValues[q1Index]\n    const percentile75 = sortedValues[q3Index]\n    const iqr = percentile75 - percentile25\n\n    // 이상치 감지를 위한 fence\n    const lowerFence = percentile25 - 1.5 * iqr\n    const upperFence = percentile75 + 1.5 * iqr\n\n    return {\n      count,\n      sum,\n      range,\n      mean,\n      median,\n      minimum,\n      maximum,\n      standardDeviation,\n      variance,\n      percentile25,\n      percentile75,\n      iqr,\n      lowerFence,\n      upperFence,\n      additionalStatistics: {\n        coefficientOfVariation: standardDeviation / mean,\n        skewness: this.calculateSkewness(values, mean, standardDeviation),\n        kurtosis: this.calculateKurtosis(values, mean, standardDeviation)\n      }\n    }\n  }\n\n  /**\n   * 왜도 계산\n   */\n  private static calculateSkewness(values: number[], mean: number, stdDev: number): number {\n    if (stdDev === 0) return 0\n    const n = values.length\n    const sum = values.reduce((acc, val) => acc + Math.pow((val - mean) / stdDev, 3), 0)\n    return (n / ((n - 1) * (n - 2))) * sum\n  }\n\n  /**\n   * 첨도 계산\n   */\n  private static calculateKurtosis(values: number[], mean: number, stdDev: number): number {\n    if (stdDev === 0) return 0\n    const n = values.length\n    const sum = values.reduce((acc, val) => acc + Math.pow((val - mean) / stdDev, 4), 0)\n    const kurtosis = ((n * (n + 1)) / ((n - 1) * (n - 2) * (n - 3))) * sum\n    const adjustment = (3 * Math.pow(n - 1, 2)) / ((n - 2) * (n - 3))\n    return kurtosis - adjustment\n  }\n\n  /**\n   * 기간 타입에 따른 날짜 필터 생성\n   */\n  private static buildDateFilter(valueDate: string, periodType: KpiPeriodType): string {\n    switch (periodType) {\n      case KpiPeriodType.DAY:\n        return valueDate // 정확한 날짜 매치\n      case KpiPeriodType.WEEK:\n        return `${valueDate.substring(0, 8)}%` // YYYY-MM-DD% -> 주 단위\n      case KpiPeriodType.MONTH:\n        return `${valueDate.substring(0, 7)}%` // YYYY-MM%\n      case KpiPeriodType.QUARTER:\n        const year = valueDate.substring(0, 4)\n        const quarter = valueDate.substring(5, 7) // Q1, Q2, Q3, Q4\n        return `${year}-${quarter}%`\n      case KpiPeriodType.YEAR:\n        return `${valueDate.substring(0, 4)}%` // YYYY%\n      default:\n        return valueDate\n    }\n  }\n}\n"]}

package/dist-server/service/kpi-statistic/kpi-statistic-mutation.d.ts

@@ -0,0 +1,14 @@
+import { KpiStatistic } from './kpi-statistic.js';
+import { NewKpiStatistic, KpiStatisticPatch } from './kpi-statistic-type.js';
+import { KpiPeriodType } from '../kpi/kpi.js';
+export declare class KpiStatisticMutation {
+    createKpiStatistic(kpiStatistic: NewKpiStatistic, context: ResolverContext): Promise<KpiStatistic>;
+    updateKpiStatistic(id: string, patch: KpiStatisticPatch, context: ResolverContext): Promise<KpiStatistic>;
+    updateMultipleKpiStatistic(patches: KpiStatisticPatch[], context: ResolverContext): Promise<KpiStatistic[]>;
+    deleteKpiStatistic(id: string, context: ResolverContext): Promise<boolean>;
+    deleteKpiStatistics(ids: string[], context: ResolverContext): Promise<boolean>;
+    importKpiStatistics(kpiStatistics: KpiStatisticPatch[], context: ResolverContext): Promise<boolean>;
+    calculateKpiStatistics(kpiId: string, periodType: KpiPeriodType, valueDate: string, context: ResolverContext): Promise<KpiStatistic[]>;
+    calculateAllKpiStatistics(periodType: KpiPeriodType, valueDate: string, context: ResolverContext): Promise<KpiStatistic[]>;
+    calculateRegionalStatistics(periodType: KpiPeriodType, valueDate: string, context: ResolverContext): Promise<KpiStatistic[]>;
+}