@things-factory/headless-twin 10.0.9 → 10.0.10

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

@@ -0,0 +1,13 @@
+export { TwinLocation } from './twin-location.js';
+export { TwinEquipment } from './twin-equipment.js';
+export { TwinOperation } from './twin-operation.js';
+import { TwinLocation } from './twin-location.js';
+import { TwinEquipment } from './twin-equipment.js';
+import { TwinOperation } from './twin-operation.js';
+import { TwinModelQuery } from './twin-model-query.js';
+import { TwinModelItemQuery } from './twin-model-item-query.js';
+import { TwinModelTreeQuery } from './twin-model-tree-query.js';
+import { TwinModelMutation } from './twin-model-mutation.js';
+import { TwinLineageQuery } from './twin-lineage-query.js';
+export declare const entities: (typeof TwinLocation | typeof TwinEquipment | typeof TwinOperation)[];
+export declare const resolvers: (typeof TwinModelQuery | typeof TwinModelItemQuery | typeof TwinModelTreeQuery | typeof TwinModelMutation | typeof TwinLineageQuery)[];

package/dist-server/service/twin-model/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvers = exports.entities = exports.TwinOperation = exports.TwinEquipment = exports.TwinLocation = void 0;
+/*
+ * 트윈 구조 모델 — `TwinInstance.model`(JSON 덩어리) 에서 풀어낸 **표준 엔티티**(ADR-0032).
+ *
+ * 여기 있는 것은 전부 **원본에서 온 캐시**다. 정본은 원본 시스템이고(ADR-0028), 이 행들은
+ * 인제스트가 만들며 언제든 전부 지우고 다시 만들 수 있어야 한다.
+ *
+ * 오늘은 **실제로 채워지는 세 축**만 있다 — 자리·설비·공정. 사람·자산·등급·속성·생산 정의는
+ * 지금 0건이라 만들지 않는다("설계와 착수는 다르다", ADR-0032-H). 모델은 그때 옳게 세운다.
+ */
+var twin_location_js_1 = require("./twin-location.js");
+Object.defineProperty(exports, "TwinLocation", { enumerable: true, get: function () { return twin_location_js_1.TwinLocation; } });
+var twin_equipment_js_1 = require("./twin-equipment.js");
+Object.defineProperty(exports, "TwinEquipment", { enumerable: true, get: function () { return twin_equipment_js_1.TwinEquipment; } });
+var twin_operation_js_1 = require("./twin-operation.js");
+Object.defineProperty(exports, "TwinOperation", { enumerable: true, get: function () { return twin_operation_js_1.TwinOperation; } });
+const twin_location_js_2 = require("./twin-location.js");
+const twin_equipment_js_2 = require("./twin-equipment.js");
+const twin_operation_js_2 = require("./twin-operation.js");
+const twin_model_query_js_1 = require("./twin-model-query.js");
+const twin_model_item_query_js_1 = require("./twin-model-item-query.js");
+const twin_model_tree_query_js_1 = require("./twin-model-tree-query.js");
+const twin_model_mutation_js_1 = require("./twin-model-mutation.js");
+const twin_lineage_query_js_1 = require("./twin-lineage-query.js");
+exports.entities = [twin_location_js_2.TwinLocation, twin_equipment_js_2.TwinEquipment, twin_operation_js_2.TwinOperation];
+exports.resolvers = [twin_model_query_js_1.TwinModelQuery, twin_model_item_query_js_1.TwinModelItemQuery, twin_model_tree_query_js_1.TwinModelTreeQuery, twin_model_mutation_js_1.TwinModelMutation, twin_lineage_query_js_1.TwinLineageQuery];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/twin-model/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,uDAAiD;AAAxC,gHAAA,YAAY,OAAA;AACrB,yDAAmD;AAA1C,kHAAA,aAAa,OAAA;AACtB,yDAAmD;AAA1C,kHAAA,aAAa,OAAA;AAEtB,yDAAiD;AACjD,2DAAmD;AACnD,2DAAmD;AAEnD,+DAAsD;AACtD,yEAA+D;AAC/D,yEAA+D;AAC/D,qEAA4D;AAC5D,mEAA0D;AAE7C,QAAA,QAAQ,GAAG,CAAC,+BAAY,EAAE,iCAAa,EAAE,iCAAa,CAAC,CAAA;AACvD,QAAA,SAAS,GAAG,CAAC,oCAAc,EAAE,6CAAkB,EAAE,6CAAkB,EAAE,0CAAiB,EAAE,wCAAgB,CAAC,CAAA","sourcesContent":["/*\n * 트윈 구조 모델 — `TwinInstance.model`(JSON 덩어리) 에서 풀어낸 **표준 엔티티**(ADR-0032).\n *\n * 여기 있는 것은 전부 **원본에서 온 캐시**다. 정본은 원본 시스템이고(ADR-0028), 이 행들은\n * 인제스트가 만들며 언제든 전부 지우고 다시 만들 수 있어야 한다.\n *\n * 오늘은 **실제로 채워지는 세 축**만 있다 — 자리·설비·공정. 사람·자산·등급·속성·생산 정의는\n * 지금 0건이라 만들지 않는다(\"설계와 착수는 다르다\", ADR-0032-H). 모델은 그때 옳게 세운다.\n */\nexport { TwinLocation } from './twin-location.js'\nexport { TwinEquipment } from './twin-equipment.js'\nexport { TwinOperation } from './twin-operation.js'\n\nimport { TwinLocation } from './twin-location.js'\nimport { TwinEquipment } from './twin-equipment.js'\nimport { TwinOperation } from './twin-operation.js'\n\nimport { TwinModelQuery } from './twin-model-query.js'\nimport { TwinModelItemQuery } from './twin-model-item-query.js'\nimport { TwinModelTreeQuery } from './twin-model-tree-query.js'\nimport { TwinModelMutation } from './twin-model-mutation.js'\nimport { TwinLineageQuery } from './twin-lineage-query.js'\n\nexport const entities = [TwinLocation, TwinEquipment, TwinOperation]\nexport const resolvers = [TwinModelQuery, TwinModelItemQuery, TwinModelTreeQuery, TwinModelMutation, TwinLineageQuery]\n"]}

package/dist-server/service/twin-model/isa95-coverage.d.ts

@@ -0,0 +1,48 @@
+/** 한 층의 상태 — 있음 · 부분 · 없음. "부분" 을 두는 이유: 절반 있는 것을 있다고 하면 기준이 죽는다. */
+export type CoverageLevel = 'full' | 'partial' | 'none';
+export interface Isa95Concept {
+    /** 표준이 부르는 이름 — 이 표의 키다(우리 어휘가 아니라 표준 어휘). */
+    std: string;
+    /** 표준의 어느 부분인가 — Part 2(자원 모델) · Part 4(일정·실적) 등. */
+    part: string;
+    /** 사람이 읽는 이름(i18n 키). 화면이 번역한다. */
+    label: string;
+    /** 우리 커널 축 — 있으면 데이터구조가 있는 것이다. 없으면 `null`. */
+    axis: string | null;
+    /** 세 층의 상태. `structure` 는 `axis` 로도 검증된다. */
+    structure: CoverageLevel;
+    behavior: CoverageLevel;
+    surface: CoverageLevel;
+    /** 왜 그 수준인지 — **모르는 것을 감추지 않기 위해** 한 줄로 적는다(i18n 키). */
+    note?: string;
+    /**
+     * 자기 축이 없을 때 **어디서 보이나** — 그 사실을 들고 있는 축들.
+     *
+     * 「어디에」칸이 두 가지를 합쳐고 있었다: *아직 축이 없다(부채)* 와 *축일 수 없다(설계)*. 가용 능력은
+     * 개체가 아니라 자원의 지금 상태이므로 축이 될 수 없는데, 세 층이 다 완전한 줄이 "개념 축이 없습니다"
+     * 라고만 말하면 **표가 스스로 모순된 말을 한다**(다 됐다면서 없다고 한다).
+     *
+     * 그래서 축일 수 없는 것은 갈 곳을 가리킨다. 여기가 비어 있고 축도 없으면 그것은 **진짜 빈칸**이다.
+     */
+    shownOn?: string[];
+}
+/** 표준이 요구하는 것 전부 — 이 배열이 곧 기준이다. */
+export declare const ISA95_CONCEPTS: Isa95Concept[];
+/**
+ * 적합성 보고 — **채운 것과 빠진 것을 함께.**
+ *
+ * `axis` 를 커널 축 목록과 맞춰 본다: 축이 있다고 적혀 있는데 커널에 없으면 그 선언이 낡은 것이므로
+ * **구조 없음으로 낮추고 그 사실을 말한다**(조용히 통과시키면 이 표가 거짓이 된다).
+ */
+export declare function isa95Coverage(axes: string[]): {
+    model: string;
+    concepts: (Isa95Concept & {
+        axisMissing?: boolean;
+    })[];
+    totals: {
+        concepts: number;
+        structure: number;
+        behavior: number;
+        surface: number;
+    };
+};

package/dist-server/service/twin-model/isa95-coverage.js

@@ -0,0 +1,155 @@
+"use strict";
+/*
+ * ISA-95 적합성 기준 — **표준이 요구하는 것의 목록.**
+ *
+ * ── 왜 이 파일이 필요한가 ──────────────────────────────────────────────────────
+ * 지금까지 화면은 "우리가 가진 축" 만 보였다. 그러면 채운 것은 세어지지만 **빠진 것은 셀 수 없다** —
+ * 없는 것은 화면에 없으므로 아무도 그것을 묻지 않는다. 표준 준수는 "우리 축에 표준 이름을 붙였다"
+ * 가 아니라 **표준의 목록을 기준으로 빠진 것이 없다**는 말이어야 한다. 기준이 코드로 있어야 그
+ * 문장을 검사할 수 있다.
+ *
+ * ── 세 층에서 본다 ────────────────────────────────────────────────────────────
+ * 표준 준수는 한 층의 일이 아니다. 개념마다 셋을 따로 본다:
+ *
+ *  · `structure` — **데이터구조**가 있나(커널 축·호스트 표에 이 개념의 자리가 있나)
+ *  · `behavior`  — **기능**이 그것을 쓰나(커널이 계획·집행·집계에서 실제로 다루나)
+ *  · `surface`   — **UI 노출**이 있나(사용자가 그것을 볼 수 있나)
+ *
+ * 셋을 합치면 "구조는 있는데 아무도 안 쓰는 컬럼" 과 "커널은 쓰는데 화면에 없는 사실" 이 같은
+ * 값으로 보인다. 실제로 이 프로젝트에서 둘 다 나왔다(인력 명세는 구조·기능이 있었지만 화면에
+ * 없었고, `properties` 는 구조만 있다).
+ *
+ * ── 값은 관측이 아니라 선언이다 ────────────────────────────────────────────────
+ * 여기 적힌 것은 **사람이 판단해 적은 사실**이다(자동 판정이 아니다). 그래서 틀릴 수 있고, 틀리면
+ * 여기를 고쳐야 한다 — 화면은 이 선언을 그대로 보이고 지어내지 않는다. 자동으로 알 수 있는 것
+ * 하나는 자동으로 한다: `axis` 가 커널 축 목록에 없으면 그것은 **구조가 없는 것**이다(오타 방지).
+ *
+ * ── 이 표가 커널에 없는 이유 ──────────────────────────────────────────────────
+ * 커널은 **런타임 모델의 SSOT** 다(무엇이 있는가). 이 표는 **참조 모델의 목록**이다(무엇이 있어야
+ * 하는가). 둘은 다른 종류의 사실이고, 후자는 커널을 배포하지 않고도 늘어야 한다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ISA95_CONCEPTS = void 0;
+exports.isa95Coverage = isa95Coverage;
+/*
+ * 가용 능력(2026-08-12, 커널 0.6.8) — **판정과 이유가 상태에 실려 온다**(`capability {available, reason}`).
+ *
+ * 셋 다 완전인 근거: 상태가 판정을 들고 오고(시뮬·미러가 같은 함수로 파생한다), 배정이 같은 판정을
+ * 쓰고, 두 화면이 같은 낱말로 그 이유를 보인다(자원 탭 배지 · 인스펙션 관측 열).
+ *
+ * 왜 축이 없는가 — 가용 능력은 개체가 아니라 **자원의 지금 상태**다. 개념 카드로 세우면 사람·설비와
+ * 나란히 놓여 "능력이 몇 개인가" 를 세게 되는데, 그건 물을 일이 아니다.
+ */
+/*
+ * 생산 능력(2026-08-13, 커널 0.6.12) — **구간의 양을 표준 종류로 구분한다.**
+ *
+ * `structure` 완전: 계약이 보고서를 낸다(`operationsCapabilityOf`) — 구간(StartTime·EndTime) · 표준
+ * 열거값(Committed·Available·Unattainable) · 공정별 분해 · 제약하는 축. 낱말은 B2MML 대조 후 표준 것을
+ * 그대로 쓴다(우리 낱말을 만들지 않았다).
+ * `behavior` 완전: 약정은 오더에서, 달성불가는 자원 판정(`capabilityOf`)에서 온다 — 그리고 그 판정은
+ * 배정이 쓰는 것과 같은 한 벌이다. 표준의 `Unattainable` 정의가 그 판정과 겹친다.
+ * `surface` 완전: 두 자리에서 보인다 — 성과 화면이 현장 전체의 "앞으로 더 받을 수 있는 몫" 을, 공정
+ * 상세가 그 공정 하나의 분해(상한·약정·달성불가·가용)와 제약하는 축을 보인다. 두 화면은 **같은 낱말**을
+ * 쓴다(같은 i18n 키) — 같은 사실을 다르게 부르면 어느 쪽이 맞는지 아무도 모른다.
+ *
+ * 남은 것 — 표준은 **게시된(약속된) 능력**도 담는다(계산이 아니라 선언). 값을 실을 소스가 아직
+ * 침묵하므로 빈 축을 먼저 만들지 않는다(상태 쪽 `workCalendar` 를 지운 이유와 같다).
+ *
+ * 과거 분해(Used·Unused)는 이 보고서에 없다 — 그것은 실적이고 이미 두 곳에 있다(설비 OEE 의 가동/유휴,
+ * 성과 화면의 구간 가동률). 표준이 그 둘을 다른 종류로 부르므로 **합치지 않는다.**
+ */
+/*
+ * Part 2 — 자원 모델. 네 자원 각각이 **등급/정의 ↔ 개체** 이중구조를 갖는 것이 이 부분의 핵심이고,
+ * 그 이중성이 이 트윈의 뼈대이기도 하다.
+ */
+const PART2 = [
+    { std: 'PersonnelClass', part: '2', label: 'twin.isa95.PersonnelClass', axis: 'personnelClasses', structure: 'full', behavior: 'full', surface: 'full' },
+    { std: 'Person', part: '2', label: 'twin.isa95.Person', axis: 'persons', structure: 'full', behavior: 'full', surface: 'full' },
+    { std: 'PersonnelCapability', part: '2', label: 'twin.isa95.PersonnelCapability', axis: null, shownOn: ['persons'], structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.capability' },
+    { std: 'EquipmentClass', part: '2', label: 'twin.isa95.EquipmentClass', axis: 'equipmentClasses', structure: 'full', behavior: 'full', surface: 'full' },
+    { std: 'Equipment', part: '2', label: 'twin.isa95.Equipment', axis: 'equipment', structure: 'full', behavior: 'full', surface: 'full' },
+    { std: 'EquipmentCapability', part: '2', label: 'twin.isa95.EquipmentCapability', axis: null, shownOn: ['equipment'], structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.capability' },
+    { std: 'PhysicalAssetClass', part: '2', label: 'twin.isa95.PhysicalAssetClass', axis: 'assetClasses', structure: 'full', behavior: 'full', surface: 'full' },
+    { std: 'PhysicalAsset', part: '2', label: 'twin.isa95.PhysicalAsset', axis: 'assets', structure: 'full', behavior: 'full', surface: 'full' },
+    { std: 'MaterialClass', part: '2', label: 'twin.isa95.MaterialClass', axis: 'materialClasses', structure: 'full', behavior: 'partial', surface: 'full' },
+    { std: 'MaterialDefinition', part: '2', label: 'twin.isa95.MaterialDefinition', axis: 'materialDefinitions', structure: 'full', behavior: 'full', surface: 'full' },
+    /* 로트·서브로트는 개체 축이 아니라 **관측**으로 존재한다(EPCIS 개체) — 구조는 저널이 갖는다. */
+    { std: 'MaterialLot', part: '2', label: 'twin.isa95.MaterialLot', axis: null, structure: 'partial', behavior: 'full', surface: 'partial', note: 'twin.isa95.note.lot' },
+    { std: 'MaterialSublot', part: '2', label: 'twin.isa95.MaterialSublot', axis: null, structure: 'none', behavior: 'none', surface: 'none' },
+    { std: 'ProcessSegment', part: '2', label: 'twin.isa95.ProcessSegment', axis: 'operations', structure: 'full', behavior: 'full', surface: 'full' },
+    /*
+     * 속성은 자원마다 붙는 확장이라 **자기 축이 아니다** — 그래서 `axis` 는 없지만 구조는 완전하다:
+     * 계약(`ResourceProperty`: 값·데이터형·단위·하위·등급속성)이 표준을 그대로 담고, 인제스트·상태·
+     * 화면이 그것을 통과시킨다.
+     *
+     * 기능은 **부분**이다: 호스트의 주행 추정기가 `speed` 를 읽어 이동 시간을 만드는 것이 유일한 소비처다
+     * (다른 속성은 아직 아무도 읽지 않는다). 그 사실을 `full` 로 올리면 표가 거짓이 된다.
+     */
+    { std: 'Property', part: '2', label: 'twin.isa95.Property', axis: null, structure: 'full', behavior: 'partial', surface: 'full', note: 'twin.isa95.note.property' }
+];
+/*
+ * Part 4 — 일정과 실적.
+ *
+ * **2026-08-11 이전에는 이 부분이 거의 비어 있었다.** 오더·작업은 런타임과 저널에 실재하는데 조회
+ * 모델의 축이 아니었고, 그래서 "이 트윈이 표준의 어디를 채우나" 라는 질문에 절반만 답했다.
+ *
+ * 커널이 계약을 넓혀(`source: 'state'`) 두 축이 추가되었다 — 이제 요구(`orders`)와 응답(`tasks`)을 개념으로
+ * 가리켜 걸어 들어갈 수 있다. 남은 것은 **과거로 다시 계산하는 길**(저널 커서 페이징)과 능력·검사 명세다.
+ */
+const PART4 = [
+    { std: 'OperationsDefinition', part: '4', label: 'twin.isa95.OperationsDefinition', axis: 'productionSpec', structure: 'full', behavior: 'full', surface: 'partial', note: 'twin.isa95.note.opsdef' },
+    /*
+     * 2026-08-11 — **축이 추가되었다**(커널 0.6.3 · `source: 'state'`). 요구는 `orders`, 응답은 `tasks` 다.
+     *
+     * `structure` 를 `full` 로 올린다: 담을 자리가 계약에 있다(상태 계약 + 축 선언). **테이블 투영이
+     * 없는 것은 결손이 아니다** — 이 축의 정본은 저널이고, 투영하지 않는 것이 결정이다(ADR-0032-D).
+     *
+     * `surface` 도 `full` 이다(같은 날 두 번째 단계): 목록·상세·관계에 더해 **과거로 다시 계산하는 길**이 화면에
+     * 있다 — 시각 커서를 옮기면 그 시점의 사실이 나오고, 무엇을 근거로 답했는지도 화면이 말한다
+     * (라이브=권위 · 저널=파생 · 접은 리비전). 실측: 이른 시각 0건 · 하루 뒤 504건.
+     */
+    { std: 'OperationsSchedule', part: '4', label: 'twin.isa95.OperationsSchedule', axis: 'orders', structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.schedule' },
+    { std: 'OperationsPerformance', part: '4', label: 'twin.isa95.OperationsPerformance', axis: 'tasks', structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.performance' },
+    { std: 'OperationsCapability', part: '4', label: 'twin.isa95.OperationsCapability', axis: null, shownOn: ['operations'], structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.opscapability' },
+    /*
+     * 2026-08-12 — **축이 추가되었다**(커널 0.6.5). 자원 아홉이 가리키던 참조에 대상이 생겼고, 없는 명세를
+     * 가리키면 선 채움이 끊어진 참조로 센다.
+     *
+     * 기능이 **`partial` 로 살아났다**(커널 0.6.6): 결과(`TestResult`)가 계약에 들어오면서 커널이 배정에서
+     * 그것을 본다 — 만료·불합격이면 그 자격은 성립하지 않는다(실측: 만료된 용접사는 용접 작업 5건 중 한
+     * 번도 배정되지 않았다).
+     *
+     * `full` 이 아닌 이유는 둘이다: **사람만 판정한다**(설비·자산의 검사 결과는 아직 배정에 쓰지 않는다),
+     * 그리고 결과가 없으면 판정하지 않는다(선언한 것만 제약이 된다 — 그건 결손이 아니라 규율이다).
+     */
+    { std: 'TestSpecification', part: '4', label: 'twin.isa95.TestSpecification', axis: 'testSpecifications', structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.test' },
+    { std: 'WorkMaster', part: '4', label: 'twin.isa95.WorkMaster', axis: 'recipes', structure: 'full', behavior: 'full', surface: 'full' },
+    { std: 'WorkDirective', part: '4', label: 'twin.isa95.WorkDirective', axis: null, structure: 'none', behavior: 'none', surface: 'none' }
+];
+/** 표준이 요구하는 것 전부 — 이 배열이 곧 기준이다. */
+exports.ISA95_CONCEPTS = [...PART2, ...PART4];
+/**
+ * 적합성 보고 — **채운 것과 빠진 것을 함께.**
+ *
+ * `axis` 를 커널 축 목록과 맞춰 본다: 축이 있다고 적혀 있는데 커널에 없으면 그 선언이 낡은 것이므로
+ * **구조 없음으로 낮추고 그 사실을 말한다**(조용히 통과시키면 이 표가 거짓이 된다).
+ */
+function isa95Coverage(axes) {
+    const known = new Set(axes);
+    const concepts = exports.ISA95_CONCEPTS.map(c => {
+        const axisMissing = !!c.axis && !known.has(c.axis);
+        /* 가리키는 곳이 없어진 축은 **가리키지 않는다** — 죽은 문으로 보내면 화면이 거짓말을 한다.
+           `axis` 와 같은 규율이고, 여기가 비면 그 줄은 다시 "축이 없다" 로 정직하게 돌아간다. */
+        const shownOn = c.shownOn?.filter(a => known.has(a));
+        const fixed = shownOn && shownOn.length !== c.shownOn?.length ? { ...c, shownOn } : c;
+        return axisMissing ? { ...fixed, structure: 'none', axisMissing } : fixed;
+    });
+    /* 채운 수는 `full` 만 센다 — 부분을 채운 것으로 세면 기준이 스스로를 속인다. */
+    const count = (k) => concepts.filter(c => c[k] === 'full').length;
+    return {
+        model: 'ISA-95',
+        concepts,
+        totals: { concepts: concepts.length, structure: count('structure'), behavior: count('behavior'), surface: count('surface') }
+    };
+}
+//# sourceMappingURL=isa95-coverage.js.map

package/dist-server/service/twin-model/isa95-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isa95-coverage.js","sourceRoot":"","sources":["../../../server/service/twin-model/isa95-coverage.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * ISA-95 적합성 기준 — **표준이 요구하는 것의 목록.**\n *\n * ── 왜 이 파일이 필요한가 ──────────────────────────────────────────────────────\n * 지금까지 화면은 \"우리가 가진 축\" 만 보였다. 그러면 채운 것은 세어지지만 **빠진 것은 셀 수 없다** —\n * 없는 것은 화면에 없으므로 아무도 그것을 묻지 않는다. 표준 준수는 \"우리 축에 표준 이름을 붙였다\"\n * 가 아니라 **표준의 목록을 기준으로 빠진 것이 없다**는 말이어야 한다. 기준이 코드로 있어야 그\n * 문장을 검사할 수 있다.\n *\n * ── 세 층에서 본다 ────────────────────────────────────────────────────────────\n * 표준 준수는 한 층의 일이 아니다. 개념마다 셋을 따로 본다:\n *\n *  · `structure` — **데이터구조**가 있나(커널 축·호스트 표에 이 개념의 자리가 있나)\n *  · `behavior`  — **기능**이 그것을 쓰나(커널이 계획·집행·집계에서 실제로 다루나)\n *  · `surface`   — **UI 노출**이 있나(사용자가 그것을 볼 수 있나)\n *\n * 셋을 합치면 \"구조는 있는데 아무도 안 쓰는 컬럼\" 과 \"커널은 쓰는데 화면에 없는 사실\" 이 같은\n * 값으로 보인다. 실제로 이 프로젝트에서 둘 다 나왔다(인력 명세는 구조·기능이 있었지만 화면에\n * 없었고, `properties` 는 구조만 있다).\n *\n * ── 값은 관측이 아니라 선언이다 ────────────────────────────────────────────────\n * 여기 적힌 것은 **사람이 판단해 적은 사실**이다(자동 판정이 아니다). 그래서 틀릴 수 있고, 틀리면\n * 여기를 고쳐야 한다 — 화면은 이 선언을 그대로 보이고 지어내지 않는다. 자동으로 알 수 있는 것\n * 하나는 자동으로 한다: `axis` 가 커널 축 목록에 없으면 그것은 **구조가 없는 것**이다(오타 방지).\n *\n * ── 이 표가 커널에 없는 이유 ──────────────────────────────────────────────────\n * 커널은 **런타임 모델의 SSOT** 다(무엇이 있는가). 이 표는 **참조 모델의 목록**이다(무엇이 있어야\n * 하는가). 둘은 다른 종류의 사실이고, 후자는 커널을 배포하지 않고도 늘어야 한다.\n */\n\n/** 한 층의 상태 — 있음 · 부분 · 없음. \"부분\" 을 두는 이유: 절반 있는 것을 있다고 하면 기준이 죽는다. */\nexport type CoverageLevel = 'full' | 'partial' | 'none'\n\nexport interface Isa95Concept {\n  /** 표준이 부르는 이름 — 이 표의 키다(우리 어휘가 아니라 표준 어휘). */\n  std: string\n  /** 표준의 어느 부분인가 — Part 2(자원 모델) · Part 4(일정·실적) 등. */\n  part: string\n  /** 사람이 읽는 이름(i18n 키). 화면이 번역한다. */\n  label: string\n  /** 우리 커널 축 — 있으면 데이터구조가 있는 것이다. 없으면 `null`. */\n  axis: string | null\n  /** 세 층의 상태. `structure` 는 `axis` 로도 검증된다. */\n  structure: CoverageLevel\n  behavior: CoverageLevel\n  surface: CoverageLevel\n  /** 왜 그 수준인지 — **모르는 것을 감추지 않기 위해** 한 줄로 적는다(i18n 키). */\n  note?: string\n  /**\n   * 자기 축이 없을 때 **어디서 보이나** — 그 사실을 들고 있는 축들.\n   *\n   * 「어디에」칸이 두 가지를 합쳐고 있었다: *아직 축이 없다(부채)* 와 *축일 수 없다(설계)*. 가용 능력은\n   * 개체가 아니라 자원의 지금 상태이므로 축이 될 수 없는데, 세 층이 다 완전한 줄이 \"개념 축이 없습니다\"\n   * 라고만 말하면 **표가 스스로 모순된 말을 한다**(다 됐다면서 없다고 한다).\n   *\n   * 그래서 축일 수 없는 것은 갈 곳을 가리킨다. 여기가 비어 있고 축도 없으면 그것은 **진짜 빈칸**이다.\n   */\n  shownOn?: string[]\n}\n\n/*\n * 가용 능력(2026-08-12, 커널 0.6.8) — **판정과 이유가 상태에 실려 온다**(`capability {available, reason}`).\n *\n * 셋 다 완전인 근거: 상태가 판정을 들고 오고(시뮬·미러가 같은 함수로 파생한다), 배정이 같은 판정을\n * 쓰고, 두 화면이 같은 낱말로 그 이유를 보인다(자원 탭 배지 · 인스펙션 관측 열).\n *\n * 왜 축이 없는가 — 가용 능력은 개체가 아니라 **자원의 지금 상태**다. 개념 카드로 세우면 사람·설비와\n * 나란히 놓여 \"능력이 몇 개인가\" 를 세게 되는데, 그건 물을 일이 아니다.\n */\n\n/*\n * 생산 능력(2026-08-13, 커널 0.6.12) — **구간의 양을 표준 종류로 구분한다.**\n *\n * `structure` 완전: 계약이 보고서를 낸다(`operationsCapabilityOf`) — 구간(StartTime·EndTime) · 표준\n * 열거값(Committed·Available·Unattainable) · 공정별 분해 · 제약하는 축. 낱말은 B2MML 대조 후 표준 것을\n * 그대로 쓴다(우리 낱말을 만들지 않았다).\n * `behavior` 완전: 약정은 오더에서, 달성불가는 자원 판정(`capabilityOf`)에서 온다 — 그리고 그 판정은\n * 배정이 쓰는 것과 같은 한 벌이다. 표준의 `Unattainable` 정의가 그 판정과 겹친다.\n * `surface` 완전: 두 자리에서 보인다 — 성과 화면이 현장 전체의 \"앞으로 더 받을 수 있는 몫\" 을, 공정\n * 상세가 그 공정 하나의 분해(상한·약정·달성불가·가용)와 제약하는 축을 보인다. 두 화면은 **같은 낱말**을\n * 쓴다(같은 i18n 키) — 같은 사실을 다르게 부르면 어느 쪽이 맞는지 아무도 모른다.\n *\n * 남은 것 — 표준은 **게시된(약속된) 능력**도 담는다(계산이 아니라 선언). 값을 실을 소스가 아직\n * 침묵하므로 빈 축을 먼저 만들지 않는다(상태 쪽 `workCalendar` 를 지운 이유와 같다).\n *\n * 과거 분해(Used·Unused)는 이 보고서에 없다 — 그것은 실적이고 이미 두 곳에 있다(설비 OEE 의 가동/유휴,\n * 성과 화면의 구간 가동률). 표준이 그 둘을 다른 종류로 부르므로 **합치지 않는다.**\n */\n\n/*\n * Part 2 — 자원 모델. 네 자원 각각이 **등급/정의 ↔ 개체** 이중구조를 갖는 것이 이 부분의 핵심이고,\n * 그 이중성이 이 트윈의 뼈대이기도 하다.\n */\nconst PART2: Isa95Concept[] = [\n  { std: 'PersonnelClass', part: '2', label: 'twin.isa95.PersonnelClass', axis: 'personnelClasses', structure: 'full', behavior: 'full', surface: 'full' },\n  { std: 'Person', part: '2', label: 'twin.isa95.Person', axis: 'persons', structure: 'full', behavior: 'full', surface: 'full' },\n  { std: 'PersonnelCapability', part: '2', label: 'twin.isa95.PersonnelCapability', axis: null, shownOn: ['persons'], structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.capability' },\n  { std: 'EquipmentClass', part: '2', label: 'twin.isa95.EquipmentClass', axis: 'equipmentClasses', structure: 'full', behavior: 'full', surface: 'full' },\n  { std: 'Equipment', part: '2', label: 'twin.isa95.Equipment', axis: 'equipment', structure: 'full', behavior: 'full', surface: 'full' },\n  { std: 'EquipmentCapability', part: '2', label: 'twin.isa95.EquipmentCapability', axis: null, shownOn: ['equipment'], structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.capability' },\n  { std: 'PhysicalAssetClass', part: '2', label: 'twin.isa95.PhysicalAssetClass', axis: 'assetClasses', structure: 'full', behavior: 'full', surface: 'full' },\n  { std: 'PhysicalAsset', part: '2', label: 'twin.isa95.PhysicalAsset', axis: 'assets', structure: 'full', behavior: 'full', surface: 'full' },\n  { std: 'MaterialClass', part: '2', label: 'twin.isa95.MaterialClass', axis: 'materialClasses', structure: 'full', behavior: 'partial', surface: 'full' },\n  { std: 'MaterialDefinition', part: '2', label: 'twin.isa95.MaterialDefinition', axis: 'materialDefinitions', structure: 'full', behavior: 'full', surface: 'full' },\n  /* 로트·서브로트는 개체 축이 아니라 **관측**으로 존재한다(EPCIS 개체) — 구조는 저널이 갖는다. */\n  { std: 'MaterialLot', part: '2', label: 'twin.isa95.MaterialLot', axis: null, structure: 'partial', behavior: 'full', surface: 'partial', note: 'twin.isa95.note.lot' },\n  { std: 'MaterialSublot', part: '2', label: 'twin.isa95.MaterialSublot', axis: null, structure: 'none', behavior: 'none', surface: 'none' },\n  { std: 'ProcessSegment', part: '2', label: 'twin.isa95.ProcessSegment', axis: 'operations', structure: 'full', behavior: 'full', surface: 'full' },\n  /*\n   * 속성은 자원마다 붙는 확장이라 **자기 축이 아니다** — 그래서 `axis` 는 없지만 구조는 완전하다:\n   * 계약(`ResourceProperty`: 값·데이터형·단위·하위·등급속성)이 표준을 그대로 담고, 인제스트·상태·\n   * 화면이 그것을 통과시킨다.\n   *\n   * 기능은 **부분**이다: 호스트의 주행 추정기가 `speed` 를 읽어 이동 시간을 만드는 것이 유일한 소비처다\n   * (다른 속성은 아직 아무도 읽지 않는다). 그 사실을 `full` 로 올리면 표가 거짓이 된다.\n   */\n  { std: 'Property', part: '2', label: 'twin.isa95.Property', axis: null, structure: 'full', behavior: 'partial', surface: 'full', note: 'twin.isa95.note.property' }\n]\n\n/*\n * Part 4 — 일정과 실적.\n *\n * **2026-08-11 이전에는 이 부분이 거의 비어 있었다.** 오더·작업은 런타임과 저널에 실재하는데 조회\n * 모델의 축이 아니었고, 그래서 \"이 트윈이 표준의 어디를 채우나\" 라는 질문에 절반만 답했다.\n *\n * 커널이 계약을 넓혀(`source: 'state'`) 두 축이 추가되었다 — 이제 요구(`orders`)와 응답(`tasks`)을 개념으로\n * 가리켜 걸어 들어갈 수 있다. 남은 것은 **과거로 다시 계산하는 길**(저널 커서 페이징)과 능력·검사 명세다.\n */\nconst PART4: Isa95Concept[] = [\n  { std: 'OperationsDefinition', part: '4', label: 'twin.isa95.OperationsDefinition', axis: 'productionSpec', structure: 'full', behavior: 'full', surface: 'partial', note: 'twin.isa95.note.opsdef' },\n  /*\n   * 2026-08-11 — **축이 추가되었다**(커널 0.6.3 · `source: 'state'`). 요구는 `orders`, 응답은 `tasks` 다.\n   *\n   * `structure` 를 `full` 로 올린다: 담을 자리가 계약에 있다(상태 계약 + 축 선언). **테이블 투영이\n   * 없는 것은 결손이 아니다** — 이 축의 정본은 저널이고, 투영하지 않는 것이 결정이다(ADR-0032-D).\n   *\n   * `surface` 도 `full` 이다(같은 날 두 번째 단계): 목록·상세·관계에 더해 **과거로 다시 계산하는 길**이 화면에\n   * 있다 — 시각 커서를 옮기면 그 시점의 사실이 나오고, 무엇을 근거로 답했는지도 화면이 말한다\n   * (라이브=권위 · 저널=파생 · 접은 리비전). 실측: 이른 시각 0건 · 하루 뒤 504건.\n   */\n  { std: 'OperationsSchedule', part: '4', label: 'twin.isa95.OperationsSchedule', axis: 'orders', structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.schedule' },\n  { std: 'OperationsPerformance', part: '4', label: 'twin.isa95.OperationsPerformance', axis: 'tasks', structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.performance' },\n  { std: 'OperationsCapability', part: '4', label: 'twin.isa95.OperationsCapability', axis: null, shownOn: ['operations'], structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.opscapability' },\n  /*\n   * 2026-08-12 — **축이 추가되었다**(커널 0.6.5). 자원 아홉이 가리키던 참조에 대상이 생겼고, 없는 명세를\n   * 가리키면 선 채움이 끊어진 참조로 센다.\n   *\n   * 기능이 **`partial` 로 살아났다**(커널 0.6.6): 결과(`TestResult`)가 계약에 들어오면서 커널이 배정에서\n   * 그것을 본다 — 만료·불합격이면 그 자격은 성립하지 않는다(실측: 만료된 용접사는 용접 작업 5건 중 한\n   * 번도 배정되지 않았다).\n   *\n   * `full` 이 아닌 이유는 둘이다: **사람만 판정한다**(설비·자산의 검사 결과는 아직 배정에 쓰지 않는다),\n   * 그리고 결과가 없으면 판정하지 않는다(선언한 것만 제약이 된다 — 그건 결손이 아니라 규율이다).\n   */\n  { std: 'TestSpecification', part: '4', label: 'twin.isa95.TestSpecification', axis: 'testSpecifications', structure: 'full', behavior: 'full', surface: 'full', note: 'twin.isa95.note.test' },\n  { std: 'WorkMaster', part: '4', label: 'twin.isa95.WorkMaster', axis: 'recipes', structure: 'full', behavior: 'full', surface: 'full' },\n  { std: 'WorkDirective', part: '4', label: 'twin.isa95.WorkDirective', axis: null, structure: 'none', behavior: 'none', surface: 'none' }\n]\n\n/** 표준이 요구하는 것 전부 — 이 배열이 곧 기준이다. */\nexport const ISA95_CONCEPTS: Isa95Concept[] = [...PART2, ...PART4]\n\n/**\n * 적합성 보고 — **채운 것과 빠진 것을 함께.**\n *\n * `axis` 를 커널 축 목록과 맞춰 본다: 축이 있다고 적혀 있는데 커널에 없으면 그 선언이 낡은 것이므로\n * **구조 없음으로 낮추고 그 사실을 말한다**(조용히 통과시키면 이 표가 거짓이 된다).\n */\nexport function isa95Coverage(axes: string[]): {\n  model: string\n  concepts: (Isa95Concept & { axisMissing?: boolean })[]\n  totals: { concepts: number; structure: number; behavior: number; surface: number }\n} {\n  const known = new Set(axes)\n  const concepts = ISA95_CONCEPTS.map(c => {\n    const axisMissing = !!c.axis && !known.has(c.axis)\n    /* 가리키는 곳이 없어진 축은 **가리키지 않는다** — 죽은 문으로 보내면 화면이 거짓말을 한다.\n       `axis` 와 같은 규율이고, 여기가 비면 그 줄은 다시 \"축이 없다\" 로 정직하게 돌아간다. */\n    const shownOn = c.shownOn?.filter(a => known.has(a))\n    const fixed = shownOn && shownOn.length !== c.shownOn?.length ? { ...c, shownOn } : c\n    return axisMissing ? { ...fixed, structure: 'none' as CoverageLevel, axisMissing } : fixed\n  })\n  /* 채운 수는 `full` 만 센다 — 부분을 채운 것으로 세면 기준이 스스로를 속인다. */\n  const count = (k: 'structure' | 'behavior' | 'surface') => concepts.filter(c => c[k] === 'full').length\n  return {\n    model: 'ISA-95',\n    concepts,\n    totals: { concepts: concepts.length, structure: count('structure'), behavior: count('behavior'), surface: count('surface') }\n  }\n}\n"]}

package/dist-server/service/twin-model/project-structure.d.ts

@@ -0,0 +1,16 @@
+export interface ProjectionReport {
+    locations: number;
+    equipment: number;
+    operations: number;
+    /** 자리를 못 찾아 기준 자리를 비운 설비 — **조용히 넘기지 않는다.** */
+    unresolvedHome: string[];
+    /** 구역을 못 찾아 비운 자리. 구역은 model 밖(호스트 개념)이라 어긋날 수 있다. */
+    unresolvedArea: string[];
+}
+/**
+ * 이 트윈의 구조 행을 **원본 그대로 다시 그린다.**
+ *
+ * `sourceRef` 는 어느 원본에서 왔는지다(`ReferenceMaster.source` = instanceId). 없는 행은
+ * 만들 수 없다 — 캐시라는 사실을 구조로 지킨다.
+ */
+export declare function projectStructure(domainId: string, instanceId: string, model: any, sourceRef: string): Promise<ProjectionReport>;

package/dist-server/service/twin-model/project-structure.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectStructure = projectStructure;
+const shell_1 = require("@things-factory/shell");
+const twin_instance_js_1 = require("../twin-instance/twin-instance.js");
+const twin_area_js_1 = require("../twin-space/twin-area.js");
+const twin_location_js_1 = require("./twin-location.js");
+const twin_equipment_js_1 = require("./twin-equipment.js");
+const twin_operation_js_1 = require("./twin-operation.js");
+const twin_kernel_1 = require("@operato/twin-kernel");
+/**
+ * 이 트윈의 구조 행을 **원본 그대로 다시 그린다.**
+ *
+ * `sourceRef` 는 어느 원본에서 왔는지다(`ReferenceMaster.source` = instanceId). 없는 행은
+ * 만들 수 없다 — 캐시라는 사실을 구조로 지킨다.
+ */
+async function projectStructure(domainId, instanceId, model, sourceRef) {
+    const instance = await (0, shell_1.getRepository)(twin_instance_js_1.TwinInstance).findOne({ where: { domain: { id: domainId }, instanceId } });
+    if (!instance)
+        throw new Error(`cannot project structure: twin instance "${instanceId}" is not registered`);
+    /*
+     * **같은 id 가 둘이면 그 사실을 말한다** — 제약 위반 문구를 사용자에게 던지지 않는다.
+     *
+     * 실측(2026-08-18): 현장 값을 그 현장의 트윈 전부에 얹다가 한 트윈에서 투영이 터졌다. 올라온 것은
+     * `SQLITE_CONSTRAINT: UNIQUE constraint failed: twin_equipment...` 뿐이라 **무엇이 잘못됐는지 아무도
+     * 알 수 없었다.** 원인은 그 모델에 설비 `load-1` 이 두 번 들어 있던 것이다(id 는 트윈 안에서 유일해야
+     * 한다). 조용히 하나만 남기지 않는다 — 그것은 모델링 오류를 감추는 일이고, 어느 쪽이 맞는지 우리는
+     * 모른다.
+     */
+    const dupOf = (list, what) => {
+        const seen = new Set();
+        for (const e of list ?? []) {
+            const id = String(e?.id ?? '');
+            if (!id)
+                continue;
+            if (seen.has(id))
+                return `twin "${instanceId}" has two ${what} with id "${id}" — ids must be unique within a twin, so the model cannot be projected`;
+            seen.add(id);
+        }
+        return undefined;
+    };
+    const dupMsg = dupOf(model?.locations, 'locations') ?? dupOf((0, twin_kernel_1.readBoardEquipment)(model), 'equipment');
+    if (dupMsg)
+        throw new Error(dupMsg);
+    const locRepo = (0, shell_1.getRepository)(twin_location_js_1.TwinLocation);
+    const eqRepo = (0, shell_1.getRepository)(twin_equipment_js_1.TwinEquipment);
+    const opRepo = (0, shell_1.getRepository)(twin_operation_js_1.TwinOperation);
+    const scope = { domain: { id: domainId }, instance: { id: instance.id } };
+    const ingestedAt = new Date();
+    /*
+     * 전량 교체 — 이 행들은 **원본에서 온 캐시**이므로 매번 그대로 다시 그린다.
+     * diff 로 아끼는 것은 "우리 쪽에 남겨야 할 것이 있다" 는 전제를 깔고, 그 전제가 소유 침범의 시작이다.
+     *
+     * **관측으로 자란 자원은 여기 쓰지 않는다.** 커널은 마스터에 없던 설비도 이벤트로 알게 되지만
+     * (`observed-reducer` 의 `origin: 'observed'`), 그것을 이 표에 밀어 넣으면 **쓰기 경로가 둘**이 되고
+     * 틱 루프에서 DB 로 쓰는 길이 생긴다(ADR-0032-D 위반). 그 차이는 **조회 시점에 비교해 보고**한다 —
+     * 숨겨야 할 불일치가 아니라 "원본이 모르는 설비가 실행 중이다" 는 사실이다.
+     */
+    await eqRepo.delete(scope);
+    await opRepo.delete(scope);
+    await locRepo.delete(scope);
+    /* 구역은 model 밖에 산다(호스트의 TwinArea). 이름으로 찾아 FK 를 잇는다. */
+    const areas = await (0, shell_1.getRepository)(twin_area_js_1.TwinArea).find({ where: { domain: { id: domainId } } });
+    const areaOf = new Map(areas.map(a => [a.areaId, a]));
+    const unresolvedArea = [];
+    /*
+     * ── 전기 상류를 「구역」으로 읽지 않는다 (2026-08-18) ────────────────────────
+     *
+     * 자리의 부모가 **다른 자리**일 수 있다(분기의 상류는 수전이다). 그 부모를 구역 표에서 찾으면 당연히
+     * 없고, 예전에는 그것을 매번 「구역이 이 트윈에 없다」로 경고했다 — 에너지 트윈을 인제스트할 때마다
+     * 분기 수만큼 거짓 경보가 났다. 경보가 소음이 되면 **사람이 경보 자체를 읽지 않게 된다.**
+     *
+     * 자리를 가리키는 부모는 계층(자리 ⊃ 자리)이고, 구역은 model 밖의 다른 표다. 그래서 부모가 이 모델의
+     * 자리이면 구역 해석을 **시도하지 않는다**(없는 것을 못 찾았다고 말하지 않는다).
+     */
+    const locationIds = new Set((model?.locations ?? []).filter((l) => l?.id).map((l) => String(l.id)));
+    const locations = (model?.locations ?? [])
+        .filter((l) => l?.id)
+        .map((l) => {
+        const parentIsLocation = l.parentId ? locationIds.has(String(l.parentId)) : false;
+        const area = l.parentId && !parentIsLocation ? areaOf.get(l.parentId) : undefined;
+        if (l.parentId && !parentIsLocation && !area)
+            unresolvedArea.push(`${l.id}→${l.parentId}`);
+        return locRepo.create({
+            ...scope,
+            locationId: l.id,
+            /* **이름을 옮긴다.** 버리고 있었다 — 그래서 화면에 자리 id 만 남았다(§name 주석 참조). */
+            name: l.name ?? null,
+            description: l.description ?? null,
+            type: l.type,
+            capacity: l.capacity ?? null,
+            parallelism: l.parallelism ?? null,
+            area: area ? { id: area.id } : null,
+            gs1Id: l.gs1Id ?? null,
+            /* 자리의 속성도 옮긴다 — 옮기지 않으면 계약전력·요금이 항목 패널에서 사라진다(조용한 누락). */
+            properties: l.properties ?? null,
+            sourceRef,
+            ingestedAt
+        });
+    });
+    const savedLocations = locations.length ? await locRepo.save(locations, { chunk: 500 }) : [];
+    const locOf = new Map(savedLocations.map(l => [l.locationId, l]));
+    const unresolvedHome = [];
+    const equipment = (model?.equipment ?? [])
+        .filter((m) => m?.id)
+        .map((m) => {
+        const home = m.homeLocation ? locOf.get(m.homeLocation) : undefined;
+        /* 끊어진 기준 자리는 **이름을 대고** 보고한다. 예전에는 화면이 경고할 뿐이었고
+           다른 경로로 들어온 데이터는 아무도 안 봤다. */
+        if (m.homeLocation && !home)
+            unresolvedHome.push(`${m.id}→${m.homeLocation}`);
+        return eqRepo.create({
+            ...scope,
+            equipmentId: m.id,
+            name: m.name ?? null,
+            description: m.description ?? null,
+            kind: m.kind,
+            /* 속성도 옮긴다 — 행에 자리가 없어 흘리고 있었다(소비처가 실제로 읽는 사실이다: 주행 속도). */
+            properties: m.properties ?? null,
+            /* 시험 참조도 함께 — 흘리면 명세 쪽에서 "누가 나를 가리키나" 에 이 설비가 빠진다. */
+            testSpecificationIds: m.testSpecificationIds ?? null,
+            /* 결과까지 — 참조만 있으면 "무엇으로 검증한다" 까지고, 자격 성립은 결과가 말한다. */
+            testResults: m.testResults ?? null,
+            homeLocation: home ? { id: home.id } : null,
+            mtbfMs: m.mtbfMs ?? null,
+            mttrMs: m.mttrMs ?? null,
+            gs1Id: m.gs1Id ?? null,
+            sourceRef,
+            ingestedAt
+        });
+    });
+    if (equipment.length)
+        await eqRepo.save(equipment, { chunk: 500 });
+    const operations = (model?.operations ?? [])
+        .filter((o) => o?.key)
+        .map((o, i) => opRepo.create({
+        ...scope,
+        operationKey: o.key,
+        /*
+         * 공정은 마스터가 `label` 로 말한다 — 행에서는 **규약의 이름 하나만** 둔다.
+         *
+         * 한동안 `label` 컬럼도 함께 남겨 뒀더니 조회 화면에 "이름" 열이 **두 개** 떴다(같은 값이
+         * 두 번). 어휘를 하나로 한다고 하면서 둘을 남기면 반드시 이렇게 새어 나온다.
+         */
+        name: o.name ?? o.label ?? null,
+        description: o.description ?? null,
+        intent: o.intent ?? null,
+        locationType: o.locationType ?? null,
+        resourceType: o.resourceType ?? null,
+        /* 소요시간은 ISO 8601 문자열이 정본 — 분으로 접으면 초가 조용히 사라진다. */
+        duration: o.duration ?? null,
+        variability: o.variability ?? null,
+        parameters: o.parameters ?? null,
+        /* **네 자원 명세를 함께 옮긴다.** 셋이 빠져 있어서 조회 화면이 "원본이 말한 값" 이라 적고도
+           넷 중 하나만 보였다 — 사람이 필요한 공정을 보고 사람이 필요 없다고 결론 내게 된다. */
+        personnelSpecification: o.personnelSpecification ?? null,
+        physicalAssetSpecification: o.physicalAssetSpecification ?? null,
+        materialSpecification: o.materialSpecification ?? null,
+        seq: i,
+        sourceRef,
+        ingestedAt
+    }));
+    if (operations.length)
+        await opRepo.save(operations, { chunk: 500 });
+    return {
+        locations: savedLocations.length,
+        equipment: equipment.length,
+        operations: operations.length,
+        unresolvedHome,
+        unresolvedArea
+    };
+}
+//# sourceMappingURL=project-structure.js.map

package/dist-server/service/twin-model/project-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-structure.js","sourceRoot":"","sources":["../../../server/service/twin-model/project-structure.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository } from '@things-factory/shell'\n\nimport { TwinInstance } from '../twin-instance/twin-instance.js'\nimport { TwinArea } from '../twin-space/twin-area.js'\nimport { TwinLocation } from './twin-location.js'\nimport { TwinEquipment } from './twin-equipment.js'\nimport { TwinOperation } from './twin-operation.js'\nimport { readBoardEquipment } from '@operato/twin-kernel'\n\n/*\n * 구조 투영 — `model`(커널 입력 문서) → **표준 엔티티 행**(ADR-0032).\n *\n * ── 왜 전량 교체인가 ────────────────────────────────────────────────────────\n * 이 행들은 **원본에서 온 캐시**다(ADR-0032-D). 원본이 진실이므로 diff 로 아끼는 것보다\n * **매번 그대로 다시 그리는 것**이 맞다 — diff 는 \"우리 쪽에 남겨야 할 것이 있다\" 는 전제를\n * 깔고, 그 전제가 소유 침범의 시작이다.\n *\n * 규모가 커지면 서명(`TwinStructure.signature`)이 같을 때 건너뛰는 장치가 이미 있으므로\n * 그것을 앞에 둔다. 여기서 diff 를 발명하지 않는다.\n *\n * ── 순서가 중요하다 ────────────────────────────────────────────────────────\n * 설비가 자리를 FK 로 가리키므로 **자리를 먼저** 넣는다. 지우는 것은 반대 순서다.\n * (자리 삭제 시 설비의 `homeLocation` 은 `SET NULL` 이지만, 전량 교체에서는 둘 다 지운다.)\n */\nexport interface ProjectionReport {\n  locations: number\n  equipment: number\n  operations: number\n  /** 자리를 못 찾아 기준 자리를 비운 설비 — **조용히 넘기지 않는다.** */\n  unresolvedHome: string[]\n  /** 구역을 못 찾아 비운 자리. 구역은 model 밖(호스트 개념)이라 어긋날 수 있다. */\n  unresolvedArea: string[]\n}\n\n/**\n * 이 트윈의 구조 행을 **원본 그대로 다시 그린다.**\n *\n * `sourceRef` 는 어느 원본에서 왔는지다(`ReferenceMaster.source` = instanceId). 없는 행은\n * 만들 수 없다 — 캐시라는 사실을 구조로 지킨다.\n */\nexport async function projectStructure(domainId: string, instanceId: string, model: any, sourceRef: string): Promise<ProjectionReport> {\n  const instance = await getRepository(TwinInstance).findOne({ where: { domain: { id: domainId }, instanceId } })\n  if (!instance) throw new Error(`cannot project structure: twin instance \"${instanceId}\" is not registered`)\n\n  /*\n   * **같은 id 가 둘이면 그 사실을 말한다** — 제약 위반 문구를 사용자에게 던지지 않는다.\n   *\n   * 실측(2026-08-18): 현장 값을 그 현장의 트윈 전부에 얹다가 한 트윈에서 투영이 터졌다. 올라온 것은\n   * `SQLITE_CONSTRAINT: UNIQUE constraint failed: twin_equipment...` 뿐이라 **무엇이 잘못됐는지 아무도\n   * 알 수 없었다.** 원인은 그 모델에 설비 `load-1` 이 두 번 들어 있던 것이다(id 는 트윈 안에서 유일해야\n   * 한다). 조용히 하나만 남기지 않는다 — 그것은 모델링 오류를 감추는 일이고, 어느 쪽이 맞는지 우리는\n   * 모른다.\n   */\n  const dupOf = (list: any[] | undefined, what: string): string | undefined => {\n    const seen = new Set<string>()\n    for (const e of list ?? []) {\n      const id = String(e?.id ?? '')\n      if (!id) continue\n      if (seen.has(id)) return `twin \"${instanceId}\" has two ${what} with id \"${id}\" — ids must be unique within a twin, so the model cannot be projected`\n      seen.add(id)\n    }\n    return undefined\n  }\n  const dupMsg = dupOf(model?.locations, 'locations') ?? dupOf(readBoardEquipment(model), 'equipment')\n  if (dupMsg) throw new Error(dupMsg)\n\n  const locRepo = getRepository(TwinLocation)\n  const eqRepo = getRepository(TwinEquipment)\n  const opRepo = getRepository(TwinOperation)\n  const scope = { domain: { id: domainId } as any, instance: { id: instance.id } as any }\n  const ingestedAt = new Date()\n\n  /*\n   * 전량 교체 — 이 행들은 **원본에서 온 캐시**이므로 매번 그대로 다시 그린다.\n   * diff 로 아끼는 것은 \"우리 쪽에 남겨야 할 것이 있다\" 는 전제를 깔고, 그 전제가 소유 침범의 시작이다.\n   *\n   * **관측으로 자란 자원은 여기 쓰지 않는다.** 커널은 마스터에 없던 설비도 이벤트로 알게 되지만\n   * (`observed-reducer` 의 `origin: 'observed'`), 그것을 이 표에 밀어 넣으면 **쓰기 경로가 둘**이 되고\n   * 틱 루프에서 DB 로 쓰는 길이 생긴다(ADR-0032-D 위반). 그 차이는 **조회 시점에 비교해 보고**한다 —\n   * 숨겨야 할 불일치가 아니라 \"원본이 모르는 설비가 실행 중이다\" 는 사실이다.\n   */\n  await eqRepo.delete(scope)\n  await opRepo.delete(scope)\n  await locRepo.delete(scope)\n\n  /* 구역은 model 밖에 산다(호스트의 TwinArea). 이름으로 찾아 FK 를 잇는다. */\n  const areas = await getRepository(TwinArea).find({ where: { domain: { id: domainId } as any } })\n  const areaOf = new Map(areas.map(a => [a.areaId, a]))\n  const unresolvedArea: string[] = []\n\n  /*\n   * ── 전기 상류를 「구역」으로 읽지 않는다 (2026-08-18) ────────────────────────\n   *\n   * 자리의 부모가 **다른 자리**일 수 있다(분기의 상류는 수전이다). 그 부모를 구역 표에서 찾으면 당연히\n   * 없고, 예전에는 그것을 매번 「구역이 이 트윈에 없다」로 경고했다 — 에너지 트윈을 인제스트할 때마다\n   * 분기 수만큼 거짓 경보가 났다. 경보가 소음이 되면 **사람이 경보 자체를 읽지 않게 된다.**\n   *\n   * 자리를 가리키는 부모는 계층(자리 ⊃ 자리)이고, 구역은 model 밖의 다른 표다. 그래서 부모가 이 모델의\n   * 자리이면 구역 해석을 **시도하지 않는다**(없는 것을 못 찾았다고 말하지 않는다).\n   */\n  const locationIds = new Set((model?.locations ?? []).filter((l: any) => l?.id).map((l: any) => String(l.id)))\n\n  const locations: TwinLocation[] = (model?.locations ?? [])\n    .filter((l: any) => l?.id)\n    .map((l: any) => {\n      const parentIsLocation = l.parentId ? locationIds.has(String(l.parentId)) : false\n      const area = l.parentId && !parentIsLocation ? areaOf.get(l.parentId) : undefined\n      if (l.parentId && !parentIsLocation && !area) unresolvedArea.push(`${l.id}→${l.parentId}`)\n      return locRepo.create({\n        ...scope,\n        locationId: l.id,\n        /* **이름을 옮긴다.** 버리고 있었다 — 그래서 화면에 자리 id 만 남았다(§name 주석 참조). */\n        name: l.name ?? null,\n        description: l.description ?? null,\n        type: l.type,\n        capacity: l.capacity ?? null,\n        parallelism: l.parallelism ?? null,\n        area: area ? ({ id: area.id } as any) : null,\n        gs1Id: l.gs1Id ?? null,\n        /* 자리의 속성도 옮긴다 — 옮기지 않으면 계약전력·요금이 항목 패널에서 사라진다(조용한 누락). */\n        properties: l.properties ?? null,\n        sourceRef,\n        ingestedAt\n      } as any)\n    })\n  const savedLocations = locations.length ? await locRepo.save(locations, { chunk: 500 }) : []\n  const locOf = new Map(savedLocations.map(l => [l.locationId, l]))\n\n  const unresolvedHome: string[] = []\n  const equipment: TwinEquipment[] = (model?.equipment ?? [])\n    .filter((m: any) => m?.id)\n    .map((m: any) => {\n      const home = m.homeLocation ? locOf.get(m.homeLocation) : undefined\n      /* 끊어진 기준 자리는 **이름을 대고** 보고한다. 예전에는 화면이 경고할 뿐이었고\n         다른 경로로 들어온 데이터는 아무도 안 봤다. */\n      if (m.homeLocation && !home) unresolvedHome.push(`${m.id}→${m.homeLocation}`)\n      return eqRepo.create({\n        ...scope,\n        equipmentId: m.id,\n        name: m.name ?? null,\n        description: m.description ?? null,\n        kind: m.kind,\n        /* 속성도 옮긴다 — 행에 자리가 없어 흘리고 있었다(소비처가 실제로 읽는 사실이다: 주행 속도). */\n        properties: m.properties ?? null,\n        /* 시험 참조도 함께 — 흘리면 명세 쪽에서 \"누가 나를 가리키나\" 에 이 설비가 빠진다. */\n        testSpecificationIds: m.testSpecificationIds ?? null,\n        /* 결과까지 — 참조만 있으면 \"무엇으로 검증한다\" 까지고, 자격 성립은 결과가 말한다. */\n        testResults: m.testResults ?? null,\n        homeLocation: home ? ({ id: home.id } as any) : null,\n        mtbfMs: m.mtbfMs ?? null,\n        mttrMs: m.mttrMs ?? null,\n        gs1Id: m.gs1Id ?? null,\n        sourceRef,\n        ingestedAt\n      } as any)\n    })\n  if (equipment.length) await eqRepo.save(equipment, { chunk: 500 })\n\n  const operations: TwinOperation[] = (model?.operations ?? [])\n    .filter((o: any) => o?.key)\n    .map((o: any, i: number) =>\n      opRepo.create({\n        ...scope,\n        operationKey: o.key,\n        /*\n         * 공정은 마스터가 `label` 로 말한다 — 행에서는 **규약의 이름 하나만** 둔다.\n         *\n         * 한동안 `label` 컬럼도 함께 남겨 뒀더니 조회 화면에 \"이름\" 열이 **두 개** 떴다(같은 값이\n         * 두 번). 어휘를 하나로 한다고 하면서 둘을 남기면 반드시 이렇게 새어 나온다.\n         */\n        name: o.name ?? o.label ?? null,\n        description: o.description ?? null,\n        intent: o.intent ?? null,\n        locationType: o.locationType ?? null,\n        resourceType: o.resourceType ?? null,\n        /* 소요시간은 ISO 8601 문자열이 정본 — 분으로 접으면 초가 조용히 사라진다. */\n        duration: o.duration ?? null,\n        variability: o.variability ?? null,\n        parameters: o.parameters ?? null,\n        /* **네 자원 명세를 함께 옮긴다.** 셋이 빠져 있어서 조회 화면이 \"원본이 말한 값\" 이라 적고도\n           넷 중 하나만 보였다 — 사람이 필요한 공정을 보고 사람이 필요 없다고 결론 내게 된다. */\n        personnelSpecification: o.personnelSpecification ?? null,\n        physicalAssetSpecification: o.physicalAssetSpecification ?? null,\n        materialSpecification: o.materialSpecification ?? null,\n        seq: i,\n        sourceRef,\n        ingestedAt\n      } as any)\n    )\n  if (operations.length) await opRepo.save(operations, { chunk: 500 })\n\n  return {\n    locations: savedLocations.length,\n    equipment: equipment.length,\n    operations: operations.length,\n    unresolvedHome,\n    unresolvedArea\n  }\n}\n"]}

package/dist-server/service/twin-model/standard-coverage.d.ts

@@ -0,0 +1,9 @@
+/** 우리가 적합성 표를 가진 표준들. */
+export type StandardId = 'isa95' | 'epcis' | 'iec61850';
+/**
+ * 이 종류의 트윈이 기대는 표준 — **순서 = 화면에 놓이는 순서.**
+ *
+ * ISA-95 는 종류와 상관없이 낸다: 자원과 계층은 어느 도메인에서나 그 표준의 것이다.
+ * 종류가 더하는 표준만 뒤에 붙인다.
+ */
+export declare function standardsForKind(kind?: string): StandardId[];

package/dist-server/service/twin-model/standard-coverage.js

@@ -0,0 +1,37 @@
+"use strict";
+/*
+ * 이 트윈이 기대는 **표준들** — 종류에 따라 다르다.
+ *
+ * 적합성 패널이 트윈 종류와 무관하게 ISA-95 하나만 말하고 있었다. 에너지 트윈에서 그것은 거짓은
+ * 아니지만 부족하다: 계량기·차단기·태양광·축전지의 어휘를 주는 것은 IEC 61850 이고, 무엇이 비었는지도
+ * 그 목록으로만 셀 수 있다.
+ *
+ * ── 여기 넣지 않는 것 ───────────────────────────────────────────────────────
+ * ISO 50001·ISO 55000 은 **경영 시스템**이다. 데이터 스키마가 아니라 요구사항에 답해야 하는 대상이라
+ * 「필드 커버리지」로 말할 수 없다 — 배우기 문서가 같은 구분을 지키고 있고, 화면도 그래야 한다.
+ *
+ * ── 왜 표를 여기서 부르지 않나 ──────────────────────────────────────────────
+ * 이 파일은 **정책**만 담는다(어느 종류가 어느 표준을 기대하나). 표를 직접 불러오면 그 순간 이 규칙을
+ * 단위 시험이 불러올 수 없게 된다(모듈 사슬이 런타임 해석을 탄다). 조립은 질의가 한 줄로 한다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.standardsForKind = standardsForKind;
+/**
+ * 이 종류의 트윈이 기대는 표준 — **순서 = 화면에 놓이는 순서.**
+ *
+ * ISA-95 는 종류와 상관없이 낸다: 자원과 계층은 어느 도메인에서나 그 표준의 것이다.
+ * 종류가 더하는 표준만 뒤에 붙인다.
+ */
+function standardsForKind(kind) {
+    /*
+     * 물류·제조는 **EPCIS** 로 「무슨 일이 있었나」와 「이 번호가 무엇을 가리키나」를 정한다.
+     * 에너지에는 붙이지 않는다 — 그 트윈에는 오가는 물건이 없고, 계측은 EPCIS 사건이 아니라 표본으로
+     * 들어온다(사건과 시계열은 다른 층이다).
+     */
+    if (kind === 'ems')
+        return ['isa95', 'iec61850'];
+    if (kind === 'wms' || kind === 'yms' || kind === 'mes')
+        return ['isa95', 'epcis'];
+    return ['isa95'];
+}
+//# sourceMappingURL=standard-coverage.js.map

package/dist-server/service/twin-model/standard-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-coverage.js","sourceRoot":"","sources":["../../../server/service/twin-model/standard-coverage.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAWH,4CASC;AAfD;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,IAAa;IAC5C;;;;OAIG;IACH,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IAChD,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACjF,OAAO,CAAC,OAAO,CAAC,CAAA;AAClB,CAAC","sourcesContent":["/*\n * 이 트윈이 기대는 **표준들** — 종류에 따라 다르다.\n *\n * 적합성 패널이 트윈 종류와 무관하게 ISA-95 하나만 말하고 있었다. 에너지 트윈에서 그것은 거짓은\n * 아니지만 부족하다: 계량기·차단기·태양광·축전지의 어휘를 주는 것은 IEC 61850 이고, 무엇이 비었는지도\n * 그 목록으로만 셀 수 있다.\n *\n * ── 여기 넣지 않는 것 ───────────────────────────────────────────────────────\n * ISO 50001·ISO 55000 은 **경영 시스템**이다. 데이터 스키마가 아니라 요구사항에 답해야 하는 대상이라\n * 「필드 커버리지」로 말할 수 없다 — 배우기 문서가 같은 구분을 지키고 있고, 화면도 그래야 한다.\n *\n * ── 왜 표를 여기서 부르지 않나 ──────────────────────────────────────────────\n * 이 파일은 **정책**만 담는다(어느 종류가 어느 표준을 기대하나). 표를 직접 불러오면 그 순간 이 규칙을\n * 단위 시험이 불러올 수 없게 된다(모듈 사슬이 런타임 해석을 탄다). 조립은 질의가 한 줄로 한다.\n */\n\n/** 우리가 적합성 표를 가진 표준들. */\nexport type StandardId = 'isa95' | 'epcis' | 'iec61850'\n\n/**\n * 이 종류의 트윈이 기대는 표준 — **순서 = 화면에 놓이는 순서.**\n *\n * ISA-95 는 종류와 상관없이 낸다: 자원과 계층은 어느 도메인에서나 그 표준의 것이다.\n * 종류가 더하는 표준만 뒤에 붙인다.\n */\nexport function standardsForKind(kind?: string): StandardId[] {\n  /*\n   * 물류·제조는 **EPCIS** 로 「무슨 일이 있었나」와 「이 번호가 무엇을 가리키나」를 정한다.\n   * 에너지에는 붙이지 않는다 — 그 트윈에는 오가는 물건이 없고, 계측은 EPCIS 사건이 아니라 표본으로\n   * 들어온다(사건과 시계열은 다른 층이다).\n   */\n  if (kind === 'ems') return ['isa95', 'iec61850']\n  if (kind === 'wms' || kind === 'yms' || kind === 'mes') return ['isa95', 'epcis']\n  return ['isa95']\n}\n"]}