@things-factory/ops-master 10.1.248 → 10.1.249

package/dist-server/service/master-page-query.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pullPage = pullPage;
+exports.refuseIfTooLarge = refuseIfTooLarge;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const master_page_1 = require("./master-page");
+/**
+ * 마스터 한 축을 **나눠 읽는다** — 저장소 쪽. 판단은 `master-page` 가 한다.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 등급은 매 쪽에 통째로 싣는다 ───────────────────────────────────────────
+ * 이 축들은 구성원이 자기 **등급을 이름으로 가리킨다.** 등급과 구성원을 따로 나눠 보내면 구성원이
+ * 먼저 도착하고 등급이 나중에 오는 순간이 생기고, 그 순간 받는 쪽은 **없는 등급을 가리키는 구성원**을
+ * 갖는다. 원래 이 조회들이 「자르지 않는다」고 적어 둔 이유가 그것이다.
+ *
+ * 그래서 **구성원만 나누고 등급은 매 쪽에 전부 싣는다.** 등급은 수십 단위라 실어도 크지 않고, 그러면
+ * 어느 쪽을 먼저 받아도 가리키는 곳이 항상 있다.
+ *
+ * ── 이름 다음부터 읽는다 ───────────────────────────────────────────────────
+ * `skip` 은 규모에서 못 쓴다 — 건너뛴 만큼을 매번 다시 읽는다. 이 축들은 이미 이름으로 정렬해 내므로
+ * **마지막 이름 다음부터** 읽으면 건너뛸 것이 없다.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * 한 축을 한 쪽만큼 읽는다.
+ *
+ * 이름 칸을 받는 이유: 축마다 다르다(`name` · `operationKey` …). 여기서 알아보려 하면 축이 늘 때마다
+ * 이 함수를 고쳐야 한다.
+ */
+async function pullPage(entity, domain, request, nameColumn = 'name') {
+    const where = { domain: { id: domain.id } };
+    if (request.after) {
+        where[nameColumn] = (0, typeorm_1.MoreThan)(request.after);
+    }
+    const read = (await (0, shell_1.getRepository)(entity).find({
+        where,
+        order: { [nameColumn]: 'ASC' },
+        take: (0, master_page_1.takeFor)(request)
+    }));
+    return (0, master_page_1.pageOf)(read, request, row => String(row[nameColumn]));
+}
+/**
+ * **통째로 달라고 했는데 너무 크면 던진다.**
+ *
+ * 자르고 넘어가지 않는다 — 받는 쪽은 그것이 전부인 줄 알고 트윈을 세우고, 없는 품목이 화면에서 그냥
+ * 존재하지 않게 된다. 오류가 안 난다. 그래서 **틀린 답 대신 오류**를 준다.
+ */
+function refuseIfTooLarge(axis, request, page) {
+    const problem = (0, master_page_1.tooLargeToPull)(axis, request, page);
+    if (problem) {
+        throw new Error(problem);
+    }
+}
+//# sourceMappingURL=master-page-query.js.map

package/dist-server/service/master-page-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-page-query.js","sourceRoot":"","sources":["../../server/service/master-page-query.ts"],"names":[],"mappings":";;AA+BA,4BAmBC;AAQD,4CAMC;AAhED,qCAAkC;AAElC,iDAA6D;AAE7D,+CAA+D;AAG/D;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;AACI,KAAK,UAAU,QAAQ,CAC5B,MAAW,EACX,MAAc,EACd,OAAoB,EACpB,aAA+B,MAAa;IAE5C,MAAM,KAAK,GAA4B,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAA;IAEpE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,UAAU,CAAC,GAAG,IAAA,kBAAQ,EAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,IAAA,qBAAa,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC;QAC7C,KAAK;QACL,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE;QAC9B,IAAI,EAAE,IAAA,qBAAO,EAAC,OAAO,CAAC;KACvB,CAAC,CAAQ,CAAA;IAEV,OAAO,IAAA,oBAAM,EAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAE,GAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;AACvE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,IAAY,EAAE,OAAoB,EAAE,IAAmB;IACtF,MAAM,OAAO,GAAG,IAAA,4BAAc,EAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAEnD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC","sourcesContent":["import { MoreThan } from 'typeorm'\n\nimport { Domain, getRepository } from '@things-factory/shell'\n\nimport { pageOf, takeFor, tooLargeToPull } from './master-page'\nimport type { Page, PageRequest } from './master-page'\n\n/**\n * 마스터 한 축을 **나눠 읽는다** — 저장소 쪽. 판단은 `master-page` 가 한다.\n *\n * ═══════════════════════════════════════════════════════════════════════════\n * ── 등급은 매 쪽에 통째로 싣는다 ───────────────────────────────────────────\n * 이 축들은 구성원이 자기 **등급을 이름으로 가리킨다.** 등급과 구성원을 따로 나눠 보내면 구성원이\n * 먼저 도착하고 등급이 나중에 오는 순간이 생기고, 그 순간 받는 쪽은 **없는 등급을 가리키는 구성원**을\n * 갖는다. 원래 이 조회들이 「자르지 않는다」고 적어 둔 이유가 그것이다.\n *\n * 그래서 **구성원만 나누고 등급은 매 쪽에 전부 싣는다.** 등급은 수십 단위라 실어도 크지 않고, 그러면\n * 어느 쪽을 먼저 받아도 가리키는 곳이 항상 있다.\n *\n * ── 이름 다음부터 읽는다 ───────────────────────────────────────────────────\n * `skip` 은 규모에서 못 쓴다 — 건너뛴 만큼을 매번 다시 읽는다. 이 축들은 이미 이름으로 정렬해 내므로\n * **마지막 이름 다음부터** 읽으면 건너뛸 것이 없다.\n * ═══════════════════════════════════════════════════════════════════════════\n */\n\n/**\n * 한 축을 한 쪽만큼 읽는다.\n *\n * 이름 칸을 받는 이유: 축마다 다르다(`name` · `operationKey` …). 여기서 알아보려 하면 축이 늘 때마다\n * 이 함수를 고쳐야 한다.\n */\nexport async function pullPage<T>(\n  entity: any,\n  domain: Domain,\n  request: PageRequest,\n  nameColumn: keyof T & string = 'name' as any\n): Promise<Page<T>> {\n  const where: Record<string, unknown> = { domain: { id: domain.id } }\n\n  if (request.after) {\n    where[nameColumn] = MoreThan(request.after)\n  }\n\n  const read = (await getRepository(entity).find({\n    where,\n    order: { [nameColumn]: 'ASC' },\n    take: takeFor(request)\n  })) as T[]\n\n  return pageOf(read, request, row => String((row as any)[nameColumn]))\n}\n\n/**\n * **통째로 달라고 했는데 너무 크면 던진다.**\n *\n * 자르고 넘어가지 않는다 — 받는 쪽은 그것이 전부인 줄 알고 트윈을 세우고, 없는 품목이 화면에서 그냥\n * 존재하지 않게 된다. 오류가 안 난다. 그래서 **틀린 답 대신 오류**를 준다.\n */\nexport function refuseIfTooLarge(axis: string, request: PageRequest, page: Page<unknown>): void {\n  const problem = tooLargeToPull(axis, request, page)\n\n  if (problem) {\n    throw new Error(problem)\n  }\n}\n"]}

package/dist-server/service/master-page.d.ts

@@ -0,0 +1,85 @@
+/**
+ * **마스터를 나눠 내는 규칙** — 순수 판단.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 무엇이 문제였나 ────────────────────────────────────────────────────────
+ * 트윈이 당겨 가는 마스터 조회 여덟 축이 **전부 전량 조회**였다. 도메인 조건 하나만 걸고 그 축의 모든
+ * 행을 읽어 JSON 한 덩어리로 낸다.
+ *
+ * 재봤다: 품목 100만에서 **2,219ms · 49MB**. 지금 미라텍은 자재 106개라 안 아프지만, 이 제품의 규모
+ * 기준은 엔티티 10만 · 품목 100만이다. 그 규모에서 이 조회는 서지 않는다.
+ *
+ * ── 왜 「조용히 자르기」가 아니라 「거절」인가 ──────────────────────────────
+ * 한계를 두고 **말없이 앞부분만 주는 것이 제일 나쁘다.** 받는 쪽은 그것이 전부인 줄 알고 트윈을
+ * 세우고, 없는 설비·없는 품목이 화면에서 그냥 **존재하지 않게** 된다. 오류가 안 난다.
+ *
+ * 오늘 하루 종일 잡은 부류가 그것이라, 여기서는 그렇게 하지 않는다.
+ *
+ *   나눠 달라고 하면(`limit`)   그만큼 주고 **더 있는지 말한다**(`hasMore`)
+ *   통째로 달라고 했는데 크면    **거절하고 나눠 받으라고 말한다**
+ *   통째로 달라고 했는데 작으면   그냥 준다 — 대부분의 현장이 여기다
+ *
+ * 그래서 작은 공장은 지금 그대로 돌고, 큰 공장은 **틀린 답 대신 오류**를 받는다.
+ *
+ * ── 왜 이름으로 이어 받나 ──────────────────────────────────────────────────
+ * `offset` 은 규모에서 못 쓴다 — 뒤로 갈수록 건너뛴 만큼을 매번 다시 읽는다. 이 축들은 이미 이름으로
+ * 정렬해 내므로(`order: { name: 'ASC' }`), **마지막 이름 다음부터** 읽으면 건너뛸 것이 없다.
+ *
+ * 이름이 유일하다는 것에 기댄다. 도메인 안에서 마스터 이름은 유일하다(그 이름으로 실적·사실이 자원을
+ * 가리킨다 — 유일하지 않으면 그것부터 깨진다).
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * 한 번에 낼 수 있는 **최대**. 이보다 크게 달라고 해도 이만큼만 낸다.
+ *
+ * ⚠ **이것은 안전장치이지 권하는 쪽 크기가 아니다.** 받는 쪽이 이 수에 붙여 두면, 우리가 한도를
+ * 내리는 날 그쪽은 **그날부터** 못 읽는다. 권하는 크기는 `SUGGESTED_PAGE` 다.
+ *
+ * 인티그레이션이 붙이면서 스스로 이 구별을 하고 2,000 을 골랐다(2026-09-05) — 「그 수는 거절하는
+ * 자리이지 권하는 크기가 아니다」. 맞는 판단이고, 여기 적혀 있지 않아서 스스로 알아낸 것이라 적는다.
+ */
+export declare const MAX_PAGE = 5000;
+/**
+ * 권하는 쪽 크기.
+ *
+ * [재봤음] 품목 100만이 전량 49MB 였으니 2,000이면 한 쪽이 100KB 안팎이다. 한 쪽에 1.4ms 이고
+ * 이어받기는 0.1ms 라, 쪽을 더 키워 얻을 것이 없다.
+ */
+export declare const SUGGESTED_PAGE = 2000;
+/** `limit` 을 안 주고 나눠 받지도 않을 때, 통째로 내주는 한도. 넘으면 거절한다. */
+export declare const WHOLE_LIMIT = 5000;
+/** 나눠 달라고 했는데 몇 개인지는 안 말했을 때. */
+export declare const DEFAULT_PAGE = 1000;
+export interface PageRequest {
+    /** 이 이름 **다음부터**. 앞 페이지의 `next` 를 그대로 준다. */
+    after?: string;
+    /** 몇 개까지. 없으면 통째로 달라는 뜻이다. */
+    limit?: number;
+}
+/**
+ * 실제로 몇 개를 읽을 것인가.
+ *
+ * **하나를 더 읽는다.** 더 있는지 알려면 세거나(`COUNT`) 한 개 더 읽어야 하는데, 세는 것은 같은 조건을
+ * 두 번 훑는 것이라 규모에서 두 배가 된다.
+ */
+export declare function takeFor(request: PageRequest): number;
+export interface Page<T> {
+    rows: T[];
+    /** 더 있나. **이 값을 안 보고 쓰면 조용히 잘린 자료를 쓰게 된다.** */
+    hasMore: boolean;
+    /** 이어 받을 자리 — 다음 요청의 `after`. 더 없으면 없다. */
+    next?: string;
+}
+/**
+ * 하나 더 읽어 온 결과를 페이지로 만든다.
+ *
+ * `nameOf` 를 받는 이유: 축마다 이름 칸이 다르다(`name` · `operationKey` …). 그 차이를 여기서 알아보려
+ * 하면 축이 늘 때마다 이 함수를 고쳐야 한다.
+ */
+export declare function pageOf<T>(read: readonly T[], request: PageRequest, nameOf: (row: T) => string): Page<T>;
+/**
+ * **통째로 달라고 했는데 너무 크다** — 낼 수 없는 이유를 사람 말로.
+ *
+ * 자르지 않는다. 자르면 받는 쪽은 그것이 전부인 줄 안다.
+ */
+export declare function tooLargeToPull(axis: string, request: PageRequest, page: Page<unknown>): string | undefined;

package/dist-server/service/master-page.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * **마스터를 나눠 내는 규칙** — 순수 판단.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 무엇이 문제였나 ────────────────────────────────────────────────────────
+ * 트윈이 당겨 가는 마스터 조회 여덟 축이 **전부 전량 조회**였다. 도메인 조건 하나만 걸고 그 축의 모든
+ * 행을 읽어 JSON 한 덩어리로 낸다.
+ *
+ * 재봤다: 품목 100만에서 **2,219ms · 49MB**. 지금 미라텍은 자재 106개라 안 아프지만, 이 제품의 규모
+ * 기준은 엔티티 10만 · 품목 100만이다. 그 규모에서 이 조회는 서지 않는다.
+ *
+ * ── 왜 「조용히 자르기」가 아니라 「거절」인가 ──────────────────────────────
+ * 한계를 두고 **말없이 앞부분만 주는 것이 제일 나쁘다.** 받는 쪽은 그것이 전부인 줄 알고 트윈을
+ * 세우고, 없는 설비·없는 품목이 화면에서 그냥 **존재하지 않게** 된다. 오류가 안 난다.
+ *
+ * 오늘 하루 종일 잡은 부류가 그것이라, 여기서는 그렇게 하지 않는다.
+ *
+ *   나눠 달라고 하면(`limit`)   그만큼 주고 **더 있는지 말한다**(`hasMore`)
+ *   통째로 달라고 했는데 크면    **거절하고 나눠 받으라고 말한다**
+ *   통째로 달라고 했는데 작으면   그냥 준다 — 대부분의 현장이 여기다
+ *
+ * 그래서 작은 공장은 지금 그대로 돌고, 큰 공장은 **틀린 답 대신 오류**를 받는다.
+ *
+ * ── 왜 이름으로 이어 받나 ──────────────────────────────────────────────────
+ * `offset` 은 규모에서 못 쓴다 — 뒤로 갈수록 건너뛴 만큼을 매번 다시 읽는다. 이 축들은 이미 이름으로
+ * 정렬해 내므로(`order: { name: 'ASC' }`), **마지막 이름 다음부터** 읽으면 건너뛸 것이 없다.
+ *
+ * 이름이 유일하다는 것에 기댄다. 도메인 안에서 마스터 이름은 유일하다(그 이름으로 실적·사실이 자원을
+ * 가리킨다 — 유일하지 않으면 그것부터 깨진다).
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PAGE = exports.WHOLE_LIMIT = exports.SUGGESTED_PAGE = exports.MAX_PAGE = void 0;
+exports.takeFor = takeFor;
+exports.pageOf = pageOf;
+exports.tooLargeToPull = tooLargeToPull;
+/**
+ * 한 번에 낼 수 있는 **최대**. 이보다 크게 달라고 해도 이만큼만 낸다.
+ *
+ * ⚠ **이것은 안전장치이지 권하는 쪽 크기가 아니다.** 받는 쪽이 이 수에 붙여 두면, 우리가 한도를
+ * 내리는 날 그쪽은 **그날부터** 못 읽는다. 권하는 크기는 `SUGGESTED_PAGE` 다.
+ *
+ * 인티그레이션이 붙이면서 스스로 이 구별을 하고 2,000 을 골랐다(2026-09-05) — 「그 수는 거절하는
+ * 자리이지 권하는 크기가 아니다」. 맞는 판단이고, 여기 적혀 있지 않아서 스스로 알아낸 것이라 적는다.
+ */
+exports.MAX_PAGE = 5_000;
+/**
+ * 권하는 쪽 크기.
+ *
+ * [재봤음] 품목 100만이 전량 49MB 였으니 2,000이면 한 쪽이 100KB 안팎이다. 한 쪽에 1.4ms 이고
+ * 이어받기는 0.1ms 라, 쪽을 더 키워 얻을 것이 없다.
+ */
+exports.SUGGESTED_PAGE = 2_000;
+/** `limit` 을 안 주고 나눠 받지도 않을 때, 통째로 내주는 한도. 넘으면 거절한다. */
+exports.WHOLE_LIMIT = 5_000;
+/** 나눠 달라고 했는데 몇 개인지는 안 말했을 때. */
+exports.DEFAULT_PAGE = 1_000;
+/**
+ * 실제로 몇 개를 읽을 것인가.
+ *
+ * **하나를 더 읽는다.** 더 있는지 알려면 세거나(`COUNT`) 한 개 더 읽어야 하는데, 세는 것은 같은 조건을
+ * 두 번 훑는 것이라 규모에서 두 배가 된다.
+ */
+function takeFor(request) {
+    if (request.limit === undefined) {
+        /* 통째로 달라는 요청이다. 한도를 넘는지 보려면 한도+1 을 읽어 봐야 한다. */
+        return exports.WHOLE_LIMIT + 1;
+    }
+    /* 0 이나 음수를 「전부」로 읽지 않는다 — 그렇게 읽으면 실수 하나가 전량 조회가 된다. */
+    const asked = Math.floor(request.limit);
+    const bounded = Number.isFinite(asked) ? Math.min(Math.max(asked, 1), exports.MAX_PAGE) : exports.DEFAULT_PAGE;
+    return bounded + 1;
+}
+/**
+ * 하나 더 읽어 온 결과를 페이지로 만든다.
+ *
+ * `nameOf` 를 받는 이유: 축마다 이름 칸이 다르다(`name` · `operationKey` …). 그 차이를 여기서 알아보려
+ * 하면 축이 늘 때마다 이 함수를 고쳐야 한다.
+ */
+function pageOf(read, request, nameOf) {
+    const size = takeFor(request) - 1;
+    const hasMore = read.length > size;
+    const rows = hasMore ? read.slice(0, size) : [...read];
+    return {
+        rows,
+        hasMore,
+        ...(hasMore && rows.length ? { next: nameOf(rows[rows.length - 1]) } : {})
+    };
+}
+/**
+ * **통째로 달라고 했는데 너무 크다** — 낼 수 없는 이유를 사람 말로.
+ *
+ * 자르지 않는다. 자르면 받는 쪽은 그것이 전부인 줄 안다.
+ */
+function tooLargeToPull(axis, request, page) {
+    if (request.limit !== undefined || !page.hasMore) {
+        return undefined;
+    }
+    return (`${axis} 축이 한 번에 낼 수 있는 ${exports.WHOLE_LIMIT}건을 넘습니다. ` +
+        `limit 과 after 로 나눠 받으십시오 — ${exports.SUGGESTED_PAGE}건쯤이 알맞고(최대 ${exports.MAX_PAGE}건), ` +
+        '응답의 hasMore 가 거짓이 될 때까지 next 를 after 로 넘기면 됩니다.');
+}
+//# sourceMappingURL=master-page.js.map

package/dist-server/service/master-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-page.js","sourceRoot":"","sources":["../../server/service/master-page.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;AAwCH,0BAWC;AAgBD,wBAUC;AAOD,wCAUC;AA5FD;;;;;;;;GAQG;AACU,QAAA,QAAQ,GAAG,KAAK,CAAA;AAE7B;;;;;GAKG;AACU,QAAA,cAAc,GAAG,KAAK,CAAA;AAEnC,wDAAwD;AAC3C,QAAA,WAAW,GAAG,KAAK,CAAA;AAEhC,iCAAiC;AACpB,QAAA,YAAY,GAAG,KAAK,CAAA;AASjC;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,OAAoB;IAC1C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,gDAAgD;QAChD,OAAO,mBAAW,GAAG,CAAC,CAAA;IACxB,CAAC;IAED,uDAAuD;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,gBAAQ,CAAC,CAAC,CAAC,CAAC,oBAAY,CAAA;IAE9F,OAAO,OAAO,GAAG,CAAC,CAAA;AACpB,CAAC;AAUD;;;;;GAKG;AACH,SAAgB,MAAM,CAAI,IAAkB,EAAE,OAAoB,EAAE,MAA0B;IAC5F,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAEtD,OAAO;QACL,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,IAAY,EAAE,OAAoB,EAAE,IAAmB;IACpF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO,CACL,GAAG,IAAI,mBAAmB,mBAAW,WAAW;QAChD,8BAA8B,sBAAc,cAAc,gBAAQ,MAAM;QACxE,iDAAiD,CAClD,CAAA;AACH,CAAC","sourcesContent":["/**\n * **마스터를 나눠 내는 규칙** — 순수 판단.\n *\n * ═══════════════════════════════════════════════════════════════════════════\n * ── 무엇이 문제였나 ────────────────────────────────────────────────────────\n * 트윈이 당겨 가는 마스터 조회 여덟 축이 **전부 전량 조회**였다. 도메인 조건 하나만 걸고 그 축의 모든\n * 행을 읽어 JSON 한 덩어리로 낸다.\n *\n * 재봤다: 품목 100만에서 **2,219ms · 49MB**. 지금 미라텍은 자재 106개라 안 아프지만, 이 제품의 규모\n * 기준은 엔티티 10만 · 품목 100만이다. 그 규모에서 이 조회는 서지 않는다.\n *\n * ── 왜 「조용히 자르기」가 아니라 「거절」인가 ──────────────────────────────\n * 한계를 두고 **말없이 앞부분만 주는 것이 제일 나쁘다.** 받는 쪽은 그것이 전부인 줄 알고 트윈을\n * 세우고, 없는 설비·없는 품목이 화면에서 그냥 **존재하지 않게** 된다. 오류가 안 난다.\n *\n * 오늘 하루 종일 잡은 부류가 그것이라, 여기서는 그렇게 하지 않는다.\n *\n *   나눠 달라고 하면(`limit`)   그만큼 주고 **더 있는지 말한다**(`hasMore`)\n *   통째로 달라고 했는데 크면    **거절하고 나눠 받으라고 말한다**\n *   통째로 달라고 했는데 작으면   그냥 준다 — 대부분의 현장이 여기다\n *\n * 그래서 작은 공장은 지금 그대로 돌고, 큰 공장은 **틀린 답 대신 오류**를 받는다.\n *\n * ── 왜 이름으로 이어 받나 ──────────────────────────────────────────────────\n * `offset` 은 규모에서 못 쓴다 — 뒤로 갈수록 건너뛴 만큼을 매번 다시 읽는다. 이 축들은 이미 이름으로\n * 정렬해 내므로(`order: { name: 'ASC' }`), **마지막 이름 다음부터** 읽으면 건너뛸 것이 없다.\n *\n * 이름이 유일하다는 것에 기댄다. 도메인 안에서 마스터 이름은 유일하다(그 이름으로 실적·사실이 자원을\n * 가리킨다 — 유일하지 않으면 그것부터 깨진다).\n * ═══════════════════════════════════════════════════════════════════════════\n */\n\n/**\n * 한 번에 낼 수 있는 **최대**. 이보다 크게 달라고 해도 이만큼만 낸다.\n *\n * ⚠ **이것은 안전장치이지 권하는 쪽 크기가 아니다.** 받는 쪽이 이 수에 붙여 두면, 우리가 한도를\n * 내리는 날 그쪽은 **그날부터** 못 읽는다. 권하는 크기는 `SUGGESTED_PAGE` 다.\n *\n * 인티그레이션이 붙이면서 스스로 이 구별을 하고 2,000 을 골랐다(2026-09-05) — 「그 수는 거절하는\n * 자리이지 권하는 크기가 아니다」. 맞는 판단이고, 여기 적혀 있지 않아서 스스로 알아낸 것이라 적는다.\n */\nexport const MAX_PAGE = 5_000\n\n/**\n * 권하는 쪽 크기.\n *\n * [재봤음] 품목 100만이 전량 49MB 였으니 2,000이면 한 쪽이 100KB 안팎이다. 한 쪽에 1.4ms 이고\n * 이어받기는 0.1ms 라, 쪽을 더 키워 얻을 것이 없다.\n */\nexport const SUGGESTED_PAGE = 2_000\n\n/** `limit` 을 안 주고 나눠 받지도 않을 때, 통째로 내주는 한도. 넘으면 거절한다. */\nexport const WHOLE_LIMIT = 5_000\n\n/** 나눠 달라고 했는데 몇 개인지는 안 말했을 때. */\nexport const DEFAULT_PAGE = 1_000\n\nexport interface PageRequest {\n  /** 이 이름 **다음부터**. 앞 페이지의 `next` 를 그대로 준다. */\n  after?: string\n  /** 몇 개까지. 없으면 통째로 달라는 뜻이다. */\n  limit?: number\n}\n\n/**\n * 실제로 몇 개를 읽을 것인가.\n *\n * **하나를 더 읽는다.** 더 있는지 알려면 세거나(`COUNT`) 한 개 더 읽어야 하는데, 세는 것은 같은 조건을\n * 두 번 훑는 것이라 규모에서 두 배가 된다.\n */\nexport function takeFor(request: PageRequest): number {\n  if (request.limit === undefined) {\n    /* 통째로 달라는 요청이다. 한도를 넘는지 보려면 한도+1 을 읽어 봐야 한다. */\n    return WHOLE_LIMIT + 1\n  }\n\n  /* 0 이나 음수를 「전부」로 읽지 않는다 — 그렇게 읽으면 실수 하나가 전량 조회가 된다. */\n  const asked = Math.floor(request.limit)\n  const bounded = Number.isFinite(asked) ? Math.min(Math.max(asked, 1), MAX_PAGE) : DEFAULT_PAGE\n\n  return bounded + 1\n}\n\nexport interface Page<T> {\n  rows: T[]\n  /** 더 있나. **이 값을 안 보고 쓰면 조용히 잘린 자료를 쓰게 된다.** */\n  hasMore: boolean\n  /** 이어 받을 자리 — 다음 요청의 `after`. 더 없으면 없다. */\n  next?: string\n}\n\n/**\n * 하나 더 읽어 온 결과를 페이지로 만든다.\n *\n * `nameOf` 를 받는 이유: 축마다 이름 칸이 다르다(`name` · `operationKey` …). 그 차이를 여기서 알아보려\n * 하면 축이 늘 때마다 이 함수를 고쳐야 한다.\n */\nexport function pageOf<T>(read: readonly T[], request: PageRequest, nameOf: (row: T) => string): Page<T> {\n  const size = takeFor(request) - 1\n  const hasMore = read.length > size\n  const rows = hasMore ? read.slice(0, size) : [...read]\n\n  return {\n    rows,\n    hasMore,\n    ...(hasMore && rows.length ? { next: nameOf(rows[rows.length - 1]) } : {})\n  }\n}\n\n/**\n * **통째로 달라고 했는데 너무 크다** — 낼 수 없는 이유를 사람 말로.\n *\n * 자르지 않는다. 자르면 받는 쪽은 그것이 전부인 줄 안다.\n */\nexport function tooLargeToPull(axis: string, request: PageRequest, page: Page<unknown>): string | undefined {\n  if (request.limit !== undefined || !page.hasMore) {\n    return undefined\n  }\n\n  return (\n    `${axis} 축이 한 번에 낼 수 있는 ${WHOLE_LIMIT}건을 넘습니다. ` +\n    `limit 과 after 로 나눠 받으십시오 — ${SUGGESTED_PAGE}건쯤이 알맞고(최대 ${MAX_PAGE}건), ` +\n    '응답의 hasMore 가 거짓이 될 때까지 next 를 after 로 넘기면 됩니다.'\n  )\n}\n"]}

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

@@ -0,0 +1,7 @@
+import { MaterialClass } from './material-class';
+import { MaterialDefinition } from './material-definition';
+import { MaterialQuery } from './material-query';
+import { MaterialClassResolver, MaterialDefinitionResolver } from './material-master-resolver';
+import { MaterialDefinitionRevisionResolver } from './material-revision-resolver';
+export declare const entities: (typeof MaterialClass | typeof MaterialDefinition | typeof import("./material-revision").MaterialDefinitionRevision | typeof import("./material-revision").MaterialDefinitionPlan | typeof import("./material-revision").MaterialDefinitionSegment | typeof import("./material-revision").MaterialDefinitionBasis)[];
+export declare const resolvers: (typeof MaterialClassResolver | typeof MaterialDefinitionResolver | typeof MaterialDefinitionRevisionResolver | typeof MaterialQuery)[];

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvers = exports.entities = void 0;
+const material_class_1 = require("./material-class");
+const material_definition_1 = require("./material-definition");
+const material_query_1 = require("./material-query");
+const material_master_resolver_1 = require("./material-master-resolver");
+const material_revision_1 = require("./material-revision");
+const material_revision_resolver_1 = require("./material-revision-resolver");
+exports.entities = [material_class_1.MaterialClass, material_definition_1.MaterialDefinition, ...material_revision_1.MATERIAL_REVISION_ENTITIES];
+exports.resolvers = [material_query_1.MaterialQuery, material_master_resolver_1.MaterialClassResolver, material_master_resolver_1.MaterialDefinitionResolver, material_revision_resolver_1.MaterialDefinitionRevisionResolver];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/material/index.ts"],"names":[],"mappings":";;;AAAA,qDAAgD;AAChD,+DAA0D;AAC1D,qDAAgD;AAChD,yEAA8F;AAC9F,2DAAgE;AAChE,6EAAiF;AAEpE,QAAA,QAAQ,GAAG,CAAC,8BAAa,EAAE,wCAAkB,EAAE,GAAG,8CAA0B,CAAC,CAAA;AAC7E,QAAA,SAAS,GAAG,CAAC,8BAAa,EAAE,gDAAqB,EAAE,qDAA0B,EAAE,+DAAkC,CAAC,CAAA","sourcesContent":["import { MaterialClass } from './material-class'\nimport { MaterialDefinition } from './material-definition'\nimport { MaterialQuery } from './material-query'\nimport { MaterialClassResolver, MaterialDefinitionResolver } from './material-master-resolver'\nimport { MATERIAL_REVISION_ENTITIES } from './material-revision'\nimport { MaterialDefinitionRevisionResolver } from './material-revision-resolver'\n\nexport const entities = [MaterialClass, MaterialDefinition, ...MATERIAL_REVISION_ENTITIES]\nexport const resolvers = [MaterialQuery, MaterialClassResolver, MaterialDefinitionResolver, MaterialDefinitionRevisionResolver]\n"]}

package/dist-server/service/material/material-axis-status.d.ts

@@ -0,0 +1,8 @@
+import { EntityManager } from 'typeorm';
+/** Future activation changes the stamp without rewriting identity rows or running a midnight job. */
+export declare function materialAxisStatus(manager: EntityManager, domainId: string, at?: Date): Promise<{
+    changedAt?: Date;
+    axis: string;
+    count: number;
+    stamp: string;
+}>;

package/dist-server/service/material/material-axis-status.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.materialAxisStatus = materialAxisStatus;
+const material_definition_1 = require("./material-definition");
+const material_revision_1 = require("./material-revision");
+/** Future activation changes the stamp without rewriting identity rows or running a midnight job. */
+async function materialAxisStatus(manager, domainId, at = new Date()) {
+    const row = await manager.createQueryBuilder(material_definition_1.MaterialDefinition, 'm')
+        .leftJoin(material_revision_1.MaterialDefinitionPlan, 'p', 'p.material_id = m.id AND p.domain_id = m.domain_id AND p.generation = m.plan_generation')
+        .leftJoin(material_revision_1.MaterialDefinitionSegment, 's', 's.plan_id = p.id AND s.validFrom <= :at AND (s.validTo IS NULL OR s.validTo > :at)', { at })
+        .leftJoin(material_revision_1.MaterialDefinitionRevision, 'r', 'r.id = s.revision_id')
+        .select('COUNT(r.id)', 'count').addSelect('SUM(r.revisionNumber)', 'revisionSum')
+        .addSelect('SUM(m.planGeneration)', 'generationSum').addSelect('MAX(p.recordedAt)', 'changedAt')
+        .where('m.domain_id = :domainId', { domainId }).getRawOne();
+    return { axis: 'materialDefinitions', count: Number(row.count),
+        stamp: JSON.stringify([row.count, row.revisionSum, row.generationSum, row.changedAt]),
+        ...(row.changedAt ? { changedAt: new Date(row.changedAt) } : {}) };
+}
+//# sourceMappingURL=material-axis-status.js.map

package/dist-server/service/material/material-axis-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-axis-status.js","sourceRoot":"","sources":["../../../server/service/material/material-axis-status.ts"],"names":[],"mappings":";;AAKA,gDAWC;AAfD,+DAA0D;AAC1D,2DAAmH;AAEnH,qGAAqG;AAC9F,KAAK,UAAU,kBAAkB,CAAC,OAAsB,EAAE,QAAgB,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE;IAChG,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,wCAAkB,EAAE,GAAG,CAAC;SAClE,QAAQ,CAAC,0CAAsB,EAAE,GAAG,EAAE,yFAAyF,CAAC;SAChI,QAAQ,CAAC,6CAAyB,EAAE,GAAG,EAAE,oFAAoF,EAAE,EAAE,EAAE,EAAE,CAAC;SACtI,QAAQ,CAAC,8CAA0B,EAAE,GAAG,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,uBAAuB,EAAE,aAAa,CAAC;SAChF,SAAS,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC,SAAS,CAAC,mBAAmB,EAAE,WAAW,CAAC;SAC/F,KAAK,CAAC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,CAAA;IAC7D,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QAC5D,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACrF,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AACtE,CAAC","sourcesContent":["import { EntityManager } from 'typeorm'\nimport { MaterialDefinition } from './material-definition'\nimport { MaterialDefinitionPlan, MaterialDefinitionRevision, MaterialDefinitionSegment } from './material-revision'\n\n/** Future activation changes the stamp without rewriting identity rows or running a midnight job. */\nexport async function materialAxisStatus(manager: EntityManager, domainId: string, at = new Date()) {\n  const row = await manager.createQueryBuilder(MaterialDefinition, 'm')\n    .leftJoin(MaterialDefinitionPlan, 'p', 'p.material_id = m.id AND p.domain_id = m.domain_id AND p.generation = m.plan_generation')\n    .leftJoin(MaterialDefinitionSegment, 's', 's.plan_id = p.id AND s.validFrom <= :at AND (s.validTo IS NULL OR s.validTo > :at)', { at })\n    .leftJoin(MaterialDefinitionRevision, 'r', 'r.id = s.revision_id')\n    .select('COUNT(r.id)', 'count').addSelect('SUM(r.revisionNumber)', 'revisionSum')\n    .addSelect('SUM(m.planGeneration)', 'generationSum').addSelect('MAX(p.recordedAt)', 'changedAt')\n    .where('m.domain_id = :domainId', { domainId }).getRawOne()\n  return { axis: 'materialDefinitions', count: Number(row.count),\n    stamp: JSON.stringify([row.count, row.revisionSum, row.generationSum, row.changedAt]),\n    ...(row.changedAt ? { changedAt: new Date(row.changedAt) } : {}) }\n}\n"]}

package/dist-server/service/material/material-class.d.ts

@@ -0,0 +1,34 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/**
+ * 품목 등급 — **ISA-95 `MaterialClass`**.
+ *
+ * 「원자재」·「완제품」처럼 품목을 묶는 상위 개념이다. 레시피가 특정 품번 대신 등급으로 투입을 적을 수 있고,
+ * 화면이 재고를 그 단위로 모은다.
+ *
+ * 구조는 인원 등급 · 설비 등급과 같다(표준이 넷을 같은 모양으로 정의한다).
+ */
+export declare class MaterialClass {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** 표준 `MaterialClassID`. */
+    name: string;
+    description?: string;
+    /** 상위 등급들 — 표준 `MaterialClassBaseID`(복수). 「6축 용접기」가 「용접기」를 상속한다. */
+    baseIds?: string[];
+    /** 이 등급의 적격을 정하는 `TestSpecification` 참조들 — 표준 `TestSpecificationID`. */
+    testSpecificationIds?: string[];
+    /** 등급 속성 — 표준 `MaterialClassProperty`. */
+    properties?: Record<string, unknown>[];
+    /** 언제부터 유효한가 — 표준 `EffectiveStartDate`. */
+    effectiveStart?: Date;
+    /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. */
+    effectiveEnd?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}

package/dist-server/service/material/material-class.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaterialClass = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+/**
+ * 품목 등급 — **ISA-95 `MaterialClass`**.
+ *
+ * 「원자재」·「완제품」처럼 품목을 묶는 상위 개념이다. 레시피가 특정 품번 대신 등급으로 투입을 적을 수 있고,
+ * 화면이 재고를 그 단위로 모은다.
+ *
+ * 구조는 인원 등급 · 설비 등급과 같다(표준이 넷을 같은 모양으로 정의한다).
+ */
+let MaterialClass = class MaterialClass {
+};
+exports.MaterialClass = MaterialClass;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], MaterialClass.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], MaterialClass.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((klass) => klass.domain),
+    tslib_1.__metadata("design:type", String)
+], MaterialClass.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MaterialClass.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], MaterialClass.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
+    tslib_1.__metadata("design:type", Array)
+], MaterialClass.prototype, "baseIds", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
+    tslib_1.__metadata("design:type", Array)
+], MaterialClass.prototype, "testSpecificationIds", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'ResourceProperty[]' }),
+    tslib_1.__metadata("design:type", Array)
+], MaterialClass.prototype, "properties", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date
+    /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. */
+    )
+], MaterialClass.prototype, "effectiveStart", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], MaterialClass.prototype, "effectiveEnd", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], MaterialClass.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], MaterialClass.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], MaterialClass.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((klass) => klass.creator),
+    tslib_1.__metadata("design:type", String)
+], MaterialClass.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], MaterialClass.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((klass) => klass.updater),
+    tslib_1.__metadata("design:type", String)
+], MaterialClass.prototype, "updaterId", void 0);
+exports.MaterialClass = MaterialClass = tslib_1.__decorate([
+    (0, typeorm_1.Entity)({ name: 'ops_material_class' }),
+    (0, typeorm_1.Index)('ix_ops_material_class_0', (klass) => [klass.domain, klass.name], { unique: true }),
+    (0, type_graphql_1.ObjectType)({ description: 'ISA-95 MaterialClass — a grouping of material definitions' })
+], MaterialClass);
+//# sourceMappingURL=material-class.js.map

package/dist-server/service/material/material-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-class.js","sourceRoot":"","sources":["../../../server/service/material/material-class.ts"],"names":[],"mappings":";;;;AAAA,qCASgB;AAChB,+CAAoD;AAEpD,iDAA4D;AAC5D,yDAAgD;AAEhD;;;;;;;GAOG;AAII,IAAM,aAAa,GAAnB,MAAM,aAAa;CAmEzB,CAAA;AAnEY,sCAAa;AAGf;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,CAAC;;yCACC;AAInB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;sCACb,cAAM;6CAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;;+CAClC;AAKjB;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,GAAE;;2CACI;AAIZ;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACN;AAKpB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CAC1B;AAKlB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2DACb;AAK/B;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;;iDAC7C;AAKtC;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACT,IAAI;IAErB,yCAAyC;;qDAFpB;AAKrB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACX,IAAI;mDAAA;AAInB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;gDAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;gDAAA;AAIhB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCAC9B,gBAAI;8CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;;gDAClC;AAIlB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCAC9B,gBAAI;8CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;;gDAClC;wBAlEP,aAAa;IAHzB,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;IACtC,IAAA,eAAK,EAAC,yBAAyB,EAAE,CAAC,KAAoB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACxG,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,2DAA2D,EAAE,CAAC;GAC5E,aAAa,CAmEzB","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/**\n * 품목 등급 — **ISA-95 `MaterialClass`**.\n *\n * 「원자재」·「완제품」처럼 품목을 묶는 상위 개념이다. 레시피가 특정 품번 대신 등급으로 투입을 적을 수 있고,\n * 화면이 재고를 그 단위로 모은다.\n *\n * 구조는 인원 등급 · 설비 등급과 같다(표준이 넷을 같은 모양으로 정의한다).\n */\n@Entity({ name: 'ops_material_class' })\n@Index('ix_ops_material_class_0', (klass: MaterialClass) => [klass.domain, klass.name], { unique: true })\n@ObjectType({ description: 'ISA-95 MaterialClass — a grouping of material definitions' })\nexport class MaterialClass {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain)\n  domain?: Domain\n\n  @RelationId((klass: MaterialClass) => klass.domain)\n  domainId?: string\n\n  /** 표준 `MaterialClassID`. */\n  @Column()\n  @Field()\n  name: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  description?: string\n\n  /** 상위 등급들 — 표준 `MaterialClassBaseID`(복수). 「6축 용접기」가 「용접기」를 상속한다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  baseIds?: string[]\n\n  /** 이 등급의 적격을 정하는 `TestSpecification` 참조들 — 표준 `TestSpecificationID`. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  testSpecificationIds?: string[]\n\n  /** 등급 속성 — 표준 `MaterialClassProperty`. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'ResourceProperty[]' })\n  properties?: Record<string, unknown>[]\n\n  /** 언제부터 유효한가 — 표준 `EffectiveStartDate`. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveStart?: Date\n\n  /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveEnd?: Date\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  creator?: User\n\n  @RelationId((klass: MaterialClass) => klass.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  updater?: User\n\n  @RelationId((klass: MaterialClass) => klass.updater)\n  updaterId?: string\n}\n"]}

package/dist-server/service/material/material-definition.d.ts

@@ -0,0 +1,45 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/**
+ * 품목 정의 — **ISA-95 `MaterialDefinition`**.
+ *
+ * 식별자는 **GTIN** 이다(`urn:epc:idpat:sgtin:…`). 정체성의 기준이 EPCIS 이기 때문이고, 사건과 마스터가
+ * 같은 이름을 써야 「이 로트가 무엇인가」를 이을 수 있다.
+ *
+ * GTIN 이 아직 없는 품목은 비워 두지 않고 사내 코드를 `name` 에 적되, **회사 프리픽스를 지어내
+ * GTIN 을 만들지 않는다.** 지어낸 식별자는 나중에 진짜 코드가 왔을 때 두 개가 된다.
+ */
+export declare class MaterialDefinition {
+    revisionNumber?: number;
+    planGeneration: number;
+    revisionLock: number;
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** 표준 `ID` — GTIN 이 있으면 GTIN 이다. 트윈으로 나갈 때 `materialDefinitions[].id` 가 된다. */
+    name: string;
+    description?: string;
+    /** 속한 등급들 — 표준 `MaterialClassID`(복수). */
+    materialClassIds?: string[];
+    /**
+     * 품목 속성 — 표준 `MaterialDefinitionProperty`. **환산 계수가 여기 들어간다.**
+     *
+     * 계약이 정한 이름은 `perBaseUnit` 이고, 값은 기준 단위 하나당 그 단위의 양이다.
+     * 한 개(EA)가 2.5 kg 이면 `{ id: 'perBaseUnit', value: 2.5, uom: 'KGM' }`.
+     */
+    properties?: Record<string, unknown>[];
+    /** 적격을 검증하는 `TestSpecification` 참조들 — 입고 검사가 이 모양에 맞는다. */
+    testSpecificationIds?: string[];
+    /** `TestResult` — 참조만 있으면 「무엇으로 검증한다」까지고, 결과가 있어야 적격이 성립한다. */
+    testResults?: Record<string, unknown>[];
+    /** 언제부터 이 품목을 쓰나 — 표준 `EffectiveStartDate`. 단종 예정 품목을 미리 적을 수 있다. */
+    effectiveStart?: Date;
+    /** 언제까지 — 표준 `EffectiveEndDate`. */
+    effectiveEnd?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}