@dssp/dcsp 1.0.2 → 1.0.5

package/dist-client/viewparts/menu-tools.d.ts

@@ -1,3 +1,4 @@
+import '@material/web/icon/icon.js';
 import { LitElement } from 'lit';
 declare const MenuTools_base: (new (...args: any[]) => {
     _storeUnsubscribe: () => void;
@@ -9,8 +10,12 @@ export declare class MenuTools extends MenuTools_base {
     static styles: import("lit").CSSResult[];
     page?: string;
     width?: string;
+    openedMenuIndex: number | null;
     private menus;
     render(): import("lit-html").TemplateResult<1>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _closeSubmenu;
     stateChanged(state: any): void;
 }
 export {};

package/dist-client/viewparts/menu-tools.js

@@ -1,15 +1,40 @@
 import { __decorate, __metadata } from "tslib";
+import '@material/web/icon/icon.js';
 import { css, html, LitElement } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
 import { store, connect } from '@operato/shell';
-import { ICONS_PROGRESS, ICONS_COMPLETED, ICONS_SETTING } from '../icons/menu-icons';
+import { ICONS_PROGRESS, ICONS_COMPLETED, ICONS_STATUS, ICONS_SETTING } from '../icons/menu-icons';
 let MenuTools = class MenuTools extends connect(store)(LitElement) {
     constructor() {
         super(...arguments);
+        this.openedMenuIndex = null;
         this.menus = [];
+        this._closeSubmenu = (e) => {
+            const path = e.composedPath();
+            if (path.includes(this)) {
+                // 내부 클릭이라도 실제 페이지로 이동하는 링크 클릭이면 닫는다.
+                const isNavLink = path.some(el => el instanceof HTMLAnchorElement &&
+                    !!el.getAttribute('href') &&
+                    el.getAttribute('href') !== 'javascript:void(0)');
+                if (!isNavLink)
+                    return;
+            }
+            this.openedMenuIndex = null;
+        };
     }
     render() {
+        var _a;
         this.menus = [
+            {
+                name: 'KPI\nOversight',
+                path: 'kpi-overview',
+                icons: ICONS_STATUS,
+                submenus: [
+                    { name: 'KPI 대시보드', path: 'kpi-dashboard-map', icon: 'dashboard' },
+                    { name: 'KPI 개요', path: 'kpi-overview', icon: 'widget_small' },
+                    { name: 'KPI 시스템 가이드', path: 'kpi-system-guide', icon: 'menu_book' }
+                ]
+            },
             {
                 name: '진행중',
                 path: 'project-list',
@@ -39,17 +64,54 @@ let MenuTools = class MenuTools extends connect(store)(LitElement) {
         var page = this.page || '';
         return html `
       <ul>
-        ${this.menus.map(menu => html `
-            <li>
-              <a href=${menu.path} ?active=${!!~page.indexOf(menu.path)}>
-                <img src=${!!~page.indexOf(menu.path) ? menu.icons[1] : menu.icons[0]} />
+        ${this.menus.map((menu, i) => {
+            /* 서브메뉴가 있으면 이동 대신 팝업을 연다 (dkpi 방식) */
+            const active = menu.submenus
+                ? menu.submenus.some(sub => !!~page.indexOf(sub.path))
+                : !!~page.indexOf(menu.path);
+            return html `
+            <li
+              @click=${menu.submenus
+                ? (e) => {
+                    e.stopPropagation();
+                    this.openedMenuIndex = i;
+                }
+                : undefined}
+            >
+              <a href=${menu.submenus ? 'javascript:void(0)' : menu.path} ?active=${active}>
+                <img src=${active ? menu.icons[1] : menu.icons[0]} />
                 <div>${menu.name}</div>
               </a>
             </li>
-          `)}
+          `;
+        })}
       </ul>
+      ${this.openedMenuIndex !== null && ((_a = this.menus[this.openedMenuIndex]) === null || _a === void 0 ? void 0 : _a.submenus)
+            ? html `
+            <div class="submenu-popup">
+              <ul>
+                ${this.menus[this.openedMenuIndex].submenus.map(sub => html `
+                    <li>
+                      <a href=${sub.path} ?active=${!!~page.indexOf(sub.path)}>
+                        <md-icon>${sub.icon}</md-icon> ${sub.name}
+                      </a>
+                    </li>
+                  `)}
+              </ul>
+            </div>
+          `
+            : ''}
     `;
     }
+    connectedCallback() {
+        super.connectedCallback();
+        // capture 단계로 등록 — stopPropagation 하는 다른 컴포넌트의 클릭에도 서브메뉴를 닫는다 (dkpi 방식)
+        window.addEventListener('click', this._closeSubmenu, true);
+    }
+    disconnectedCallback() {
+        window.removeEventListener('click', this._closeSubmenu, true);
+        super.disconnectedCallback();
+    }
     stateChanged(state) {
         this.page = state.route.page;
         this.width = state.layout.width;
@@ -58,6 +120,7 @@ let MenuTools = class MenuTools extends connect(store)(LitElement) {
 MenuTools.styles = [
     css `
       :host {
+        position: relative;
         display: flex;
         background-color: var(--secondary-color);
 
@@ -75,7 +138,8 @@ MenuTools.styles = [
         height: 100%;
       }
 
-      ul {
+      /* 사이드바 메뉴 스타일 — 팝업 내부로 새지 않도록 직계 자식(> ul)으로 스코핑 */
+      :host > ul {
         display: flex;
         flex-direction: row;
 
@@ -86,24 +150,24 @@ MenuTools.styles = [
         overflow: none;
       }
 
-      :host([width='NARROW']) ul {
+      :host([width='NARROW']) > ul {
         width: 100%;
         justify-content: space-around;
       }
 
-      :host([width='WIDE']) ul {
+      :host([width='WIDE']) > ul {
         flex-direction: column;
       }
-      :host([width='NARROW']) li {
+      :host([width='NARROW']) > ul > li {
         flex: 1;
       }
 
-      :host([width='WIDE']) li {
+      :host([width='WIDE']) > ul > li {
         border-top: 1px solid rgba(255, 255, 255, 0.1);
         border-bottom: 1px solid rgba(0, 0, 0, 0.1);
       }
 
-      a {
+      :host > ul a {
         display: flex;
         flex-direction: column;
         padding: 5px 0px;
@@ -116,7 +180,7 @@ MenuTools.styles = [
         border-left: 2px solid transparent;
       }
 
-      a[active] {
+      :host > ul a[active] {
         opacity: 1;
         color: var(--menu-tools-active-color);
         font-weight: bold;
@@ -124,7 +188,7 @@ MenuTools.styles = [
         border-left: 2px solid var(--menu-tools-active-color);
       }
 
-      :host([width='NARROW']) a {
+      :host([width='NARROW']) > ul a {
         padding: 0px 0px 5px 0px;
         opacity: 0.8;
         color: var(--menu-tools-color);
@@ -132,7 +196,7 @@ MenuTools.styles = [
         border-top: 2px solid transparent;
       }
 
-      :host([width='NARROW']) a[active] {
+      :host([width='NARROW']) > ul a[active] {
         opacity: 1;
         color: var(--menu-tools-active-color);
         font-weight: bold;
@@ -151,8 +215,73 @@ MenuTools.styles = [
         padding: 0;
       }
 
-      div {
+      :host > ul div {
         font-size: 0.6em;
+        white-space: pre-line; /* 메뉴명 내 \n 줄바꿈 표현 */
+      }
+
+      /* dkpi menu-tools의 서브메뉴 팝업과 동일 구성 — 배경만 테마색(--secondary-color) 사용 */
+      .submenu-popup {
+        position: absolute;
+        left: 60px; /* 탑메뉴 width */
+        top: 0;
+        width: 220px;
+        height: 100%;
+        background: var(--secondary-color);
+        color: #fff;
+        box-shadow: 2px 0 8px rgba(0, 0, 0, 0.15);
+        z-index: 1000;
+        display: flex;
+        flex-direction: column;
+        border-radius: 0 10px 10px 0;
+      }
+
+      .submenu-popup ul {
+        list-style: none;
+        margin: 0;
+        padding: 0;
+      }
+
+      .submenu-popup li {
+        /* em 은 상속 기준에 따라 커질 수 있어 고정 크기 사용 */
+        font-size: 14px;
+        border-top: 1px solid rgba(255, 255, 255, 0.1);
+        border-bottom: 1px solid rgba(0, 0, 0, 0.1);
+      }
+
+      .submenu-popup li a {
+        color: var(--menu-tools-color);
+        opacity: 0.7;
+        text-decoration: none;
+        text-transform: capitalize;
+        display: flex;
+        flex-direction: row;
+        align-items: center;
+        gap: 12px;
+        transition: background 0.2s;
+        padding: 12px 16px;
+        border-left: 2px solid transparent;
+      }
+
+      .submenu-popup li a:hover {
+        background: rgba(0, 0, 0, 0.15);
+      }
+
+      .submenu-popup li a[active] {
+        opacity: 1;
+        color: var(--menu-tools-active-color);
+        font-weight: bold;
+        background-color: rgba(0, 0, 0, 0.15);
+        border-left: 2px solid var(--menu-tools-active-color);
+      }
+
+      .submenu-popup li a md-icon {
+        --md-icon-size: 20px;
+        color: rgba(255, 255, 255, 0.8);
+      }
+
+      .submenu-popup li a[active] md-icon {
+        color: var(--menu-tools-active-color);
       }
     `
 ];
@@ -164,6 +293,10 @@ __decorate([
     property({ type: String, reflect: true }),
     __metadata("design:type", String)
 ], MenuTools.prototype, "width", void 0);
+__decorate([
+    property({ type: Number }),
+    __metadata("design:type", Object)
+], MenuTools.prototype, "openedMenuIndex", void 0);
 MenuTools = __decorate([
     customElement('menu-tools')
 ], MenuTools);

package/dist-client/viewparts/menu-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"menu-tools.js","sourceRoot":"","sources":["../../client/viewparts/menu-tools.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAS,MAAM,mBAAmB,CAAA;AAElE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAiC,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAG5G,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;IAAlD;;QA0GG,UAAK,GAAsD,EAAE,CAAA;IAqDvE,CAAC;IAnDC,MAAM;QACJ,IAAI,CAAC,KAAK,GAAG;YACX;gBACE,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,cAAc;aACtB;YACD;gBACE,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,wBAAwB;gBAC9B,KAAK,EAAE,eAAe;aACvB;YACD,IAAI;YACJ,kBAAkB;YAClB,yBAAyB;YACzB,wBAAwB;YACxB,KAAK;YACL,IAAI;YACJ,iBAAiB;YACjB,+BAA+B;YAC/B,2BAA2B;YAC3B,KAAK;YACL;gBACE,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,sBAAsB;gBAC5B,KAAK,EAAE,aAAa;aACrB;SACF,CAAA;QAED,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;QAE1B,OAAO,IAAI,CAAA;;UAEL,IAAI,CAAC,KAAK,CAAC,GAAG,CACd,IAAI,CAAC,EAAE,CAAC,IAAI,CAAA;;wBAEE,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;2BAC5C,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;uBAC9D,IAAI,CAAC,IAAI;;;WAGrB,CACF;;KAEJ,CAAA;IACH,CAAC;IAED,YAAY,CAAC,KAAK;QAChB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAA;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAA;IACjC,CAAC;;AA7JM,gBAAM,GAAG;IACd,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkGF;CACF,AApGY,CAoGZ;AAE2B;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;uCAAc;AACE;IAA1C,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;wCAAe;AAxG9C,SAAS;IADrB,aAAa,CAAC,YAAY,CAAC;GACf,SAAS,CA+JrB","sourcesContent":["import { css, html, LitElement } from 'lit'\nimport { customElement, property, query } from 'lit/decorators.js'\n\nimport { store, connect } from '@operato/shell'\n\nimport { ICONS_PROGRESS, ICONS_COMPLETED, ICONS_STATUS, ICONS_OPERATING, ICONS_SETTING } from '../icons/menu-icons'\n\n@customElement('menu-tools')\nexport class MenuTools extends connect(store)(LitElement) {\n  static styles = [\n    css`\n      :host {\n        display: flex;\n        background-color: var(--secondary-color);\n\n        /* for narrow mode */\n        flex-direction: column;\n        width: 100%;\n        --menu-tools-color: rgba(255, 255, 255, 0.9);\n        --menu-tools-active-color: rgba(107, 178, 249, 1);\n      }\n\n      :host([width='WIDE']) {\n        /* for wide mode */\n        flex-direction: row;\n        width: initial;\n        height: 100%;\n      }\n\n      ul {\n        display: flex;\n        flex-direction: row;\n\n        margin: auto;\n        padding: 0;\n        list-style: none;\n        height: 100%;\n        overflow: none;\n      }\n\n      :host([width='NARROW']) ul {\n        width: 100%;\n        justify-content: space-around;\n      }\n\n      :host([width='WIDE']) ul {\n        flex-direction: column;\n      }\n      :host([width='NARROW']) li {\n        flex: 1;\n      }\n\n      :host([width='WIDE']) li {\n        border-top: 1px solid rgba(255, 255, 255, 0.1);\n        border-bottom: 1px solid rgba(0, 0, 0, 0.1);\n      }\n\n      a {\n        display: flex;\n        flex-direction: column;\n        padding: 5px 0px;\n        opacity: 0.7;\n        align-items: center;\n        text-align: center;\n        text-decoration: none;\n        text-transform: capitalize;\n        color: var(--menu-tools-color);\n        border-left: 2px solid transparent;\n      }\n\n      a[active] {\n        opacity: 1;\n        color: var(--menu-tools-active-color);\n        font-weight: bold;\n        background-color: rgba(0, 0, 0, 0.15);\n        border-left: 2px solid var(--menu-tools-active-color);\n      }\n\n      :host([width='NARROW']) a {\n        padding: 0px 0px 5px 0px;\n        opacity: 0.8;\n        color: var(--menu-tools-color);\n        border-left: none;\n        border-top: 2px solid transparent;\n      }\n\n      :host([width='NARROW']) a[active] {\n        opacity: 1;\n        color: var(--menu-tools-active-color);\n        font-weight: bold;\n        background-color: rgba(0, 0, 0, 0.15);\n        border-left: none;\n        border-top: 2px solid var(--menu-tools-active-color);\n      }\n\n      img {\n        display: block;\n        width: 35px;\n        padding: 5px 10px 0px 10px;\n      }\n\n      :host([width='NARROW']) img {\n        padding: 0;\n      }\n\n      div {\n        font-size: 0.6em;\n      }\n    `\n  ]\n\n  @property({ type: String }) page?: string\n  @property({ type: String, reflect: true }) width?: string\n\n  private menus: { name: string; path: string; icons: string[] }[] = []\n\n  render() {\n    this.menus = [\n      {\n        name: '진행중',\n        path: 'project-list',\n        icons: ICONS_PROGRESS\n      },\n      {\n        name: '완료',\n        path: 'project-completed-list',\n        icons: ICONS_COMPLETED\n      },\n      // {\n      //   name: '검측현황',\n      //   path: 'dssp-status',\n      //   icons: ICONS_STATUS\n      // },\n      // {\n      //   name: '공정표',\n      //   path: 'project-task-list',\n      //   icons: ICONS_OPERATING\n      // },\n      {\n        name: '셋팅',\n        path: 'project-setting-list',\n        icons: ICONS_SETTING\n      }\n    ]\n\n    var page = this.page || ''\n\n    return html`\n      <ul>\n        ${this.menus.map(\n          menu => html`\n            <li>\n              <a href=${menu.path} ?active=${!!~page.indexOf(menu.path)}>\n                <img src=${!!~page.indexOf(menu.path) ? menu.icons[1] : menu.icons[0]} />\n                <div>${menu.name}</div>\n              </a>\n            </li>\n          `\n        )}\n      </ul>\n    `\n  }\n\n  stateChanged(state) {\n    this.page = state.route.page\n    this.width = state.layout.width\n  }\n}\n"]}
+{"version":3,"file":"menu-tools.js","sourceRoot":"","sources":["../../client/viewparts/menu-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import '@material/web/icon/icon.js'\n\nimport { css, html, LitElement } from 'lit'\nimport { customElement, property, query } from 'lit/decorators.js'\n\nimport { store, connect } from '@operato/shell'\n\nimport { ICONS_PROGRESS, ICONS_COMPLETED, ICONS_STATUS, ICONS_OPERATING, ICONS_SETTING } from '../icons/menu-icons'\n\n@customElement('menu-tools')\nexport class MenuTools extends connect(store)(LitElement) {\n  static styles = [\n    css`\n      :host {\n        position: relative;\n        display: flex;\n        background-color: var(--secondary-color);\n\n        /* for narrow mode */\n        flex-direction: column;\n        width: 100%;\n        --menu-tools-color: rgba(255, 255, 255, 0.9);\n        --menu-tools-active-color: rgba(107, 178, 249, 1);\n      }\n\n      :host([width='WIDE']) {\n        /* for wide mode */\n        flex-direction: row;\n        width: initial;\n        height: 100%;\n      }\n\n      /* 사이드바 메뉴 스타일 — 팝업 내부로 새지 않도록 직계 자식(> ul)으로 스코핑 */\n      :host > ul {\n        display: flex;\n        flex-direction: row;\n\n        margin: auto;\n        padding: 0;\n        list-style: none;\n        height: 100%;\n        overflow: none;\n      }\n\n      :host([width='NARROW']) > ul {\n        width: 100%;\n        justify-content: space-around;\n      }\n\n      :host([width='WIDE']) > ul {\n        flex-direction: column;\n      }\n      :host([width='NARROW']) > ul > li {\n        flex: 1;\n      }\n\n      :host([width='WIDE']) > ul > li {\n        border-top: 1px solid rgba(255, 255, 255, 0.1);\n        border-bottom: 1px solid rgba(0, 0, 0, 0.1);\n      }\n\n      :host > ul a {\n        display: flex;\n        flex-direction: column;\n        padding: 5px 0px;\n        opacity: 0.7;\n        align-items: center;\n        text-align: center;\n        text-decoration: none;\n        text-transform: capitalize;\n        color: var(--menu-tools-color);\n        border-left: 2px solid transparent;\n      }\n\n      :host > ul a[active] {\n        opacity: 1;\n        color: var(--menu-tools-active-color);\n        font-weight: bold;\n        background-color: rgba(0, 0, 0, 0.15);\n        border-left: 2px solid var(--menu-tools-active-color);\n      }\n\n      :host([width='NARROW']) > ul a {\n        padding: 0px 0px 5px 0px;\n        opacity: 0.8;\n        color: var(--menu-tools-color);\n        border-left: none;\n        border-top: 2px solid transparent;\n      }\n\n      :host([width='NARROW']) > ul a[active] {\n        opacity: 1;\n        color: var(--menu-tools-active-color);\n        font-weight: bold;\n        background-color: rgba(0, 0, 0, 0.15);\n        border-left: none;\n        border-top: 2px solid var(--menu-tools-active-color);\n      }\n\n      img {\n        display: block;\n        width: 35px;\n        padding: 5px 10px 0px 10px;\n      }\n\n      :host([width='NARROW']) img {\n        padding: 0;\n      }\n\n      :host > ul div {\n        font-size: 0.6em;\n        white-space: pre-line; /* 메뉴명 내 \\n 줄바꿈 표현 */\n      }\n\n      /* dkpi menu-tools의 서브메뉴 팝업과 동일 구성 — 배경만 테마색(--secondary-color) 사용 */\n      .submenu-popup {\n        position: absolute;\n        left: 60px; /* 탑메뉴 width */\n        top: 0;\n        width: 220px;\n        height: 100%;\n        background: var(--secondary-color);\n        color: #fff;\n        box-shadow: 2px 0 8px rgba(0, 0, 0, 0.15);\n        z-index: 1000;\n        display: flex;\n        flex-direction: column;\n        border-radius: 0 10px 10px 0;\n      }\n\n      .submenu-popup ul {\n        list-style: none;\n        margin: 0;\n        padding: 0;\n      }\n\n      .submenu-popup li {\n        /* em 은 상속 기준에 따라 커질 수 있어 고정 크기 사용 */\n        font-size: 14px;\n        border-top: 1px solid rgba(255, 255, 255, 0.1);\n        border-bottom: 1px solid rgba(0, 0, 0, 0.1);\n      }\n\n      .submenu-popup li a {\n        color: var(--menu-tools-color);\n        opacity: 0.7;\n        text-decoration: none;\n        text-transform: capitalize;\n        display: flex;\n        flex-direction: row;\n        align-items: center;\n        gap: 12px;\n        transition: background 0.2s;\n        padding: 12px 16px;\n        border-left: 2px solid transparent;\n      }\n\n      .submenu-popup li a:hover {\n        background: rgba(0, 0, 0, 0.15);\n      }\n\n      .submenu-popup li a[active] {\n        opacity: 1;\n        color: var(--menu-tools-active-color);\n        font-weight: bold;\n        background-color: rgba(0, 0, 0, 0.15);\n        border-left: 2px solid var(--menu-tools-active-color);\n      }\n\n      .submenu-popup li a md-icon {\n        --md-icon-size: 20px;\n        color: rgba(255, 255, 255, 0.8);\n      }\n\n      .submenu-popup li a[active] md-icon {\n        color: var(--menu-tools-active-color);\n      }\n    `\n  ]\n\n  @property({ type: String }) page?: string\n  @property({ type: String, reflect: true }) width?: string\n  @property({ type: Number }) openedMenuIndex: number | null = null\n\n  private menus: {\n    name: string\n    path: string\n    icons: string[]\n    submenus?: { name: string; path: string; icon: string }[]\n  }[] = []\n\n  render() {\n    this.menus = [\n      {\n        name: 'KPI\\nOversight',\n        path: 'kpi-overview',\n        icons: ICONS_STATUS,\n        submenus: [\n          { name: 'KPI 대시보드', path: 'kpi-dashboard-map', icon: 'dashboard' },\n          { name: 'KPI 개요', path: 'kpi-overview', icon: 'widget_small' },\n          { name: 'KPI 시스템 가이드', path: 'kpi-system-guide', icon: 'menu_book' }\n        ]\n      },\n      {\n        name: '진행중',\n        path: 'project-list',\n        icons: ICONS_PROGRESS\n      },\n      {\n        name: '완료',\n        path: 'project-completed-list',\n        icons: ICONS_COMPLETED\n      },\n      // {\n      //   name: '검측현황',\n      //   path: 'dssp-status',\n      //   icons: ICONS_STATUS\n      // },\n      // {\n      //   name: '공정표',\n      //   path: 'project-task-list',\n      //   icons: ICONS_OPERATING\n      // },\n      {\n        name: '셋팅',\n        path: 'project-setting-list',\n        icons: ICONS_SETTING\n      }\n    ]\n\n    var page = this.page || ''\n\n    return html`\n      <ul>\n        ${this.menus.map((menu, i) => {\n          /* 서브메뉴가 있으면 이동 대신 팝업을 연다 (dkpi 방식) */\n          const active = menu.submenus\n            ? menu.submenus.some(sub => !!~page.indexOf(sub.path))\n            : !!~page.indexOf(menu.path)\n\n          return html`\n            <li\n              @click=${menu.submenus\n                ? (e: Event) => {\n                    e.stopPropagation()\n                    this.openedMenuIndex = i\n                  }\n                : undefined}\n            >\n              <a href=${menu.submenus ? 'javascript:void(0)' : menu.path} ?active=${active}>\n                <img src=${active ? menu.icons[1] : menu.icons[0]} />\n                <div>${menu.name}</div>\n              </a>\n            </li>\n          `\n        })}\n      </ul>\n      ${this.openedMenuIndex !== null && this.menus[this.openedMenuIndex]?.submenus\n        ? html`\n            <div class=\"submenu-popup\">\n              <ul>\n                ${this.menus[this.openedMenuIndex].submenus!.map(\n                  sub => html`\n                    <li>\n                      <a href=${sub.path} ?active=${!!~page.indexOf(sub.path)}>\n                        <md-icon>${sub.icon}</md-icon> ${sub.name}\n                      </a>\n                    </li>\n                  `\n                )}\n              </ul>\n            </div>\n          `\n        : ''}\n    `\n  }\n\n  connectedCallback() {\n    super.connectedCallback()\n    // capture 단계로 등록 — stopPropagation 하는 다른 컴포넌트의 클릭에도 서브메뉴를 닫는다 (dkpi 방식)\n    window.addEventListener('click', this._closeSubmenu, true)\n  }\n\n  disconnectedCallback() {\n    window.removeEventListener('click', this._closeSubmenu, true)\n    super.disconnectedCallback()\n  }\n\n  private _closeSubmenu = (e: MouseEvent) => {\n    const path = e.composedPath()\n    if (path.includes(this)) {\n      // 내부 클릭이라도 실제 페이지로 이동하는 링크 클릭이면 닫는다.\n      const isNavLink = path.some(\n        el =>\n          el instanceof HTMLAnchorElement &&\n          !!el.getAttribute('href') &&\n          el.getAttribute('href') !== 'javascript:void(0)'\n      )\n      if (!isNavLink) return\n    }\n    this.openedMenuIndex = null\n  }\n\n  stateChanged(state) {\n    this.page = state.route.page\n    this.width = state.layout.width\n  }\n}\n"]}

package/dist-server/index.d.ts

@@ -0,0 +1 @@
+export * from './service/index.js';

package/dist-server/index.js

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

package/dist-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":"","sourcesContent":[""]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC","sourcesContent":["export * from './service/index.js'\n"]}

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

@@ -0,0 +1,4 @@
+export declare const entities: any[];
+export declare const schema: {
+    resolverClasses: (typeof import("./kpi-stat/kpi-stat-query").KpiStatQuery | typeof import("./kpi-value/kpi-value-query").KpiValueQueryForProject | typeof import("./kpi-metric-value/kpi-metric-value-query").KpiMetricValueQuery | typeof import("./kpi-metric-value/kpi-metric-value-mutation").KpiMetricValueMutation)[];
+};

package/dist-server/service/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schema = exports.entities = void 0;
+/* IMPORT ENTITIES AND RESOLVERS */
+const kpi_stat_1 = require("./kpi-stat");
+const kpi_value_1 = require("./kpi-value");
+const kpi_metric_value_1 = require("./kpi-metric-value");
+exports.entities = [
+/* ENTITIES */
+];
+exports.schema = {
+    resolverClasses: [
+        /* RESOLVER CLASSES */
+        ...kpi_stat_1.resolvers,
+        ...kpi_value_1.resolvers,
+        ...kpi_metric_value_1.resolvers
+    ]
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;AAAA,mCAAmC;AACnC,yCAA0D;AAC1D,2CAA4D;AAC5D,yDAAyE;AAE5D,QAAA,QAAQ,GAAG;AACtB,cAAc;CACf,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,GAAG,oBAAgB;QACnB,GAAG,qBAAiB;QACpB,GAAG,4BAAuB;KAC3B;CACF,CAAA","sourcesContent":["/* IMPORT ENTITIES AND RESOLVERS */\nimport { resolvers as KpiStatResolvers } from './kpi-stat'\nimport { resolvers as KpiValueResolvers } from './kpi-value'\nimport { resolvers as KpiMetricValueResolvers } from './kpi-metric-value'\n\nexport const entities = [\n  /* ENTITIES */\n]\n\nexport const schema = {\n  resolverClasses: [\n    /* RESOLVER CLASSES */\n    ...KpiStatResolvers,\n    ...KpiValueResolvers,\n    ...KpiMetricValueResolvers\n  ]\n}\n"]}

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

@@ -0,0 +1,4 @@
+import { KpiMetricValueQuery } from './kpi-metric-value-query';
+import { KpiMetricValueMutation } from './kpi-metric-value-mutation';
+export declare const resolvers: (typeof KpiMetricValueQuery | typeof KpiMetricValueMutation)[];
+export declare const subscribers: any[];

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscribers = exports.resolvers = void 0;
+const kpi_metric_value_query_1 = require("./kpi-metric-value-query");
+const kpi_metric_value_mutation_1 = require("./kpi-metric-value-mutation");
+exports.resolvers = [kpi_metric_value_query_1.KpiMetricValueQuery, kpi_metric_value_mutation_1.KpiMetricValueMutation];
+exports.subscribers = [];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/kpi-metric-value/index.ts"],"names":[],"mappings":";;;AAAA,qEAA8D;AAC9D,2EAAoE;AAEvD,QAAA,SAAS,GAAG,CAAC,4CAAmB,EAAE,kDAAsB,CAAC,CAAA;AACzD,QAAA,WAAW,GAAG,EAAE,CAAA","sourcesContent":["import { KpiMetricValueQuery } from './kpi-metric-value-query'\nimport { KpiMetricValueMutation } from './kpi-metric-value-mutation'\n\nexport const resolvers = [KpiMetricValueQuery, KpiMetricValueMutation]\nexport const subscribers = []\n"]}

package/dist-server/service/kpi-metric-value/kpi-metric-value-mutation.d.ts

@@ -0,0 +1,198 @@
+import { KpiMetricValue, KpiMetricValuePatch } from '@things-factory/kpi';
+import { Attachment, NewAttachment } from '@things-factory/attachment-base';
+/**
+ * 외부 시스템 데이터 수집 결과 — 시스템별 한 row.
+ * UI "자동 수집" 버튼이 시나리오 호출 후 시스템별 성공·오류 표시에 사용.
+ */
+declare class ExternalDataCollectionResult {
+    source: string;
+    label: string;
+    ok: boolean;
+    message: string;
+    data?: any;
+}
+export declare class KpiMetricValueMutation {
+    updateKpiMetricValuesCumulative(patches: KpiMetricValuePatch[], context: ResolverContext): Promise<KpiMetricValue[]>;
+    updateKpiMetricValuesAssessment(patches: KpiMetricValuePatch[], context: ResolverContext): Promise<KpiMetricValue[]>;
+    /**
+     * KpiMetricValue 의 unique 조합 (domain, metric, valueDate, org) 기준 진짜 upsert.
+     *
+     * 기존 mutation 의 `repo.save({...patch})` 는 patch.id 만 보고 update/insert 결정해
+     * 같은 metric × 같은 valueDate × 같은 org 인데 patch.id 가 새 UUID 인 경우 unique
+     * 인덱스 (ix_kpi_metric_value_latest) 위반 에러 또는 row 누적 위험. 정확한 upsert
+     * 동작을 보장하기 위해 조합 lookup → 기존 id 사용 → save.
+     *
+     * 월별 metric (periodType=MONTH, valueDate=YYYY-MM-01) 의 단일 row 정책을 자연 충족.
+     *
+     * **도메인 컨텍스트 스위치**: caller (운영자) 가 system 도메인일 수 있어 patch.org
+     * (= projectId) 로 프로젝트 테넌트 도메인을 lookup 해 그 컨텍스트로 저장. 모든
+     * patch 가 같은 projectId 라 가정 (한 번의 mutation = 한 프로젝트의 값들).
+     */
+    private upsertKpiMetricValues;
+    updateKpiMetricValuesSentiment(attachment: NewAttachment, context: ResolverContext): Promise<Attachment | null>;
+    /**
+     * FileUpload 스트림을 버퍼로 읽기
+     */
+    private readFileToBuffer;
+    /**
+     * Buffer로부터 FileUpload 객체 생성
+     */
+    private createFileUploadFromBuffer;
+    /**
+     * operator-runner 서비스 호출 (Buffer 사용)
+     */
+    private callOperatorRunnerServiceWithBuffer;
+    /**
+     * 메트릭 값 저장
+     */
+    private saveMetricValue;
+    finalizeProjectWithKpiRecalculation(projectId: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * 완공 처리 없이 KPI 만 재계산 — 진행 중 프로젝트의 중간 결과 산정 용도.
+     * DB 에 이미 저장된 KpiMetricValue 만 가지고 formula 평가. 외부 시나리오 (juso/
+     * allbaro/kiscon) 자동 수집은 의도적으로 호출하지 않음 — 외부 수집은 사용자가
+     * "자동 수집" 버튼 (`collectProjectExternalData`) 으로 명시적으로 실행하는 흐름.
+     * 권한은 `kpi:recalculate` 로 분리해 finalize 보다 가볍게 부여 가능.
+     */
+    recalculateProjectKpi(projectId: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * UI "자동 수집" 버튼 전용 mutation. 외부 시스템 3종 시나리오를 순차 호출하고
+     * 시스템별 성공/실패 + 메시지를 반환. UI 는 결과를 보고 카드별 상태 (성공·오류) 를 표시.
+     *
+     * 시나리오는 도메인 EnvVar (주소·자격증명·서비스키 등) 만으로 동작하므로 파라미터 X.
+     * 한 시스템 실패가 다른 시스템 수집을 막지 않도록 try/catch 로 격리.
+     *
+     * 운영 현실: 키스콘·올바로는 시공사 ID/PW 가 자주 미확보 → 오류 흔함. 세움터는 공공
+     * 데이터 서비스키만으로 동작 가능. UI 는 시스템별로 명확한 오류 메시지 노출.
+     */
+    collectProjectExternalData(projectId: string, context: ResolverContext): Promise<ExternalDataCollectionResult[]>;
+    /**
+     * 프로젝트 정보 수정 화면의 "정보 연동" 버튼 전용 — 세움터 수집.
+     * BuildingComplex 기본 속성 (area / floorAreaRatio / siteType / structureType /
+     * coverageRatio / householdCount 등) 자동 채움 목적.
+     *
+     * **완공/완공전 케이스 통합**: 완공 단지는 건축물대장, 완공 전(택지지구·정비사업 블록)
+     * 단지는 주택인허가에 연면적이 있다. `collectSaeumteo` 가 주소 하나로 대장 → (연면적
+     * 없으면) 인허가 순으로 시도해 하나의 세움터 결과로 반환.
+     *
+     * address 인자가 있으면 시나리오 실행 전에 canonical EnvVar 로 upsert — 운영자가 폼에서
+     * 방금 입력한 주소를 시나리오가 곧바로 사용. (블록형이면 `…블럭 (단지명)` 형태.)
+     *
+     * **도메인 스위치**: mutation 호출은 system / 운영자 도메인에서 일어나지만 시나리오·
+     * EnvVar 는 **프로젝트가 속한 도메인** 에 있어야 자연. project.domain 으로 컨텍스트
+     * 스위치 후 그 도메인에서 EnvVar upsert + 시나리오 실행.
+     */
+    collectProjectBasicInfo(projectId: string, address: string, context: ResolverContext): Promise<ExternalDataCollectionResult>;
+    /**
+     * mutation 호출이 system / 운영자 도메인에서 일어나도 시나리오·EnvVar 는 **프로젝트
+     * 테넌트 도메인** 에서 동작해야 자연. project.code 로 자식 (테넌트) 도메인을 찾아
+     * 컨텍스트 사본 만들어 반환.
+     *
+     * 테넌트 도메인 매핑: Domain.subdomain = project.code AND Domain.extType = 'project'
+     * (promoteProjectToTenant mutation 이 그렇게 생성). project.domain 자체는 부모
+     * 도메인이라 외부 연동 EnvVar 가 거기 있을 일이 없어 사용 부적합.
+     *
+     * 테넌트 도메인이 없거나 (= 아직 승격 안 됨) project.code 가 비어있으면 원본
+     * 컨텍스트 그대로 반환 (방어). project 자체가 없으면 throw.
+     */
+    private switchToProjectDomain;
+    /**
+     * 컨텍스트의 도메인에 EnvVar 1개 upsert. 시나리오가 도메인 EnvVar 를 우선 참조하는
+     * 정책이라, 폼에서 입력한 주소를 시나리오 입력으로 흘리는 다리 역할.
+     */
+    private upsertEnvVar;
+    /**
+     * 단일 시나리오 호출 + result unwrap + 실패 판정 — collectProjectExternalData 의
+     * loop 본체와 같은 로직을 1건짜리로 분리.
+     */
+    private runSingleScenario;
+    /**
+     * 외부 시스템 3종 시나리오 순차 실행 + 시스템별 결과 수집.
+     */
+    private runExternalDataScenariosWithResults;
+    /**
+     * 세움터 수집 — 완공/완공전 케이스를 **하나의 세움터 결과**로 통합.
+     *
+     * 완공 단지는 건축물대장(building-info)에, 완공 전(택지지구·정비사업 블록) 단지는
+     * 인허가에 연면적이 있다. 인허가는 **용도별로 소스가 갈린다**:
+     *  - 주택(공동주택) → 주택인허가(housing-permit, 사업계획승인)
+     *  - 비주택(복합·노유자·근생·업무 등) → 건축인허가(building-permit block, 건축허가)
+     * 주소 하나로 세 소스를 순차 시도 — **대장 → 주택인허가 → 건축인허가**. 각 블록 소스는
+     * nameFilter(사업명)가 실제로 매칭될 때만 값을 내고, 매칭 없으면 빈 결과로 통과하므로
+     * (태스크 레벨에서 미매칭=빈결과 보장) **순서와 무관하게 잘못된 소스를 집지 않는다**.
+     * 저장된 용도 필드는 신뢰불가(예: 노유자 복합시설도 building_usage=RESIDENTIAL)라
+     * 사전 라우팅 대신 이 nameFilter 기반 사슬을 쓴다. 출력 필드가 세 소스 동일
+     * (totArea→area 등)이라 downstream 매핑·클로버 방지는 그대로 동작.
+     *
+     * 주소 소스: `address` 인자(정보연동 버튼) 우선, 없으면 도메인 canonical EnvVar
+     * (`Step::건축물관리대장조회::address::query`). 각 시나리오가 자기 EnvVar 를 참조하므로
+     * canonical 주소를 세 키에 동기화한 뒤 실행 — **프로젝트당 주소 1개** 유지.
+     * (블록형 프로젝트는 canonical 에 `…블럭 (단지명)` 을 넣으면 juso 가 자동 분기.)
+     */
+    private collectSaeumteo;
+    /** 시나리오 result 에 유효한 연면적(area>0)이 있는지. 완공/완공전 채택 판정용. */
+    private hasArea;
+    /** 컨텍스트 도메인의 EnvVar 값 읽기 (없으면 undefined). */
+    private readEnvVar;
+    /**
+     * finalize 흐름용 시나리오 호출. 결과 형태 없이 진행만 — finalize 의 KPI 재계산이 곧
+     * 이어지므로 시스템별 결과를 클라이언트에 돌려줄 필요 없음. 실패는 warning 만.
+     */
+    private runExternalDataScenarios;
+    /**
+     * 프로젝트의 모든 KPI Value들을 계층적으로 재계산합니다.
+     * 1. 기존 KPI Value 삭제 (중복 방지)
+     * 2. Leaf KPIs (자식이 없는 KPI): formula 기반 계산
+     * 3. Parent KPIs (자식이 있는 KPI): 자식 KPI scores의 weighted average 계산
+     */
+    private recalculateProjectKpiValues;
+    /**
+     * 개별 KPI Value를 재계산합니다.
+     * 항상 최신 버전의 KPI를 사용하여 계산합니다.
+     */
+    private recalculateKpiValue;
+    /**
+     * scoreFormula를 사용한 성과 점수 계산
+     */
+    private calculateScoreFromFormula;
+    /**
+     * KPI의 grades lookup table을 이용한 성과 점수 변환
+     * 1D (기존 배열) 및 2D (X13 공정률×편차) lookup 모두 지원
+     */
+    private calculateScoreFromLookup;
+    /**
+     * 2D lookup table에서 점수 계산 (X13: 공정률 × 편차 → 점수 1~5)
+     *
+     * 단위 정합:
+     *   - deviationValue (= KpiMetric '일정 이탈 수준' value): % 단위 (예: 2.5 = 2.5%).
+     *   - row.boundary*: ratio 단위 (예: 0.025 = 2.5%).
+     *   - 비교 전 deviationValue 를 /100 해서 ratio 로 변환.
+     */
+    private calculateScoreFrom2DLookup;
+    /**
+     * KpiValue의 성과 점수 계산 및 저장
+     * @param context.progressRate X13 등 2D lookup KPI에 필요한 공정률 (0~100)
+     */
+    private calculateAndSaveScore;
+    /**
+     * Leaf KPI Value를 formula로 계산합니다.
+     * 참고: recalculateProjectKpiValues에서 호출 시 기존 값이 이미 삭제되었으므로 항상 새로 생성됩니다.
+     */
+    private recalculateLeafKpiValue;
+    /**
+     * Parent KPI Value를 계산합니다.
+     * 1. formula가 있으면 자식 KPI 값들을 변수로 사용하여 formula 계산
+     * 2. formula가 없으면 자식 KPI scores의 weighted average로 계산
+     * 참고: recalculateProjectKpiValues에서 호출 시 기존 값이 이미 삭제되었으므로 항상 새로 생성됩니다.
+     */
+    private recalculateParentKpiValue;
+    /**
+     * KPIs를 계층 레벨순으로 정렬합니다 (깊은 레벨부터)
+     */
+    private sortKpisByLevel;
+    /**
+     * 자식 KPI values의 weighted average를 계산합니다.
+     */
+    private calculateWeightedAverage;
+}
+export {};