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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/kpi",
-  "version": "9.2.5",
+  "version": "10.0.0-beta.10",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -28,22 +28,22 @@
     "migration:create": "node ../../node_modules/typeorm/cli.js migration:create ./server/migrations/migration"
   },
   "dependencies": {
-    "@operato/app": "^9.0.0",
-    "@operato/data-grist": "^9.0.0",
-    "@operato/dataset": "^9.0.0",
-    "@operato/ghost-print": "^9.0.0",
-    "@operato/graphql": "^9.0.0",
-    "@operato/grist-editor": "^9.0.0",
-    "@operato/i18n": "^9.0.0",
-    "@operato/layout": "^9.0.0",
-    "@operato/moment-timezone-es": "^9.0.0",
-    "@operato/p13n": "^9.0.0",
-    "@operato/shell": "^9.0.0",
-    "@operato/styles": "^9.0.0",
-    "@operato/utils": "^9.0.0",
-    "@things-factory/auth-base": "^9.2.5",
-    "@things-factory/dataset": "^9.2.5",
-    "@things-factory/shell": "^9.2.5"
+    "@operato/app": "^10.0.0-beta.1",
+    "@operato/data-grist": "^10.0.0-beta.1",
+    "@operato/dataset": "^10.0.0-beta.1",
+    "@operato/ghost-print": "^10.0.0-beta.1",
+    "@operato/graphql": "^10.0.0-beta.1",
+    "@operato/grist-editor": "^10.0.0-beta.1",
+    "@operato/i18n": "^10.0.0-beta.1",
+    "@operato/layout": "^10.0.0-beta.1",
+    "@operato/moment-timezone-es": "^10.0.0-beta.1",
+    "@operato/p13n": "^10.0.0-beta.1",
+    "@operato/shell": "^10.0.0-beta.1",
+    "@operato/styles": "^10.0.0-beta.1",
+    "@operato/utils": "^10.0.0-beta.1",
+    "@things-factory/auth-base": "^10.0.0-beta.10",
+    "@things-factory/dataset": "^10.0.0-beta.10",
+    "@things-factory/shell": "^10.0.0-beta.10"
   },
-  "gitHead": "d3622f475ae3bab84322d31b064cc4cda20f7062"
+  "gitHead": "95acadd39e9a0ff3b2f34d9f7082142395903179"
 }

package/client/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "extends": "../../tsconfig-base.json",
-  "compilerOptions": {
-    "strict": true,
-    "declaration": true,
-    "module": "esnext",
-    "outDir": "../dist-client",
-    "baseUrl": "./"
-  },
-  "include": ["./**/*"]
-}

package/dist-server/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../../tsconfig-base.json",
-  "compilerOptions": {
-    "strict": false,
-    "module": "commonjs",
-    "outDir": "../dist-server",
-    "baseUrl": "./"
-  },
-  "include": ["./**/*"]
-}

package/server/@types/index.d.ts

@@ -1,11 +0,0 @@
-// Things Factory Global Types
-// auth-base의 글로벌 타입들을 자동으로 사용할 수 있게 함
-
-/// <reference types="@things-factory/auth-base/server/types" />
-
-declare global {
-  // 추가적인 KPI 모듈만의 글로벌 타입이 필요하면 여기에 선언
-  // 예: KpiContext, KpiFormula 등
-}
-
-export {}

package/server/calculator/evaluator.ts

@@ -1,45 +0,0 @@
-import type { FormulaNode } from './parser'
-import type { FormulaFunctionMap } from './functions'
-import type { ValueProvider } from './provider'
-
-export interface EvalContext {
-  functions: FormulaFunctionMap
-  provider: ValueProvider
-}
-
-// 비동기 evaluator만 유지, 함수명은 evaluateFormula로 단순화
-export async function evaluateFormula(node: FormulaNode, ctx: EvalContext): Promise<any> {
-  switch (node.type) {
-    case 'number':
-      return node.value
-    case 'variable':
-      return await ctx.provider.get(node.name)
-    case 'function': {
-      const fn = ctx.functions[node.name]
-      if (!fn) throw new Error('Unknown function: ' + node.name)
-      const args = await Promise.all(node.args.map(arg => evaluateFormula(arg, ctx)))
-      return fn(...args)
-    }
-    case 'binary': {
-      const l = await evaluateFormula(node.left, ctx)
-      const r = await evaluateFormula(node.right, ctx)
-      switch (node.op) {
-        case '+':
-          return l + r
-        case '-':
-          return l - r
-        case '*':
-          return l * r
-        case '/':
-          return l / r
-        default:
-          throw new Error('Unknown operator: ' + node.op)
-      }
-    }
-    case 'unary':
-      if (node.op === '-') return -(await evaluateFormula(node.arg, ctx))
-      throw new Error('Unknown unary operator: ' + node.op)
-    default:
-      throw new Error('Unknown node type: ' + (node as any).type)
-  }
-}

package/server/calculator/functions.ts

@@ -1,67 +0,0 @@
-export type FormulaFunction = (...args: any[]) => any
-export type FormulaFunctionMap = Record<string, FormulaFunction>
-
-export const builtinFunctions: FormulaFunctionMap = {
-  sum: (...args: any[]) => args.reduce((a, b) => a + b, 0),
-  avg: (...args: any[]) => (args.length ? args.reduce((a, b) => a + b, 0) / args.length : 0),
-  min: (...args: any[]) => Math.min(...args),
-  max: (...args: any[]) => Math.max(...args),
-  round: (v: number, d: number = 0) => Number(v.toFixed(d)),
-  if: (cond: any, t: any, f: any) => (cond ? t : f),
-  // 성과 지수 계산을 위한 수치 적분 함수들
-  integrate: (func: Function, a: number, b: number, n: number = 1000) => {
-    // 사다리꼴 적분법 (Trapezoidal Rule)
-    const h = (b - a) / n
-    let sum = (func(a) + func(b)) / 2
-    for (let i = 1; i < n; i++) {
-      sum += func(a + i * h)
-    }
-    return sum * h
-  },
-
-  beta_integrand: (t: number, alpha: number, beta: number) => {
-    // 베타 분포 피적분함수: t^(α-1) × (1-t)^(β-1)
-    return Math.pow(t, alpha - 1) * Math.pow(1 - t, beta - 1)
-  },
-
-  incomplete_beta: (x: number, alpha: number, beta: number) => {
-    // 불완전 베타 함수 계산
-    const func = (t: number) => Math.pow(t, alpha - 1) * Math.pow(1 - t, beta - 1)
-    const h = x / 1000
-    let sum = (func(0) + func(x)) / 2
-    for (let i = 1; i < 1000; i++) {
-      sum += func(i * h)
-    }
-    return sum * h
-  },
-
-  complete_beta: (alpha: number, beta: number) => {
-    // 완전 베타 함수 계산
-    const func = (t: number) => Math.pow(t, alpha - 1) * Math.pow(1 - t, beta - 1)
-    const h = 1 / 1000
-    let sum = (func(0) + func(1)) / 2
-    for (let i = 1; i < 1000; i++) {
-      sum += func(i * h)
-    }
-    return sum * h
-  },
-
-  performance_index: (x: number, alpha1: number, beta1: number, alpha2: number, beta2: number) => {
-    // 성과 지수 계산: 1 - (불완전 베타 / 완전 베타)
-    const numerator = builtinFunctions.incomplete_beta(x, alpha1, beta1)
-    const denominator = builtinFunctions.complete_beta(alpha2, beta2)
-    return 1 - numerator / denominator
-  },
-
-  // 지수 함수들
-  exp: (x: number) => Math.exp(x),
-  log: (x: number) => Math.log(x),
-  pow: (x: number, y: number) => Math.pow(x, y),
-
-  // 지수 감쇠 성과 지수
-  exponential_decay: (value: number, scale: number, power: number) => {
-    // exp(-(value / scale)^power)
-    return Math.exp(-Math.pow(value / scale, power))
-  }
-  // 필요시 확장
-}

package/server/calculator/index.ts

@@ -1,4 +0,0 @@
-export * from './parser.js'
-export * from './evaluator.js'
-export * from './functions.js'
-export * from './provider.js'

package/server/calculator/parser.ts

@@ -1,137 +0,0 @@
-// KPI formula 파서: 수식 문자열을 AST로 변환
-
-export type FormulaNode =
-  | { type: 'number'; value: number }
-  | { type: 'variable'; name: string }
-  | { type: 'function'; name: string; args: FormulaNode[] }
-  | { type: 'binary'; op: string; left: FormulaNode; right: FormulaNode }
-  | { type: 'unary'; op: string; arg: FormulaNode }
-
-// 토큰 타입 정의
-const TOKEN_REGEX = /\s*(\d+\.\d+|\d+|\[.*?\]|[A-Za-z_][A-Za-z0-9_]*|[+\-*/(),])/y
-
-interface Token {
-  type: 'number' | 'variable' | 'function' | 'operator' | 'paren' | 'comma'
-  value: string
-}
-
-function tokenize(formula: string): Token[] {
-  const tokens: Token[] = []
-  let m: RegExpExecArray | null
-  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
-}
-
-// 파서 구현 (재귀 하향, 연산자 우선순위, 함수/변수/숫자/괄호 지원)
-export function parseFormula(formula: string): FormulaNode {
-  const tokens = tokenize(formula)
-  let pos = 0
-
-  function peek() {
-    return tokens[pos]
-  }
-  function next() {
-    return tokens[pos++]
-  }
-  function expect(type: string, value?: string) {
-    const t = next()
-    if (!t || t.type !== type || (value && t.value !== value))
-      throw new Error('Expected ' + type + (value ? ':' + value : ''))
-    return t
-  }
-
-  function parsePrimary(): FormulaNode {
-    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: FormulaNode[] = []
-        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(): FormulaNode {
-    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(): FormulaNode {
-    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(): FormulaNode {
-    return parseAddSub()
-  }
-
-  const ast = parseExpr()
-  if (pos < tokens.length) throw new Error('Unexpected token at end: ' + JSON.stringify(tokens[pos]))
-  return ast
-}

package/server/calculator/provider.ts

@@ -1,10 +0,0 @@
-export interface ValueProvider {
-  get(name: string): any | Promise<any>
-}
-
-export class ObjectValueProvider implements ValueProvider {
-  constructor(private values: Record<string, any>) {}
-  get(name: string) {
-    return this.values[name]
-  }
-}

package/server/controllers/index.ts

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

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

@@ -1,79 +0,0 @@
-import { getRepository } from '@things-factory/shell'
-import { KpiMetric } from '../service/kpi-metric/kpi-metric'
-import { KpiMetricValue } from '../service/kpi-metric-value/kpi-metric-value'
-import { ValueProvider } from '../calculator/provider'
-import { getDefaultValueDate } from '../service/utils/value-date-util'
-
-export class KpiMetricValueProvider implements ValueProvider {
-  constructor(
-    private options: {
-      valueDate: string
-      org?: string
-      domainId: string
-      tx?: any
-    }
-  ) {}
-
-  async get(name: string) {
-    const metricRepo = getRepository(KpiMetric, this.options.tx)
-    const metric = await metricRepo.findOne({ where: { name, domain: { id: this.options.domainId } } })
-    if (!metric) throw new Error(`Metric not found: ${name}`)
-
-    // ALLTIME 타입인 경우 valueDate 무시하고 최신 값 조회
-    if (metric.periodType === 'ALLTIME') {
-      const valueRepo = getRepository(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
-    }
-
-    // metric의 periodType에 맞게 valueDate 보정
-    let valueDate = this.options.valueDate
-    if (!valueDate) {
-      valueDate = getDefaultValueDate(metric.periodType, 'current')
-    } else {
-      // 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)
-      // 기타 periodType별 보정 추가 가능
-    }
-    const valueRepo = getRepository(KpiMetricValue, this.options.tx)
-    var value = await valueRepo.findOne({
-      where: {
-        metric: { id: metric.id },
-        valueDate,
-        org: this.options.org ?? '',
-        domain: { id: this.options.domainId }
-      }
-    })
-    if (!value) {
-      // 임시로 최신의 데이타 하나를 찾아오는 것으로 하자.
-      value = await valueRepo.findOne({
-        where: {
-          metric: { id: metric.id },
-          org: this.options.org ?? '',
-          domain: { id: this.options.domainId }
-        },
-        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
-  }
-}

package/server/controllers/kpi-value-provider.ts

@@ -1,51 +0,0 @@
-import { getRepository } from '@things-factory/shell'
-import { Kpi } from '../service/kpi/kpi'
-import { KpiValue } from '../service/kpi-value/kpi-value'
-import { ValueProvider } from '../calculator/provider'
-
-export class KpiValueProvider implements ValueProvider {
-  constructor(
-    private options: {
-      valueDate: string
-      org?: string
-      domainId: string
-      tx?: any
-    }
-  ) {}
-
-  async get(name: string) {
-    const kpiRepo = getRepository(Kpi, this.options.tx)
-    const kpi = await kpiRepo.findOne({ where: { name, domain: { id: this.options.domainId } } })
-    if (!kpi) throw new Error(`KPI not found: ${name}`)
-    const valueRepo = getRepository(KpiValue, this.options.tx)
-
-    // SINGLE 타입인 경우 valueDate 무시하고 최신 값 조회
-    const whereCondition: any = {
-      kpi: { id: kpi.id },
-      org: this.options.org ?? '',
-      domain: { id: this.options.domainId }
-    }
-
-    if (kpi.periodType === 'ALLTIME') {
-      // ALLTIME 타입은 valueDate 무시하고 최신 값 사용
-      const value = await valueRepo.findOne({
-        where: whereCondition,
-        order: { createdAt: 'DESC' }
-      })
-      if (!value) {
-        throw new Error(`KPI value not found: kpi='${name}', org='${this.options.org ?? ''}' (ALLTIME type)`)
-      }
-      return value.value
-    } else {
-      // 기존 로직: 특정 날짜의 값 조회
-      whereCondition.valueDate = this.options.valueDate
-      const value = await valueRepo.findOne({ where: whereCondition })
-      if (!value) {
-        throw new Error(
-          `KPI value not found: kpi='${name}', org='${this.options.org ?? ''}', valueDate='${this.options.valueDate}'`
-        )
-      }
-      return value.value
-    }
-  }
-}

package/server/index.ts

@@ -1,6 +0,0 @@
-export * from './migrations/index.js'
-export * from './service/index.js'
-export * from './calculator/index.js'
-export * from './controllers/index.js'
-
-import './routes'

package/server/migrations/1752190849680-seed-kpi-metrics.ts

@@ -1,124 +0,0 @@
-import { MigrationInterface, QueryRunner } from 'typeorm'
-import { Domain, getRepository } from '@things-factory/shell'
-import { KpiPeriodType } from '../service/kpi/kpi'
-import { KpiMetric, KpiMetricCollectType } from '../service/kpi-metric/kpi-metric'
-import * as fs from 'fs'
-import * as path from 'path'
-
-interface KpiMetricSeedData {
-  name: string
-  description: string
-  unit?: string | null
-  source?: string | null
-  field_name?: string | null
-  active: boolean
-  schedule_id?: string | null
-  timezone: string
-  data_set_id?: string | null
-  period_type: string
-  collect_type: string
-  schedule?: string | null
-  created_at?: string
-  updated_at?: string
-}
-
-export class SeedKpiMetrics1752190849680 implements MigrationInterface {
-  name = 'SeedKpiMetrics1752190849680'
-
-  public async up(queryRunner: QueryRunner): Promise<void> {
-    try {
-      const repository = getRepository(KpiMetric)
-      const domainRepository = getRepository(Domain)
-
-      // SYSTEM 도메인 확인
-      const domain: Domain = await domainRepository.findOneBy({ name: 'SYSTEM' })
-      if (!domain) {
-        console.log('❌ SYSTEM domain not found')
-        return
-      }
-
-      // JSON 파일 읽기
-      const seedFilePath = path.join(__dirname, 'seed-data', 'kpi-metrics-seed.json')
-      const seedData: KpiMetricSeedData[] = JSON.parse(fs.readFileSync(seedFilePath, 'utf8'))
-
-      console.log(`📊 Processing ${seedData.length} KPI metrics from JSON seed`)
-
-      for (const metricData of seedData) {
-        try {
-          const existingMetric = await repository.findOne({
-            where: { name: metricData.name, domain: { id: domain.id } }
-          })
-
-          if (existingMetric) {
-            console.log(`⚠️  KPI Metric already exists: ${metricData.name}`)
-            continue
-          }
-
-          const metric = await repository.save({
-            name: metricData.name,
-            description: metricData.description,
-            unit: metricData.unit,
-            source: metricData.source,
-            fieldName: metricData.field_name,
-            active: metricData.active,
-            scheduleId: metricData.schedule_id,
-            timezone: metricData.timezone,
-            dataSetId: metricData.data_set_id,
-            periodType: KpiPeriodType[metricData.period_type as keyof typeof KpiPeriodType],
-            collectType: KpiMetricCollectType[metricData.collect_type as keyof typeof KpiMetricCollectType],
-            schedule: metricData.schedule,
-            domain
-          })
-
-          console.log(`✅ Created KPI Metric: ${metric.name}`)
-        } catch (error) {
-          console.error(`❌ Error creating KPI Metric "${metricData.name}":`, error)
-        }
-      }
-
-      console.log(`🎉 Successfully processed KPI metrics from JSON seed`)
-    } catch (error) {
-      console.error('❌ Error seeding KPI metrics from JSON:', error)
-      throw error
-    }
-  }
-
-  public async down(queryRunner: QueryRunner): Promise<void> {
-    try {
-      const repository = getRepository(KpiMetric)
-      const domainRepository = getRepository(Domain)
-
-      const domain: Domain = await domainRepository.findOneBy({ name: 'SYSTEM' })
-      if (!domain) {
-        console.log('⚠️  SYSTEM domain not found. Nothing to delete.')
-        return
-      }
-
-      // JSON 파일 읽기
-      const seedFilePath = path.join(__dirname, 'seed-data', 'kpi-metrics-seed.json')
-      const seedData: KpiMetricSeedData[] = JSON.parse(fs.readFileSync(seedFilePath, 'utf8'))
-
-      console.log(`🗑️  Cleaning up ${seedData.length} KPI metrics`)
-
-      for (const metricData of seedData.reverse()) {
-        try {
-          const metric = await repository.findOne({
-            where: { name: metricData.name, domain: { id: domain.id } }
-          })
-
-          if (metric) {
-            await repository.delete(metric.id)
-            console.log(`✅ Deleted KPI Metric: ${metricData.name}`)
-          }
-        } catch (error) {
-          console.error(`❌ Error deleting KPI Metric "${metricData.name}":`, error)
-        }
-      }
-
-      console.log(`🎉 Successfully cleaned up KPI metrics`)
-    } catch (error) {
-      console.error('❌ Error cleaning up KPI metrics:', error)
-      throw error
-    }
-  }
-}