@things-factory/kpi 10.0.0-beta.4 → 10.0.0-beta.41

package/client/index.ts

@@ -0,0 +1 @@
+export { KpiListPage } from './pages/kpi/kpi-list-page.js'

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

@@ -21,6 +21,44 @@ import { p13n } from '@operato/p13n'
 
 import gql from 'graphql-tag'
 
+/**
+ * KPI scoreType — value → score 변환 방식 (null이면 미설정)
+ *
+ * DIRECT  — value = score, 변환 없음
+ * FORMULA — scoreFormula 수식으로 변환
+ * LOOKUP  — grade table(1D)로 변환
+ * CUSTOM  — 2D 룩업 등 특수 변환
+ */
+export const KPI_SCORE_TYPE = {
+  DIRECT: 'DIRECT',
+  FORMULA: 'FORMULA',
+  LOOKUP: 'LOOKUP',
+  CUSTOM: 'CUSTOM'
+} as const
+
+/**
+ * KPI valueType — value 획득 방식
+ *
+ * MEASURED   — 외부 시스템 수집 측정값
+ * ASSESSED   — 감리자 직접 평가 (1~5)
+ * CALCULATED — formula 자동 계산
+ * COMPOSITE  — 다차원 복합 입력
+ */
+export const KPI_VALUE_TYPE = {
+  MEASURED: 'MEASURED',
+  ASSESSED: 'ASSESSED',
+  CALCULATED: 'CALCULATED',
+  COMPOSITE: 'COMPOSITE'
+} as const
+
+export function inferScoreType(kpi: any): string {
+  if (kpi.scoreType) return kpi.scoreType
+  if (kpi.scoreFormula) return KPI_SCORE_TYPE.FORMULA
+  if (kpi.grades && typeof kpi.grades === 'object' && !Array.isArray(kpi.grades)) return KPI_SCORE_TYPE.CUSTOM
+  if (Array.isArray(kpi.grades) && kpi.grades.length > 0) return KPI_SCORE_TYPE.LOOKUP
+  return KPI_SCORE_TYPE.DIRECT
+}
+
 import { KpiImporter } from './kpi-importer'
 import { KpiGradeEditor } from './kpi-grade-editor'
 import { KpiVizEditor } from './kpi-viz-editor'
@@ -57,7 +95,7 @@ export class KpiListPage extends p13n(localize(i18next)(ScopedElementsMixin(Page
   @property({ type: Object }) gristConfig: any
   @property({ type: String }) mode: 'CARD' | 'GRID' | 'LIST' = isMobileDevice() ? 'CARD' : 'GRID'
 
-  @query('ox-grist') private grist!: DataGrist
+  @query('ox-grist') protected grist!: DataGrist
 
   @state() availableVariables: any[] = []
   @state() availableVariablesLoaded = false
@@ -387,14 +425,7 @@ export class KpiListPage extends p13n(localize(i18next)(ScopedElementsMixin(Page
           name: 'grades',
           header: '성과지수 Lookup',
           record: {             editable: false,
-            renderer: (v, c, r) => {               if (r.grades && r.grades.length > 0) {                 return html`<span style="color: #4caf50; cursor: pointer;" @click=${() => this._editGrades(r)}>
-                  ${r.grades.length}개 등급 설정됨
-                </span>`
- } else {                 return html`<span style="color: #999; cursor: pointer;" @click=${() => this._editGrades(r)}>
-                  등급 설정 없음
-                </span>`
- }
- }
+            renderer: (v, c, r) => this.renderGradesCell(r)
  },
           width: 150
  },
@@ -487,6 +518,7 @@ export class KpiListPage extends p13n(localize(i18next)(ScopedElementsMixin(Page
               active
               formula
               periodType
+              scoreType
               scoreFormula
               grades
               vizType
@@ -654,19 +686,86 @@ export class KpiListPage extends p13n(localize(i18next)(ScopedElementsMixin(Page
  }
  }
 
-  async _editGrades(kpi: any) {     if (!kpi.id) {       notify({         message: 'KPI를 먼저 저장한 후에 등급 설정을 할 수 있습니다.'
- })
+  /**
+   * grades 셀 렌더러. 서브클래스에서 override 가능.
+   * CUSTOM scoreType은 renderCustomGradesCell()로 위임.
+   */
+  protected renderGradesCell(kpi: any): any {
+    const scoreType = inferScoreType(kpi)
+    let label: string
+    let hasGrades: boolean
+
+    switch (scoreType) {
+      case KPI_SCORE_TYPE.LOOKUP:
+        hasGrades = Array.isArray(kpi.grades) && kpi.grades.length > 0
+        label = hasGrades ? `${kpi.grades.length}개 등급 설정됨` : '등급 설정 없음'
+        break
+      case KPI_SCORE_TYPE.DIRECT:
+        // valueType으로 세분화 표시
+        if (kpi.valueType === KPI_VALUE_TYPE.ASSESSED) {
+          return html`<span style="color:#2196f3">평가형 (1~5)</span>`
+        }
+        if (kpi.valueType === KPI_VALUE_TYPE.CALCULATED) {
+          return html`<span style="color:#888">산식 계산</span>`
+        }
+        return html`<span style="color:#888">직접 (value=score)</span>`
+      case KPI_SCORE_TYPE.FORMULA:
+        return html`<span style="color:#888">산식 변환</span>`
+      case KPI_SCORE_TYPE.CUSTOM:
+        return this.renderCustomGradesCell(kpi)
+      default:
+        if (!scoreType) {
+          return html`<span style="color:#ccc">미설정</span>`
+        }
+        hasGrades = false
+        label = '등급 설정 없음'
+    }
+
+    return html`<span
+      style="color:${hasGrades ? '#4caf50' : '#999'};cursor:pointer;"
+      @click=${() => this._editGrades(kpi)}
+      >${label}</span
+    >`
+  }
+
+  /**
+   * CUSTOM scoreType의 grades 셀 렌더링. 서브클래스에서 override하여 구현.
+   */
+  protected renderCustomGradesCell(kpi: any): any {
+    return html`<span style="color:#999;cursor:pointer;" @click=${() => this._editGrades(kpi)}>커스텀 설정됨</span>`
+  }
+
+  /**
+   * 등급 편집 팝업. CUSTOM 타입은 _editCustomGrades()로 위임. 서브클래스에서 override 가능.
+   */
+  protected async _editGrades(kpi: any) {
+    if (!kpi.id) {
+      notify({ message: 'KPI를 먼저 저장한 후에 등급 설정을 할 수 있습니다.' })
+      return
+    }
+
+    const scoreType = inferScoreType(kpi)
 
+    if (scoreType === KPI_SCORE_TYPE.CUSTOM) {
+      await this._editCustomGrades(kpi)
       return
- }
+    }
+
+    if (scoreType !== KPI_SCORE_TYPE.LOOKUP) return
 
-    const popup = await openPopup(html` <kpi-grade-editor .kpi=${kpi}></kpi-grade-editor> `, {       title: `${kpi.name} - 등급 설정`,
+    const popup = await openPopup(html` <kpi-grade-editor .kpi=${kpi}></kpi-grade-editor> `, {
+      title: `${kpi.name} - 등급 설정`,
       size: 'large'
- })
+    })
+    popup.onclosed = () => { this.grist.fetch() }
+  }
 
-    popup.onclosed = () => {       this.grist.fetch()
- }
- }
+  /**
+   * CUSTOM scoreType의 등급 편집 팝업. 서브클래스에서 override하여 구현.
+   */
+  protected async _editCustomGrades(kpi: any) {
+    notify({ message: '커스텀 등급 편집기가 필요합니다.' })
+  }
 
   async _editViz(kpi: any) {     const popup = await openPopup(
       html`
@@ -733,6 +832,7 @@ export class KpiListPage extends p13n(localize(i18next)(ScopedElementsMixin(Page
             active
             formula
             periodType
+            scoreType
             scoreFormula
             grades
             vizType

package/client/pages/kpi-dashboard/components/kpi-map-panel.ts

@@ -329,7 +329,7 @@ export class KpiMapPanel extends LitElement {
                 this.onPeriodChange()
               }}
             >
-              <option value="전체">전체</option>
+              <option value="2026">2026년</option>
               <option value="2025">2025년</option>
               <option value="2024">2024년</option>
               <option value="2023">2023년</option>
@@ -366,7 +366,7 @@ export class KpiMapPanel extends LitElement {
                 this.onPeriodChange()
               }}
             >
-              <option value="전체">전체</option>
+              <option value="2026">2026년</option>
               <option value="2025">2025년</option>
               <option value="2024">2024년</option>
               <option value="2023">2023년</option>

package/dist-client/index.d.ts

@@ -0,0 +1 @@
+export { KpiListPage } from './pages/kpi/kpi-list-page.js';

package/dist-client/index.js

@@ -1,2 +1,2 @@
-"use strict";
+export { KpiListPage } from './pages/kpi/kpi-list-page.js';
 //# sourceMappingURL=index.js.map

package/dist-client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../client/index.ts"],"names":[],"mappings":"","sourcesContent":[""]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA","sourcesContent":["export { KpiListPage } from './pages/kpi/kpi-list-page.js'\n"]}

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

@@ -6,7 +6,36 @@ import '@operato/data-grist/ox-record-creator.js';
 import './kpi-viz-editor.js';
 import './kpi-grade-editor.js';
 import { PageView } from '@operato/shell';
-import { FetchOption } from '@operato/data-grist';
+import { DataGrist, FetchOption } from '@operato/data-grist';
+/**
+ * KPI scoreType — value → score 변환 방식 (null이면 미설정)
+ *
+ * DIRECT  — value = score, 변환 없음
+ * FORMULA — scoreFormula 수식으로 변환
+ * LOOKUP  — grade table(1D)로 변환
+ * CUSTOM  — 2D 룩업 등 특수 변환
+ */
+export declare const KPI_SCORE_TYPE: {
+    readonly DIRECT: "DIRECT";
+    readonly FORMULA: "FORMULA";
+    readonly LOOKUP: "LOOKUP";
+    readonly CUSTOM: "CUSTOM";
+};
+/**
+ * KPI valueType — value 획득 방식
+ *
+ * MEASURED   — 외부 시스템 수집 측정값
+ * ASSESSED   — 감리자 직접 평가 (1~5)
+ * CALCULATED — formula 자동 계산
+ * COMPOSITE  — 다차원 복합 입력
+ */
+export declare const KPI_VALUE_TYPE: {
+    readonly MEASURED: "MEASURED";
+    readonly ASSESSED: "ASSESSED";
+    readonly CALCULATED: "CALCULATED";
+    readonly COMPOSITE: "COMPOSITE";
+};
+export declare function inferScoreType(kpi: any): string;
 import { KpiImporter } from './kpi-importer';
 import { KpiGradeEditor } from './kpi-grade-editor';
 import { KpiVizEditor } from './kpi-viz-editor';
@@ -25,7 +54,7 @@ export declare class KpiListPage extends KpiListPage_base {
     };
     gristConfig: any;
     mode: 'CARD' | 'GRID' | 'LIST';
-    private grist;
+    protected grist: DataGrist;
     availableVariables: any[];
     availableVariablesLoaded: boolean;
     hierarchicalView: boolean;
@@ -77,7 +106,23 @@ export declare class KpiListPage extends KpiListPage_base {
     creationCallback(kpi: any): Promise<boolean>;
     exportHandler(): Promise<{}[]>;
     importHandler(records: any): Promise<void>;
-    _editGrades(kpi: any): Promise<void>;
+    /**
+     * grades 셀 렌더러. 서브클래스에서 override 가능.
+     * CUSTOM scoreType은 renderCustomGradesCell()로 위임.
+     */
+    protected renderGradesCell(kpi: any): any;
+    /**
+     * CUSTOM scoreType의 grades 셀 렌더링. 서브클래스에서 override하여 구현.
+     */
+    protected renderCustomGradesCell(kpi: any): any;
+    /**
+     * 등급 편집 팝업. CUSTOM 타입은 _editCustomGrades()로 위임. 서브클래스에서 override 가능.
+     */
+    protected _editGrades(kpi: any): Promise<void>;
+    /**
+     * CUSTOM scoreType의 등급 편집 팝업. 서브클래스에서 override하여 구현.
+     */
+    protected _editCustomGrades(kpi: any): Promise<void>;
     _editViz(kpi: any): Promise<void>;
     _onVizUpdated(kpiId: string, vizType: string, vizMeta: any): Promise<void>;
     _calculateKpiValue(kpi: any): Promise<void>;

package/dist-client/pages/kpi/kpi-list-page.js

@@ -19,6 +19,45 @@ import { OxPrompt } from '@operato/popup';
 import { isMobileDevice } from '@operato/utils';
 import { p13n } from '@operato/p13n';
 import gql from 'graphql-tag';
+/**
+ * KPI scoreType — value → score 변환 방식 (null이면 미설정)
+ *
+ * DIRECT  — value = score, 변환 없음
+ * FORMULA — scoreFormula 수식으로 변환
+ * LOOKUP  — grade table(1D)로 변환
+ * CUSTOM  — 2D 룩업 등 특수 변환
+ */
+export const KPI_SCORE_TYPE = {
+    DIRECT: 'DIRECT',
+    FORMULA: 'FORMULA',
+    LOOKUP: 'LOOKUP',
+    CUSTOM: 'CUSTOM'
+};
+/**
+ * KPI valueType — value 획득 방식
+ *
+ * MEASURED   — 외부 시스템 수집 측정값
+ * ASSESSED   — 감리자 직접 평가 (1~5)
+ * CALCULATED — formula 자동 계산
+ * COMPOSITE  — 다차원 복합 입력
+ */
+export const KPI_VALUE_TYPE = {
+    MEASURED: 'MEASURED',
+    ASSESSED: 'ASSESSED',
+    CALCULATED: 'CALCULATED',
+    COMPOSITE: 'COMPOSITE'
+};
+export function inferScoreType(kpi) {
+    if (kpi.scoreType)
+        return kpi.scoreType;
+    if (kpi.scoreFormula)
+        return KPI_SCORE_TYPE.FORMULA;
+    if (kpi.grades && typeof kpi.grades === 'object' && !Array.isArray(kpi.grades))
+        return KPI_SCORE_TYPE.CUSTOM;
+    if (Array.isArray(kpi.grades) && kpi.grades.length > 0)
+        return KPI_SCORE_TYPE.LOOKUP;
+    return KPI_SCORE_TYPE.DIRECT;
+}
 import { KpiImporter } from './kpi-importer';
 import { KpiGradeEditor } from './kpi-grade-editor';
 import { KpiVizEditor } from './kpi-viz-editor';
@@ -383,18 +422,7 @@ let KpiListPage = class KpiListPage extends p13n(localize(i18next)(ScopedElement
                     name: 'grades',
                     header: '성과지수 Lookup',
                     record: { editable: false,
-                        renderer: (v, c, r) => {
-                            if (r.grades && r.grades.length > 0) {
-                                return html `<span style="color: #4caf50; cursor: pointer;" @click=${() => this._editGrades(r)}>
-                  ${r.grades.length}개 등급 설정됨
-                </span>`;
-                            }
-                            else {
-                                return html `<span style="color: #999; cursor: pointer;" @click=${() => this._editGrades(r)}>
-                  등급 설정 없음
-                </span>`;
-                            }
-                        }
+                        renderer: (v, c, r) => this.renderGradesCell(r)
                     },
                     width: 150
                 },
@@ -486,6 +514,7 @@ let KpiListPage = class KpiListPage extends p13n(localize(i18next)(ScopedElement
               active
               formula
               periodType
+              scoreType
               scoreFormula
               grades
               vizType
@@ -648,18 +677,77 @@ let KpiListPage = class KpiListPage extends p13n(localize(i18next)(ScopedElement
             this.grist.fetch();
         };
     }
+    /**
+     * grades 셀 렌더러. 서브클래스에서 override 가능.
+     * CUSTOM scoreType은 renderCustomGradesCell()로 위임.
+     */
+    renderGradesCell(kpi) {
+        const scoreType = inferScoreType(kpi);
+        let label;
+        let hasGrades;
+        switch (scoreType) {
+            case KPI_SCORE_TYPE.LOOKUP:
+                hasGrades = Array.isArray(kpi.grades) && kpi.grades.length > 0;
+                label = hasGrades ? `${kpi.grades.length}개 등급 설정됨` : '등급 설정 없음';
+                break;
+            case KPI_SCORE_TYPE.DIRECT:
+                // valueType으로 세분화 표시
+                if (kpi.valueType === KPI_VALUE_TYPE.ASSESSED) {
+                    return html `<span style="color:#2196f3">평가형 (1~5)</span>`;
+                }
+                if (kpi.valueType === KPI_VALUE_TYPE.CALCULATED) {
+                    return html `<span style="color:#888">산식 계산</span>`;
+                }
+                return html `<span style="color:#888">직접 (value=score)</span>`;
+            case KPI_SCORE_TYPE.FORMULA:
+                return html `<span style="color:#888">산식 변환</span>`;
+            case KPI_SCORE_TYPE.CUSTOM:
+                return this.renderCustomGradesCell(kpi);
+            default:
+                if (!scoreType) {
+                    return html `<span style="color:#ccc">미설정</span>`;
+                }
+                hasGrades = false;
+                label = '등급 설정 없음';
+        }
+        return html `<span
+      style="color:${hasGrades ? '#4caf50' : '#999'};cursor:pointer;"
+      @click=${() => this._editGrades(kpi)}
+      >${label}</span
+    >`;
+    }
+    /**
+     * CUSTOM scoreType의 grades 셀 렌더링. 서브클래스에서 override하여 구현.
+     */
+    renderCustomGradesCell(kpi) {
+        return html `<span style="color:#999;cursor:pointer;" @click=${() => this._editGrades(kpi)}>커스텀 설정됨</span>`;
+    }
+    /**
+     * 등급 편집 팝업. CUSTOM 타입은 _editCustomGrades()로 위임. 서브클래스에서 override 가능.
+     */
     async _editGrades(kpi) {
         if (!kpi.id) {
-            notify({ message: 'KPI를 먼저 저장한 후에 등급 설정을 할 수 있습니다.'
-            });
+            notify({ message: 'KPI를 먼저 저장한 후에 등급 설정을 할 수 있습니다.' });
+            return;
+        }
+        const scoreType = inferScoreType(kpi);
+        if (scoreType === KPI_SCORE_TYPE.CUSTOM) {
+            await this._editCustomGrades(kpi);
             return;
         }
-        const popup = await openPopup(html ` <kpi-grade-editor .kpi=${kpi}></kpi-grade-editor> `, { title: `${kpi.name} - 등급 설정`,
+        if (scoreType !== KPI_SCORE_TYPE.LOOKUP)
+            return;
+        const popup = await openPopup(html ` <kpi-grade-editor .kpi=${kpi}></kpi-grade-editor> `, {
+            title: `${kpi.name} - 등급 설정`,
             size: 'large'
         });
-        popup.onclosed = () => {
-            this.grist.fetch();
-        };
+        popup.onclosed = () => { this.grist.fetch(); };
+    }
+    /**
+     * CUSTOM scoreType의 등급 편집 팝업. 서브클래스에서 override하여 구현.
+     */
+    async _editCustomGrades(kpi) {
+        notify({ message: '커스텀 등급 편집기가 필요합니다.' });
     }
     async _editViz(kpi) {
         const popup = await openPopup(html `
@@ -731,6 +819,7 @@ let KpiListPage = class KpiListPage extends p13n(localize(i18next)(ScopedElement
             active
             formula
             periodType
+            scoreType
             scoreFormula
             grades
             vizType