@things-factory/kpi 10.1.248 → 10.1.249

package/dist-server/service/index.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schema = exports.entities = void 0;
+const tslib_1 = require("tslib");
+/* EXPORT ENTITY TYPES */
+tslib_1.__exportStar(require("./kpi-statistic/kpi-statistic"), exports);
+tslib_1.__exportStar(require("./kpi/kpi"), exports);
+tslib_1.__exportStar(require("./kpi/kpi-type"), exports);
+tslib_1.__exportStar(require("./kpi-value/kpi-value"), exports);
+tslib_1.__exportStar(require("./kpi-value/kpi-value-type"), exports);
+tslib_1.__exportStar(require("./kpi-metric/kpi-metric"), exports);
+tslib_1.__exportStar(require("./kpi-metric/kpi-metric-type"), exports);
+tslib_1.__exportStar(require("./kpi-metric-value/kpi-metric-value"), exports);
+tslib_1.__exportStar(require("./kpi-metric-value/kpi-metric-value-type"), exports);
+tslib_1.__exportStar(require("./kpi-scope/kpi-scope"), exports);
+tslib_1.__exportStar(require("./kpi-org-scope/kpi-org-scope"), exports);
+/* IMPORT ENTITIES AND RESOLVERS */
+const kpi_statistic_1 = require("./kpi-statistic");
+const kpi_1 = require("./kpi");
+const kpi_value_1 = require("./kpi-value");
+const kpi_metric_1 = require("./kpi-metric");
+const kpi_metric_value_1 = require("./kpi-metric-value");
+const kpi_org_scope_1 = require("./kpi-org-scope");
+const kpi_alert_1 = require("./kpi-alert");
+const kpi_scope_1 = require("./kpi-scope");
+exports.entities = [
+    /* ENTITIES */
+    ...kpi_statistic_1.entities,
+    ...kpi_1.entities,
+    ...kpi_value_1.entities,
+    ...kpi_metric_1.entities,
+    ...kpi_metric_value_1.entities,
+    ...kpi_org_scope_1.entities,
+    ...kpi_scope_1.entities
+];
+exports.schema = {
+    resolverClasses: [
+        /* RESOLVER CLASSES */
+        ...kpi_statistic_1.resolvers,
+        ...kpi_1.resolvers,
+        ...kpi_value_1.resolvers,
+        ...kpi_metric_1.resolvers,
+        ...kpi_metric_value_1.resolvers,
+        ...kpi_org_scope_1.resolvers,
+        ...kpi_alert_1.resolvers,
+        ...kpi_scope_1.resolvers
+    ]
+};
+//# sourceMappingURL=index.js.map

package/dist-server/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,yBAAyB;AACzB,wEAA6C;AAC7C,oDAAyB;AACzB,yDAA8B;AAC9B,gEAAqC;AACrC,qEAA0C;AAC1C,kEAAuC;AACvC,uEAA4C;AAC5C,8EAAmD;AACnD,mFAAwD;AACxD,gEAAqC;AACrC,wEAA6C;AAE7C,mCAAmC;AACnC,mDAIwB;AACxB,+BAA0E;AAC1E,2CAA0F;AAC1F,6CAA6F;AAC7F,yDAA6G;AAC7G,mDAAoG;AACpG,2CAA4D;AAC5D,2CAA0F;AAE7E,QAAA,QAAQ,GAAG;IACtB,cAAc;IACd,GAAG,wBAAoB;IACvB,GAAG,cAAW;IACd,GAAG,oBAAgB;IACnB,GAAG,qBAAiB;IACpB,GAAG,2BAAsB;IACzB,GAAG,wBAAmB;IACtB,GAAG,oBAAgB;CACpB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,GAAG,yBAAqB;QACxB,GAAG,eAAY;QACf,GAAG,qBAAiB;QACpB,GAAG,sBAAkB;QACrB,GAAG,4BAAuB;QAC1B,GAAG,yBAAoB;QACvB,GAAG,qBAAiB;QACpB,GAAG,qBAAiB;KACrB;CACF,CAAA","sourcesContent":["/* EXPORT ENTITY TYPES */\nexport * from './kpi-statistic/kpi-statistic'\nexport * from './kpi/kpi'\nexport * from './kpi/kpi-type'\nexport * from './kpi-value/kpi-value'\nexport * from './kpi-value/kpi-value-type'\nexport * from './kpi-metric/kpi-metric'\nexport * from './kpi-metric/kpi-metric-type'\nexport * from './kpi-metric-value/kpi-metric-value'\nexport * from './kpi-metric-value/kpi-metric-value-type'\nexport * from './kpi-scope/kpi-scope'\nexport * from './kpi-org-scope/kpi-org-scope'\n\n/* IMPORT ENTITIES AND RESOLVERS */\nimport {\n  entities as KpiStatisticEntities,\n  resolvers as KpiStatisticResolvers,\n  subscribers as KpiStatisticSubscribers\n} from './kpi-statistic'\nimport { entities as KpiEntities, resolvers as KpiResolvers } from './kpi'\nimport { entities as KpiValueEntities, resolvers as KpiValueResolvers } from './kpi-value'\nimport { entities as KpiMetricEntities, resolvers as KpiMetricResolvers } from './kpi-metric'\nimport { entities as KpiMetricValueEntities, resolvers as KpiMetricValueResolvers } from './kpi-metric-value'\nimport { entities as KpiOrgScopeEntities, resolvers as KpiOrgScopeResolvers } from './kpi-org-scope'\nimport { resolvers as KpiAlertResolvers } from './kpi-alert'\nimport { entities as KpiScopeEntities, resolvers as KpiScopeResolvers } from './kpi-scope'\n\nexport const entities = [\n  /* ENTITIES */\n  ...KpiStatisticEntities,\n  ...KpiEntities,\n  ...KpiValueEntities,\n  ...KpiMetricEntities,\n  ...KpiMetricValueEntities,\n  ...KpiOrgScopeEntities,\n  ...KpiScopeEntities\n]\n\nexport const schema = {\n  resolverClasses: [\n    /* RESOLVER CLASSES */\n    ...KpiStatisticResolvers,\n    ...KpiResolvers,\n    ...KpiValueResolvers,\n    ...KpiMetricResolvers,\n    ...KpiMetricValueResolvers,\n    ...KpiOrgScopeResolvers,\n    ...KpiAlertResolvers,\n    ...KpiScopeResolvers\n  ]\n}\n"]}

package/dist-server/service/kpi/aggregate-kpi.d.ts

@@ -0,0 +1,8 @@
+/**
+ * KPI 단위 집계/산식 자동화 함수
+ * @param kpiId KPI ID
+ * @param domainId 도메인 ID
+ * @param context ResolverContext
+ * @returns 저장된 KPI Value 배열
+ */
+export declare function aggregateKpiValue(kpiId: string, domainId: string, context: ResolverContext): Promise<any[]>;

package/dist-server/service/kpi/aggregate-kpi.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aggregateKpiValue = aggregateKpiValue;
+const shell_1 = require("@things-factory/shell");
+const kpi_1 = require("./kpi");
+const kpi_metric_1 = require("../kpi-metric/kpi-metric");
+const kpi_value_1 = require("../kpi-value/kpi-value");
+const kpi_org_scope_1 = require("../kpi-org-scope/kpi-org-scope");
+const parser_js_1 = require("../../calculator/parser.js");
+const evaluator_js_1 = require("../../calculator/evaluator.js");
+const functions_js_1 = require("../../calculator/functions.js");
+const provider_js_1 = require("../../calculator/provider.js");
+const aggregate_kpi_metric_1 = require("../kpi-metric/aggregate-kpi-metric");
+const kpi_value_score_service_1 = require("../kpi-value/kpi-value-score.service");
+/**
+ * KPI 단위 집계/산식 자동화 함수
+ * @param kpiId KPI ID
+ * @param domainId 도메인 ID
+ * @param context ResolverContext
+ * @returns 저장된 KPI Value 배열
+ */
+async function aggregateKpiValue(kpiId, domainId, context) {
+    const tx = context.state?.tx || (0, shell_1.getRepository)(kpi_1.Kpi).manager;
+    const scoreService = new kpi_value_score_service_1.KpiValueScoreService();
+    // 1. KPI 정보 조회
+    const kpi = await (0, shell_1.getRepository)(kpi_1.Kpi).findOne({ where: { id: kpiId, domain: { id: domainId } } });
+    if (!kpi)
+        throw new Error('KPI 정보 없음');
+    if (!kpi.active)
+        throw new Error('비활성화된 KPI');
+    if (!kpi.formula)
+        throw new Error('KPI formula 없음');
+    // 2. formula 를 AST 로 파싱하고, 참조 변수명(=metric 이름)을 AST 에서 추출한다.
+    //    정규식 추출(extractMetricCodes)은 `[한글 변수]`·공백 포함 이름을 놓치므로 AST 기반이 정확.
+    let ast;
+    try {
+        ast = (0, parser_js_1.parseFormula)(kpi.formula);
+    }
+    catch (e) {
+        throw new Error(`KPI formula 파싱 실패 (kpi=${kpi.name}): ${e.message}`);
+    }
+    const metricCodes = (0, parser_js_1.collectVariableNames)(ast);
+    const codeValueMap = {};
+    for (const code of metricCodes) {
+        // 변수명으로 metric 찾기
+        const metric = await (0, shell_1.getRepository)(kpi_metric_1.KpiMetric).findOne({ where: { name: code, domain: { id: domainId } } });
+        if (!metric)
+            throw new Error(`KPI formula metric '${code}' not found`);
+        codeValueMap[code] = await (0, aggregate_kpi_metric_1.aggregateKpiMetricValue)(metric.id, domainId, context);
+    }
+    // org/date/period별로 값 매핑(가장 최근 기준, org key 조합)
+    const orgKey = v => [v.date, v.period, v.org].join('|');
+    const orgMap = {};
+    for (const code of metricCodes) {
+        for (const v of codeValueMap[code]) {
+            const key = orgKey(v);
+            orgMap[key] = orgMap[key] || { ...v, _values: {} };
+            orgMap[key]._values[code] = v.value;
+        }
+    }
+    // formula 계산 — 안전한 AST 평가기 사용 (JS `Function()` eval 제거).
+    //   · 변수(metric)는 ObjectValueProvider 로 org-combo 값 맵에서 해석
+    //   · 평가 실패는 조용히 null 로 두지 않고 로그로 남긴다 (원인 추적)
+    const savedValues = [];
+    for (const key in orgMap) {
+        const ctx = orgMap[key]._values;
+        let value = null;
+        try {
+            value = await (0, evaluator_js_1.evaluateFormula)(ast, {
+                functions: functions_js_1.builtinFunctions,
+                provider: new provider_js_1.ObjectValueProvider(ctx)
+            });
+        }
+        catch (e) {
+            console.error(`[aggregateKpiValue] formula 평가 실패 (kpi=${kpi.name}, formula=${kpi.formula})`, e);
+            value = null;
+        }
+        const valueDate = orgMap[key].date;
+        const org = orgMap[key].org;
+        const version = kpi.version || 1;
+        if (value == null || isNaN(value))
+            continue;
+        // KpiOrgScope 처리 (org 문자열로 찾기 또는 생성)
+        const kpiOrgScopeRepo = (0, shell_1.getRepository)(kpi_org_scope_1.KpiOrgScope, context.state?.tx);
+        let kpiOrgScope = await kpiOrgScopeRepo.findOne({
+            where: { org: org, domain: { id: domainId } }
+        });
+        if (!kpiOrgScope) {
+            // 새 KpiOrgScope 생성
+            kpiOrgScope = await kpiOrgScopeRepo.save({
+                entityType: 'AutoAggregate',
+                entityId: `auto-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+                entityName: org,
+                org: org,
+                domain: kpi.domain
+            });
+        }
+        // upsert(동일 KPI, valueDate, kpiOrgScope, version) 기준으로 저장
+        const repo = (0, shell_1.getRepository)(kpi_value_1.KpiValue, context.state?.tx);
+        const existing = await repo.findOne({
+            where: { kpi: { id: kpi.id }, valueDate, kpiOrgScope: { id: kpiOrgScope.id }, version, domain: { id: domainId } }
+        });
+        let entity = existing || repo.create();
+        entity.kpi = kpi;
+        entity.kpiId = kpi.id;
+        entity.version = version;
+        entity.valueDate = valueDate;
+        entity.value = value;
+        entity.kpiOrgScope = kpiOrgScope;
+        entity.kpiOrgScopeId = kpiOrgScope.id;
+        entity.inputType = kpi_value_1.KpiValueInputType.AUTO;
+        entity.source = 'AUTO';
+        entity.domain = kpi.domain;
+        entity.creator = context.state?.user;
+        entity.updater = context.state?.user;
+        // 성과 점수 자동 계산 및 저장
+        await scoreService.calculateAndSaveScore(entity, kpi);
+        entity = await repo.save(entity);
+        savedValues.push(entity);
+    }
+    return savedValues;
+}
+//# sourceMappingURL=aggregate-kpi.js.map

package/dist-server/service/kpi/aggregate-kpi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-kpi.js","sourceRoot":"","sources":["../../../server/service/kpi/aggregate-kpi.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository } from '@things-factory/shell'\nimport { Kpi } from './kpi'\nimport { KpiMetric } from '../kpi-metric/kpi-metric'\nimport { KpiValue, KpiValueInputType } from '../kpi-value/kpi-value'\nimport { KpiOrgScope } from '../kpi-org-scope/kpi-org-scope'\nimport { parseFormula, collectVariableNames } from '../../calculator/parser.js'\nimport { evaluateFormula } from '../../calculator/evaluator.js'\nimport { builtinFunctions } from '../../calculator/functions.js'\nimport { ObjectValueProvider } from '../../calculator/provider.js'\nimport { aggregateKpiMetricValue } from '../kpi-metric/aggregate-kpi-metric'\nimport { KpiValueScoreService } from '../kpi-value/kpi-value-score.service'\n\n/**\n * KPI 단위 집계/산식 자동화 함수\n * @param kpiId KPI ID\n * @param domainId 도메인 ID\n * @param context ResolverContext\n * @returns 저장된 KPI Value 배열\n */\nexport async function aggregateKpiValue(kpiId: string, domainId: string, context: ResolverContext) {\n  const tx = context.state?.tx || getRepository(Kpi).manager\n  const scoreService = new KpiValueScoreService()\n\n  // 1. KPI 정보 조회\n  const kpi = await getRepository(Kpi).findOne({ where: { id: kpiId, domain: { id: domainId } } })\n  if (!kpi) throw new Error('KPI 정보 없음')\n  if (!kpi.active) throw new Error('비활성화된 KPI')\n  if (!kpi.formula) throw new Error('KPI formula 없음')\n\n  // 2. formula 를 AST 로 파싱하고, 참조 변수명(=metric 이름)을 AST 에서 추출한다.\n  //    정규식 추출(extractMetricCodes)은 `[한글 변수]`·공백 포함 이름을 놓치므로 AST 기반이 정확.\n  let ast\n  try {\n    ast = parseFormula(kpi.formula)\n  } catch (e) {\n    throw new Error(`KPI formula 파싱 실패 (kpi=${kpi.name}): ${(e as Error).message}`)\n  }\n  const metricCodes = collectVariableNames(ast)\n  const codeValueMap: Record<string, any[]> = {}\n  for (const code of metricCodes) {\n    // 변수명으로 metric 찾기\n    const metric = await getRepository(KpiMetric).findOne({ where: { name: code, domain: { id: domainId } } })\n    if (!metric) throw new Error(`KPI formula metric '${code}' not found`)\n    codeValueMap[code] = await aggregateKpiMetricValue(metric.id, domainId, context)\n  }\n  // org/date/period별로 값 매핑(가장 최근 기준, org key 조합)\n  const orgKey = v => [v.date, v.period, v.org].join('|')\n  const orgMap: Record<string, any> = {}\n  for (const code of metricCodes) {\n    for (const v of codeValueMap[code]) {\n      const key = orgKey(v)\n      orgMap[key] = orgMap[key] || { ...v, _values: {} }\n      orgMap[key]._values[code] = v.value\n    }\n  }\n  // formula 계산 — 안전한 AST 평가기 사용 (JS `Function()` eval 제거).\n  //   · 변수(metric)는 ObjectValueProvider 로 org-combo 값 맵에서 해석\n  //   · 평가 실패는 조용히 null 로 두지 않고 로그로 남긴다 (원인 추적)\n  const savedValues = []\n  for (const key in orgMap) {\n    const ctx = orgMap[key]._values\n    let value = null\n    try {\n      value = await evaluateFormula(ast, {\n        functions: builtinFunctions,\n        provider: new ObjectValueProvider(ctx)\n      })\n    } catch (e) {\n      console.error(`[aggregateKpiValue] formula 평가 실패 (kpi=${kpi.name}, formula=${kpi.formula})`, e)\n      value = null\n    }\n    const valueDate = orgMap[key].date\n    const org = orgMap[key].org\n    const version = kpi.version || 1\n    if (value == null || isNaN(value)) continue\n    // KpiOrgScope 처리 (org 문자열로 찾기 또는 생성)\n    const kpiOrgScopeRepo = getRepository(KpiOrgScope, context.state?.tx)\n    let kpiOrgScope = await kpiOrgScopeRepo.findOne({\n      where: { org: org, domain: { id: domainId } }\n    })\n    if (!kpiOrgScope) {\n      // 새 KpiOrgScope 생성\n      kpiOrgScope = await kpiOrgScopeRepo.save({\n        entityType: 'AutoAggregate',\n        entityId: `auto-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,\n        entityName: org,\n        org: org,\n        domain: kpi.domain\n      })\n    }\n\n    // upsert(동일 KPI, valueDate, kpiOrgScope, version) 기준으로 저장\n    const repo = getRepository(KpiValue, context.state?.tx)\n    const existing = await repo.findOne({\n      where: { kpi: { id: kpi.id }, valueDate, kpiOrgScope: { id: kpiOrgScope.id }, version, domain: { id: domainId } }\n    })\n    let entity = existing || repo.create()\n    entity.kpi = kpi\n    entity.kpiId = kpi.id\n    entity.version = version\n    entity.valueDate = valueDate\n    entity.value = value\n    entity.kpiOrgScope = kpiOrgScope\n    entity.kpiOrgScopeId = kpiOrgScope.id\n    entity.inputType = KpiValueInputType.AUTO\n    entity.source = 'AUTO'\n    entity.domain = kpi.domain\n    entity.creator = context.state?.user\n    entity.updater = context.state?.user\n\n    // 성과 점수 자동 계산 및 저장\n    await scoreService.calculateAndSaveScore(entity, kpi)\n\n    entity = await repo.save(entity)\n    savedValues.push(entity)\n  }\n  return savedValues\n}\n"]}

package/dist-server/service/kpi/event-subscriber.d.ts

@@ -0,0 +1,9 @@
+import { HistoryEntitySubscriber } from '@operato/typeorm-history';
+import { Kpi } from './kpi';
+import { KpiHistory } from './kpi-history';
+export declare class KpiHistoryEntitySubscriber extends HistoryEntitySubscriber<Kpi, KpiHistory> {
+    get entity(): typeof Kpi;
+    get historyEntity(): typeof KpiHistory;
+    afterInsert(event: any): Promise<void>;
+    afterUpdate(event: any): Promise<void>;
+}

package/dist-server/service/kpi/event-subscriber.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KpiHistoryEntitySubscriber = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const typeorm_history_1 = require("@operato/typeorm-history");
+const kpi_1 = require("./kpi");
+const kpi_history_1 = require("./kpi-history");
+let KpiHistoryEntitySubscriber = class KpiHistoryEntitySubscriber extends typeorm_history_1.HistoryEntitySubscriber {
+    get entity() {
+        return kpi_1.Kpi;
+    }
+    get historyEntity() {
+        return kpi_history_1.KpiHistory;
+    }
+    async afterInsert(event) {
+        if (event.entity.state == 'RELEASE') {
+            await super.afterInsert(event);
+        }
+    }
+    async afterUpdate(event) {
+        if (event.entity.state == 'RELEASE') {
+            await super.afterUpdate(event);
+        }
+    }
+};
+exports.KpiHistoryEntitySubscriber = KpiHistoryEntitySubscriber;
+exports.KpiHistoryEntitySubscriber = KpiHistoryEntitySubscriber = tslib_1.__decorate([
+    (0, typeorm_1.EventSubscriber)()
+], KpiHistoryEntitySubscriber);
+//# sourceMappingURL=event-subscriber.js.map

package/dist-server/service/kpi/event-subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-subscriber.js","sourceRoot":"","sources":["../../../server/service/kpi/event-subscriber.ts"],"names":[],"mappings":";;;;AAAA,qCAAyC;AAEzC,8DAAkE;AAElE,+BAA2B;AAC3B,+CAA0C;AAGnC,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,yCAAwC;IACtF,IAAW,MAAM;QACf,OAAO,SAAG,CAAA;IACZ,CAAC;IAED,IAAW,aAAa;QACtB,OAAO,wBAAU,CAAA;IACnB,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,KAAK;QAC5B,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;YACpC,MAAM,KAAK,CAAC,WAAW,CAAC,KAAY,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,KAAK;QAC5B,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;YACpC,MAAM,KAAK,CAAC,WAAW,CAAC,KAAY,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;CACF,CAAA;AApBY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,yBAAe,GAAE;GACL,0BAA0B,CAoBtC","sourcesContent":["import { EventSubscriber } from 'typeorm'\n\nimport { HistoryEntitySubscriber } from '@operato/typeorm-history'\n\nimport { Kpi } from './kpi'\nimport { KpiHistory } from './kpi-history'\n\n@EventSubscriber()\nexport class KpiHistoryEntitySubscriber extends HistoryEntitySubscriber<Kpi, KpiHistory> {\n  public get entity() {\n    return Kpi\n  }\n\n  public get historyEntity() {\n    return KpiHistory\n  }\n\n  public async afterInsert(event): Promise<void> {\n    if (event.entity.state == 'RELEASE') {\n      await super.afterInsert(event as any)\n    }\n  }\n\n  public async afterUpdate(event): Promise<void> {\n    if (event.entity.state == 'RELEASE') {\n      await super.afterUpdate(event as any)\n    }\n  }\n}\n"]}

package/dist-server/service/kpi/index.d.ts

@@ -0,0 +1,8 @@
+import { Kpi } from './kpi';
+import { KpiHistory } from './kpi-history';
+import { KpiHistoryEntitySubscriber } from './event-subscriber';
+import { KpiQuery } from './kpi-query';
+import { KpiMutation } from './kpi-mutation';
+export declare const entities: (typeof Kpi | typeof KpiHistory)[];
+export declare const resolvers: (typeof KpiQuery | typeof KpiMutation)[];
+export declare const subscribers: (typeof KpiHistoryEntitySubscriber)[];

package/dist-server/service/kpi/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscribers = exports.resolvers = exports.entities = void 0;
+const kpi_1 = require("./kpi");
+const kpi_history_1 = require("./kpi-history");
+const event_subscriber_1 = require("./event-subscriber");
+const kpi_query_1 = require("./kpi-query");
+const kpi_mutation_1 = require("./kpi-mutation");
+exports.entities = [kpi_1.Kpi, kpi_history_1.KpiHistory];
+exports.resolvers = [kpi_query_1.KpiQuery, kpi_mutation_1.KpiMutation];
+exports.subscribers = [event_subscriber_1.KpiHistoryEntitySubscriber];
+//# sourceMappingURL=index.js.map

package/dist-server/service/kpi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/kpi/index.ts"],"names":[],"mappings":";;;AAAA,+BAA2B;AAC3B,+CAA0C;AAC1C,yDAA+D;AAC/D,2CAAsC;AACtC,iDAA4C;AAE/B,QAAA,QAAQ,GAAG,CAAC,SAAG,EAAE,wBAAU,CAAC,CAAA;AAC5B,QAAA,SAAS,GAAG,CAAC,oBAAQ,EAAE,0BAAW,CAAC,CAAA;AACnC,QAAA,WAAW,GAAG,CAAC,6CAA0B,CAAC,CAAA","sourcesContent":["import { Kpi } from './kpi'\nimport { KpiHistory } from './kpi-history'\nimport { KpiHistoryEntitySubscriber } from './event-subscriber'\nimport { KpiQuery } from './kpi-query'\nimport { KpiMutation } from './kpi-mutation'\n\nexport const entities = [Kpi, KpiHistory]\nexport const resolvers = [KpiQuery, KpiMutation]\nexport const subscribers = [KpiHistoryEntitySubscriber]\n"]}

package/dist-server/service/kpi/kpi-formula.service.d.ts

@@ -0,0 +1,49 @@
+export interface FormulaValidationResult {
+    /** 하드 에러(구문/미지 함수/순환참조)가 없으면 true. 경고는 valid 에 영향 없음. */
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * KPI formula 파싱/검증/매핑 유효성 검사 서비스
+ * - formula에서 Metric 코드(변수명) 추출
+ * - 각 Metric의 존재/매핑 유효성 검사
+ * - 구문 오류, 미정의 Metric, 매핑 오류 등 에러 리포팅
+ */
+export declare class KpiFormulaService {
+    /**
+     * formula 문자열에서 Metric 코드(변수명) 추출
+     * @param formula KPI formula (예: 'defect_count / total_count * 100')
+     * @returns string[] 추출된 Metric 코드 리스트
+     */
+    extractMetricCodes(formula: string): string[];
+    /**
+     * 순수(DB 무관) 구문 검증 — calculator/validate 로 위임 (단위 테스트는 그쪽에서).
+     */
+    validateFormulaSyntax(formula: string): import("../../calculator/validate.js").FormulaSyntaxResult;
+    /**
+     * formula 검증 + metric 참조/순환참조 검사.
+     *
+     * 정책:
+     *  - **에러(저장 거부)**: 구문 오류, 미지 함수, 순환참조.
+     *  - **경고(저장 허용)**: 미정의 metric, 데이터셋 필드 미매핑. (metric 시딩 순서 등 실무 유연성)
+     *
+     * @returns { valid, errors, warnings } — valid 는 errors 가 없을 때 true (warnings 무관).
+     */
+    validateFormula(formula: string, visited?: Set<string>): Promise<FormulaValidationResult>;
+    /**
+     * 계층 구조 KPI의 값을 자식 KPI들로부터 집계 계산
+     * @param kpiId 부모 KPI ID
+     * @param valueDate 계산 대상 날짜
+     * @param org 조직 단위
+     * @returns Promise<number | null> 집계된 값
+     */
+    calculateHierarchicalValue(kpiId: string, valueDate: string, org?: string): Promise<number | null>;
+    /**
+     * KPI가 순환 참조를 생성하는지 확인
+     * @param kpiId KPI ID
+     * @param parentId 설정하려는 부모 KPI ID
+     * @returns Promise<boolean> 순환 참조 여부
+     */
+    hasCircularReference(kpiId: string, parentId: string): Promise<boolean>;
+}

package/dist-server/service/kpi/kpi-formula.service.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KpiFormulaService = void 0;
+const shell_1 = require("@things-factory/shell");
+const kpi_metric_1 = require("../kpi-metric/kpi-metric");
+const kpi_1 = require("./kpi");
+const kpi_value_1 = require("../kpi-value/kpi-value");
+const kpi_org_scope_1 = require("../kpi-org-scope/kpi-org-scope");
+const validate_js_1 = require("../../calculator/validate.js");
+/**
+ * KPI formula 파싱/검증/매핑 유효성 검사 서비스
+ * - formula에서 Metric 코드(변수명) 추출
+ * - 각 Metric의 존재/매핑 유효성 검사
+ * - 구문 오류, 미정의 Metric, 매핑 오류 등 에러 리포팅
+ */
+class KpiFormulaService {
+    /**
+     * formula 문자열에서 Metric 코드(변수명) 추출
+     * @param formula KPI formula (예: 'defect_count / total_count * 100')
+     * @returns string[] 추출된 Metric 코드 리스트
+     */
+    extractMetricCodes(formula) {
+        // 변수명: 알파벳/언더스코어로 시작, 숫자/알파벳/언더스코어 포함
+        const regex = /[a-zA-Z_][a-zA-Z0-9_]*/g;
+        // 숫자/예약어/연산자 제외(후처리 필요)
+        const reserved = new Set(['if', 'else', 'return', 'true', 'false']);
+        return Array.from(new Set((formula.match(regex) || []).filter(code => isNaN(Number(code)) && !reserved.has(code))));
+    }
+    /**
+     * 순수(DB 무관) 구문 검증 — calculator/validate 로 위임 (단위 테스트는 그쪽에서).
+     */
+    validateFormulaSyntax(formula) {
+        return (0, validate_js_1.validateFormulaSyntax)(formula);
+    }
+    /**
+     * formula 검증 + metric 참조/순환참조 검사.
+     *
+     * 정책:
+     *  - **에러(저장 거부)**: 구문 오류, 미지 함수, 순환참조.
+     *  - **경고(저장 허용)**: 미정의 metric, 데이터셋 필드 미매핑. (metric 시딩 순서 등 실무 유연성)
+     *
+     * @returns { valid, errors, warnings } — valid 는 errors 가 없을 때 true (warnings 무관).
+     */
+    async validateFormula(formula, visited = new Set()) {
+        // 1) 순수 구문/함수 검증 — 하드 에러면 즉시 실패
+        const { errors, warnings, variables } = this.validateFormulaSyntax(formula);
+        if (errors.length)
+            return { valid: false, errors, warnings };
+        // 2) metric 참조 검증 (DB) — 미존재/미매핑은 경고, 순환참조는 에러
+        const metricRepo = (0, shell_1.getRepository)(kpi_metric_1.KpiMetric);
+        for (const code of variables) {
+            if (visited.has(code)) {
+                errors.push(`순환참조 감지: ${Array.from(visited).join(' → ')} → ${code}`);
+                continue;
+            }
+            visited.add(code);
+            const metric = await metricRepo.findOne({ where: { name: code } });
+            if (!metric) {
+                warnings.push(`Metric '${code}' 미정의 (경고 — 저장은 허용)`);
+                visited.delete(code);
+                continue;
+            }
+            if (!metric.dataSetId || !metric.fieldName) {
+                warnings.push(`Metric '${code}' 데이터셋 필드 미매핑 (경고)`);
+            }
+            // metric 이 자체 formula 를 가지면 재귀 검증(순환참조 포함)
+            if (metric.formula) {
+                const sub = await this.validateFormula(metric.formula, new Set(visited));
+                errors.push(...sub.errors);
+                warnings.push(...sub.warnings);
+            }
+            visited.delete(code);
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    /**
+     * 계층 구조 KPI의 값을 자식 KPI들로부터 집계 계산
+     * @param kpiId 부모 KPI ID
+     * @param valueDate 계산 대상 날짜
+     * @param org 조직 단위
+     * @returns Promise<number | null> 집계된 값
+     */
+    async calculateHierarchicalValue(kpiId, valueDate, org) {
+        const kpiRepo = (0, shell_1.getRepository)(kpi_1.Kpi);
+        const kpi = await kpiRepo.findOne({
+            where: { id: kpiId },
+            relations: ['children']
+        });
+        if (!kpi || !kpi.children || kpi.children.length === 0) {
+            return null;
+        }
+        const childValues = [];
+        const childWeights = [];
+        for (const child of kpi.children) {
+            let childValue = null;
+            if (child.isLeaf) {
+                // Leaf KPI인 경우 KpiValue에서 실제 값을 가져옴
+                const kpiValueRepo = (0, shell_1.getRepository)(kpi_value_1.KpiValue);
+                let kpiValue = null;
+                if (org) {
+                    const kpiOrgScope = await (0, shell_1.getRepository)(kpi_org_scope_1.KpiOrgScope).findOne({
+                        where: { org: org, domain: { id: child.domain?.id } }
+                    });
+                    if (kpiOrgScope) {
+                        kpiValue = await kpiValueRepo.findOne({
+                            where: {
+                                kpi: { id: child.id },
+                                valueDate,
+                                kpiOrgScope: { id: kpiOrgScope.id }
+                            }
+                        });
+                    }
+                }
+                else {
+                    // org가 없는 경우 kpiOrgScope 없이 조회 
+                    kpiValue = await kpiValueRepo.findOne({
+                        where: {
+                            kpi: { id: child.id },
+                            valueDate,
+                            kpiOrgScope: null
+                        }
+                    });
+                }
+                childValue = kpiValue?.value || null;
+            }
+            else {
+                // 중간 노드인 경우 재귀적으로 계산
+                childValue = await this.calculateHierarchicalValue(child.id, valueDate, org);
+            }
+            if (childValue !== null) {
+                childValues.push(childValue);
+                childWeights.push(child.weight || 1);
+            }
+        }
+        if (childValues.length === 0) {
+            return null;
+        }
+        // 가중 평균 계산
+        const totalWeight = childWeights.reduce((sum, weight) => sum + weight, 0);
+        const weightedSum = childValues.reduce((sum, value, index) => sum + value * childWeights[index], 0);
+        return totalWeight > 0 ? weightedSum / totalWeight : null;
+    }
+    /**
+     * KPI가 순환 참조를 생성하는지 확인
+     * @param kpiId KPI ID
+     * @param parentId 설정하려는 부모 KPI ID
+     * @returns Promise<boolean> 순환 참조 여부
+     */
+    async hasCircularReference(kpiId, parentId) {
+        if (kpiId === parentId) {
+            return true;
+        }
+        const kpiRepo = (0, shell_1.getRepository)(kpi_1.Kpi);
+        const parent = await kpiRepo.findOne({
+            where: { id: parentId },
+            relations: ['parent']
+        });
+        if (!parent || !parent.parent) {
+            return false;
+        }
+        return await this.hasCircularReference(kpiId, parent.parent.id);
+    }
+}
+exports.KpiFormulaService = KpiFormulaService;
+//# sourceMappingURL=kpi-formula.service.js.map

package/dist-server/service/kpi/kpi-formula.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-formula.service.js","sourceRoot":"","sources":["../../../server/service/kpi/kpi-formula.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository } from '@things-factory/shell'\nimport { KpiMetric } from '../kpi-metric/kpi-metric'\nimport { Kpi } from './kpi'\nimport { KpiValue } from '../kpi-value/kpi-value'\nimport { KpiOrgScope } from '../kpi-org-scope/kpi-org-scope'\nimport { validateFormulaSyntax } from '../../calculator/validate.js'\n\nexport interface FormulaValidationResult {\n  /** 하드 에러(구문/미지 함수/순환참조)가 없으면 true. 경고는 valid 에 영향 없음. */\n  valid: boolean\n  errors: string[]\n  warnings: string[]\n}\n\n/**\n * KPI formula 파싱/검증/매핑 유효성 검사 서비스\n * - formula에서 Metric 코드(변수명) 추출\n * - 각 Metric의 존재/매핑 유효성 검사\n * - 구문 오류, 미정의 Metric, 매핑 오류 등 에러 리포팅\n */\nexport class KpiFormulaService {\n  /**\n   * formula 문자열에서 Metric 코드(변수명) 추출\n   * @param formula KPI formula (예: 'defect_count / total_count * 100')\n   * @returns string[] 추출된 Metric 코드 리스트\n   */\n  extractMetricCodes(formula: string): string[] {\n    // 변수명: 알파벳/언더스코어로 시작, 숫자/알파벳/언더스코어 포함\n    const regex = /[a-zA-Z_][a-zA-Z0-9_]*/g\n    // 숫자/예약어/연산자 제외(후처리 필요)\n    const reserved = new Set(['if', 'else', 'return', 'true', 'false'])\n    return Array.from(new Set((formula.match(regex) || []).filter(code => isNaN(Number(code)) && !reserved.has(code))))\n  }\n\n  /**\n   * 순수(DB 무관) 구문 검증 — calculator/validate 로 위임 (단위 테스트는 그쪽에서).\n   */\n  validateFormulaSyntax(formula: string) {\n    return validateFormulaSyntax(formula)\n  }\n\n  /**\n   * formula 검증 + metric 참조/순환참조 검사.\n   *\n   * 정책:\n   *  - **에러(저장 거부)**: 구문 오류, 미지 함수, 순환참조.\n   *  - **경고(저장 허용)**: 미정의 metric, 데이터셋 필드 미매핑. (metric 시딩 순서 등 실무 유연성)\n   *\n   * @returns { valid, errors, warnings } — valid 는 errors 가 없을 때 true (warnings 무관).\n   */\n  async validateFormula(formula: string, visited: Set<string> = new Set()): Promise<FormulaValidationResult> {\n    // 1) 순수 구문/함수 검증 — 하드 에러면 즉시 실패\n    const { errors, warnings, variables } = this.validateFormulaSyntax(formula)\n    if (errors.length) return { valid: false, errors, warnings }\n\n    // 2) metric 참조 검증 (DB) — 미존재/미매핑은 경고, 순환참조는 에러\n    const metricRepo = getRepository(KpiMetric)\n    for (const code of variables) {\n      if (visited.has(code)) {\n        errors.push(`순환참조 감지: ${Array.from(visited).join(' → ')} → ${code}`)\n        continue\n      }\n      visited.add(code)\n      const metric = await metricRepo.findOne({ where: { name: code } })\n      if (!metric) {\n        warnings.push(`Metric '${code}' 미정의 (경고 — 저장은 허용)`)\n        visited.delete(code)\n        continue\n      }\n      if (!metric.dataSetId || !metric.fieldName) {\n        warnings.push(`Metric '${code}' 데이터셋 필드 미매핑 (경고)`)\n      }\n      // metric 이 자체 formula 를 가지면 재귀 검증(순환참조 포함)\n      if ((metric as any).formula) {\n        const sub = await this.validateFormula((metric as any).formula, new Set(visited))\n        errors.push(...sub.errors)\n        warnings.push(...sub.warnings)\n      }\n      visited.delete(code)\n    }\n    return { valid: errors.length === 0, errors, warnings }\n  }\n\n  /**\n   * 계층 구조 KPI의 값을 자식 KPI들로부터 집계 계산\n   * @param kpiId 부모 KPI ID\n   * @param valueDate 계산 대상 날짜\n   * @param org 조직 단위\n   * @returns Promise<number | null> 집계된 값\n   */\n  async calculateHierarchicalValue(kpiId: string, valueDate: string, org?: string): Promise<number | null> {\n    const kpiRepo = getRepository(Kpi)\n    const kpi = await kpiRepo.findOne({\n      where: { id: kpiId },\n      relations: ['children']\n    })\n\n    if (!kpi || !kpi.children || kpi.children.length === 0) {\n      return null\n    }\n\n    const childValues: number[] = []\n    const childWeights: number[] = []\n\n    for (const child of kpi.children) {\n      let childValue: number | null = null\n      \n      if (child.isLeaf) {\n        // Leaf KPI인 경우 KpiValue에서 실제 값을 가져옴\n        const kpiValueRepo = getRepository(KpiValue)\n        let kpiValue: KpiValue | null = null\n        if (org) {\n          const kpiOrgScope = await getRepository(KpiOrgScope).findOne({\n            where: { org: org, domain: { id: child.domain?.id } }\n          })\n          if (kpiOrgScope) {\n            kpiValue = await kpiValueRepo.findOne({ \n              where: { \n                kpi: { id: child.id }, \n                valueDate,\n                kpiOrgScope: { id: kpiOrgScope.id }\n              }\n            })\n          }\n        } else {\n          // org가 없는 경우 kpiOrgScope 없이 조회 \n          kpiValue = await kpiValueRepo.findOne({ \n            where: { \n              kpi: { id: child.id }, \n              valueDate,\n              kpiOrgScope: null\n            }\n          })\n        }\n        childValue = kpiValue?.value || null\n      } else {\n        // 중간 노드인 경우 재귀적으로 계산\n        childValue = await this.calculateHierarchicalValue(child.id, valueDate, org)\n      }\n\n      if (childValue !== null) {\n        childValues.push(childValue)\n        childWeights.push(child.weight || 1)\n      }\n    }\n\n    if (childValues.length === 0) {\n      return null\n    }\n\n    // 가중 평균 계산\n    const totalWeight = childWeights.reduce((sum, weight) => sum + weight, 0)\n    const weightedSum = childValues.reduce((sum, value, index) => sum + value * childWeights[index], 0)\n    \n    return totalWeight > 0 ? weightedSum / totalWeight : null\n  }\n\n  /**\n   * KPI가 순환 참조를 생성하는지 확인\n   * @param kpiId KPI ID\n   * @param parentId 설정하려는 부모 KPI ID\n   * @returns Promise<boolean> 순환 참조 여부\n   */\n  async hasCircularReference(kpiId: string, parentId: string): Promise<boolean> {\n    if (kpiId === parentId) {\n      return true\n    }\n\n    const kpiRepo = getRepository(Kpi)\n    const parent = await kpiRepo.findOne({\n      where: { id: parentId },\n      relations: ['parent']\n    })\n\n    if (!parent || !parent.parent) {\n      return false\n    }\n\n    return await this.hasCircularReference(kpiId, parent.parent.id)\n  }\n}\n"]}

package/dist-server/service/kpi/kpi-grade.types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * KPI 성과 점수 lookup table 타입 정의
+ * 복잡한 성과 점수 변환을 수식으로 표현하기 어려운 경우 사용
+ */
+export interface KpiScore {
+    /** 성과 지수명 (예: A, B, C, 우수, 양호 등) */
+    name: string;
+    /** 성과 점수 변환 기준 최소값 */
+    minValue: number;
+    /** 성과 점수 변환 기준 최대값 */
+    maxValue: number;
+    /** 성과 지수 점수 (선택사항) */
+    score?: number;
+    /** 성과 지수 색상 (선택사항) */
+    color?: string;
+    /** 성과 지수 설명 (선택사항) */
+    description?: string;
+}
+/**
+ * KPI 성과 점수 lookup table 배열 타입
+ */
+export type KpiScores = KpiScore[];

package/dist-server/service/kpi/kpi-grade.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=kpi-grade.types.js.map

package/dist-server/service/kpi/kpi-grade.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-grade.types.js","sourceRoot":"","sources":["../../../server/service/kpi/kpi-grade.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * KPI 성과 점수 lookup table 타입 정의\n * 복잡한 성과 점수 변환을 수식으로 표현하기 어려운 경우 사용\n */\nexport interface KpiScore {\n  /** 성과 지수명 (예: A, B, C, 우수, 양호 등) */\n  name: string\n\n  /** 성과 점수 변환 기준 최소값 */\n  minValue: number\n\n  /** 성과 점수 변환 기준 최대값 */\n  maxValue: number\n\n  /** 성과 지수 점수 (선택사항) */\n  score?: number\n\n  /** 성과 지수 색상 (선택사항) */\n  color?: string\n\n  /** 성과 지수 설명 (선택사항) */\n  description?: string\n}\n\n/**\n * KPI 성과 점수 lookup table 배열 타입\n */\nexport type KpiScores = KpiScore[]\n"]}

package/dist-server/service/kpi/kpi-history.d.ts

@@ -0,0 +1,29 @@
+import { HistoryActionType, HistoryEntityInterface } from '@operato/typeorm-history';
+import { User } from '@things-factory/auth-base';
+import { Domain } from '@things-factory/shell';
+import { Kpi, KpiStatus, KpiPeriodType } from './kpi';
+import { KpiScores } from './kpi-grade.types';
+export declare class KpiHistory implements HistoryEntityInterface<Kpi> {
+    readonly id: string;
+    version?: number;
+    domain?: Domain;
+    domainId?: string;
+    name: string;
+    description?: string;
+    formula?: string;
+    active?: boolean;
+    state?: KpiStatus;
+    thumbnail?: string;
+    grades?: KpiScores;
+    weight?: number;
+    periodType: KpiPeriodType;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    originalId: string;
+    action: HistoryActionType;
+}