@things-factory/kpi 9.0.22 → 9.0.24

package/client/pages/kpi/kpi-list-page.ts

@@ -68,7 +68,7 @@ export class KpiListPage extends connect(store)(localize(i18next)(ScopedElements
   @state() availableVariables: any[] = []
   @state() availableVariablesLoaded = false
 
-  async getAvailableVariables() {
+  async getAvailableKpiMetricVariables() {
     if (this.availableVariablesLoaded) {
       return this.availableVariables
     }
@@ -166,24 +166,7 @@ export class KpiListPage extends connect(store)(localize(i18next)(ScopedElements
   async pageInitialized(lifecycle: any) {
     this.gristConfig = {
       list: {
-        fields: [
-          'name',
-          'description',
-          'category',
-          'formula',
-          'active',
-          'state',
-          'vizType',
-          'schedule',
-          'scheduleId',
-          'timezone',
-          'version',
-          'createdAt',
-          'updatedAt',
-          'creator',
-          'updater',
-          'thumbnail'
-        ],
+        fields: ['name', 'description'],
         details: [
           'name',
           'description',
@@ -206,6 +189,18 @@ export class KpiListPage extends connect(store)(localize(i18next)(ScopedElements
       columns: [
         { type: 'gutter', gutterName: 'sequence' },
         { type: 'gutter', gutterName: 'row-selector', multiple: true },
+        // KPI 실적값 계산 버튼 추가
+        {
+          type: 'gutter',
+          gutterName: 'button',
+          icon: 'calculate',
+          title: '실적값 계산',
+          handlers: {
+            click: (columns, data, column, record, rowIndex) => {
+              this._calculateKpiValue(record)
+            }
+          }
+        },
         {
           type: 'string',
           name: 'name',
@@ -244,15 +239,150 @@ export class KpiListPage extends connect(store)(localize(i18next)(ScopedElements
           record: {
             editable: true,
             availableVariables: async () => {
-              return await this.getAvailableVariables()
+              return await this.getAvailableKpiMetricVariables()
             }
           },
           width: 320
         },
+        {
+          type: 'select',
+          name: 'periodType',
+          header: '계산주기',
+          record: {
+            editable: true,
+            options: [
+              { value: '', display: '' },
+              { value: 'DAY', display: '일' },
+              { value: 'WEEK', display: '주' },
+              { value: 'MONTH', display: '월' },
+              { value: 'QUARTER', display: '분기' },
+              { value: 'YEAR', display: '년' },
+              { value: 'RANGE', display: '범위' },
+              { value: 'ALLTIME', display: '전체' }
+            ]
+          },
+          width: 80
+        },
+        {
+          type: 'formula',
+          name: 'scoreFormula',
+          header: '성과점수수식',
+          record: {
+            editable: true,
+            availableVariables: async () => {
+              return [
+                {
+                  name: 'value',
+                  description: 'KPI 실적값',
+                  type: 'kpi-value',
+                  unit: ''
+                }
+              ]
+            },
+            includeDefaultFunctions: false,
+            availableFunctions: [
+              {
+                name: 'INTEGRATE()',
+                description: '수치 적분',
+                template: 'INTEGRATE({func}, {a}, {b}, {n})',
+                syntax: 'INTEGRATE(func, a, b, n)',
+                parameters: ['func - 적분할 함수', 'a - 하한값', 'b - 상한값', 'n - 분할 수 (기본값: 1000)'],
+                returnType: 'number',
+                help: '사다리꼴 적분법을 사용하여 수치 적분을 계산합니다.',
+                examples: ['INTEGRATE(x => x*x, 0, 1, 1000)', 'INTEGRATE([효율성], 0, 1)']
+              },
+              {
+                name: 'BETA_FUNCTION()',
+                description: '베타 함수',
+                template: 'BETA_FUNCTION({x}, {alpha}, {beta})',
+                syntax: 'BETA_FUNCTION(x, alpha, beta)',
+                parameters: ['x - 변수 (0 ≤ x ≤ 1)', 'alpha - 첫 번째 모수', 'beta - 두 번째 모수'],
+                returnType: 'number',
+                help: '베타 분포 함수를 계산합니다. t^(α-1) × (1-t)^(β-1)',
+                examples: ['BETA_FUNCTION(0.5, 2, 3)', 'BETA_FUNCTION([품질지수], 3, 2)']
+              },
+              {
+                name: 'INCOMPLETE_BETA()',
+                description: '불완전 베타 함수',
+                template: 'INCOMPLETE_BETA({x}, {alpha}, {beta})',
+                syntax: 'INCOMPLETE_BETA(x, alpha, beta)',
+                parameters: ['x - 상한값 (0 ≤ x ≤ 1)', 'alpha - 첫 번째 모수', 'beta - 두 번째 모수'],
+                returnType: 'number',
+                help: '불완전 베타 함수를 수치 적분으로 계산합니다.',
+                examples: ['INCOMPLETE_BETA(0.7, 2, 3)', 'INCOMPLETE_BETA([목표달성률]/100, 2, 3)']
+              },
+              {
+                name: 'COMPLETE_BETA()',
+                description: '완전 베타 함수',
+                template: 'COMPLETE_BETA({alpha}, {beta})',
+                syntax: 'COMPLETE_BETA(alpha, beta)',
+                parameters: ['alpha - 첫 번째 모수', 'beta - 두 번째 모수'],
+                returnType: 'number',
+                help: '완전 베타 함수 B(α,β)를 계산합니다.',
+                examples: ['COMPLETE_BETA(2, 3)', 'COMPLETE_BETA(3, 2)']
+              },
+              {
+                name: 'PERFORMANCE_INDEX()',
+                description: '성과 지수',
+                template: 'PERFORMANCE_INDEX({x}, {alpha1}, {beta1}, {alpha2}, {beta2})',
+                syntax: 'PERFORMANCE_INDEX(x, alpha1, beta1, alpha2, beta2)',
+                parameters: [
+                  'x - 성과 값 (0 ≤ x ≤ 1)',
+                  'alpha1, beta1 - 분자 베타 함수 모수',
+                  'alpha2, beta2 - 분모 베타 함수 모수'
+                ],
+                returnType: 'number',
+                help: '성과 지수를 계산합니다: 1 - (불완전 베타 / 완전 베타)',
+                examples: ['PERFORMANCE_INDEX(0.8, 2, 3, 2, 3)', 'PERFORMANCE_INDEX([성과점수]/100, 2, 3, 2, 3)']
+              },
+              {
+                name: 'EXP()',
+                description: '지수 함수',
+                template: 'EXP({x})',
+                syntax: 'EXP(x)',
+                parameters: ['x - 지수'],
+                returnType: 'number',
+                help: '자연상수 e의 x제곱을 계산합니다.',
+                examples: ['EXP(1)', 'EXP([효율성])']
+              },
+              {
+                name: 'LOG()',
+                description: '자연 로그',
+                template: 'LOG({x})',
+                syntax: 'LOG(x)',
+                parameters: ['x - 로그를 취할 값'],
+                returnType: 'number',
+                help: '자연 로그 ln(x)를 계산합니다.',
+                examples: ['LOG(2.718)', 'LOG([성과점수])']
+              },
+              {
+                name: 'POW()',
+                description: '거듭제곱',
+                template: 'POW({x}, {y})',
+                syntax: 'POW(x, y)',
+                parameters: ['x - 밑수', 'y - 지수'],
+                returnType: 'number',
+                help: 'x의 y제곱을 계산합니다.',
+                examples: ['POW(2, 3)', 'POW([효율성], 2)']
+              },
+              {
+                name: 'EXPONENTIAL_DECAY()',
+                description: '지수 감쇠',
+                template: 'EXPONENTIAL_DECAY({value}, {scale}, {power})',
+                syntax: 'EXPONENTIAL_DECAY(value, scale, power)',
+                parameters: ['value - 입력 값', 'scale - 스케일 파라미터', 'power - 지수 파라미터'],
+                returnType: 'number',
+                help: '지수 감쇠 함수 exp(-(value/scale)^power)를 계산합니다.',
+                examples: ['EXPONENTIAL_DECAY(50, 100, 2)', 'EXPONENTIAL_DECAY([목표달성률], 50, 2)']
+              }
+            ]
+          },
+          width: 200
+        },
         {
           type: 'string',
           name: 'grades',
-          header: '등급 설정',
+          header: '성과지수 Lookup',
           record: {
             editable: false,
             renderer: (v, c, r) => {
@@ -369,11 +499,13 @@ export class KpiListPage extends connect(store)(localize(i18next)(ScopedElements
               name
               description
               active
+              formula
+              periodType
+              scoreFormula
               grades
               vizType
               vizMeta
               weight
-              formula
               schedule
               scheduleId
               timezone
@@ -648,4 +780,30 @@ export class KpiListPage extends connect(store)(localize(i18next)(ScopedElements
       })
     }
   }
+
+  async _calculateKpiValue(kpi) {
+    try {
+      const response = await client.mutate({
+        mutation: gql`
+          mutation ($kpiId: String!) {
+            calculateKpiValue(kpiId: $kpiId) {
+              id
+              value
+              valueDate
+              group
+            }
+          }
+        `,
+        variables: {
+          kpiId: kpi.id
+        }
+      })
+      if (!response.errors) {
+        notify({ message: 'KPI 실적값이 성공적으로 계산되었습니다.' })
+        this.grist.fetch()
+      }
+    } catch (error) {
+      notify({ message: 'KPI 실적값 계산 중 오류가 발생했습니다.' })
+    }
+  }
 }

package/client/pages/kpi/kpi-viz-editor.ts

@@ -1,5 +1,5 @@
 import '@material/web/button/elevated-button.js'
-import '@material/web/select/outlined-select.js'
+// import '@material/web/select/outlined-select.js'
 import '@material/web/textfield/outlined-text-field.js'
 import '@material/web/icon/icon.js'
 

package/client/pages/kpi-category/kpi-category-list-page.ts

@@ -20,6 +20,7 @@ import { connect } from 'pwa-helpers/connect-mixin'
 import gql from 'graphql-tag'
 
 import { KpiCategoryImporter } from './kpi-category-importer'
+import { KpiCategoryValueCalculator } from './kpi-category-value-calculator'
 
 @customElement('kpi-category-list-page')
 export class KpiCategoryListPage extends connect(store)(localize(i18next)(ScopedElementsMixin(PageView))) {
@@ -50,7 +51,8 @@ export class KpiCategoryListPage extends connect(store)(localize(i18next)(Scoped
 
   static get scopedElements() {
     return {
-      'kpi-category-importer': KpiCategoryImporter
+      'kpi-category-importer': KpiCategoryImporter,
+      'kpi-category-value-calculator': KpiCategoryValueCalculator
     }
   }
 
@@ -159,12 +161,45 @@ export class KpiCategoryListPage extends connect(store)(localize(i18next)(Scoped
   async pageInitialized(lifecycle: any) {
     this.gristConfig = {
       list: {
-        fields: ['name', 'description', 'active', 'formula', 'weight', 'createdAt', 'updatedAt', 'creator', 'updater'],
-        details: ['name', 'description', 'active', 'formula', 'weight', 'createdAt', 'updatedAt', 'creator', 'updater']
+        fields: [
+          'name',
+          'description',
+          'active',
+          'formula',
+          'weight',
+          'periodType',
+          'createdAt',
+          'updatedAt',
+          'creator',
+          'updater'
+        ],
+        details: [
+          'name',
+          'description',
+          'active',
+          'formula',
+          'weight',
+          'periodType',
+          'createdAt',
+          'updatedAt',
+          'creator',
+          'updater'
+        ]
       },
       columns: [
         { type: 'gutter', gutterName: 'sequence' },
         { type: 'gutter', gutterName: 'row-selector', multiple: true },
+        {
+          type: 'gutter',
+          gutterName: 'button',
+          icon: 'calculate',
+          title: '실적값 계산',
+          handlers: {
+            click: (columns, data, column, record, rowIndex) => {
+              this.openCalculator(record)
+            }
+          }
+        },
         {
           type: 'string',
           name: 'name',
@@ -201,6 +236,26 @@ export class KpiCategoryListPage extends connect(store)(localize(i18next)(Scoped
           record: { editable: true },
           width: 80
         },
+        {
+          type: 'select',
+          name: 'periodType',
+          header: '계산주기',
+          record: {
+            editable: true,
+            options: [
+              { value: '', display: '' },
+              { value: 'DAY', display: '일' },
+              { value: 'WEEK', display: '주' },
+              { value: 'MONTH', display: '월' },
+              { value: 'QUARTER', display: '분기' },
+              { value: 'YEAR', display: '년' },
+              { value: 'RANGE', display: '범위' },
+              { value: 'ALLTIME', display: '전체' }
+            ]
+          },
+
+          width: 80
+        },
         {
           type: 'checkbox',
           name: 'active',
@@ -264,6 +319,7 @@ export class KpiCategoryListPage extends connect(store)(localize(i18next)(Scoped
               active
               formula
               weight
+              periodType
               updater {
                 id
                 name
@@ -461,4 +517,21 @@ export class KpiCategoryListPage extends connect(store)(localize(i18next)(Scoped
       this.grist.fetch()
     }
   }
+
+  private async openCalculator(record: any) {
+    const popup = openPopup(
+      html`
+        <kpi-category-value-calculator
+          .categoryId=${record.id}
+          .categoryName=${record.name}
+          @closed=${() => popup.close()}
+        ></kpi-category-value-calculator>
+      `,
+      {
+        backdrop: true,
+        size: 'large',
+        title: i18next.t('title.calculate kpi value')
+      }
+    )
+  }
 }

package/client/pages/kpi-category/kpi-category-value-calculator.ts

@@ -0,0 +1,233 @@
+import '@material/web/icon/icon.js'
+
+import { css, html, LitElement } from 'lit'
+import { customElement, property, state } from 'lit/decorators.js'
+import { client } from '@operato/graphql'
+import { notify } from '@operato/layout'
+import gql from 'graphql-tag'
+
+// KpiPeriodType enum 정의 (서버와 동일하게)
+enum KpiPeriodType {
+  DAY = 'DAY',
+  WEEK = 'WEEK',
+  MONTH = 'MONTH',
+  QUARTER = 'QUARTER',
+  YEAR = 'YEAR',
+  RANGE = 'RANGE',
+  ALLTIME = 'ALLTIME'
+}
+
+// periodType에 따른 마지막 일자 계산 함수
+function getLastValueDate(periodType: KpiPeriodType = KpiPeriodType.DAY): string {
+  const now = new Date()
+
+  switch (periodType) {
+    case KpiPeriodType.DAY: {
+      const d = new Date(now)
+      d.setDate(d.getDate() - 1)
+      return d.toISOString().slice(0, 10)
+    }
+    case KpiPeriodType.MONTH: {
+      const d = new Date(now)
+      d.setMonth(d.getMonth() - 1)
+      return d.toISOString().slice(0, 7)
+    }
+    case KpiPeriodType.QUARTER: {
+      let year = now.getFullYear()
+      let quarter = Math.floor(now.getMonth() / 3)
+      if (quarter === 0) {
+        year -= 1
+        quarter = 4
+      }
+      return `${year}-Q${quarter}`
+    }
+    case KpiPeriodType.WEEK: {
+      const d = new Date(now)
+      d.setDate(d.getDate() - 7)
+      const year = d.getFullYear()
+      const week = getISOWeek(d)
+      return `${year}-W${week}`
+    }
+    case KpiPeriodType.ALLTIME:
+      return 'ALLTIME'
+    default: {
+      const d = new Date(now)
+      d.setDate(d.getDate() - 1)
+      return d.toISOString().slice(0, 10)
+    }
+  }
+}
+
+// ISO 주차 계산 함수
+function getISOWeek(date: Date): number {
+  const tmp = new Date(date.getTime())
+  tmp.setHours(0, 0, 0, 0)
+  tmp.setDate(tmp.getDate() + 4 - (tmp.getDay() || 7))
+  const yearStart = new Date(tmp.getFullYear(), 0, 1)
+  const weekNo = Math.ceil(((tmp.getTime() - yearStart.getTime()) / 86400000 + 1) / 7)
+  return weekNo
+}
+
+@customElement('kpi-category-value-calculator')
+export class KpiCategoryValueCalculator extends LitElement {
+  static styles = [
+    css`
+      :host {
+        display: block;
+        padding: 20px;
+        min-width: 400px;
+      }
+
+      .container {
+        display: flex;
+        flex-direction: column;
+        gap: 10px;
+      }
+
+      .form-group {
+        display: flex;
+        flex-direction: column;
+        margin-bottom: 15px;
+      }
+
+      label {
+        display: block;
+        margin-bottom: 5px;
+        font-weight: bold;
+      }
+
+      input,
+      select {
+        padding: 8px;
+        border: 1px solid #ccc;
+        border-radius: 4px;
+      }
+
+      .result {
+        margin-top: 20px;
+        padding: 15px;
+        background-color: #f5f5f5;
+        border-radius: 4px;
+      }
+
+      .result-value {
+        font-size: 18px;
+        font-weight: bold;
+        color: #2196f3;
+      }
+
+      .kpi-values {
+        margin-top: 10px;
+      }
+
+      .kpi-value-item {
+        display: flex;
+        justify-content: space-between;
+        padding: 5px 0;
+        border-bottom: 1px solid #eee;
+      }
+    `
+  ]
+
+  @property({ type: String }) categoryId = ''
+  @property({ type: String }) categoryName = ''
+  @state() valueDate = getLastValueDate()
+  @state() group = ''
+  @state() result: any = null
+  @state() loading = false
+
+  render() {
+    return html`
+      <div class="container">
+        <h3>${this.categoryName} - KPI 값 계산</h3>
+
+        <div class="form-group">
+          <label>계산 기준일</label>
+          <input type="date" .value=${this.valueDate} @input=${e => (this.valueDate = e.target.value)} />
+        </div>
+
+        <div class="form-group">
+          <label>그룹</label>
+          <input
+            type="text"
+            placeholder="그룹명 (선택사항)"
+            .value=${this.group}
+            @input=${e => (this.group = e.target.value)}
+          />
+        </div>
+
+        <button
+          @click=${this.calculateValue}
+          ?disabled=${this.loading}
+          style="width: 100%; padding: 10px; background: #2196f3; color: white; border: none; border-radius: 4px; cursor: pointer;"
+        >
+          ${this.loading ? '계산 중...' : '계산하기'}
+        </button>
+
+        ${this.result
+          ? html`
+              <div class="result">
+                <div class="result-value">
+                  계산 결과: ${this.result.value !== null ? this.result.value.toFixed(2) : 'N/A'}
+                </div>
+                ${this.result.kpiValues && this.result.kpiValues.length > 0
+                  ? html`
+                      <div class="kpi-values">
+                        <h4>개별 KPI 값:</h4>
+                        ${this.result.kpiValues.map(
+                          item => html`
+                            <div class="kpi-value-item">
+                              <span>KPI ID: ${item.kpiId}</span>
+                              <span>${item.value !== null ? item.value.toFixed(2) : 'N/A'}</span>
+                            </div>
+                          `
+                        )}
+                      </div>
+                    `
+                  : ''}
+              </div>
+            `
+          : ''}
+      </div>
+    `
+  }
+
+  async calculateValue() {
+    if (!this.categoryId) return
+
+    this.loading = true
+    try {
+      const response = await client.query({
+        query: gql`
+          query ($categoryId: String!, $valueDate: String, $group: String) {
+            calculateKpiValue(categoryId: $categoryId, valueDate: $valueDate, group: $group) {
+              value
+              valueDate
+              group
+              kpiValues {
+                kpiId
+                value
+              }
+            }
+          }
+        `,
+        variables: {
+          categoryId: this.categoryId,
+          valueDate: this.valueDate || null,
+          group: this.group || null
+        }
+      })
+
+      if (!response.errors) {
+        this.result = response.data.calculateKpiValue
+      }
+    } catch (error) {
+      console.error('KPI 값 계산 중 오류:', error)
+      notify({
+        message: 'KPI 값 계산 중 오류가 발생했습니다.'
+      })
+    } finally {
+      this.loading = false
+    }
+  }
+}