@things-factory/ops-master 10.1.248 → 10.1.250

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

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * 마스터가 **말이 되나** — 축을 가로질러 한 번에 본다.
+ *
+ * ── 왜 필요한가 ────────────────────────────────────────────────────────────
+ * 축마다 화면이 있고 축마다 값이 차 있는데, 그 사이가 이어지는지는 아무도 안 봤다. 설비 등급 다섯이
+ * 서 있고 설비 스물둘이 어느 등급에도 안 들어 있던 일이 그랬다 — 두 화면 다 멀쩡해 보였다.
+ * 카메라 자산 다섯이 ECU 등급에 들어 있던 것도, 정지 사유 고르기가 빈 목록으로 보이던 것도 같다.
+ *
+ * 사람이 열두 화면을 오가며 맞춰 보는 것으로는 안 된다. 맞춰 보지 않으면 아무도 모르고, 맞춰 봤는지
+ * 아닌지도 남지 않는다.
+ *
+ * ── 두 가지만 본다 ─────────────────────────────────────────────────────────
+ * **비어 있으면 안 되는 칸**과 **가리키는데 없는 것**이다. 둘 다 사실 판정이라 다툼이 없다.
+ * 「이 값이 옳은가」는 여기서 안 본다 — 그것은 현장이 정한다.
+ *
+ * ── 없는 것을 없다고 말한다 ────────────────────────────────────────────────
+ * 표가 통째로 비었으면 그것도 낸다. 「빠진 것 0건」과 「아직 아무것도 안 세웠다」는 다르고, 세지
+ * 않으면 둘이 같아 보인다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkMaster = checkMaster;
+exports.scannedCounts = scannedCounts;
+exports.summarize = summarize;
+exports.readMasterSnapshot = readMasterSnapshot;
+const nameSet = (rows) => new Set(rows.map(one => one.name).filter(Boolean));
+/** 값이 비었나 — 빈 문자열과 빈 배열도 빈 것으로 본다. */
+function blank(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    return String(value).trim() === '';
+}
+/** 이름 목록으로 만든다 — 한 개짜리 문자열도, 배열도 같게 다룬다. */
+function asList(value) {
+    if (blank(value)) {
+        return [];
+    }
+    return (Array.isArray(value) ? value : [value]).map(one => String(one).trim()).filter(Boolean);
+}
+/**
+ * 축 하나를 잰다.
+ *
+ * `required` 는 비어 있으면 안 되는 칸, `refs` 는 「이 칸의 값이 저 이름들 안에 있어야 한다」이다.
+ */
+function checkAxis(axis, rows, required, refs) {
+    const found = [];
+    if (rows.length === 0) {
+        /* 표가 통째로 비었다. 「빠진 것 0건」과 다르다. */
+        return [{ axis, kind: 'empty', field: axis }];
+    }
+    for (const row of rows) {
+        for (const field of required) {
+            if (blank(row[field])) {
+                found.push({ axis, subject: row.name, kind: 'missing', field });
+            }
+        }
+        for (const { field, within } of refs) {
+            for (const value of asList(row[field])) {
+                if (!within.has(value)) {
+                    found.push({ axis, subject: row.name, kind: 'dangling', field, value });
+                }
+            }
+        }
+    }
+    return found;
+}
+/** 아무도 안 가리키는 것들 — 세워 놓고 쓰지 않는 선언. */
+function checkUnused(axis, rows, pointedAt, field) {
+    return rows
+        .filter(one => one.name && !pointedAt.has(one.name))
+        .map(one => ({ axis, subject: one.name, kind: 'unused', field }));
+}
+/**
+ * 마스터 전체를 잰다.
+ *
+ * **순서에 뜻이 없다.** 어느 축부터 보든 같은 답이 나와야 하고, 그래야 이 결과를 두 번 재서
+ * 견줄 수 있다.
+ */
+function checkMaster(snapshot) {
+    const locations = nameSet(snapshot.operationalLocations);
+    const operations = nameSet(snapshot.operationDefinitions);
+    const routes = nameSet(snapshot.routeDefinitions);
+    const materials = nameSet(snapshot.materialDefinitions);
+    const specs = nameSet(snapshot.testSpecifications);
+    const personnelClasses = nameSet(snapshot.personnelClasses);
+    const equipmentClasses = nameSet(snapshot.equipmentClasses);
+    const assetClasses = nameSet(snapshot.physicalAssetClasses);
+    const materialClasses = nameSet(snapshot.materialClasses);
+    const stopReasons = nameSet(snapshot.stopReasons);
+    const found = [
+        ...checkAxis('person', snapshot.persons, ['personnelClassIds', 'homeLocation'], [
+            { field: 'personnelClassIds', within: personnelClasses },
+            { field: 'homeLocation', within: locations },
+            { field: 'testSpecificationIds', within: specs }
+        ]),
+        ...checkAxis('equipment', snapshot.equipment, ['kind', 'homeLocation', 'equipmentClassIds'], [
+            { field: 'equipmentClassIds', within: equipmentClasses },
+            { field: 'homeLocation', within: locations },
+            { field: 'testSpecificationIds', within: specs }
+        ]),
+        ...checkAxis('physicalAsset', snapshot.physicalAssets, ['assetClassIds'], [
+            { field: 'assetClassIds', within: assetClasses },
+            { field: 'homeLocation', within: locations },
+            { field: 'testSpecificationIds', within: specs }
+        ]),
+        ...checkAxis('materialDefinition', snapshot.materialDefinitions, ['materialClassIds'], [
+            { field: 'materialClassIds', within: materialClasses },
+            { field: 'testSpecificationIds', within: specs }
+        ]),
+        /*
+         * 공정의 `resourceType` 은 설비 **종류**를 가리키는 값이라 이름 집합이 없다. 여기서는
+         * 비었는지만 본다 — 없는 것을 있는 척 검사하지 않는다.
+         */
+        ...checkAxis('operationDefinition', snapshot.operationDefinitions, ['intent', 'locationType', 'duration'], []),
+        ...checkAxis('routeDefinition', snapshot.routeDefinitions, ['steps'], [
+            { field: 'steps', within: operations }
+        ]),
+        ...checkAxis('recipeDefinition', snapshot.recipeDefinitions, ['materialDefinitionName', 'route', 'inputs'], [
+            { field: 'materialDefinitionName', within: materials },
+            { field: 'route', within: routes }
+        ]),
+        ...checkAxis('operationalLocation', snapshot.operationalLocations, ['type', 'level'], [
+            { field: 'parentId', within: locations }
+        ]),
+        ...checkAxis('stopReason', snapshot.stopReasons, ['status'], [{ field: 'parentName', within: stopReasons }]),
+        ...checkAxis('testSpecification', snapshot.testSpecifications, ['criteria'], [])
+    ];
+    /*
+     * 제조법의 투입은 한 줄이 여럿을 가리킨다. 위의 검사는 칸 하나를 보므로 여기서 따로 본다.
+     */
+    for (const recipe of snapshot.recipeDefinitions) {
+        for (const part of recipe.inputs ?? []) {
+            if (part?.material && !materials.has(part.material)) {
+                found.push({ axis: 'recipeDefinition', subject: recipe.name, kind: 'dangling', field: 'inputs.material', value: part.material });
+            }
+            if (part?.operation && !operations.has(part.operation)) {
+                found.push({ axis: 'recipeDefinition', subject: recipe.name, kind: 'dangling', field: 'inputs.operation', value: part.operation });
+            }
+        }
+    }
+    /*
+     * ── 세워 놓고 아무도 안 든 등급 ─────────────────────────────────────────
+     *
+     * **상속을 타고 센다.** 등급은 등급을 상속하고(`baseIds`), 자격 판정도 그 사슬을 닫아서 본다
+     * (커널의 `classClosure`). 그러니 「아무도 안 든다」도 닫힌 소속으로 물어야 한다.
+     *
+     * 직접 소속만 세면 뿌리 등급이 늘 걸린다. 품목의 유형 등급(완제품 · 반제품 · 원재료)이 그렇다 —
+     * 품목은 성격 등급에 들고 그 등급이 유형을 상속하므로, 직접 소속은 언제나 0이다. 그것을 결함으로
+     * 읽으면 멀쩡한 등급을 지우러 간다.
+     *
+     * 처음에는 품목만 따로 다뤘고 나머지 셋은 직접 소속으로 셌다. 아키텍트 레인이 설비 등급에도
+     * 같은 축이 있다고 알려 주어 넷을 한 규칙으로 모았다 — 축마다 다르게 세면 한쪽만 고쳐지는 날이
+     * 온다. [재봤음] 2026-09-04
+     */
+    const classAxes = [
+        ['personnelClass', snapshot.personnelClasses, snapshot.persons, 'personnelClassIds'],
+        ['equipmentClass', snapshot.equipmentClasses, snapshot.equipment, 'equipmentClassIds'],
+        ['physicalAssetClass', snapshot.physicalAssetClasses, snapshot.physicalAssets, 'assetClassIds'],
+        ['materialClass', snapshot.materialClasses, snapshot.materialDefinitions, 'materialClassIds']
+    ];
+    for (const [axis, classes, members, field] of classAxes) {
+        found.push(...checkUnused(axis, classes, closedMembership(classes, members, field), 'members'));
+    }
+    /* 아무도 안 가리키는 라우팅·공정. 만들어 놓고 안 쓰는 것은 지워도 되는 것인지 사람이 판단한다. */
+    const routesUsed = new Set(snapshot.recipeDefinitions.map(one => one.route).filter(Boolean));
+    const operationsUsed = new Set([
+        ...snapshot.routeDefinitions.flatMap(one => asList(one.steps)),
+        ...snapshot.recipeDefinitions.flatMap(one => (one.inputs ?? []).map((part) => part?.operation).filter(Boolean))
+    ]);
+    found.push(...checkUnused('routeDefinition', snapshot.routeDefinitions, routesUsed, 'usedByRecipes'), ...checkUnused('operationDefinition', snapshot.operationDefinitions, operationsUsed, 'usedInRoutes'));
+    return found;
+}
+/**
+ * **닫힌 소속** — 소속이 상속을 타고 닿는 등급까지 모은다.
+ *
+ * 사람이 `welding-robot-6axis` 에 들고 그것이 `welding-equipment` 를 상속하면, 두 등급 다 「누가
+ * 들었다」로 센다. 자격 판정이 그 사슬을 닫아서 보므로(커널의 `classClosure`) 여기서도 같게 본다.
+ *
+ * **고리를 밟으면 멈춘다.** `baseIds` 는 화면에서 손으로 넣을 수 있어 A→B→A 가 생길 수 있다.
+ */
+function closedMembership(classes, members, field) {
+    const baseOf = new Map(classes.map(one => [one.name, asList(one.baseIds)]));
+    const reached = new Set();
+    const walk = (name) => {
+        if (!name || reached.has(name)) {
+            return;
+        }
+        reached.add(name);
+        for (const base of baseOf.get(name) ?? []) {
+            walk(base);
+        }
+    };
+    for (const row of members) {
+        for (const name of asList(row[field])) {
+            walk(name);
+        }
+    }
+    return reached;
+}
+/** 여러 줄이 가리키는 이름들을 모은다. */
+function collect(rows, field) {
+    return new Set(rows.flatMap(one => asList(one[field])));
+}
+/**
+ * **무엇을 몇 개 봤나.**
+ *
+ * 어긋남 0건이 「멀쩡하다」인지 「안 돌았다」인지는 이것으로만 갈린다. 본 수를 안 내면 두 답이
+ * 같은 글자로 나온다 — 검사기가 스스로를 못 믿게 만드는 가장 흔한 방식이다.
+ */
+function scannedCounts(snapshot) {
+    return Object.entries(snapshot)
+        .map(([axis, rows]) => ({ axis, rows: rows.length }))
+        .sort((a, b) => a.axis.localeCompare(b.axis));
+}
+/** 축·종류별로 몇 건인지. 사람이 먼저 볼 것을 고르는 데 쓴다. */
+function summarize(findings) {
+    const tally = new Map();
+    for (const one of findings) {
+        const key = `${one.axis}${one.kind}`;
+        tally.set(key, (tally.get(key) ?? 0) + 1);
+    }
+    return [...tally.entries()]
+        .map(([key, count]) => {
+        const [axis, kind] = key.split('');
+        return { axis, kind, count };
+    })
+        .sort((a, b) => b.count - a.count || a.axis.localeCompare(b.axis));
+}
+/**
+ * 한 도메인의 마스터를 통째로 읽어 잰다.
+ *
+ * **상한을 두지 않는다.** 정합성은 「전부 봤나」가 곧 답이라, 일부만 보고 「어긋남 0건」이라고 하면
+ * 그 답이 거짓이 된다. 그래서 이것은 목록 화면이 부르는 것이 아니라 **사람이 눌러서 도는 검사**다.
+ */
+async function readMasterSnapshot(domain, getRepository, entities) {
+    const all = async (Entity, select) => (await getRepository(Entity).find({
+        where: { domain: { id: domain.id } },
+        select: ['id', 'name', ...select]
+    }));
+    const [persons, equipment, physicalAssets, materialDefinitions, operationDefinitions, routeDefinitions, recipeDefinitions, operationalLocations, stopReasons, testSpecifications, personnelClasses, equipmentClasses, physicalAssetClasses, materialClasses] = await Promise.all([
+        all(entities.Person, ['personnelClassIds', 'homeLocation', 'testSpecificationIds']),
+        all(entities.Equipment, ['kind', 'homeLocation', 'equipmentClassIds', 'testSpecificationIds']),
+        all(entities.PhysicalAsset, ['assetClassIds', 'homeLocation', 'testSpecificationIds']),
+        all(entities.MaterialDefinition, ['materialClassIds', 'testSpecificationIds']),
+        all(entities.OperationDefinition, ['intent', 'locationType', 'resourceType', 'duration']),
+        all(entities.RouteDefinition, ['steps']),
+        all(entities.RecipeDefinition, ['materialDefinitionName', 'route', 'inputs']),
+        all(entities.OperationalLocation, ['type', 'level', 'parentId']),
+        all(entities.StopReason, ['status', 'parentName']),
+        all(entities.TestSpecification, ['criteria']),
+        all(entities.PersonnelClass, ['baseIds']),
+        all(entities.EquipmentClass, ['baseIds']),
+        all(entities.PhysicalAssetClass, ['baseIds']),
+        all(entities.MaterialClass, ['baseIds'])
+    ]);
+    return {
+        persons, equipment, physicalAssets, materialDefinitions, operationDefinitions,
+        routeDefinitions, recipeDefinitions, operationalLocations, stopReasons, testSpecifications,
+        personnelClasses, equipmentClasses, physicalAssetClasses, materialClasses
+    };
+}
+//# sourceMappingURL=master-conformance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"master-conformance.js","sourceRoot":"","sources":["../../server/service/master-conformance.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 마스터가 **말이 되나** — 축을 가로질러 한 번에 본다.\n *\n * ── 왜 필요한가 ────────────────────────────────────────────────────────────\n * 축마다 화면이 있고 축마다 값이 차 있는데, 그 사이가 이어지는지는 아무도 안 봤다. 설비 등급 다섯이\n * 서 있고 설비 스물둘이 어느 등급에도 안 들어 있던 일이 그랬다 — 두 화면 다 멀쩡해 보였다.\n * 카메라 자산 다섯이 ECU 등급에 들어 있던 것도, 정지 사유 고르기가 빈 목록으로 보이던 것도 같다.\n *\n * 사람이 열두 화면을 오가며 맞춰 보는 것으로는 안 된다. 맞춰 보지 않으면 아무도 모르고, 맞춰 봤는지\n * 아닌지도 남지 않는다.\n *\n * ── 두 가지만 본다 ─────────────────────────────────────────────────────────\n * **비어 있으면 안 되는 칸**과 **가리키는데 없는 것**이다. 둘 다 사실 판정이라 다툼이 없다.\n * 「이 값이 옳은가」는 여기서 안 본다 — 그것은 현장이 정한다.\n *\n * ── 없는 것을 없다고 말한다 ────────────────────────────────────────────────\n * 표가 통째로 비었으면 그것도 낸다. 「빠진 것 0건」과 「아직 아무것도 안 세웠다」는 다르고, 세지\n * 않으면 둘이 같아 보인다.\n */\n\n/** 한 건의 어긋남. 사실만 담는다 — 무엇을, 어디서, 무엇이. */\nexport interface Finding {\n  /** 어느 축인가. `person` · `equipment` · `recipeDefinition` … */\n  axis: string\n  /** 어느 줄인가. 표가 통째로 빈 경우에는 없다. */\n  subject?: string\n  /** `missing` = 비어 있으면 안 되는 칸이 비었다 · `dangling` = 가리키는데 그런 것이 없다 · `empty` = 표가 비었다 · `unused` = 아무도 안 가리킨다 */\n  kind: 'missing' | 'dangling' | 'empty' | 'unused'\n  /** 어느 칸인가(`missing`·`dangling`), 또는 무엇이 비었나(`empty`·`unused`). */\n  field: string\n  /** 가리키던 값. `dangling` 일 때만. */\n  value?: string\n}\n\n/** 한 축이 내놓는 줄들. 이름과 칸 몇 개만 본다. */\nexport type Row = Record<string, any>\n\nexport interface MasterSnapshot {\n  persons: Row[]\n  equipment: Row[]\n  physicalAssets: Row[]\n  materialDefinitions: Row[]\n  operationDefinitions: Row[]\n  routeDefinitions: Row[]\n  recipeDefinitions: Row[]\n  operationalLocations: Row[]\n  stopReasons: Row[]\n  testSpecifications: Row[]\n  personnelClasses: Row[]\n  equipmentClasses: Row[]\n  physicalAssetClasses: Row[]\n  materialClasses: Row[]\n}\n\nconst nameSet = (rows: Row[]) => new Set(rows.map(one => one.name).filter(Boolean))\n\n/** 값이 비었나 — 빈 문자열과 빈 배열도 빈 것으로 본다. */\nfunction blank(value: any): boolean {\n  if (value === null || value === undefined) {\n    return true\n  }\n  if (Array.isArray(value)) {\n    return value.length === 0\n  }\n\n  return String(value).trim() === ''\n}\n\n/** 이름 목록으로 만든다 — 한 개짜리 문자열도, 배열도 같게 다룬다. */\nfunction asList(value: any): string[] {\n  if (blank(value)) {\n    return []\n  }\n\n  return (Array.isArray(value) ? value : [value]).map(one => String(one).trim()).filter(Boolean)\n}\n\n/**\n * 축 하나를 잰다.\n *\n * `required` 는 비어 있으면 안 되는 칸, `refs` 는 「이 칸의 값이 저 이름들 안에 있어야 한다」이다.\n */\nfunction checkAxis(\n  axis: string,\n  rows: Row[],\n  required: string[],\n  refs: { field: string; within: Set<string> }[]\n): Finding[] {\n  const found: Finding[] = []\n\n  if (rows.length === 0) {\n    /* 표가 통째로 비었다. 「빠진 것 0건」과 다르다. */\n    return [{ axis, kind: 'empty', field: axis }]\n  }\n\n  for (const row of rows) {\n    for (const field of required) {\n      if (blank(row[field])) {\n        found.push({ axis, subject: row.name, kind: 'missing', field })\n      }\n    }\n\n    for (const { field, within } of refs) {\n      for (const value of asList(row[field])) {\n        if (!within.has(value)) {\n          found.push({ axis, subject: row.name, kind: 'dangling', field, value })\n        }\n      }\n    }\n  }\n\n  return found\n}\n\n/** 아무도 안 가리키는 것들 — 세워 놓고 쓰지 않는 선언. */\nfunction checkUnused(axis: string, rows: Row[], pointedAt: Set<string>, field: string): Finding[] {\n  return rows\n    .filter(one => one.name && !pointedAt.has(one.name))\n    .map(one => ({ axis, subject: one.name, kind: 'unused' as const, field }))\n}\n\n/**\n * 마스터 전체를 잰다.\n *\n * **순서에 뜻이 없다.** 어느 축부터 보든 같은 답이 나와야 하고, 그래야 이 결과를 두 번 재서\n * 견줄 수 있다.\n */\nexport function checkMaster(snapshot: MasterSnapshot): Finding[] {\n  const locations = nameSet(snapshot.operationalLocations)\n  const operations = nameSet(snapshot.operationDefinitions)\n  const routes = nameSet(snapshot.routeDefinitions)\n  const materials = nameSet(snapshot.materialDefinitions)\n  const specs = nameSet(snapshot.testSpecifications)\n  const personnelClasses = nameSet(snapshot.personnelClasses)\n  const equipmentClasses = nameSet(snapshot.equipmentClasses)\n  const assetClasses = nameSet(snapshot.physicalAssetClasses)\n  const materialClasses = nameSet(snapshot.materialClasses)\n  const stopReasons = nameSet(snapshot.stopReasons)\n\n  const found: Finding[] = [\n    ...checkAxis('person', snapshot.persons, ['personnelClassIds', 'homeLocation'], [\n      { field: 'personnelClassIds', within: personnelClasses },\n      { field: 'homeLocation', within: locations },\n      { field: 'testSpecificationIds', within: specs }\n    ]),\n\n    ...checkAxis('equipment', snapshot.equipment, ['kind', 'homeLocation', 'equipmentClassIds'], [\n      { field: 'equipmentClassIds', within: equipmentClasses },\n      { field: 'homeLocation', within: locations },\n      { field: 'testSpecificationIds', within: specs }\n    ]),\n\n    ...checkAxis('physicalAsset', snapshot.physicalAssets, ['assetClassIds'], [\n      { field: 'assetClassIds', within: assetClasses },\n      { field: 'homeLocation', within: locations },\n      { field: 'testSpecificationIds', within: specs }\n    ]),\n\n    ...checkAxis('materialDefinition', snapshot.materialDefinitions, ['materialClassIds'], [\n      { field: 'materialClassIds', within: materialClasses },\n      { field: 'testSpecificationIds', within: specs }\n    ]),\n\n    /*\n     * 공정의 `resourceType` 은 설비 **종류**를 가리키는 값이라 이름 집합이 없다. 여기서는\n     * 비었는지만 본다 — 없는 것을 있는 척 검사하지 않는다.\n     */\n    ...checkAxis('operationDefinition', snapshot.operationDefinitions, ['intent', 'locationType', 'duration'], []),\n\n    ...checkAxis('routeDefinition', snapshot.routeDefinitions, ['steps'], [\n      { field: 'steps', within: operations }\n    ]),\n\n    ...checkAxis('recipeDefinition', snapshot.recipeDefinitions, ['materialDefinitionName', 'route', 'inputs'], [\n      { field: 'materialDefinitionName', within: materials },\n      { field: 'route', within: routes }\n    ]),\n\n    ...checkAxis('operationalLocation', snapshot.operationalLocations, ['type', 'level'], [\n      { field: 'parentId', within: locations }\n    ]),\n\n    ...checkAxis('stopReason', snapshot.stopReasons, ['status'], [{ field: 'parentName', within: stopReasons }]),\n\n    ...checkAxis('testSpecification', snapshot.testSpecifications, ['criteria'], [])\n  ]\n\n  /*\n   * 제조법의 투입은 한 줄이 여럿을 가리킨다. 위의 검사는 칸 하나를 보므로 여기서 따로 본다.\n   */\n  for (const recipe of snapshot.recipeDefinitions) {\n    for (const part of recipe.inputs ?? []) {\n      if (part?.material && !materials.has(part.material)) {\n        found.push({ axis: 'recipeDefinition', subject: recipe.name, kind: 'dangling', field: 'inputs.material', value: part.material })\n      }\n      if (part?.operation && !operations.has(part.operation)) {\n        found.push({ axis: 'recipeDefinition', subject: recipe.name, kind: 'dangling', field: 'inputs.operation', value: part.operation })\n      }\n    }\n  }\n\n  /*\n   * ── 세워 놓고 아무도 안 든 등급 ─────────────────────────────────────────\n   *\n   * **상속을 타고 센다.** 등급은 등급을 상속하고(`baseIds`), 자격 판정도 그 사슬을 닫아서 본다\n   * (커널의 `classClosure`). 그러니 「아무도 안 든다」도 닫힌 소속으로 물어야 한다.\n   *\n   * 직접 소속만 세면 뿌리 등급이 늘 걸린다. 품목의 유형 등급(완제품 · 반제품 · 원재료)이 그렇다 —\n   * 품목은 성격 등급에 들고 그 등급이 유형을 상속하므로, 직접 소속은 언제나 0이다. 그것을 결함으로\n   * 읽으면 멀쩡한 등급을 지우러 간다.\n   *\n   * 처음에는 품목만 따로 다뤘고 나머지 셋은 직접 소속으로 셌다. 아키텍트 레인이 설비 등급에도\n   * 같은 축이 있다고 알려 주어 넷을 한 규칙으로 모았다 — 축마다 다르게 세면 한쪽만 고쳐지는 날이\n   * 온다. [재봤음] 2026-09-04\n   */\n  const classAxes: [string, Row[], Row[], string][] = [\n    ['personnelClass', snapshot.personnelClasses, snapshot.persons, 'personnelClassIds'],\n    ['equipmentClass', snapshot.equipmentClasses, snapshot.equipment, 'equipmentClassIds'],\n    ['physicalAssetClass', snapshot.physicalAssetClasses, snapshot.physicalAssets, 'assetClassIds'],\n    ['materialClass', snapshot.materialClasses, snapshot.materialDefinitions, 'materialClassIds']\n  ]\n\n  for (const [axis, classes, members, field] of classAxes) {\n    found.push(...checkUnused(axis, classes, closedMembership(classes, members, field), 'members'))\n  }\n\n  /* 아무도 안 가리키는 라우팅·공정. 만들어 놓고 안 쓰는 것은 지워도 되는 것인지 사람이 판단한다. */\n  const routesUsed = new Set(snapshot.recipeDefinitions.map(one => one.route).filter(Boolean))\n  const operationsUsed = new Set([\n    ...snapshot.routeDefinitions.flatMap(one => asList(one.steps)),\n    ...snapshot.recipeDefinitions.flatMap(one => (one.inputs ?? []).map((part: any) => part?.operation).filter(Boolean))\n  ])\n\n  found.push(\n    ...checkUnused('routeDefinition', snapshot.routeDefinitions, routesUsed, 'usedByRecipes'),\n    ...checkUnused('operationDefinition', snapshot.operationDefinitions, operationsUsed, 'usedInRoutes')\n  )\n\n  return found\n}\n\n/**\n * **닫힌 소속** — 소속이 상속을 타고 닿는 등급까지 모은다.\n *\n * 사람이 `welding-robot-6axis` 에 들고 그것이 `welding-equipment` 를 상속하면, 두 등급 다 「누가\n * 들었다」로 센다. 자격 판정이 그 사슬을 닫아서 보므로(커널의 `classClosure`) 여기서도 같게 본다.\n *\n * **고리를 밟으면 멈춘다.** `baseIds` 는 화면에서 손으로 넣을 수 있어 A→B→A 가 생길 수 있다.\n */\nfunction closedMembership(classes: Row[], members: Row[], field: string): Set<string> {\n  const baseOf = new Map(classes.map(one => [one.name, asList(one.baseIds)]))\n  const reached = new Set<string>()\n\n  const walk = (name: string) => {\n    if (!name || reached.has(name)) {\n      return\n    }\n    reached.add(name)\n\n    for (const base of baseOf.get(name) ?? []) {\n      walk(base)\n    }\n  }\n\n  for (const row of members) {\n    for (const name of asList(row[field])) {\n      walk(name)\n    }\n  }\n\n  return reached\n}\n\n/** 여러 줄이 가리키는 이름들을 모은다. */\nfunction collect(rows: Row[], field: string): Set<string> {\n  return new Set(rows.flatMap(one => asList(one[field])))\n}\n\n/**\n * **무엇을 몇 개 봤나.**\n *\n * 어긋남 0건이 「멀쩡하다」인지 「안 돌았다」인지는 이것으로만 갈린다. 본 수를 안 내면 두 답이\n * 같은 글자로 나온다 — 검사기가 스스로를 못 믿게 만드는 가장 흔한 방식이다.\n */\nexport function scannedCounts(snapshot: MasterSnapshot): { axis: string; rows: number }[] {\n  return Object.entries(snapshot)\n    .map(([axis, rows]) => ({ axis, rows: (rows as Row[]).length }))\n    .sort((a, b) => a.axis.localeCompare(b.axis))\n}\n\n/** 축·종류별로 몇 건인지. 사람이 먼저 볼 것을 고르는 데 쓴다. */\nexport function summarize(findings: Finding[]): { axis: string; kind: string; count: number }[] {\n  const tally = new Map<string, number>()\n\n  for (const one of findings) {\n    const key = `${one.axis}\u0000${one.kind}`\n    tally.set(key, (tally.get(key) ?? 0) + 1)\n  }\n\n  return [...tally.entries()]\n    .map(([key, count]) => {\n      const [axis, kind] = key.split('\u0000')\n\n      return { axis, kind, count }\n    })\n    .sort((a, b) => b.count - a.count || a.axis.localeCompare(b.axis))\n}\n\n/**\n * 한 도메인의 마스터를 통째로 읽어 잰다.\n *\n * **상한을 두지 않는다.** 정합성은 「전부 봤나」가 곧 답이라, 일부만 보고 「어긋남 0건」이라고 하면\n * 그 답이 거짓이 된다. 그래서 이것은 목록 화면이 부르는 것이 아니라 **사람이 눌러서 도는 검사**다.\n */\nexport async function readMasterSnapshot(domain: any, getRepository: any, entities: Record<string, any>): Promise<MasterSnapshot> {\n  const all = async (Entity: any, select: string[]) =>\n    (await getRepository(Entity).find({\n      where: { domain: { id: domain.id } } as any,\n      select: ['id', 'name', ...select] as any\n    })) as Row[]\n\n  const [\n    persons, equipment, physicalAssets, materialDefinitions, operationDefinitions,\n    routeDefinitions, recipeDefinitions, operationalLocations, stopReasons, testSpecifications,\n    personnelClasses, equipmentClasses, physicalAssetClasses, materialClasses\n  ] = await Promise.all([\n    all(entities.Person, ['personnelClassIds', 'homeLocation', 'testSpecificationIds']),\n    all(entities.Equipment, ['kind', 'homeLocation', 'equipmentClassIds', 'testSpecificationIds']),\n    all(entities.PhysicalAsset, ['assetClassIds', 'homeLocation', 'testSpecificationIds']),\n    all(entities.MaterialDefinition, ['materialClassIds', 'testSpecificationIds']),\n    all(entities.OperationDefinition, ['intent', 'locationType', 'resourceType', 'duration']),\n    all(entities.RouteDefinition, ['steps']),\n    all(entities.RecipeDefinition, ['materialDefinitionName', 'route', 'inputs']),\n    all(entities.OperationalLocation, ['type', 'level', 'parentId']),\n    all(entities.StopReason, ['status', 'parentName']),\n    all(entities.TestSpecification, ['criteria']),\n    all(entities.PersonnelClass, ['baseIds']),\n    all(entities.EquipmentClass, ['baseIds']),\n    all(entities.PhysicalAssetClass, ['baseIds']),\n    all(entities.MaterialClass, ['baseIds'])\n  ])\n\n  return {\n    persons, equipment, physicalAssets, materialDefinitions, operationDefinitions,\n    routeDefinitions, recipeDefinitions, operationalLocations, stopReasons, testSpecifications,\n    personnelClasses, equipmentClasses, physicalAssetClasses, materialClasses\n  }\n}\n"]}

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

@@ -0,0 +1,55 @@
+import { EntityManager, ObjectLiteral } from 'typeorm';
+import { Domain } from '@things-factory/shell';
+/**
+ * 마스터를 채우고 고치는 **한 벌의 규칙** — 열두 축이 같은 함수를 쓴다.
+ *
+ * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────
+ * 업무 화면(실적 · 검사 · 처분)은 조회 전용이다. 그것은 **일어난 일의 기록**이라, 고칠 수 있으면
+ * 「그때 무엇이 있었나」가 「지금 무엇으로 적혀 있나」로 바뀐다.
+ *
+ * 마스터는 다르다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 **선언**이다. 선언은 바뀌고,
+ * 바뀐 것이 지금의 선언이다. 그래서 그리드에서 고친다.
+ *
+ * ── 지우는 것만 다르게 다룬다 ──────────────────────────────────────────────
+ * 유효 기간을 가진 축은 **행을 지우지 않는다.** 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다
+ * (어제 실적이 가리키던 설비가 사라지면 그 실적은 어느 설비의 것도 아니게 된다). 대신
+ * `effectiveEnd` 를 채워 오늘부터 유효하지 않게 한다.
+ *
+ * 유효 기간이 없는 축만 실제로 지운다.
+ */
+/** 그리드가 보내는 표식. `+` 새로 만든 행 · `M` 고친 행 · `-` 지운 행. */
+export type CuFlag = '+' | 'M' | '-';
+export interface MasterPatch {
+    id?: string;
+    cuFlag?: string;
+    [key: string]: unknown;
+}
+type EntityClass = {
+    new (): ObjectLiteral;
+};
+export interface SaveMasterOptions {
+    /**
+     * **언제부터 그러한가** — 배정과 선언을 고칠 때.
+     *
+     * 안 주면 지금부터다. 미래면 주장만 남고 본행은 그 시각이 올 때까지 그대로다
+     * (§`claimAssignmentChanges`).
+     */
+    appliedAt?: Date;
+    /** 과거 시각일 때, **지연 기록인가 이미 적은 것의 정정인가.** 안 주면 지연 기록으로 본다. */
+    appliedKind?: 'change' | 'correction';
+    /** 정정이면 어느 구간까지인가. */
+    appliedUntil?: Date;
+    /**
+     * 유효 기간을 갖는 축인가.
+     *
+     * 참이면 지우기가 **`effectiveEnd` 를 채우는 것**이 된다. 거짓이면 행을 지운다.
+     */
+    hasEffectivePeriod?: boolean;
+}
+/**
+ * 그리드가 보낸 변경을 한 번에 적용한다.
+ *
+ * 한 트랜잭션에서 처리한다 — 절반만 반영되면 그리드가 보여 주는 것과 저장된 것이 갈린다.
+ */
+export declare function saveMasterPatches(manager: EntityManager, domain: Domain, entity: EntityClass, patches: readonly MasterPatch[], user: unknown, options?: SaveMasterOptions): Promise<ObjectLiteral[]>;
+export {};

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

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveMasterPatches = saveMasterPatches;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const master_axis_1 = require("./master-axis");
+const master_change_policy_1 = require("./master-change-policy");
+const assignment_write_1 = require("./assignment/assignment-write");
+/**
+ * 그리드가 보낸 변경을 한 번에 적용한다.
+ *
+ * 한 트랜잭션에서 처리한다 — 절반만 반영되면 그리드가 보여 주는 것과 저장된 것이 갈린다.
+ */
+async function saveMasterPatches(manager, domain, entity, patches, user, options = {}) {
+    const axis = master_axis_1.MASTER_AXES.find(axis => axis.entity === entity);
+    if (!axis)
+        throw new Error('saveMasterPatches: the entity must be a declared master axis');
+    await (0, master_change_policy_1.assertDirectMasterChange)(manager, domain.id, axis.key);
+    if (['recipeDefinition', 'materialDefinition'].includes(axis.key))
+        throw new shell_1.Refusal('REVISION_REQUIRED', { axis: axis.key }, 'Change this master through a revision draft, including non-regulated publication.');
+    const repository = manager.getRepository(entity);
+    const results = [];
+    const created = patches.filter(patch => flagOf(patch) === '+');
+    const updated = patches.filter(patch => flagOf(patch) === 'M');
+    const removed = patches.filter(patch => flagOf(patch) === '-');
+    for (const patch of created) {
+        /* 새 행의 `id` 는 그리드가 임시로 붙인 것이다 — 그대로 저장하면 그것이 진짜 키가 된다. */
+        const { cuFlag, id, ...values } = patch;
+        results.push(await repository.save({ ...values, domain, creator: user, updater: user }));
+    }
+    for (const patch of updated) {
+        const { cuFlag, id, ...values } = patch;
+        if (!id) {
+            throw new Error('saveMasterPatches: a changed row must carry its id');
+        }
+        const found = await repository.findOne({ where: { domain: { id: domain.id }, id } });
+        /*
+         * 없는 행을 고치라고 하면 만들지 않는다. 다른 사람이 지웠거나 다른 도메인의 행이고, 둘 다
+         * 조용히 새 행을 만들 일이 아니다.
+         */
+        if (!found) {
+            throw new Error(`saveMasterPatches: no such row to change — ${String(id)}`);
+        }
+        /*
+         * ── 배정과 선언은 **주장으로 남기고, 미래는 본행에 안 쓴다** ──────────────
+         *
+         * 세 칸(`equipment.homeLocation` · `operationalLocation.workShiftNames` · `parentId`)은 가동률
+         * 분모를 정한다. 그래서 「언제부터 그러한가」를 함께 받아 이력에 남긴다.
+         *
+         * **적용 시각이 미래면 본행을 안 건드린다.** 다음 달 이동을 지금 적었다고 다른 제품이 오늘부터
+         * 새 자리를 읽으면 안 된다 — 도래하면 `projectDueClaims` 가 옮긴다.
+         */
+        const scheduled = await (0, assignment_write_1.claimAssignmentChanges)(manager, domain, axis.key, found, values, user, options);
+        results.push(await repository.save({ ...found, ...values, ...scheduled.keepOnRow, updater: user }));
+    }
+    if (removed.length) {
+        await retire(repository, domain, removed, user, options);
+    }
+    return results;
+}
+/**
+ * 없앤다 — 유효 기간이 있으면 **끝을 채우고**, 없으면 지운다.
+ */
+async function retire(repository, domain, removed, user, options) {
+    const ids = removed.map(patch => patch.id).filter(Boolean);
+    if (!ids.length) {
+        return;
+    }
+    if (!options.hasEffectivePeriod) {
+        await repository.delete({ domain: { id: domain.id }, id: (0, typeorm_1.In)(ids) });
+        return;
+    }
+    const rows = await repository.find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(ids) } });
+    const now = new Date();
+    for (const row of rows) {
+        /*
+         * 이미 끝이 적혀 있으면 그대로 둔다. 다시 오늘로 바꾸면 「언제부터 안 썼나」가 바뀐다.
+         */
+        if (row.effectiveEnd) {
+            continue;
+        }
+        await repository.save({ ...row, effectiveEnd: now, updater: user });
+    }
+}
+function flagOf(patch) {
+    const flag = String(patch.cuFlag ?? '').toUpperCase();
+    if (flag === '+' || flag === 'M' || flag === '-') {
+        return flag;
+    }
+    /* 표식이 없으면 고침으로 본다 — 그리드가 표식을 안 붙이는 경우가 있고, 만드는 쪽으로 두면 행이 늘어난다. */
+    return 'M';
+}
+//# sourceMappingURL=master-crud.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"master-crud.js","sourceRoot":"","sources":["../../server/service/master-crud.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In, ObjectLiteral, Repository } from 'typeorm'\n\nimport { Domain, Refusal } from '@things-factory/shell'\nimport { MASTER_AXES } from './master-axis'\nimport { assertDirectMasterChange } from './master-change-policy'\nimport { claimAssignmentChanges } from './assignment/assignment-write'\n\n/**\n * 마스터를 채우고 고치는 **한 벌의 규칙** — 열두 축이 같은 함수를 쓴다.\n *\n * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────\n * 업무 화면(실적 · 검사 · 처분)은 조회 전용이다. 그것은 **일어난 일의 기록**이라, 고칠 수 있으면\n * 「그때 무엇이 있었나」가 「지금 무엇으로 적혀 있나」로 바뀐다.\n *\n * 마스터는 다르다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 **선언**이다. 선언은 바뀌고,\n * 바뀐 것이 지금의 선언이다. 그래서 그리드에서 고친다.\n *\n * ── 지우는 것만 다르게 다룬다 ──────────────────────────────────────────────\n * 유효 기간을 가진 축은 **행을 지우지 않는다.** 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다\n * (어제 실적이 가리키던 설비가 사라지면 그 실적은 어느 설비의 것도 아니게 된다). 대신\n * `effectiveEnd` 를 채워 오늘부터 유효하지 않게 한다.\n *\n * 유효 기간이 없는 축만 실제로 지운다.\n */\n\n/** 그리드가 보내는 표식. `+` 새로 만든 행 · `M` 고친 행 · `-` 지운 행. */\nexport type CuFlag = '+' | 'M' | '-'\n\nexport interface MasterPatch {\n  id?: string\n  cuFlag?: string\n  [key: string]: unknown\n}\n\ntype EntityClass = { new (): ObjectLiteral }\n\nexport interface SaveMasterOptions {\n  /**\n   * **언제부터 그러한가** — 배정과 선언을 고칠 때.\n   *\n   * 안 주면 지금부터다. 미래면 주장만 남고 본행은 그 시각이 올 때까지 그대로다\n   * (§`claimAssignmentChanges`).\n   */\n  appliedAt?: Date\n  /** 과거 시각일 때, **지연 기록인가 이미 적은 것의 정정인가.** 안 주면 지연 기록으로 본다. */\n  appliedKind?: 'change' | 'correction'\n  /** 정정이면 어느 구간까지인가. */\n  appliedUntil?: Date\n  /**\n   * 유효 기간을 갖는 축인가.\n   *\n   * 참이면 지우기가 **`effectiveEnd` 를 채우는 것**이 된다. 거짓이면 행을 지운다.\n   */\n  hasEffectivePeriod?: boolean\n}\n\n/**\n * 그리드가 보낸 변경을 한 번에 적용한다.\n *\n * 한 트랜잭션에서 처리한다 — 절반만 반영되면 그리드가 보여 주는 것과 저장된 것이 갈린다.\n */\nexport async function saveMasterPatches(\n  manager: EntityManager,\n  domain: Domain,\n  entity: EntityClass,\n  patches: readonly MasterPatch[],\n  user: unknown,\n  options: SaveMasterOptions = {}\n): Promise<ObjectLiteral[]> {\n  const axis = MASTER_AXES.find(axis => axis.entity === entity)\n  if (!axis) throw new Error('saveMasterPatches: the entity must be a declared master axis')\n  await assertDirectMasterChange(manager, domain.id, axis.key)\n  if (['recipeDefinition', 'materialDefinition'].includes(axis.key))\n    throw new Refusal('REVISION_REQUIRED', { axis: axis.key }, 'Change this master through a revision draft, including non-regulated publication.')\n  const repository = manager.getRepository(entity)\n  const results: ObjectLiteral[] = []\n\n  const created = patches.filter(patch => flagOf(patch) === '+')\n  const updated = patches.filter(patch => flagOf(patch) === 'M')\n  const removed = patches.filter(patch => flagOf(patch) === '-')\n\n  for (const patch of created) {\n    /* 새 행의 `id` 는 그리드가 임시로 붙인 것이다 — 그대로 저장하면 그것이 진짜 키가 된다. */\n    const { cuFlag, id, ...values } = patch\n\n    results.push(await repository.save({ ...values, domain, creator: user, updater: user }))\n  }\n\n  for (const patch of updated) {\n    const { cuFlag, id, ...values } = patch\n\n    if (!id) {\n      throw new Error('saveMasterPatches: a changed row must carry its id')\n    }\n\n    const found = await repository.findOne({ where: { domain: { id: domain.id }, id } })\n\n    /*\n     * 없는 행을 고치라고 하면 만들지 않는다. 다른 사람이 지웠거나 다른 도메인의 행이고, 둘 다\n     * 조용히 새 행을 만들 일이 아니다.\n     */\n    if (!found) {\n      throw new Error(`saveMasterPatches: no such row to change — ${String(id)}`)\n    }\n\n    /*\n     * ── 배정과 선언은 **주장으로 남기고, 미래는 본행에 안 쓴다** ──────────────\n     *\n     * 세 칸(`equipment.homeLocation` · `operationalLocation.workShiftNames` · `parentId`)은 가동률\n     * 분모를 정한다. 그래서 「언제부터 그러한가」를 함께 받아 이력에 남긴다.\n     *\n     * **적용 시각이 미래면 본행을 안 건드린다.** 다음 달 이동을 지금 적었다고 다른 제품이 오늘부터\n     * 새 자리를 읽으면 안 된다 — 도래하면 `projectDueClaims` 가 옮긴다.\n     */\n    const scheduled = await claimAssignmentChanges(manager, domain, axis.key, found, values, user, options)\n\n    results.push(await repository.save({ ...found, ...values, ...scheduled.keepOnRow, updater: user }))\n  }\n\n  if (removed.length) {\n    await retire(repository, domain, removed, user, options)\n  }\n\n  return results\n}\n\n/**\n * 없앤다 — 유효 기간이 있으면 **끝을 채우고**, 없으면 지운다.\n */\nasync function retire(\n  repository: Repository<ObjectLiteral>,\n  domain: Domain,\n  removed: readonly MasterPatch[],\n  user: unknown,\n  options: SaveMasterOptions\n): Promise<void> {\n  const ids = removed.map(patch => patch.id).filter(Boolean) as string[]\n\n  if (!ids.length) {\n    return\n  }\n\n  if (!options.hasEffectivePeriod) {\n    await repository.delete({ domain: { id: domain.id }, id: In(ids) })\n    return\n  }\n\n  const rows = await repository.find({ where: { domain: { id: domain.id }, id: In(ids) } })\n  const now = new Date()\n\n  for (const row of rows) {\n    /*\n     * 이미 끝이 적혀 있으면 그대로 둔다. 다시 오늘로 바꾸면 「언제부터 안 썼나」가 바뀐다.\n     */\n    if (row.effectiveEnd) {\n      continue\n    }\n\n    await repository.save({ ...row, effectiveEnd: now, updater: user })\n  }\n}\n\nfunction flagOf(patch: MasterPatch): CuFlag {\n  const flag = String(patch.cuFlag ?? '').toUpperCase()\n\n  if (flag === '+' || flag === 'M' || flag === '-') {\n    return flag\n  }\n\n  /* 표식이 없으면 고침으로 본다 — 그리드가 표식을 안 붙이는 경우가 있고, 만드는 쪽으로 두면 행이 늘어난다. */\n  return 'M'\n}\n"]}

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

@@ -0,0 +1,12 @@
+import { ObjectLiteral } from 'typeorm';
+import { Domain, ListParam } from '@things-factory/shell';
+/**
+ * 마스터 한 축을 목록으로 읽는다 — **열두 축이 같은 함수를 쓴다.**
+ *
+ * 총 건수를 함께 낸다. 화면이 「몇 건 중 몇 건을 보고 있나」를 말하려면 그 값이 있어야 하고, 없으면
+ * 잘린 목록과 「이게 전부」를 구별할 수 없다.
+ */
+export declare function listMaster(axisKey: string, params: ListParam, domain: Domain): Promise<{
+    items: ObjectLiteral[];
+    total: number;
+}>;

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listMaster = listMaster;
+const shell_1 = require("@things-factory/shell");
+const master_axis_1 = require("./master-axis");
+const recipe_effective_list_1 = require("./recipe/recipe-effective-list");
+const material_effective_list_1 = require("./material/material-effective-list");
+/**
+ * 마스터 한 축을 목록으로 읽는다 — **열두 축이 같은 함수를 쓴다.**
+ *
+ * 총 건수를 함께 낸다. 화면이 「몇 건 중 몇 건을 보고 있나」를 말하려면 그 값이 있어야 하고, 없으면
+ * 잘린 목록과 「이게 전부」를 구별할 수 없다.
+ */
+async function listMaster(axisKey, params, domain) {
+    const axis = (0, master_axis_1.masterAxisOf)(axisKey);
+    if (axisKey === 'recipeDefinition')
+        return (0, recipe_effective_list_1.listEffectiveRecipes)((0, shell_1.getRepository)(axis.entity).manager, domain, params);
+    if (axisKey === 'materialDefinition')
+        return (0, material_effective_list_1.listEffectiveMaterialDefinitions)((0, shell_1.getRepository)(axis.entity).manager, domain, params);
+    const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+        repository: (0, shell_1.getRepository)(axis.entity),
+        params,
+        domain,
+        searchables: axis.searchables,
+        alias: 'm'
+    });
+    const [items, total] = await queryBuilder.getManyAndCount();
+    return { items, total };
+}
+//# sourceMappingURL=master-list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"master-list.js","sourceRoot":"","sources":["../../server/service/master-list.ts"],"names":[],"mappings":";;AAcA,gCAoBC;AAhCD,iDAAuG;AAEvG,+CAA4C;AAC5C,0EAAqE;AACrE,gFAAqF;AAErF;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,MAAiB,EACjB,MAAc;IAEd,MAAM,IAAI,GAAG,IAAA,0BAAY,EAAC,OAAO,CAAC,CAAA;IAClC,IAAI,OAAO,KAAK,kBAAkB;QAAE,OAAO,IAAA,4CAAoB,EAAC,IAAA,qBAAa,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACnH,IAAI,OAAO,KAAK,oBAAoB;QAAE,OAAO,IAAA,0DAAgC,EAAC,IAAA,qBAAa,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAEjI,MAAM,YAAY,GAAG,IAAA,qCAA6B,EAAC;QACjD,UAAU,EAAE,IAAA,qBAAa,EAAC,IAAI,CAAC,MAAM,CAAC;QACtC,MAAM;QACN,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,GAAG;KACX,CAAC,CAAA;IAEF,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,YAAY,CAAC,eAAe,EAAE,CAAA;IAE3D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AACzB,CAAC","sourcesContent":["import { ObjectLiteral } from 'typeorm'\n\nimport { Domain, ListParam, getQueryBuilderFromListParams, getRepository } from '@things-factory/shell'\n\nimport { masterAxisOf } from './master-axis'\nimport { listEffectiveRecipes } from './recipe/recipe-effective-list'\nimport { listEffectiveMaterialDefinitions } from './material/material-effective-list'\n\n/**\n * 마스터 한 축을 목록으로 읽는다 — **열두 축이 같은 함수를 쓴다.**\n *\n * 총 건수를 함께 낸다. 화면이 「몇 건 중 몇 건을 보고 있나」를 말하려면 그 값이 있어야 하고, 없으면\n * 잘린 목록과 「이게 전부」를 구별할 수 없다.\n */\nexport async function listMaster(\n  axisKey: string,\n  params: ListParam,\n  domain: Domain\n): Promise<{ items: ObjectLiteral[]; total: number }> {\n  const axis = masterAxisOf(axisKey)\n  if (axisKey === 'recipeDefinition') return listEffectiveRecipes(getRepository(axis.entity).manager, domain, params)\n  if (axisKey === 'materialDefinition') return listEffectiveMaterialDefinitions(getRepository(axis.entity).manager, domain, params)\n\n  const queryBuilder = getQueryBuilderFromListParams({\n    repository: getRepository(axis.entity),\n    params,\n    domain,\n    searchables: axis.searchables,\n    alias: 'm'\n  })\n\n  const [items, total] = await queryBuilder.getManyAndCount()\n\n  return { items, total }\n}\n"]}

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

@@ -0,0 +1,33 @@
+import { Domain } from '@things-factory/shell';
+import type { Page, PageRequest } from './master-page';
+/**
+ * 마스터 한 축을 **나눠 읽는다** — 저장소 쪽. 판단은 `master-page` 가 한다.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 등급은 매 쪽에 통째로 싣는다 ───────────────────────────────────────────
+ * 이 축들은 구성원이 자기 **등급을 이름으로 가리킨다.** 등급과 구성원을 따로 나눠 보내면 구성원이
+ * 먼저 도착하고 등급이 나중에 오는 순간이 생기고, 그 순간 받는 쪽은 **없는 등급을 가리키는 구성원**을
+ * 갖는다. 원래 이 조회들이 「자르지 않는다」고 적어 둔 이유가 그것이다.
+ *
+ * 그래서 **구성원만 나누고 등급은 매 쪽에 전부 싣는다.** 등급은 수십 단위라 실어도 크지 않고, 그러면
+ * 어느 쪽을 먼저 받아도 가리키는 곳이 항상 있다.
+ *
+ * ── 이름 다음부터 읽는다 ───────────────────────────────────────────────────
+ * `skip` 은 규모에서 못 쓴다 — 건너뛴 만큼을 매번 다시 읽는다. 이 축들은 이미 이름으로 정렬해 내므로
+ * **마지막 이름 다음부터** 읽으면 건너뛸 것이 없다.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * 한 축을 한 쪽만큼 읽는다.
+ *
+ * 이름 칸을 받는 이유: 축마다 다르다(`name` · `operationKey` …). 여기서 알아보려 하면 축이 늘 때마다
+ * 이 함수를 고쳐야 한다.
+ */
+export declare function pullPage<T>(entity: any, domain: Domain, request: PageRequest, nameColumn?: keyof T & string): Promise<Page<T>>;
+/**
+ * **통째로 달라고 했는데 너무 크면 던진다.**
+ *
+ * 자르고 넘어가지 않는다 — 받는 쪽은 그것이 전부인 줄 알고 트윈을 세우고, 없는 품목이 화면에서 그냥
+ * 존재하지 않게 된다. 오류가 안 난다. 그래서 **틀린 답 대신 오류**를 준다.
+ */
+export declare function refuseIfTooLarge(axis: string, request: PageRequest, page: Page<unknown>): void;