@things-factory/kpi 10.1.248 → 10.1.249

package/dist-server/calculator/parser.js

@@ -0,0 +1,185 @@
+"use strict";
+// KPI formula 파서: 수식 문자열을 AST로 변환
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFormula = parseFormula;
+exports.collectVariableNames = collectVariableNames;
+exports.collectFunctionNames = collectFunctionNames;
+// 토큰 타입 정의
+const TOKEN_REGEX = /\s*(\d+\.\d+|\d+|\[.*?\]|[A-Za-z_][A-Za-z0-9_]*|[+\-*/(),])/y;
+function tokenize(formula) {
+    const tokens = [];
+    let m;
+    let lastIndex = 0;
+    while ((m = TOKEN_REGEX.exec(formula))) {
+        lastIndex = TOKEN_REGEX.lastIndex;
+        // m[0]은 공백 포함, m[1]은 capturing group (공백 제외)
+        const raw = m[1];
+        if (/^\d/.test(raw)) {
+            tokens.push({ type: 'number', value: raw });
+        }
+        else if (/^\[.*\]$/.test(raw)) {
+            tokens.push({ type: 'variable', value: raw.slice(1, -1) });
+        }
+        else if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(raw)) {
+            tokens.push({ type: 'function', value: raw });
+        }
+        else if (/^[+\-*/]$/.test(raw)) {
+            tokens.push({ type: 'operator', value: raw });
+        }
+        else if (/^[(),]$/.test(raw)) {
+            if (raw === ',')
+                tokens.push({ type: 'comma', value: raw });
+            else
+                tokens.push({ type: 'paren', value: raw });
+        }
+    }
+    if (lastIndex < formula.length) {
+        throw new Error('Unexpected token at: ' + formula.slice(lastIndex));
+    }
+    return tokens;
+}
+// 파서 구현 (재귀 하향, 연산자 우선순위, 함수/변수/숫자/괄호 지원)
+function parseFormula(formula) {
+    const tokens = tokenize(formula);
+    let pos = 0;
+    function peek() {
+        return tokens[pos];
+    }
+    function next() {
+        return tokens[pos++];
+    }
+    function expect(type, value) {
+        const t = next();
+        if (!t || t.type !== type || (value && t.value !== value))
+            throw new Error('Expected ' + type + (value ? ':' + value : ''));
+        return t;
+    }
+    function parsePrimary() {
+        const t = peek();
+        if (!t)
+            throw new Error('Unexpected end');
+        if (t.type === 'number') {
+            next();
+            return { type: 'number', value: parseFloat(t.value) };
+        }
+        if (t.type === 'variable') {
+            next();
+            return { type: 'variable', name: t.value };
+        }
+        if (t.type === 'function') {
+            // function 타입 토큰을 만났을 때, 다음 토큰이 '('인지 확인
+            const name = t.value;
+            next();
+            // 다음 토큰이 '('이면 함수 호출, 아니면 변수로 처리
+            if (peek() && peek().type === 'paren' && peek().value === '(') {
+                // 함수 호출: func(expr, ...)
+                expect('paren', '(');
+                const args = [];
+                if ((peek() && peek().type !== 'paren') || (peek() && peek().value !== ')')) {
+                    while (true) {
+                        args.push(parseExpr());
+                        if (peek() && peek().type === 'comma') {
+                            next();
+                        }
+                        else
+                            break;
+                    }
+                }
+                expect('paren', ')');
+                return { type: 'function', name, args };
+            }
+            else {
+                // 변수로 처리
+                return { type: 'variable', name };
+            }
+        }
+        if (t.type === 'operator' && t.value === '-') {
+            next();
+            return { type: 'unary', op: '-', arg: parsePrimary() };
+        }
+        if (t.type === 'paren' && t.value === '(') {
+            next();
+            const node = parseExpr();
+            expect('paren', ')');
+            return node;
+        }
+        throw new Error('Unexpected token: ' + t.type + ':' + t.value);
+    }
+    function parseMulDiv() {
+        let node = parsePrimary();
+        while (peek() && peek().type === 'operator' && (peek().value === '*' || peek().value === '/')) {
+            const op = next().value;
+            node = { type: 'binary', op, left: node, right: parsePrimary() };
+        }
+        return node;
+    }
+    function parseAddSub() {
+        let node = parseMulDiv();
+        while (peek() && peek().type === 'operator' && (peek().value === '+' || peek().value === '-')) {
+            const op = next().value;
+            node = { type: 'binary', op, left: node, right: parseMulDiv() };
+        }
+        return node;
+    }
+    function parseExpr() {
+        return parseAddSub();
+    }
+    const ast = parseExpr();
+    if (pos < tokens.length)
+        throw new Error('Unexpected token at end: ' + JSON.stringify(tokens[pos]));
+    return ast;
+}
+/**
+ * AST 안의 모든 변수명을 (중복 제거하여) 수집한다.
+ *
+ * 정규식 기반 추출(예: `[a-zA-Z_]\w*`)은 `[한글 변수명]`·공백 포함 이름을 놓치지만,
+ * 파서가 만든 AST 의 variable 노드는 대괄호가 벗겨진 실제 이름을 담으므로 정확하다.
+ * aggregate 등에서 "이 수식이 참조하는 metric 이름들"을 얻는 신뢰 가능한 경로.
+ */
+function collectVariableNames(node) {
+    const out = new Set();
+    const walk = (n) => {
+        switch (n.type) {
+            case 'variable':
+                out.add(n.name);
+                break;
+            case 'function':
+                n.args.forEach(walk);
+                break;
+            case 'binary':
+                walk(n.left);
+                walk(n.right);
+                break;
+            case 'unary':
+                walk(n.arg);
+                break;
+        }
+    };
+    walk(node);
+    return Array.from(out);
+}
+/**
+ * AST 안의 모든 함수명을 (중복 제거하여) 수집한다.
+ * formula 검증에서 "알 수 없는 함수" 를 잡는 데 쓴다.
+ */
+function collectFunctionNames(node) {
+    const out = new Set();
+    const walk = (n) => {
+        switch (n.type) {
+            case 'function':
+                out.add(n.name);
+                n.args.forEach(walk);
+                break;
+            case 'binary':
+                walk(n.left);
+                walk(n.right);
+                break;
+            case 'unary':
+                walk(n.arg);
+                break;
+        }
+    };
+    walk(node);
+    return Array.from(out);
+}
+//# sourceMappingURL=parser.js.map

package/dist-server/calculator/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../server/calculator/parser.ts"],"names":[],"mappings":"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","sourcesContent":["// KPI formula 파서: 수식 문자열을 AST로 변환\n\nexport type FormulaNode =\n  | { type: 'number'; value: number }\n  | { type: 'variable'; name: string }\n  | { type: 'function'; name: string; args: FormulaNode[] }\n  | { type: 'binary'; op: string; left: FormulaNode; right: FormulaNode }\n  | { type: 'unary'; op: string; arg: FormulaNode }\n\n// 토큰 타입 정의\nconst TOKEN_REGEX = /\\s*(\\d+\\.\\d+|\\d+|\\[.*?\\]|[A-Za-z_][A-Za-z0-9_]*|[+\\-*/(),])/y\n\ninterface Token {\n  type: 'number' | 'variable' | 'function' | 'operator' | 'paren' | 'comma'\n  value: string\n}\n\nfunction tokenize(formula: string): Token[] {\n  const tokens: Token[] = []\n  let m: RegExpExecArray | null\n  let lastIndex = 0\n  while ((m = TOKEN_REGEX.exec(formula))) {\n    lastIndex = TOKEN_REGEX.lastIndex\n    // m[0]은 공백 포함, m[1]은 capturing group (공백 제외)\n    const raw = m[1]\n    if (/^\\d/.test(raw)) {\n      tokens.push({ type: 'number', value: raw })\n    } else if (/^\\[.*\\]$/.test(raw)) {\n      tokens.push({ type: 'variable', value: raw.slice(1, -1) })\n    } else if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(raw)) {\n      tokens.push({ type: 'function', value: raw })\n    } else if (/^[+\\-*/]$/.test(raw)) {\n      tokens.push({ type: 'operator', value: raw })\n    } else if (/^[(),]$/.test(raw)) {\n      if (raw === ',') tokens.push({ type: 'comma', value: raw })\n      else tokens.push({ type: 'paren', value: raw })\n    }\n  }\n  if (lastIndex < formula.length) {\n    throw new Error('Unexpected token at: ' + formula.slice(lastIndex))\n  }\n  return tokens\n}\n\n// 파서 구현 (재귀 하향, 연산자 우선순위, 함수/변수/숫자/괄호 지원)\nexport function parseFormula(formula: string): FormulaNode {\n  const tokens = tokenize(formula)\n  let pos = 0\n\n  function peek() {\n    return tokens[pos]\n  }\n  function next() {\n    return tokens[pos++]\n  }\n  function expect(type: string, value?: string) {\n    const t = next()\n    if (!t || t.type !== type || (value && t.value !== value))\n      throw new Error('Expected ' + type + (value ? ':' + value : ''))\n    return t\n  }\n\n  function parsePrimary(): FormulaNode {\n    const t = peek()\n    if (!t) throw new Error('Unexpected end')\n    if (t.type === 'number') {\n      next()\n      return { type: 'number', value: parseFloat(t.value) }\n    }\n    if (t.type === 'variable') {\n      next()\n      return { type: 'variable', name: t.value }\n    }\n    if (t.type === 'function') {\n      // function 타입 토큰을 만났을 때, 다음 토큰이 '('인지 확인\n      const name = t.value\n      next()\n\n      // 다음 토큰이 '('이면 함수 호출, 아니면 변수로 처리\n      if (peek() && peek().type === 'paren' && peek().value === '(') {\n        // 함수 호출: func(expr, ...)\n        expect('paren', '(')\n        const args: FormulaNode[] = []\n        if ((peek() && peek().type !== 'paren') || (peek() && peek().value !== ')')) {\n          while (true) {\n            args.push(parseExpr())\n            if (peek() && peek().type === 'comma') {\n              next()\n            } else break\n          }\n        }\n        expect('paren', ')')\n        return { type: 'function', name, args }\n      } else {\n        // 변수로 처리\n        return { type: 'variable', name }\n      }\n    }\n    if (t.type === 'operator' && t.value === '-') {\n      next()\n      return { type: 'unary', op: '-', arg: parsePrimary() }\n    }\n    if (t.type === 'paren' && t.value === '(') {\n      next()\n      const node = parseExpr()\n      expect('paren', ')')\n      return node\n    }\n    throw new Error('Unexpected token: ' + t.type + ':' + t.value)\n  }\n\n  function parseMulDiv(): FormulaNode {\n    let node = parsePrimary()\n    while (peek() && peek().type === 'operator' && (peek().value === '*' || peek().value === '/')) {\n      const op = next().value\n      node = { type: 'binary', op, left: node, right: parsePrimary() }\n    }\n    return node\n  }\n\n  function parseAddSub(): FormulaNode {\n    let node = parseMulDiv()\n    while (peek() && peek().type === 'operator' && (peek().value === '+' || peek().value === '-')) {\n      const op = next().value\n      node = { type: 'binary', op, left: node, right: parseMulDiv() }\n    }\n    return node\n  }\n\n  function parseExpr(): FormulaNode {\n    return parseAddSub()\n  }\n\n  const ast = parseExpr()\n  if (pos < tokens.length) throw new Error('Unexpected token at end: ' + JSON.stringify(tokens[pos]))\n  return ast\n}\n\n/**\n * AST 안의 모든 변수명을 (중복 제거하여) 수집한다.\n *\n * 정규식 기반 추출(예: `[a-zA-Z_]\\w*`)은 `[한글 변수명]`·공백 포함 이름을 놓치지만,\n * 파서가 만든 AST 의 variable 노드는 대괄호가 벗겨진 실제 이름을 담으므로 정확하다.\n * aggregate 등에서 \"이 수식이 참조하는 metric 이름들\"을 얻는 신뢰 가능한 경로.\n */\nexport function collectVariableNames(node: FormulaNode): string[] {\n  const out = new Set<string>()\n  const walk = (n: FormulaNode): void => {\n    switch (n.type) {\n      case 'variable':\n        out.add(n.name)\n        break\n      case 'function':\n        n.args.forEach(walk)\n        break\n      case 'binary':\n        walk(n.left)\n        walk(n.right)\n        break\n      case 'unary':\n        walk(n.arg)\n        break\n    }\n  }\n  walk(node)\n  return Array.from(out)\n}\n\n/**\n * AST 안의 모든 함수명을 (중복 제거하여) 수집한다.\n * formula 검증에서 \"알 수 없는 함수\" 를 잡는 데 쓴다.\n */\nexport function collectFunctionNames(node: FormulaNode): string[] {\n  const out = new Set<string>()\n  const walk = (n: FormulaNode): void => {\n    switch (n.type) {\n      case 'function':\n        out.add(n.name)\n        n.args.forEach(walk)\n        break\n      case 'binary':\n        walk(n.left)\n        walk(n.right)\n        break\n      case 'unary':\n        walk(n.arg)\n        break\n    }\n  }\n  walk(node)\n  return Array.from(out)\n}\n"]}

package/dist-server/calculator/provider.d.ts

@@ -0,0 +1,8 @@
+export interface ValueProvider {
+    get(name: string): any | Promise<any>;
+}
+export declare class ObjectValueProvider implements ValueProvider {
+    private values;
+    constructor(values: Record<string, any>);
+    get(name: string): any;
+}

package/dist-server/calculator/provider.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectValueProvider = void 0;
+class ObjectValueProvider {
+    constructor(values) {
+        this.values = values;
+    }
+    get(name) {
+        return this.values[name];
+    }
+}
+exports.ObjectValueProvider = ObjectValueProvider;
+//# sourceMappingURL=provider.js.map

package/dist-server/calculator/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../server/calculator/provider.ts"],"names":[],"mappings":";;;AAIA,MAAa,mBAAmB;IAC9B,YAAoB,MAA2B;QAA3B,WAAM,GAAN,MAAM,CAAqB;IAAG,CAAC;IACnD,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;CACF;AALD,kDAKC","sourcesContent":["export interface ValueProvider {\n  get(name: string): any | Promise<any>\n}\n\nexport class ObjectValueProvider implements ValueProvider {\n  constructor(private values: Record<string, any>) {}\n  get(name: string) {\n    return this.values[name]\n  }\n}\n"]}

package/dist-server/calculator/score.d.ts

@@ -0,0 +1,21 @@
+import { FormulaFunctionMap } from './functions.js';
+export interface ScoreResult {
+    score: number;
+    calculationMethod: 'formula' | 'lookup';
+}
+/** grades lookup table 한 구간. */
+export interface GradeBand {
+    minValue: number;
+    maxValue: number;
+    score: number;
+}
+/**
+ * scoreFormula 로 성과 점수 계산. 수식에는 변수 `value`(측정값)만 제공된다.
+ * 결과가 유효한 수치가 아니면 null. (파싱/평가 예외는 호출측에서 처리)
+ */
+export declare function scoreFromFormula(scoreFormula: string | null | undefined, value: number, functions?: FormulaFunctionMap): Promise<ScoreResult | null>;
+/**
+ * grades lookup table 로 성과 점수 변환. value 가 속한 [minValue, maxValue] 구간의 score.
+ * @deprecated scoreFormula 로 대체 권장.
+ */
+export declare function scoreFromLookup(grades: GradeBand[] | null | undefined, value: number): ScoreResult | null;

package/dist-server/calculator/score.js

@@ -0,0 +1,36 @@
+"use strict";
+// KPI 성과 점수 계산 (순수 — DB/shell 무관, 단위 테스트 용이)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreFromFormula = scoreFromFormula;
+exports.scoreFromLookup = scoreFromLookup;
+const parser_js_1 = require("./parser.js");
+const evaluator_js_1 = require("./evaluator.js");
+const functions_js_1 = require("./functions.js");
+/**
+ * scoreFormula 로 성과 점수 계산. 수식에는 변수 `value`(측정값)만 제공된다.
+ * 결과가 유효한 수치가 아니면 null. (파싱/평가 예외는 호출측에서 처리)
+ */
+async function scoreFromFormula(scoreFormula, value, functions = functions_js_1.builtinFunctions) {
+    if (!scoreFormula)
+        return null;
+    const ast = (0, parser_js_1.parseFormula)(scoreFormula);
+    const provider = {
+        get: async (name) => (name === 'value' ? value : null)
+    };
+    const result = await (0, evaluator_js_1.evaluateFormula)(ast, { functions, provider });
+    if (result !== null && result !== undefined && !isNaN(result)) {
+        return { score: Number(result), calculationMethod: 'formula' };
+    }
+    return null;
+}
+/**
+ * grades lookup table 로 성과 점수 변환. value 가 속한 [minValue, maxValue] 구간의 score.
+ * @deprecated scoreFormula 로 대체 권장.
+ */
+function scoreFromLookup(grades, value) {
+    if (!grades || grades.length === 0)
+        return null;
+    const grade = grades.find(g => value >= g.minValue && value <= g.maxValue);
+    return grade ? { score: grade.score, calculationMethod: 'lookup' } : null;
+}
+//# sourceMappingURL=score.js.map

package/dist-server/calculator/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../server/calculator/score.ts"],"names":[],"mappings":";AAAA,6CAA6C;;AAsB7C,4CAiBC;AAMD,0CAIC;AA/CD,2CAA0C;AAC1C,iDAAgD;AAChD,iDAAqE;AAcrE;;;GAGG;AACI,KAAK,UAAU,gBAAgB,CACpC,YAAuC,EACvC,KAAa,EACb,YAAgC,+BAAgB;IAEhD,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAA;IAE9B,MAAM,GAAG,GAAG,IAAA,wBAAY,EAAC,YAAY,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG;QACf,GAAG,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;KAC/D,CAAA;IACD,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAe,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAA;IAElE,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAA;IAChE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,MAAsC,EAAE,KAAa;IACnF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC1E,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC3E,CAAC","sourcesContent":["// KPI 성과 점수 계산 (순수 — DB/shell 무관, 단위 테스트 용이)\n\nimport { parseFormula } from './parser.js'\nimport { evaluateFormula } from './evaluator.js'\nimport { builtinFunctions, FormulaFunctionMap } from './functions.js'\n\nexport interface ScoreResult {\n  score: number\n  calculationMethod: 'formula' | 'lookup'\n}\n\n/** grades lookup table 한 구간. */\nexport interface GradeBand {\n  minValue: number\n  maxValue: number\n  score: number\n}\n\n/**\n * scoreFormula 로 성과 점수 계산. 수식에는 변수 `value`(측정값)만 제공된다.\n * 결과가 유효한 수치가 아니면 null. (파싱/평가 예외는 호출측에서 처리)\n */\nexport async function scoreFromFormula(\n  scoreFormula: string | null | undefined,\n  value: number,\n  functions: FormulaFunctionMap = builtinFunctions\n): Promise<ScoreResult | null> {\n  if (!scoreFormula) return null\n\n  const ast = parseFormula(scoreFormula)\n  const provider = {\n    get: async (name: string) => (name === 'value' ? value : null)\n  }\n  const result = await evaluateFormula(ast, { functions, provider })\n\n  if (result !== null && result !== undefined && !isNaN(result)) {\n    return { score: Number(result), calculationMethod: 'formula' }\n  }\n  return null\n}\n\n/**\n * grades lookup table 로 성과 점수 변환. value 가 속한 [minValue, maxValue] 구간의 score.\n * @deprecated scoreFormula 로 대체 권장.\n */\nexport function scoreFromLookup(grades: GradeBand[] | null | undefined, value: number): ScoreResult | null {\n  if (!grades || grades.length === 0) return null\n  const grade = grades.find(g => value >= g.minValue && value <= g.maxValue)\n  return grade ? { score: grade.score, calculationMethod: 'lookup' } : null\n}\n"]}

package/dist-server/calculator/score.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-server/calculator/score.test.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const score_1 = require("./score");
+describe('scoreFromFormula (순수)', () => {
+    it('scoreFormula 없으면 null', async () => {
+        expect(await (0, score_1.scoreFromFormula)(null, 5)).toBeNull();
+        expect(await (0, score_1.scoreFromFormula)('', 5)).toBeNull();
+        expect(await (0, score_1.scoreFromFormula)(undefined, 5)).toBeNull();
+    });
+    it("변수 'value' 를 측정값으로 치환해 계산한다", async () => {
+        expect(await (0, score_1.scoreFromFormula)('value * 20', 4)).toEqual({ score: 80, calculationMethod: 'formula' });
+        expect(await (0, score_1.scoreFromFormula)('round(value / 2, 1)', 7)).toEqual({ score: 3.5, calculationMethod: 'formula' });
+    });
+    it('if() 로 분기 계산', async () => {
+        expect((await (0, score_1.scoreFromFormula)('if(value, 100, 0)', 3)).score).toBe(100);
+        expect((await (0, score_1.scoreFromFormula)('if(value, 100, 0)', 0)).score).toBe(0);
+    });
+    it('결과가 NaN 이면 null (예: 0/0)', async () => {
+        expect(await (0, score_1.scoreFromFormula)('value / value', 0)).toBeNull();
+    });
+    it('구문 오류는 예외로 전파된다 (서비스가 catch)', async () => {
+        await expect((0, score_1.scoreFromFormula)('value +', 5)).rejects.toThrow();
+    });
+});
+describe('scoreFromLookup (순수, deprecated)', () => {
+    const grades = [
+        { minValue: 0, maxValue: 10, score: 1 },
+        { minValue: 11, maxValue: 20, score: 2 },
+        { minValue: 21, maxValue: 100, score: 3 }
+    ];
+    it('grades 없으면 null', () => {
+        expect((0, score_1.scoreFromLookup)(undefined, 5)).toBeNull();
+        expect((0, score_1.scoreFromLookup)([], 5)).toBeNull();
+    });
+    it('구간에 맞는 score 반환 (경계 포함)', () => {
+        expect((0, score_1.scoreFromLookup)(grades, 5)).toEqual({ score: 1, calculationMethod: 'lookup' });
+        expect((0, score_1.scoreFromLookup)(grades, 0)).toEqual({ score: 1, calculationMethod: 'lookup' }); // minValue 포함
+        expect((0, score_1.scoreFromLookup)(grades, 10)).toEqual({ score: 1, calculationMethod: 'lookup' }); // maxValue 포함
+        expect((0, score_1.scoreFromLookup)(grades, 15)).toEqual({ score: 2, calculationMethod: 'lookup' });
+        expect((0, score_1.scoreFromLookup)(grades, 100)).toEqual({ score: 3, calculationMethod: 'lookup' });
+    });
+    it('어느 구간에도 없으면 null', () => {
+        expect((0, score_1.scoreFromLookup)(grades, 200)).toBeNull();
+        expect((0, score_1.scoreFromLookup)(grades, -1)).toBeNull();
+    });
+});
+//# sourceMappingURL=score.test.js.map

package/dist-server/calculator/score.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.test.js","sourceRoot":"","sources":["../../server/calculator/score.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { scoreFromFormula, scoreFromLookup } from './score'\n\ndescribe('scoreFromFormula (순수)', () => {\n  it('scoreFormula 없으면 null', async () => {\n    expect(await scoreFromFormula(null, 5)).toBeNull()\n    expect(await scoreFromFormula('', 5)).toBeNull()\n    expect(await scoreFromFormula(undefined, 5)).toBeNull()\n  })\n\n  it(\"변수 'value' 를 측정값으로 치환해 계산한다\", async () => {\n    expect(await scoreFromFormula('value * 20', 4)).toEqual({ score: 80, calculationMethod: 'formula' })\n    expect(await scoreFromFormula('round(value / 2, 1)', 7)).toEqual({ score: 3.5, calculationMethod: 'formula' })\n  })\n\n  it('if() 로 분기 계산', async () => {\n    expect((await scoreFromFormula('if(value, 100, 0)', 3))!.score).toBe(100)\n    expect((await scoreFromFormula('if(value, 100, 0)', 0))!.score).toBe(0)\n  })\n\n  it('결과가 NaN 이면 null (예: 0/0)', async () => {\n    expect(await scoreFromFormula('value / value', 0)).toBeNull()\n  })\n\n  it('구문 오류는 예외로 전파된다 (서비스가 catch)', async () => {\n    await expect(scoreFromFormula('value +', 5)).rejects.toThrow()\n  })\n})\n\ndescribe('scoreFromLookup (순수, deprecated)', () => {\n  const grades = [\n    { minValue: 0, maxValue: 10, score: 1 },\n    { minValue: 11, maxValue: 20, score: 2 },\n    { minValue: 21, maxValue: 100, score: 3 }\n  ]\n\n  it('grades 없으면 null', () => {\n    expect(scoreFromLookup(undefined, 5)).toBeNull()\n    expect(scoreFromLookup([], 5)).toBeNull()\n  })\n\n  it('구간에 맞는 score 반환 (경계 포함)', () => {\n    expect(scoreFromLookup(grades, 5)).toEqual({ score: 1, calculationMethod: 'lookup' })\n    expect(scoreFromLookup(grades, 0)).toEqual({ score: 1, calculationMethod: 'lookup' }) // minValue 포함\n    expect(scoreFromLookup(grades, 10)).toEqual({ score: 1, calculationMethod: 'lookup' }) // maxValue 포함\n    expect(scoreFromLookup(grades, 15)).toEqual({ score: 2, calculationMethod: 'lookup' })\n    expect(scoreFromLookup(grades, 100)).toEqual({ score: 3, calculationMethod: 'lookup' })\n  })\n\n  it('어느 구간에도 없으면 null', () => {\n    expect(scoreFromLookup(grades, 200)).toBeNull()\n    expect(scoreFromLookup(grades, -1)).toBeNull()\n  })\n})\n"]}

package/dist-server/calculator/validate.d.ts

@@ -0,0 +1,15 @@
+export interface FormulaSyntaxResult {
+    /** 하드 에러: 구문 오류, 미지 함수. */
+    errors: string[];
+    /** 경고(저장 허용). 이 순수 단계에선 비어있고, metric 존재 검사 등 DB 단계에서 채워짐. */
+    warnings: string[];
+    /** 수식이 참조하는 변수(=metric 이름) 목록. */
+    variables: string[];
+}
+/**
+ * 수식의 구문·함수 유효성만 검사한다 (DB 접근 없음).
+ *  - 파싱 실패 → 에러
+ *  - 화이트리스트에 없는 함수 → 에러
+ *  - 변수는 추출만 (존재 여부 판단은 호출측 DB 단계)
+ */
+export declare function validateFormulaSyntax(formula: string, knownFunctions?: Set<string>): FormulaSyntaxResult;

package/dist-server/calculator/validate.js

@@ -0,0 +1,30 @@
+"use strict";
+// KPI formula 구문 검증 (순수 — DB/shell 무관, 단위 테스트 용이)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFormulaSyntax = validateFormulaSyntax;
+const parser_js_1 = require("./parser.js");
+const functions_js_1 = require("./functions.js");
+/**
+ * 수식의 구문·함수 유효성만 검사한다 (DB 접근 없음).
+ *  - 파싱 실패 → 에러
+ *  - 화이트리스트에 없는 함수 → 에러
+ *  - 변수는 추출만 (존재 여부 판단은 호출측 DB 단계)
+ */
+function validateFormulaSyntax(formula, knownFunctions = new Set(Object.keys(functions_js_1.builtinFunctions))) {
+    const errors = [];
+    const warnings = [];
+    let ast;
+    try {
+        ast = (0, parser_js_1.parseFormula)(formula);
+    }
+    catch (e) {
+        errors.push(`구문 오류: ${e.message}`);
+        return { errors, warnings, variables: [] };
+    }
+    for (const fn of (0, parser_js_1.collectFunctionNames)(ast)) {
+        if (!knownFunctions.has(fn))
+            errors.push(`알 수 없는 함수: '${fn}'`);
+    }
+    return { errors, warnings, variables: (0, parser_js_1.collectVariableNames)(ast) };
+}
+//# sourceMappingURL=validate.js.map

package/dist-server/calculator/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../server/calculator/validate.ts"],"names":[],"mappings":";AAAA,kDAAkD;;AAoBlD,sDAoBC;AAtCD,2CAAsF;AACtF,iDAAiD;AAWjD;;;;;GAKG;AACH,SAAgB,qBAAqB,CACnC,OAAe,EACf,iBAA8B,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,+BAAgB,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,IAAI,GAAG,CAAA;IACP,IAAI,CAAC;QACH,GAAG,GAAG,IAAA,wBAAY,EAAC,OAAO,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,UAAW,CAAW,CAAC,OAAO,EAAE,CAAC,CAAA;QAC7C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAC5C,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,IAAA,gCAAoB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,CAAA;IAChE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAA,gCAAoB,EAAC,GAAG,CAAC,EAAE,CAAA;AACnE,CAAC","sourcesContent":["// KPI formula 구문 검증 (순수 — DB/shell 무관, 단위 테스트 용이)\n\nimport { parseFormula, collectVariableNames, collectFunctionNames } from './parser.js'\nimport { builtinFunctions } from './functions.js'\n\nexport interface FormulaSyntaxResult {\n  /** 하드 에러: 구문 오류, 미지 함수. */\n  errors: string[]\n  /** 경고(저장 허용). 이 순수 단계에선 비어있고, metric 존재 검사 등 DB 단계에서 채워짐. */\n  warnings: string[]\n  /** 수식이 참조하는 변수(=metric 이름) 목록. */\n  variables: string[]\n}\n\n/**\n * 수식의 구문·함수 유효성만 검사한다 (DB 접근 없음).\n *  - 파싱 실패 → 에러\n *  - 화이트리스트에 없는 함수 → 에러\n *  - 변수는 추출만 (존재 여부 판단은 호출측 DB 단계)\n */\nexport function validateFormulaSyntax(\n  formula: string,\n  knownFunctions: Set<string> = new Set(Object.keys(builtinFunctions))\n): FormulaSyntaxResult {\n  const errors: string[] = []\n  const warnings: string[] = []\n\n  let ast\n  try {\n    ast = parseFormula(formula)\n  } catch (e) {\n    errors.push(`구문 오류: ${(e as Error).message}`)\n    return { errors, warnings, variables: [] }\n  }\n\n  for (const fn of collectFunctionNames(ast)) {\n    if (!knownFunctions.has(fn)) errors.push(`알 수 없는 함수: '${fn}'`)\n  }\n\n  return { errors, warnings, variables: collectVariableNames(ast) }\n}\n"]}

package/dist-server/calculator/validate.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-server/calculator/validate.test.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const validate_1 = require("./validate");
+const parser_1 = require("./parser");
+describe('collectFunctionNames', () => {
+    it('중첩 함수명을 중복 없이 수집한다', () => {
+        expect((0, parser_1.collectFunctionNames)((0, parser_1.parseFormula)('sum(round([a], 2), avg([b], [c]))')).sort()).toEqual([
+            'avg',
+            'round',
+            'sum'
+        ]);
+    });
+    it('함수 없으면 빈 배열', () => {
+        expect((0, parser_1.collectFunctionNames)((0, parser_1.parseFormula)('[a] + [b]'))).toEqual([]);
+    });
+});
+describe('validateFormulaSyntax (순수, DB 무관)', () => {
+    it('정상 수식: 에러 없음 + 변수 추출', () => {
+        const r = (0, validate_1.validateFormulaSyntax)('([실제공사비] - [계획공사비]) / [계획공사비]');
+        expect(r.errors).toEqual([]);
+        expect(r.variables.sort()).toEqual(['계획공사비', '실제공사비'].sort());
+    });
+    it('구문 오류는 에러로 (파싱 실패)', () => {
+        expect((0, validate_1.validateFormulaSyntax)('[a] +').errors.length).toBeGreaterThan(0);
+        expect((0, validate_1.validateFormulaSyntax)('(1 + 2').errors[0]).toMatch(/구문 오류/);
+        expect((0, validate_1.validateFormulaSyntax)('1 @ 2').errors[0]).toMatch(/구문 오류/);
+    });
+    it('알 수 없는 함수는 에러', () => {
+        expect((0, validate_1.validateFormulaSyntax)('bogus([a])').errors.some(e => /알 수 없는 함수/.test(e))).toBe(true);
+    });
+    it('빌트인 함수(sum/round/if)는 통과', () => {
+        expect((0, validate_1.validateFormulaSyntax)('round(sum([a], [b]) / 2, 1)').errors).toEqual([]);
+        expect((0, validate_1.validateFormulaSyntax)('if([a], [b], [c])').errors).toEqual([]);
+    });
+    it('순수 단계에서 warnings 는 비어있고, 미정의 변수도 여기선 에러 아님(변수로 추출만)', () => {
+        const r = (0, validate_1.validateFormulaSyntax)('[없는변수] / 2');
+        expect(r.warnings).toEqual([]);
+        expect(r.errors).toEqual([]);
+        expect(r.variables).toEqual(['없는변수']);
+    });
+    it('커스텀 함수 화이트리스트를 존중한다', () => {
+        expect((0, validate_1.validateFormulaSyntax)('myfn(1)', new Set(['myfn'])).errors).toEqual([]);
+    });
+});
+//# sourceMappingURL=validate.test.js.map

package/dist-server/calculator/validate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.test.js","sourceRoot":"","sources":["../../server/calculator/validate.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { validateFormulaSyntax } from './validate'\nimport { parseFormula, collectFunctionNames } from './parser'\n\ndescribe('collectFunctionNames', () => {\n  it('중첩 함수명을 중복 없이 수집한다', () => {\n    expect(collectFunctionNames(parseFormula('sum(round([a], 2), avg([b], [c]))')).sort()).toEqual([\n      'avg',\n      'round',\n      'sum'\n    ])\n  })\n  it('함수 없으면 빈 배열', () => {\n    expect(collectFunctionNames(parseFormula('[a] + [b]'))).toEqual([])\n  })\n})\n\ndescribe('validateFormulaSyntax (순수, DB 무관)', () => {\n  it('정상 수식: 에러 없음 + 변수 추출', () => {\n    const r = validateFormulaSyntax('([실제공사비] - [계획공사비]) / [계획공사비]')\n    expect(r.errors).toEqual([])\n    expect(r.variables.sort()).toEqual(['계획공사비', '실제공사비'].sort())\n  })\n\n  it('구문 오류는 에러로 (파싱 실패)', () => {\n    expect(validateFormulaSyntax('[a] +').errors.length).toBeGreaterThan(0)\n    expect(validateFormulaSyntax('(1 + 2').errors[0]).toMatch(/구문 오류/)\n    expect(validateFormulaSyntax('1 @ 2').errors[0]).toMatch(/구문 오류/)\n  })\n\n  it('알 수 없는 함수는 에러', () => {\n    expect(validateFormulaSyntax('bogus([a])').errors.some(e => /알 수 없는 함수/.test(e))).toBe(true)\n  })\n\n  it('빌트인 함수(sum/round/if)는 통과', () => {\n    expect(validateFormulaSyntax('round(sum([a], [b]) / 2, 1)').errors).toEqual([])\n    expect(validateFormulaSyntax('if([a], [b], [c])').errors).toEqual([])\n  })\n\n  it('순수 단계에서 warnings 는 비어있고, 미정의 변수도 여기선 에러 아님(변수로 추출만)', () => {\n    const r = validateFormulaSyntax('[없는변수] / 2')\n    expect(r.warnings).toEqual([])\n    expect(r.errors).toEqual([])\n    expect(r.variables).toEqual(['없는변수'])\n  })\n\n  it('커스텀 함수 화이트리스트를 존중한다', () => {\n    expect(validateFormulaSyntax('myfn(1)', new Set(['myfn'])).errors).toEqual([])\n  })\n})\n"]}

package/dist-server/controllers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './kpi-metric-value-provider.js';
+export * from './kpi-value-provider.js';

package/dist-server/controllers/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./kpi-metric-value-provider.js"), exports);
+tslib_1.__exportStar(require("./kpi-value-provider.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/controllers/index.ts"],"names":[],"mappings":";;;AAAA,yEAA8C;AAC9C,kEAAuC","sourcesContent":["export * from './kpi-metric-value-provider.js'\nexport * from './kpi-value-provider.js'\n"]}

package/dist-server/controllers/kpi-metric-value-provider.d.ts

@@ -0,0 +1,11 @@
+import { ValueProvider } from '../calculator/provider';
+export declare class KpiMetricValueProvider implements ValueProvider {
+    private options;
+    constructor(options: {
+        valueDate: string;
+        org?: string;
+        domainId: string;
+        tx?: any;
+    });
+    get(name: string): Promise<number>;
+}

package/dist-server/controllers/kpi-metric-value-provider.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KpiMetricValueProvider = void 0;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const kpi_metric_1 = require("../service/kpi-metric/kpi-metric");
+const kpi_metric_value_1 = require("../service/kpi-metric-value/kpi-metric-value");
+class KpiMetricValueProvider {
+    constructor(options) {
+        this.options = options;
+    }
+    async get(name) {
+        const metricRepo = (0, shell_1.getRepository)(kpi_metric_1.KpiMetric, this.options.tx);
+        // KpiMetric '정의' 는 부모(admin) 도메인에 있을 수 있어 조상 도메인까지 포함해 조회한다.
+        // 단, KpiMetricValue '값' 은 테넌트(현재 도메인)에만 저장되므로 값 조회는 반드시
+        // 현재 도메인(this.options.domainId)으로만 한정한다 — 조상을 포함하면 부모/템플릿·타 테넌트
+        // 값을 집어 도메인 격리가 깨질 수 있다.
+        const domain = await (0, shell_1.getRepository)(shell_1.Domain, this.options.tx).findOne({ where: { id: this.options.domainId } });
+        const domainIds = domain ? await (0, shell_1.getDomainIdsWithAncestors)(domain) : [this.options.domainId];
+        const metric = await metricRepo.findOne({ where: { name, domain: { id: (0, typeorm_1.In)(domainIds) } } });
+        if (!metric)
+            throw new Error(`Metric not found: ${name}`);
+        // ALLTIME 타입인 경우 valueDate 무시하고 최신 값 조회
+        if (metric.periodType === 'ALLTIME') {
+            const valueRepo = (0, shell_1.getRepository)(kpi_metric_value_1.KpiMetricValue, this.options.tx);
+            const value = await valueRepo.findOne({
+                where: {
+                    metric: { id: metric.id },
+                    org: this.options.org ?? '',
+                    domain: { id: this.options.domainId }
+                },
+                order: { createdAt: 'DESC' }
+            });
+            if (!value) {
+                throw new Error(`Metric value not found: metric='${name}', org='${this.options.org ?? ''}' (ALLTIME type)`);
+            }
+            return value.value;
+        }
+        const valueRepo = (0, shell_1.getRepository)(kpi_metric_value_1.KpiMetricValue, this.options.tx);
+        // valueDate 미지정 (예: KPI 재계산) → 그 metric 의 '최신 월'(가장 최근 valueDate) 값을
+        // 대표값으로 사용한다. 완료평가/'월별 데이터' 탭에서 최신월을 수정하면 이 값이 곧 KPI
+        // 계산 입력이 된다.
+        // (MONTH 는 valueDate 를 'YYYY-MM-01' 로 저장하는데, 과거엔 current-month('YYYY-MM')
+        //  exact 조회라 포맷 불일치로 못 찾고 우연히 아래 fallback 으로만 동작했음 — 명시적 최신월 조회)
+        if (!this.options.valueDate) {
+            const latest = await valueRepo.findOne({
+                where: {
+                    metric: { id: metric.id },
+                    org: this.options.org ?? '',
+                    domain: { id: this.options.domainId },
+                    // metric 의 periodType 과 같은 값만 — MONTH 지표인데 섞여 있는 DAY 행이 valueDate 로
+                    // 더 최신이라 잘못 집히던 문제 방지 (예: 실적공정률 MONTH 2026-05 vs 잔여 DAY 2026-06-15).
+                    periodType: metric.periodType
+                },
+                order: { valueDate: 'DESC' }
+            });
+            if (!latest) {
+                throw new Error(`Metric value not found: metric='${name}', org='${this.options.org ?? ''}' (latest)`);
+            }
+            return latest.value;
+        }
+        // 명시적 valueDate 가 주어진 경우: 해당 기간 조회 (없으면 최신 fallback).
+        let valueDate = this.options.valueDate;
+        // valueDate가 metric.periodType에 맞는 포맷인지 검사, 아니면 보정
+        if (metric.periodType === 'MONTH' && valueDate.length > 7)
+            valueDate = valueDate.slice(0, 7);
+        if (metric.periodType === 'DAY' && valueDate.length > 10)
+            valueDate = valueDate.slice(0, 10);
+        var value = await valueRepo.findOne({
+            where: {
+                metric: { id: metric.id },
+                valueDate,
+                org: this.options.org ?? '',
+                domain: { id: this.options.domainId },
+                periodType: metric.periodType
+            }
+        });
+        if (!value) {
+            // 해당 기간 데이터 없으면 최신 데이터로 fallback.
+            value = await valueRepo.findOne({
+                where: {
+                    metric: { id: metric.id },
+                    org: this.options.org ?? '',
+                    domain: { id: this.options.domainId },
+                    periodType: metric.periodType
+                },
+                order: { valueDate: 'DESC' }
+            });
+            if (!value) {
+                throw new Error(`Metric value not found: metric='${name}', org='${this.options.org ?? ''}', valueDate='${valueDate}', periodType='${metric.periodType}'`);
+            }
+        }
+        return value.value;
+    }
+}
+exports.KpiMetricValueProvider = KpiMetricValueProvider;
+//# sourceMappingURL=kpi-metric-value-provider.js.map