@things-factory/kpi 10.0.0-beta.9 → 10.0.0-beta.91

package/dist-server/service/utils/domain-inheritance.d.ts

@@ -0,0 +1,17 @@
+import { Domain } from '@things-factory/shell';
+export declare function getDomainIdsWithAncestors(domain: Domain): Promise<string[]>;
+/**
+ * "가까운 도메인 우선(override)" 의미 구현.
+ * 여러 ancestor 도메인의 항목들 중 같은 키(name 등)가 중복 존재하면
+ * domainIds 배열에서 더 앞(=가까운 도메인)에 있는 도메인에 속한 항목 1개만 남긴다.
+ *
+ * - domainIds: closest-first 순서 (getDomainIdsWithAncestors 결과)
+ * - keyFn: 중복 판정 키 (예: kpi.name)
+ *
+ * 정렬은 호출자가 다시 적용해야 한다 (typeorm 의 사전 정렬은 dedup 으로 깨지지 않음 -
+ *  같은 키 그룹 내부의 선택만 바뀌고 그룹의 위치는 입력 순서를 유지하므로
+ *  안정적이다).
+ */
+export declare function dedupByClosestDomain<T extends {
+    domainId?: string;
+}>(items: T[], domainIds: string[], keyFn: (item: T) => string | undefined): T[];

package/dist-server/service/utils/domain-inheritance.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDomainIdsWithAncestors = getDomainIdsWithAncestors;
+exports.dedupByClosestDomain = dedupByClosestDomain;
+const shell_1 = require("@things-factory/shell");
+/**
+ * 멀티테넌트 도메인 다단계 상속 헬퍼.
+ *
+ * SYSTEM → PROJECT-TEMPLATE → project 처럼 계층이 깊어질 수 있으므로
+ * 현재 도메인 부터 루트(부모가 없는 도메인)까지의 ancestor id 를
+ * "가까운 순서대로" 반환한다. (closest-first)
+ *
+ * - 사용처: 단일 fetch 의 `In([...])`, list 조회의 `andWhere('domain IN (:...ids)')`,
+ *   그리고 closest-wins dedup 의 우선순위 키.
+ *
+ * 깊이는 보통 2~3 이지만 순환 방지 + 최대 깊이(10) 안전장치를 둔다.
+ */
+const MAX_ANCESTOR_DEPTH = 10;
+async function getDomainIdsWithAncestors(domain) {
+    const ids = [domain.id];
+    const seen = new Set([domain.id]);
+    let parentId = domain.parentId;
+    let depth = 0;
+    while (parentId && !seen.has(parentId) && depth < MAX_ANCESTOR_DEPTH) {
+        seen.add(parentId);
+        ids.push(parentId);
+        const parent = await (0, shell_1.getRepository)(shell_1.Domain).findOne({ where: { id: parentId } });
+        parentId = parent?.parentId;
+        depth++;
+    }
+    return ids;
+}
+/**
+ * "가까운 도메인 우선(override)" 의미 구현.
+ * 여러 ancestor 도메인의 항목들 중 같은 키(name 등)가 중복 존재하면
+ * domainIds 배열에서 더 앞(=가까운 도메인)에 있는 도메인에 속한 항목 1개만 남긴다.
+ *
+ * - domainIds: closest-first 순서 (getDomainIdsWithAncestors 결과)
+ * - keyFn: 중복 판정 키 (예: kpi.name)
+ *
+ * 정렬은 호출자가 다시 적용해야 한다 (typeorm 의 사전 정렬은 dedup 으로 깨지지 않음 -
+ *  같은 키 그룹 내부의 선택만 바뀌고 그룹의 위치는 입력 순서를 유지하므로
+ *  안정적이다).
+ */
+function dedupByClosestDomain(items, domainIds, keyFn) {
+    const rankOf = (domainId) => {
+        if (!domainId)
+            return Number.MAX_SAFE_INTEGER;
+        const idx = domainIds.indexOf(domainId);
+        return idx < 0 ? Number.MAX_SAFE_INTEGER : idx;
+    };
+    const byKey = new Map();
+    const order = [];
+    for (const item of items) {
+        const key = keyFn(item);
+        if (key == null)
+            continue;
+        const existing = byKey.get(key);
+        if (!existing) {
+            byKey.set(key, item);
+            order.push(key);
+        }
+        else if (rankOf(item.domainId) < rankOf(existing.domainId)) {
+            byKey.set(key, item);
+        }
+    }
+    return order.map(k => byKey.get(k));
+}
+//# sourceMappingURL=domain-inheritance.js.map

package/dist-server/service/utils/domain-inheritance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-inheritance.js","sourceRoot":"","sources":["../../../server/service/utils/domain-inheritance.ts"],"names":[],"mappings":";;AAgBA,8DAiBC;AAcD,oDA4BC;AA3ED,iDAA6D;AAE7D;;;;;;;;;;;GAWG;AACH,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAEtB,KAAK,UAAU,yBAAyB,CAAC,MAAc;IAC5D,MAAM,GAAG,GAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;IAEzC,IAAI,QAAQ,GAAuB,MAAM,CAAC,QAAQ,CAAA;IAClD,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,kBAAkB,EAAE,CAAC;QACrE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAClB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAElB,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAa,EAAC,cAAM,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAA;QAC/E,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAA;QAC3B,KAAK,EAAE,CAAA;IACT,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,oBAAoB,CAClC,KAAU,EACV,SAAmB,EACnB,KAAsC;IAEtC,MAAM,MAAM,GAAG,CAAC,QAA4B,EAAU,EAAE;QACtD,IAAI,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC,gBAAgB,CAAA;QAC7C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACvC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAA;IAChD,CAAC,CAAA;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAa,CAAA;IAClC,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,IAAI;YAAE,SAAQ;QAEzB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACpB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACtB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAA;AACtC,CAAC","sourcesContent":["import { Domain, getRepository } from '@things-factory/shell'\n\n/**\n * 멀티테넌트 도메인 다단계 상속 헬퍼.\n *\n * SYSTEM → PROJECT-TEMPLATE → project 처럼 계층이 깊어질 수 있으므로\n * 현재 도메인 부터 루트(부모가 없는 도메인)까지의 ancestor id 를\n * \"가까운 순서대로\" 반환한다. (closest-first)\n *\n * - 사용처: 단일 fetch 의 `In([...])`, list 조회의 `andWhere('domain IN (:...ids)')`,\n *   그리고 closest-wins dedup 의 우선순위 키.\n *\n * 깊이는 보통 2~3 이지만 순환 방지 + 최대 깊이(10) 안전장치를 둔다.\n */\nconst MAX_ANCESTOR_DEPTH = 10\n\nexport async function getDomainIdsWithAncestors(domain: Domain): Promise<string[]> {\n  const ids: string[] = [domain.id]\n  const seen = new Set<string>([domain.id])\n\n  let parentId: string | undefined = domain.parentId\n  let depth = 0\n\n  while (parentId && !seen.has(parentId) && depth < MAX_ANCESTOR_DEPTH) {\n    seen.add(parentId)\n    ids.push(parentId)\n\n    const parent = await getRepository(Domain).findOne({ where: { id: parentId } })\n    parentId = parent?.parentId\n    depth++\n  }\n\n  return ids\n}\n\n/**\n * \"가까운 도메인 우선(override)\" 의미 구현.\n * 여러 ancestor 도메인의 항목들 중 같은 키(name 등)가 중복 존재하면\n * domainIds 배열에서 더 앞(=가까운 도메인)에 있는 도메인에 속한 항목 1개만 남긴다.\n *\n * - domainIds: closest-first 순서 (getDomainIdsWithAncestors 결과)\n * - keyFn: 중복 판정 키 (예: kpi.name)\n *\n * 정렬은 호출자가 다시 적용해야 한다 (typeorm 의 사전 정렬은 dedup 으로 깨지지 않음 -\n *  같은 키 그룹 내부의 선택만 바뀌고 그룹의 위치는 입력 순서를 유지하므로\n *  안정적이다).\n */\nexport function dedupByClosestDomain<T extends { domainId?: string }>(\n  items: T[],\n  domainIds: string[],\n  keyFn: (item: T) => string | undefined\n): T[] {\n  const rankOf = (domainId: string | undefined): number => {\n    if (!domainId) return Number.MAX_SAFE_INTEGER\n    const idx = domainIds.indexOf(domainId)\n    return idx < 0 ? Number.MAX_SAFE_INTEGER : idx\n  }\n\n  const byKey = new Map<string, T>()\n  const order: string[] = []\n\n  for (const item of items) {\n    const key = keyFn(item)\n    if (key == null) continue\n\n    const existing = byKey.get(key)\n    if (!existing) {\n      byKey.set(key, item)\n      order.push(key)\n    } else if (rankOf(item.domainId) < rankOf(existing.domainId)) {\n      byKey.set(key, item)\n    }\n  }\n\n  return order.map(k => byKey.get(k)!)\n}\n"]}