@things-factory/headless-twin 10.0.8 → 10.0.10

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

@@ -1,15 +1,17 @@
 "use strict";
 /*
  * Face2 마스터 인제스트(ADR-0018 반영 모드) — 레퍼런스 시스템(실 WMS/YMS/MES 또는 가상 레퍼런스)의
- * 마스터를 읽어 트윈 구조(BoardDef) + 공간(Space content)을 생성. 손배선이 아니라 인제스트로 엔티티가 흐른다.
+ * 마스터를 읽어 트윈 구조(TwinModelDef) + 공간(Space content)을 생성. 손배선이 아니라 인제스트로 엔티티가 흐른다.
  *
  * 규율(ADR-0018): 도메인 타입(location.type=노드용)은 커널 카탈로그 어휘를 그대로 반영(발명 금지).
- * location 은 role 로 노드(운영점)·area(공간영역)·both 를 구분 — 노드→BoardDef, area→Space.areas.
+ * location 은 role 로 노드(운영점)·area(공간영역)·both 를 구분 — 노드→TwinModelDef, area→Space.areas.
  * 좌표·representations 는 트윈 공간층(보완/추가). 실 시스템이 좌표를 안 주면 layout 없이 위상만 인제스트.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.siteEquipmentAdopted = exports.knobDefaultsFilled = exports.describeWarnings = exports.connectorMappingFallback = exports.structureAdopted = exports.projectionFailed = exports.unresolvedReference = exports.noViewableRepresentation = exports.operationWithoutDuration = exports.unknownTimezone = exports.unknownLocationType = exports.generationWithoutTimeZone = void 0;
 exports.utcOffsetOf = utcOffsetOf;
 exports.masterToTwin = masterToTwin;
+exports.pickOriginSite = pickOriginSite;
 /**
  * 마스터 → 트윈 구조 매핑(순수). 노드타입을 카탈로그로 검증(모르는 타입은 warning, 버리진 않음 — 반영 우선).
  * @param catalog DOMAIN_CATALOG (커널 SSOT). 없으면 검증 생략.
@@ -21,7 +23,7 @@ exports.masterToTwin = masterToTwin;
  * 값이다. 그래서 8월의 `America/Tijuana` 는 −420(PDT), 1월은 −480(PST)이 된다.
  *
  * **한계를 밝힌다**: 여기서 나오는 것은 **한 시점의** 오프셋이다. 커널은 고정 오프셋으로 하루 중 분을
- * 읽으므로, 보드를 만든 계절과 다른 계절을 길게 예측하면 한 시간 어긋난다. 표준에 충실한 끝 모습은
+ * 읽으므로, 모델을 만든 계절과 다른 계절을 길게 예측하면 한 시간 어긋난다. 표준에 충실한 끝 모습은
  * 호스트가 절대 구간(`StartDateTime`/`FinishDateTime`)을 계산해 넣는 것이고, 그때 이 함수는 사라진다.
  *
  * 모르는 이름에는 **0 을 답하지 않는다**(`undefined`) — 0 은 "UTC 라고 선언했다" 는 뜻이고, 모르는 것을
@@ -45,19 +47,158 @@ function utcOffsetOf(timezone, at = new Date()) {
         return undefined; // 알 수 없는 이름 — Intl 이 던진다
     }
 }
+/**
+ * **시각을 모르는 채 시각으로 판정하려 한다** — 발전 형상은 하루의 시각을 읽는데 이 트윈의 공간이
+ * 시간대를 말하지 않았다.
+ *
+ * ── 왜 경고인가 (2026-08-18) ────────────────────────────────────────────────
+ * 커널은 시간대를 모르면 UTC 로 읽는다(계약에 밝혀 둔 규율 — 모르는 값을 지어내지 않는다). 그런데 발전
+ * 형상은 **시각별 비율**이라, 시간대가 없으면 현장 정오가 아니라 UTC 정오에 피크가 선다(KST 현장이면
+ * 밤 9시). 값이 그럴듯하게 나오므로 아무도 알아채지 못한다.
+ *
+ * 그래서 시간대를 **지어내지 않고**(서버 로컬이나 임의 기본값을 넣으면 그 트윈의 모든 시각 판정이 조용히
+ * 그 가정 위에 선다) 대신 **그 조합을 말한다** — 공간에 시간대를 선언하면 사라지는 경고다.
+ */
+const generationWithoutTimeZone = (spaceId, equipmentId) => ({
+    code: 'generation-without-time-zone',
+    params: { spaceId, equipmentId },
+    message: `"${equipmentId}" declares a daily generation shape but space "${spaceId}" declares no time zone — the hourly fractions will be read in UTC, ` +
+        'so the generation peak will not land at local noon. Declare the space time zone (we do not guess one).'
+});
+exports.generationWithoutTimeZone = generationWithoutTimeZone;
+/** 커널 카탈로그가 모르는 자리 타입 — 그 자리는 흐름에 참여하지 못할 수 있다. */
+const unknownLocationType = (system, type, id) => ({
+    code: 'unknown-location-type',
+    params: { system, type, id },
+    message: `"${type}" is not a known ${system} location type (${id}) — the kernel may not include this location in the flow`
+});
+exports.unknownLocationType = unknownLocationType;
+/** 시간대 문자열을 못 읽었다 — 시각 해석이 UTC 로 떨어진다(조용히 현지 시각으로 가정하지 않는다). */
+const unknownTimezone = (timezone) => ({
+    code: 'unknown-timezone',
+    params: { timezone },
+    message: `space timezone "${timezone}" is not a known IANA zone — the twin will read times as UTC`
+});
+exports.unknownTimezone = unknownTimezone;
+/** 작업 정의에 소요시간·파라미터가 없다 — 커널 기본값으로 동작한다. */
+const operationWithoutDuration = (operation) => ({
+    code: 'operation-without-duration',
+    params: { operation },
+    message: `operation "${operation}" has no duration or parameters — kernel defaults will be used`
+});
+exports.operationWithoutDuration = operationWithoutDuration;
+/** 볼 수 있는 표현이 없다 — 현장이 화면에 뜨지 않는다. */
+const noViewableRepresentation = () => ({
+    code: 'no-viewable-representation',
+    message: 'the space has no viewable representation (no representations and no geo) — add one, or provide geo/board'
+});
+exports.noViewableRepresentation = noViewableRepresentation;
+/**
+ * 구조 투영에서 **가리키는 대상을 못 찾았다.**
+ *
+ * 예전에는 이런 참조가 model JSON 안의 맨 문자열이라 화면만 경고할 수 있었고, 다른 경로로 들어온
+ * 데이터는 아무도 안 봤다. 이제 행으로 풀면서 **인제스트가 직접 안다** — 그러니 인제스트가 말한다.
+ * 막지는 않는다(트윈은 model 로 이미 동작한다). 다만 조용히 넘기지 않는다.
+ */
+const unresolvedReference = (field, ref) => ({
+    code: 'unresolved-reference',
+    params: { field, ref },
+    message: `${field} points at something that is not in this twin (${ref}) — the link was left empty`
+});
+exports.unresolvedReference = unresolvedReference;
+/**
+ * 구조 투영 자체가 실패했다 — 조회는 못 하지만 **트윈은 동작한다**(커널은 model 를 이미 받았다).
+ * 행은 원본에서 다시 그릴 수 있으므로 인제스트를 실패로 만들지 않되, 침묵하지도 않는다.
+ */
+const projectionFailed = (reason) => ({
+    code: 'projection-failed',
+    params: { reason },
+    message: `structure projection failed (${reason}) — the twin runs, but model inspection will be stale until the next ingest`
+});
+exports.projectionFailed = projectionFailed;
+/**
+ * **동작 중에 공장을 전환했다** — 미러는 멈추지 않으므로, 무엇이 사라졌는지 여기서 말한다.
+ *
+ * 멈췄다 세우는 구조 전환이라면 사용자가 "다시 세웠다" 는 것을 안다. 미러는 그 마디가 없어서
+ * 자리 하나·설비 한 대가 조용히 없어질 수 있다 — 자리가 수천인 현장에서 화면의 수를 세어
+ * 눈치채기를 기대할 수는 없다. 늘어난 것도 함께 말한다(무엇이 반영되었나가 곧 인제스트의 답이다).
+ */
+const structureAdopted = (rev, shift) => ({
+    code: 'structure-adopted',
+    params: { rev, ...shift },
+    message: `the running mirror adopted a new structure (revision ${rev}) — ` +
+        `+${shift.locationsAdded} location(s), -${shift.locationsDropped} location(s), ` +
+        `-${shift.equipmentDropped} equipment, -${shift.personsDropped} person(s), -${shift.assetsDropped} asset(s)`
+});
+exports.structureAdopted = structureAdopted;
+/**
+ * 커넥터가 외부 시스템의 값을 **우리 어휘로 옮기지 못해 기본값을 넣었다.**
+ *
+ * 예: Oracle WMS 가 우리 표에 없는 `locn_type` 을 주면 그 자리는 `storage` 가 된다 — 도크가 랙으로
+ * 모델링되는 것이다. 인제스트를 통째로 실패시킬 일은 아니지만(로케이션 하나 때문에 현장 전체가
+ * 안 들어오는 편이 더 나쁘다), **조용히 넘어가면 안 된다.** 트윈이 실물과 다르게 생겼는데
+ * 아무도 그 사실을 모른 채 그 위에서 흐름을 논하게 된다.
+ *
+ * 값을 나열하는 이유: "3건" 만으로는 커넥터 매핑에 무엇을 더해야 하는지 알 수 없다.
+ */
+const connectorMappingFallback = (field, fallback, values, count) => ({
+    code: 'connector-mapping-fallback',
+    params: { field, fallback, values: values.join(', '), count },
+    message: `${count} ${field} value(s) had no mapping and fell back to "${fallback}" (${values.join(', ')}) — the twin's shape differs from the source system here`
+});
+exports.connectorMappingFallback = connectorMappingFallback;
+/** 로그 한 줄 — 개발자가 읽는 것이므로 영어 canonical 문장을 쓴다. */
+const describeWarnings = (warnings) => warnings.map(w => `${w.code}: ${w.message}`).join(' | ');
+exports.describeWarnings = describeWarnings;
+/**
+ * 서버가 기본값으로 채운 노브들 — 사용자가 준 적 없는 값으로 트윈이 만들어졌음을 알린다.
+ *
+ * 조용히 채우면 나중에 "왜 이 수치인가" 를 아무도 답할 수 없다. 막을 일은 아니다(기본값은 템플릿이
+ * 확신을 갖고 선언한 값이다) — 다만 밝힌다.
+ */
+const knobDefaultsFilled = (keys) => ({
+    code: 'knob-defaults-filled',
+    params: { keys: keys.join(', '), count: keys.length },
+    message: `values you did not provide were filled from the template defaults: ${keys.join(', ')}`
+});
+exports.knobDefaultsFilled = knobDefaultsFilled;
+/**
+ * 이 현장의 설비를 노브 값으로 채웠다 — **조용히 채우지 않는다.**
+ *
+ * 에너지 트윈의 부하를 이웃 설비 id 로 선언할 때 쓴다. 몇 개를 가져왔는지 말해 주지 않으면, 사용자는
+ * 자기가 고르지 않은 설비들이 부하로 잡힌 것을 나중에 화면에서야 알게 된다.
+ */
+const siteEquipmentAdopted = (key, count) => ({
+    code: 'site-equipment-adopted',
+    params: { key, count },
+    message: `${count} piece(s) of equipment already on this site were adopted as loads (knob "${key}") — set their coefficients before trusting the numbers`
+});
+exports.siteEquipmentAdopted = siteEquipmentAdopted;
 function masterToTwin(master, catalog) {
-    const warnings = [];
+    /* 커넥터가 옮기며 알게 된 것을 먼저 싣는다 — 원인이 앞에 오는 편이 읽기 쉽다(대체가 먼저, 그 결과가 뒤). */
+    const warnings = [...(master.warnings ?? [])];
     const known = catalog?.[master.system]?.locationTypes ?? [];
     const locationEntries = master.locations.filter(l => l.role === 'location' || l.role === 'both');
     const areaLocs = master.locations.filter(l => l.role === 'area' || l.role === 'both');
     const locations = locationEntries.map(l => {
         if (known.length && !known.includes(l.type))
-            warnings.push(`unknown ${master.system} location type "${l.type}" (${l.id}) — 카탈로그에 없음`);
-        // gs1Id(정식 정체성)를 보드 노드로 통과 — 결합(tag)/추적이 GS1 로(§J). 로컬 id 는 그대로 유지(name/xref).
-        return { id: l.id, type: l.type, capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), parentId: l.parentId, gs1Id: l.gs1Id };
+            warnings.push((0, exports.unknownLocationType)(master.system, l.type, l.id));
+        // gs1Id(정식 정체성)를 모델의 자리로 통과 — 결합(tag)/추적이 GS1 로(§J). 로컬 id 는 그대로 유지(name/xref).
+        /*
+         * **이름을 통과시킨다.** 여기서 버리고 있었다 — 그래서 모델에도, 투영한 행에도 이름이 없고
+         * 화면은 자리 id 를 그대로 찍었다(`cut-station`). 목록·표·관계 그림에서 같은 결함이 따로
+         * 보였던 이유가 이 한 줄이다. 이름 없는 원본은 이름 없이 통과한다(id 로 메우지 않는다).
+         */
+        /*
+         * **속성도 통과시킨다** — 설비와 같은 규율(손대지 않고 나른다). 여기가 없으면 자리에 실은 값이
+         * 커널에 닿지 않는다: 에너지의 계약전력(`contract.kW`)이 그 경로이고, 통과하지 않으면 커널이
+         * 계약을 모르는 채로 서서 **판정을 아예 하지 않는다**(오류 없이 조용히).
+         */
+        return { id: l.id, type: l.type, ...(l.name ? { name: l.name } : {}), ...(l.description ? { description: l.description } : {}), capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), ...(l.properties?.length ? { properties: l.properties } : {}), parentId: l.parentId, ...(l.upstreamId ? { upstreamId: l.upstreamId } : {}), gs1Id: l.gs1Id };
     });
     const equipment = (master.equipment ?? []).map(e => ({
-        id: e.id, kind: e.kind, homeLocation: e.homeLocationId, mtbfMs: e.mtbfMs, mttrMs: e.mttrMs, gs1Id: e.gs1Id,
+        id: e.id, kind: e.kind, ...(e.name ? { name: e.name } : {}), ...(e.description ? { description: e.description } : {}), ...(e.testResults?.length ? { testResults: e.testResults } : {}),
+        homeLocation: e.homeLocationId, mtbfMs: e.mtbfMs, mttrMs: e.mttrMs, gs1Id: e.gs1Id,
         ...(e.window ? { window: e.window } : {}),
         /* 속성은 손대지 않고 통과 — 이동시간 추정기가 kind 별 속도를 여기서 읽는다(단위 코드 그대로). */
         ...(e.properties?.length ? { properties: e.properties } : {}), ...(e.workCalendar?.length ? { workCalendar: e.workCalendar } : {}), ...(e.testSpecificationIds?.length ? { testSpecificationIds: e.testSpecificationIds } : {}),
@@ -72,56 +213,82 @@ function masterToTwin(master, catalog) {
     const spaceId = master.space.spaceId ?? `${master.source}-site`;
     /*
      * 시각 기준을 커널이 읽을 형태로 푼다 — 커널은 zero-dep 이라 시간대 데이터베이스를 들이지 않고
-     * **분 오프셋**만 받는다(계약 `BoardDef.utcOffsetMinutes`). 푸는 일은 호스트의 몫이다.
+     * **분 오프셋**만 받는다(계약 `TwinModelDef.utcOffsetMinutes`). 푸는 일은 호스트의 몫이다.
      *
      * 선언이 없으면 **필드를 만들지 않는다** — 그러면 커널이 UTC 로 읽고, 그 기본값은 계약에 밝혀져 있다.
      * 여기서 0 을 넣으면 "UTC 라고 선언했다" 와 "선언하지 않았다" 가 구별되지 않는다.
      */
     const utcOffsetMinutes = utcOffsetOf(master.space.timezone);
     if (master.space.timezone && utcOffsetMinutes === undefined) {
-        warnings.push(`space timezone "${master.space.timezone}" is not a known IANA zone — the twin will read times as UTC`);
+        warnings.push((0, exports.unknownTimezone)(String(master.space.timezone)));
     }
     /*
-     * 오퍼레이션 명세를 board 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(BoardDef 확장 필드,
+     * 오퍼레이션 명세를 model 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(TwinModelDef 확장 필드,
      * 모르는 커널은 무시). 여기서 값을 손대지 않는다: 기간은 표준 표기(ISO 8601)로 커널까지 그대로 간다.
      */
     const operations = master.operations;
     if (operations?.length) {
         for (const o of operations) {
             if (!o.duration && !o.parameters?.length)
-                warnings.push(`operation "${o.key}" has no duration or parameters — kernel defaults will be used`);
+                warnings.push((0, exports.operationWithoutDuration)(o.key));
         }
     }
     /* 사람도 손대지 않고 통과 — 등급·교대 그대로 커널까지 간다(경계에서 어휘를 갈지 않는다). */
-    const persons = master.persons?.map(p => ({ id: p.id, personnelClassIds: p.personnelClassIds, ...(p.window ? { window: p.window } : {}), ...(p.workCalendar?.length ? { workCalendar: p.workCalendar } : {}), ...(p.homeLocationId ? { homeLocation: p.homeLocationId } : {}), ...(p.properties?.length ? { properties: p.properties } : {}), ...(p.testSpecificationIds?.length ? { testSpecificationIds: p.testSpecificationIds } : {}), ...(p.effectiveStart ? { effectiveStart: p.effectiveStart } : {}), ...(p.effectiveEnd ? { effectiveEnd: p.effectiveEnd } : {}) }));
+    const persons = master.persons?.map(p => ({ id: p.id, ...(p.name ? { name: p.name } : {}), ...(p.testResults?.length ? { testResults: p.testResults } : {}), personnelClassIds: p.personnelClassIds, ...(p.window ? { window: p.window } : {}), ...(p.workCalendar?.length ? { workCalendar: p.workCalendar } : {}), ...(p.homeLocationId ? { homeLocation: p.homeLocationId } : {}), ...(p.properties?.length ? { properties: p.properties } : {}), ...(p.testSpecificationIds?.length ? { testSpecificationIds: p.testSpecificationIds } : {}), ...(p.effectiveStart ? { effectiveStart: p.effectiveStart } : {}), ...(p.effectiveEnd ? { effectiveEnd: p.effectiveEnd } : {}) }));
     /* 자산도 손대지 않고 통과 — 등급·자리 그대로 커널까지. */
-    const assets = master.assets?.map(a => ({ id: a.id, assetClassIds: a.assetClassIds, homeLocation: a.homeLocationId, gs1Id: a.gs1Id, ...(a.properties?.length ? { properties: a.properties } : {}), ...(a.testSpecificationIds?.length ? { testSpecificationIds: a.testSpecificationIds } : {}), ...(a.effectiveStart ? { effectiveStart: a.effectiveStart } : {}), ...(a.effectiveEnd ? { effectiveEnd: a.effectiveEnd } : {}) }));
+    const assets = master.assets?.map(a => ({ id: a.id, ...(a.name ? { name: a.name } : {}), ...(a.testResults?.length ? { testResults: a.testResults } : {}), assetClassIds: a.assetClassIds, homeLocation: a.homeLocationId, gs1Id: a.gs1Id, ...(a.properties?.length ? { properties: a.properties } : {}), ...(a.testSpecificationIds?.length ? { testSpecificationIds: a.testSpecificationIds } : {}), ...(a.effectiveStart ? { effectiveStart: a.effectiveStart } : {}), ...(a.effectiveEnd ? { effectiveEnd: a.effectiveEnd } : {}) }));
     /* 품목 정의·등급도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(환산 계수는 커널이 읽는다). */
     const materialDefinitions = master.materialDefinitions?.map(d => ({
         id: d.id,
-        ...(d.name ? { description: d.name } : {}),
+        /* 이름은 이름 자리에 — 예전에는 `name` 을 `description` 으로 옮겨 담았다(어휘가 뒤집혀 있었다). */
+        ...(d.name ? { name: d.name } : {}),
         ...(d.materialClassIds?.length ? { materialClassIds: d.materialClassIds } : {}),
         ...(d.properties?.length ? { properties: d.properties } : {}),
         ...(d.testSpecificationIds?.length ? { testSpecificationIds: d.testSpecificationIds } : {}),
         ...(d.effectiveStart ? { effectiveStart: d.effectiveStart } : {}),
         ...(d.effectiveEnd ? { effectiveEnd: d.effectiveEnd } : {})
     }));
-    const board = {
+    /*
+     * **등급의 표시명은 `name` 이다.**
+     *
+     * 표준 마스터는 등급의 표시명을 `description` 에 담는다(`RefResourceClass.description` = i18n 키).
+     * 그것을 그대로 모델에 실으면 화면의 "설명" 열에 이름이 앉는다 — 사용자에게는 이름인데 머리글은
+     * 설명이라, 같은 것을 축마다 다른 이름으로 부르게 된다.
+     *
+     * 그래서 **문 하나에서 어휘를 맞춘다**: 표시명은 어느 축이든 `name`. 원래의 `description` 은
+     * 남겨 두지 않는다 — 두 자리에 같은 값이 있으면 어느 것이 정본인지 다시 헷갈린다.
+     */
+    const asName = (list) => list?.map(({ description, ...rest }) => ({ ...rest, ...(description ? { name: description } : {}) }));
+    /*
+     * 검사 명세도 **표시명은 `name`** 이다 — 등급과 같은 규칙을 쓴다(어휘를 하나로). 표준 마스터는
+     * 표시명을 `description` 에 담으므로 문 하나에서 옮긴다. 그러지 않으면 화면의 "설명" 열에 이름이
+     * 앉아 축마다 다른 이름으로 같은 것을 부르게 된다(등급에서 이미 겪었다).
+     */
+    const testSpecifications = master.testSpecifications?.map(({ description, ...rest }) => ({
+        ...rest,
+        ...(description ? { name: description } : {})
+    }));
+    const personnelClasses = asName(master.personnelClasses);
+    const equipmentClasses = asName(master.equipmentClasses);
+    const assetClasses = asName(master.assetClasses);
+    const materialClasses = asName(master.materialClasses);
+    const model = {
         locations, equipment, layout, spaceId,
         /* 생산 정의도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(커널이 그대로 소비한다). */
-        ...(master.mesSpec ? { mesSpec: master.mesSpec } : {}),
+        ...(master.productionSpec ? { productionSpec: master.productionSpec } : {}),
         ...(materialDefinitions?.length ? { materialDefinitions } : {}),
-        ...(master.materialClasses?.length ? { materialClasses: master.materialClasses } : {}),
+        ...(materialClasses?.length ? { materialClasses } : {}),
         ...(utcOffsetMinutes !== undefined ? { utcOffsetMinutes } : {}),
         ...(operations?.length ? { operations } : {}),
-        ...(master.personnelClasses?.length ? { personnelClasses: master.personnelClasses } : {}),
-        ...(master.equipmentClasses?.length ? { equipmentClasses: master.equipmentClasses } : {}),
-        ...(master.assetClasses?.length ? { assetClasses: master.assetClasses } : {}),
+        ...(testSpecifications?.length ? { testSpecifications } : {}),
+        ...(personnelClasses?.length ? { personnelClasses } : {}),
+        ...(equipmentClasses?.length ? { equipmentClasses } : {}),
+        ...(assetClasses?.length ? { assetClasses } : {}),
         ...(persons?.length ? { persons } : {}),
         ...(assets?.length ? { assets } : {})
     };
     const areas = areaLocs.map(l => ({
-        id: l.id, type: l.type, name: l.name ?? l.id, parentId: l.parentId,
+        id: l.id, type: l.type, name: l.name ?? l.id, parentId: l.parentId, ...(l.upstreamId ? { upstreamId: l.upstreamId } : {}),
         x: l.footprint?.x ?? 0, y: l.footprint?.y ?? 0, w: l.footprint?.w ?? 10, h: l.footprint?.h ?? 10
     }));
     // 인제스트 현장 물질화(space facet #4) — 표현이 없고 geo 가 있으면 기본 map 표현 합성.
@@ -135,13 +302,27 @@ function masterToTwin(master, catalog) {
             ? [{ id: 'r-map', type: 'map', name: '위성 지도', primary: true, center: { lat: geo.lat, lon: geo.lon }, zoom: 17 }]
             : [];
     if (representations.length === 0) {
-        warnings.push('space has no viewable representation (no representations and no geo) — add one manually or provide geo/board');
+        warnings.push((0, exports.noViewableRepresentation)());
     }
     const spaceContent = {
         width: master.space.width, depth: master.space.depth, unit: master.space.unit ?? 'm',
         geo, representations, primaryId: master.space.primaryId ?? representations[0]?.id,
-        areas, landmarks: []
+        areas
     };
-    return { board, spaceContent, warnings };
+    return { model, spaceContent, warnings };
+}
+/**
+ * 다시 읽을 사이트를 고른다 — **기억해 둔 사이트 하나만**.
+ *
+ * 못 찾으면 **첫 사이트로 때우지 않는다**: 다른 현장의 구조를 이 트윈에 덮어쓰는 일이고, 그것은 오류가
+ * 아니라 **조용히 틀린 공장**으로 나타난다. 기억이 없는 옛 트윈은 `undefined` 를 돌려주고, 부르는 쪽이
+ * 마스터의 정체(`source` = 인스턴스 id)로 찾는 길을 택한다.
+ */
+function pickOriginSite(sites, origin) {
+    const wanted = String(origin?.siteId ?? '').trim();
+    if (!wanted)
+        return { reason: 'no-remembered-site' };
+    const site = sites.find(s => String(s.siteId) === wanted);
+    return site ? { site } : { reason: 'site-gone' };
 }
 //# sourceMappingURL=reference-master.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"reference-master.js","sourceRoot":"","sources":["../../../server/service/reference/reference-master.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Face2 마스터 인제스트(ADR-0018 반영 모드) — 레퍼런스 시스템(실 WMS/YMS/MES 또는 가상 레퍼런스)의\n * 마스터를 읽어 트윈 구조(BoardDef) + 공간(Space content)을 생성. 손배선이 아니라 인제스트로 엔티티가 흐른다.\n *\n * 규율(ADR-0018): 도메인 타입(location.type=노드용)은 커널 카탈로그 어휘를 그대로 반영(발명 금지).\n * location 은 role 로 노드(운영점)·area(공간영역)·both 를 구분 — 노드→BoardDef, area→Space.areas.\n * 좌표·representations 는 트윈 공간층(보완/추가). 실 시스템이 좌표를 안 주면 layout 없이 위상만 인제스트.\n */\n\nimport type { EquipmentLevel, WorkCalendarEntry } from '@operato/twin-kernel'\n\nexport interface RefLocation {\n  id: string\n  type: string // 노드는 커널 노드타입(dock/storage/yard-slot…), area 는 공간 region 타입\n  name?: string\n  role: 'location' | 'area' | 'both'\n  parentId?: string\n  /** 저장 용량 — 이 자리에 동시에 놓일 수 있는 물품 수. */\n  capacity?: number\n  /**\n   * 동시 처리 수 — 이 자리에서 한 번에 진행될 수 있는 작업 수. **저장 용량과 다른 축**이다\n   * (자재를 20개 쌓아 두는 절단 스테이션이 한 번에 한 대만 깎는다). 미지정=제약 없음.\n   */\n  parallelism?: number\n  /**\n   * **ISA-95 설비 계층 단계** — `EquipmentLevel` 열거값(`ProductionLine`·`StorageZone`·`WorkCenter`…).\n   *\n   * `type` 은 현장의 낱말(`paint-booth`)이고 이것은 **표준이 정한 역할**이다. 둘은 다른 축이라 함께 든다 —\n   * 연동·집계는 표준 축으로, 화면은 현장 낱말로. 미지정이면 그 자리의 표준 역할을 아직 모른다는 뜻이고,\n   * 짐작해 채우지 않는다.\n   */\n  level?: EquipmentLevel\n  footprint?: { x: number; y: number; w: number; h: number } // 있으면 area 기하 + 노드 중심좌표\n  gs1Id?: string // 정식 GS1 정체성(§J) — 위치=SGLN. 결합(tag)/추적 canonical id. 받아들이기 경계서 부여(로컬 id=name/xref 로 보존).\n}\n\n/**\n * 설비 속성 — **ISA-95 `EquipmentSpecificationProperty`(`OpEquipmentSpecificationPropertyType`) 1:1.**\n * 그 타입도 `ID` + `Value`(`ValueString`·`DataType`·`UnitOfMeasure`) 이므로 공정 모수와 같은 모양이다.\n *\n * 단위 코드는 **UN/CEFACT 권고 20 공통코드**(EPCIS `uom` 과 같은 코드계): 속도는 `MTS`(metre per\n * second) 또는 `KMH`(kilometre per hour). 코드를 우리가 발명하지 않는다.\n */\n/**\n * 자원 속성 — **커널 `ResourceProperty` 와 같은 모양**이고, 그 모양은 ISA-95 가 세 자원에 똑같이\n * 정의한 것이다(`EquipmentPropertyType` · `PersonPropertyType` · `PhysicalAssetPropertyType`).\n *\n * 그래서 자원마다 다른 속성 타입을 두지 않는다 — 예전에는 설비만 속성을 가졌고(RefEquipmentProperty),\n * 인원·자산에 붙는 사실은 **실을 자리가 없어서 들어오지 못했다.**\n */\nexport interface RefResourceProperty {\n  id: string\n  description?: string\n  value?: string\n  /** 표준 `Value.DataType`. */\n  dataType?: string\n  /** 표준 `Value.UnitOfMeasure` — UN/CEFACT 공통코드. 물리량에 단위가 없으면 소비처가 거절한다. */\n  uom?: string\n  /** 하위 속성(재귀) — 표준 `<X>PropertyChild`. */\n  children?: RefResourceProperty[]\n  /** 이 개체 속성이 구체화하는 등급 속성 — 표준 `<X>ClassPropertyID`. */\n  classPropertyId?: string\n}\n\n/** 옛 이름 — 설비 전용이던 시절의 별칭(소비처 호환). 신규 소싱은 `RefResourceProperty`. */\nexport type RefEquipmentProperty = RefResourceProperty\n\n/**\n * 자원 **등급 정의** — 커널 `ResourceClassDef` 와 같은 모양이고, 그 모양은 ISA-95 가 세 자원에 똑같이\n * 정의한 것이다(`PersonnelClassType`·`EquipmentClassType`·`PhysicalAssetClassType`).\n *\n * 왜 필요한가: 원 시스템은 등급 **체계**를 갖고 있다(\"6축 용접 자격자\" 는 \"용접 자격자\" 이고, 그것은\n * \"생산직\" 이다). 그 체계가 들어올 자리가 없으면 요구와 소속이 **문자열이 똑같을 때만** 맞아,\n * 현장에서는 되는 배정이 모델에서 막힌다.\n */\nexport interface RefResourceClass {\n  id: string\n  description?: string\n  /** 상위 등급들 — 표준 `<X>ClassBaseID`(복수 = 다중 상속). */\n  baseIds?: string[]\n  properties?: RefResourceProperty[]\n  testSpecificationIds?: string[]\n  /** 유효 기간(ISO) — 표준 `EffectiveStartDate`/`EffectiveEndDate`. 밖이면 자격이 성립하지 않는다. */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport interface RefEquipment {\n  id: string\n  kind: string\n  homeLocationId: string\n  mtbfMs?: number // 평균 고장 간격(확률적 고장) — 지정 시 커널이 breakdown 시뮬 → 주목(고장) 발생\n  mttrMs?: number // 평균 수리 시간\n  gs1Id?: string // 정식 GS1 정체성(§J) — 설비=GIAI.\n  /**\n   * 교대(가동시간) — 이 시간대에만 배정된다. `startHour <= endHour` 면 같은 날, 넘어가면 야간(22→6).\n   * 미지정=24시간 가용. 교대 밖 자원은 고장·계획정지와 **구별되는 이유**로 쉰다(상태에 드러난다).\n   */\n  window?: { startHour: number; endHour: number }\n  /**\n   * 근무 캘린더 — 표준 `WorkCalendarEntry`(복수). 있으면 `window` 보다 이것을 본다.\n   *\n   * 축을 프레임워크 `@things-factory/work-shift` 의 `WorkShift`(`fromDate`·`fromTime`·`toDate`·`toTime`)와\n   * 맞춰 두었다 — 그 엔티티를 교대의 정본으로 결선할 때 직선 매핑이 되게. **아직 결선하지 않았다**:\n   * 그 엔티티에는 자원 연결과 비근무(휴일)가 없어 확장이 함께 필요하고, operato-twin 의 의존성 추가는\n   * 앱 아키텍처 결정이다(커버리지 §4-7 에 결선 지점으로 기록).\n   */\n  workCalendar?: WorkCalendarEntry[]\n  /**\n   * 설비 속성(속도 등) — 없으면 **이동시간을 거리에서 계산할 수 없다**(속도 없이 거리만으로는 시간이\n   * 안 나온다). 그때는 커널 상수로 떨어지고 그 사실이 `specCoverage()` 에 남는다.\n   */\n  properties?: RefResourceProperty[]\n  /** 적격을 검증한 시험 명세들 — 표준 `TestSpecificationID`(교정 등). */\n  testSpecificationIds?: string[]\n  /**\n   * 유효 기간 — **표준 `EffectiveStartDate` / `EffectiveEndDate`**(개체 타입 셋 모두에 있다).\n   *\n   * 없으면 **폐기한 것이 영구히 살아 있다**: 배정 대상에 남고, 가용 수에 들어가고, 화면에 뜬다.\n   * 도입 예정인 것은 반대로 오늘부터 있는 것처럼 보인다. 기간 밖이면 커널이 그 시각의 모델에서\n   * 빼고 **이유를 달아 남긴다**(`effectivity: 'not-yet' | 'expired'`) — 조용히 지우지 않는다.\n   */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 공정 모수 — 커널 `OperationParameter`(= ISA-95 `ParameterSpecification`/`ParameterType`) 와 **같은 모양**.\n * 이름을 바꾸지 않는다: 인제스트 경계에서 어휘가 갈리면 그 자리에서 방언이 생긴다.\n * ID 어휘의 정본은 커널 `OP_PARAM`(표준이 파라미터 ID 를 정하지 않으므로 우리가 한 곳에서 정한다).\n */\nexport interface RefOperationParameter {\n  id: string\n  /** ISA-95 `Value.ValueString` — 표준이 문자열로 싣는다. 기간 모수는 ISO 8601(`PT8M`). */\n  value: string\n  /** ISA-95 `Value.UnitOfMeasure`. 무차원(비율)이면 생략. */\n  uom?: string\n}\n\n/**\n * 공정의 자재 요구·산출 — **ISA-95 `OperationsSegment.MaterialSpecification`** 과 같은 모양.\n * 인원·설비·자산 명세와 같은 자리에 있어야 4대 자원이 대칭이 된다(자재만 빠져 있었다).\n */\nexport interface RefOpMaterialSpecification {\n  id?: string\n  /** 품목 등급으로 요구 — 표준 `MaterialClassID`. */\n  materialClass?: string\n  /** 특정 품목으로 요구 — 표준 `MaterialDefinitionID`. */\n  materialDefinition?: string\n  /** 표준 `MaterialUse` — 이 공정에서의 쓰임. */\n  use: 'consumed' | 'produced' | 'consumable'\n  /** 표준 `Quantity`. 단위 미지정이면 개수. */\n  quantity: number\n  uom?: string\n}\n\n/** 소요시간 변동 — **표준 밖 확장**(ISA-95 Duration 은 스칼라). 커널 `DurationVariability` 와 동형. */\nexport interface RefOperationVariability {\n  distribution: 'constant' | 'exponential' | 'uniform' | 'triangular'\n  min?: string\n  max?: string\n  mode?: string\n}\n\n/**\n * 오퍼레이션 명세 — ISA-95 `OperationsSegment`. 커널 `OperationDef` 와 필드 이름이 1:1이다.\n *\n * **이것이 없으면 시뮬레이션의 시간은 우리가 코드에 박아 둔 상수다.** 원 시스템(또는 가상 레퍼런스)이\n * 공정별 소요·변동·수율을 말해 줘야 예측이 그 현장의 예측이 된다. 주지 않으면 커널 기본값으로\n * 굴러가고, **기본값을 썼다는 사실은 커널 `specCoverage()` 가 밝힌다**(조용히 넘어가지 않는다).\n */\nexport interface RefOperation {\n  /** 작업 종류 키 — 커널 `FlowTask.kind` 와 같은 값이어야 명세가 그 작업에 붙는다. */\n  key: string\n  label: string\n  intent: 'transport' | 'process' | 'dwell'\n  locationType?: string\n  resourceType?: string\n  bizStep?: string\n  /** ISA-95 `OperationsSegment.Duration` — ISO 8601 기간(`PT12M`). */\n  duration?: string\n  variability?: RefOperationVariability\n  parameters?: RefOperationParameter[]\n  /**\n   * 필요 인원 — ISA-95 `PersonnelSpecification`(`PersonnelClassID` + `Quantity`) 1:1.\n   * 없으면 사람 없이 도는 공정이다(설비만 잡는다).\n   */\n  personnelSpecification?: { personnelClass?: string; quantity: number }[]\n  /** 필요 물리 자산 — ISA-95 `PhysicalAssetSpecification`(등급 + 수량). 빈 팔레트가 없으면 못 나간다. */\n  physicalAssetSpecification?: { assetClass?: string; quantity: number }[]\n  /**\n   * 필요·산출 자재 — ISA-95 `MaterialSpecification`. **4대 자원 중 자재만 이 자리가 없었다** —\n   * 그래서 부품이 떨어져 라인이 서는 상황이 예측에 나타나지 않았다.\n   * BOM 의 \"몇 개\" 는 여기다(품목 정의의 조립 구조에는 수량이 없다 — 1차 출처 확인).\n   */\n  materialSpecification?: RefOpMaterialSpecification[]\n}\n\n/**\n * 사람 — **ISA-95 `Person`.** 설비와 별개 자원이다(고장·설비효율이 아니라 등급·교대로 산다).\n * `personnelClass` 가 ISA-95 `PersonnelClassID` — 공정은 특정인이 아니라 **등급으로** 인원을 요구한다.\n */\nexport interface RefPerson {\n  id: string\n  name?: string\n  /**\n   * 속한 등급들 — **표준 `Person.PersonnelClassID`, `maxOccurs=\"unbounded\"`**.\n   * 복수인 것이 표준이고 그것이 자격 표현이다: 한 사람이 용접 자격과 지게차 자격을 함께 갖는다.\n   */\n  personnelClassIds?: string[]\n  /** 교대 — 설비와 같은 모양. 미지정=24시간 가용. */\n  window?: { startHour: number; endHour: number }\n  /** 근무 캘린더 — 표준 `WorkCalendarEntry`(복수). 2교대·휴게·휴일을 함께 표현한다. */\n  workCalendar?: WorkCalendarEntry[]\n  /**\n   * 기본 위치 — 표준 `Person.OperationalLocation`. 없으면 \"이 라인에 몇 명 있나\" 를 물을 수 없다.\n   * 사람은 움직이므로 이 값은 **출발점**이고, 실제 위치는 관측(person.status)이 갱신한다.\n   */\n  homeLocationId?: string\n  /**\n   * 자원 속성 — 표준 `PersonProperty`. **자격증·숙련도가 여기 들어간다.**\n   *\n   * 표준에는 자격(Qualification)이라는 별도 요소가 없다(`B2MML-Personnel.xsd` 확인). 자격은\n   * ① 등급 복수 소속으로(`personnelClassIds: ['welder-certified','forklift-licensed']`) ②\n   * 증빙은 이 속성으로(자격증 번호·만료일), ③ 검증 시험은 표준 `TestSpecificationID`(아직 미구현).\n   */\n  properties?: RefResourceProperty[]\n  /** 자격을 검증한 시험 명세들 — 표준 `TestSpecificationID`(참조만; 시험 명세·결과 모델은 아직 없다). */\n  testSpecificationIds?: string[]\n  /** 유효 기간 — 사람에게는 **입사 전·퇴사 후**다(자격 만료는 등급 쪽 기간이다: 사람은 남고 자격만 끊긴다). */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 물리 자산(반복사용) — **ISA-95 `PhysicalAsset`, GS1 `GRAI`.**\n * 팔레트·랙·용기처럼 **나갔다 돌아오는** 것. 물류단위(SSCC)와 다르다: SSCC 는 그 팔레트에 실린 화물\n * 한 덩어리이고, GRAI 는 팔레트 자체다(오늘은 이 화물, 내일은 저 화물을 싣는다).\n */\nexport interface RefAsset {\n  id: string\n  name?: string\n  /**\n   * 속한 등급들 — 표준 `PhysicalAssetClassID`(복수). 팔레트가 'euro-pallet' 이면서 'food-grade' 일 수 있다.\n   * 공정의 요구는 등급 하나 + 수량이다(표준 `PhysicalAssetSpecification`).\n   */\n  assetClassIds?: string[]\n  /** 기본 위치. */\n  homeLocationId?: string\n  /** 정식 GS1 정체성 — 반복사용 자산=GRAI. */\n  gs1Id?: string\n  /** 자원 속성 — 표준 `PhysicalAssetProperty`(적재 한도·규격 등). */\n  properties?: RefResourceProperty[]\n  /** 적격을 검증한 시험 명세들 — 표준 `TestSpecificationID`. */\n  testSpecificationIds?: string[]\n  /** 유효 기간 — 자산에서는 **폐기한 팔레트가 풀에서 빠지는 것**이다(회수 대상 수가 부풀지 않게). */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 품목 정의 — **ISA-95 `MaterialDefinition`.**\n *\n * 없으면 로트만 관측으로 들어오고 **품목이 무엇인지는 아무 데도 없다.** 그래서 같은 로트를 100개로\n * 받아도 \"몇 kg 인가\" 에 답할 수 없다(커널 `quantityIn` 이 환산을 거부하는 근거).\n *\n * **표준에 단위 환산 요소는 없다**(1차 출처 전수 확인) — 속성 주머니뿐이다. 그래서 환산 계수는\n * 커널이 정한 속성 이름(`perBaseUnit`, `uom` 이 대상 단위)으로 `properties` 에 싣는다.\n */\nexport interface RefMaterialDefinition {\n  /** 표준 `ID` — GTIN(`urn:epc:idpat:sgtin:…`)을 쓴다(정체성의 정본이 EPCIS 다). */\n  id: string\n  name?: string\n  /** 속한 등급들 — 표준 `MaterialClassID`(복수). */\n  materialClassIds?: string[]\n  /** 품목 속성 — 표준 `MaterialDefinitionProperty`. 환산 계수가 여기 들어간다. */\n  properties?: RefResourceProperty[]\n  testSpecificationIds?: string[]\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport interface ReferenceMaster {\n  source: string\n  system: 'wms' | 'yms' | 'mes'\n  siteName: string\n  /* spaceId 명시 시 그 공간을 참조(여러 트윈이 한 공간 공유, N:1). 없으면 source 에서 파생(1:1). */\n  /**\n   * 현장(공간). **시각 기준(`timezone`)이 여기 있는 이유**: 한 테넌트가 Rosarito(태평양)와 한국\n   * 공장을 함께 가질 수 있다. 테넌트 단위(`Domain.timezone`)로 두면 **둘 중 하나는 반드시 틀린다.**\n   * 시각 기준은 **물리 현장의 성질**이므로 공간이 그것을 갖는다(공간 중심 원칙).\n   *\n   * `timezone` 은 IANA 이름(`'America/Tijuana'`) — 오프셋 숫자가 아니다. 숫자로 두면 일광절약시간을\n   * 표현할 수 없고, 나중에 절대 구간으로 옮길 때도 이름이 있어야 계산할 수 있다.\n   */\n  space: { spaceId?: string; width: number; depth: number; unit?: string; timezone?: string; geo?: { lat: number; lon: number; rotation?: number }; representations?: any[]; primaryId?: string }\n  locations: RefLocation[]\n  equipment?: RefEquipment[]\n  /** 공정 명세(소요·변동·수율) — 없으면 커널 기본값으로 굴러간다(그 사실은 specCoverage 가 보고). */\n  operations?: RefOperation[]\n  /**\n   * **생산 정의**(레시피·라우트·자재 바인딩) — 커널의 정의-구동 MES 모드 입구.\n   *\n   * 없으면 커널은 레거시(하드코딩) 흐름으로 돈다. 즉 **현장 레시피를 적어도 이 자리에 실리지 않으면\n   * 커널은 그것을 보지 못한다** — 선언과 실행이 갈라지는 지점이라 자리를 연다.\n   */\n  mesSpec?: unknown\n  /**\n   * 사람 — 선언하지 않으면 **인원 제약이 없는 트윈**이 된다(설비만 있으면 언제나 돌아가는 공장).\n   * 공정이 인원을 요구하는데 사람이 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.\n   */\n  persons?: RefPerson[]\n  /**\n   * 물리 자산(반복사용) — 선언하지 않으면 자산 제약이 없는 트윈이다.\n   * 공정이 자산을 요구하는데 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.\n   */\n  assets?: RefAsset[]\n  /**\n   * 등급 정의 — 표준 `PersonnelClass`·`EquipmentClass`·`PhysicalAssetClass`.\n   * 안 실어도 트윈은 돈다(소속 문자열 그대로 판정). 실으면 상속·유효기간이 살아난다.\n   */\n  personnelClasses?: RefResourceClass[]\n  equipmentClasses?: RefResourceClass[]\n  assetClasses?: RefResourceClass[]\n  /** 품목 정의·등급 — 표준 `MaterialDefinition` / `MaterialClass`. 없으면 단위 환산을 할 수 없다. */\n  materialDefinitions?: RefMaterialDefinition[]\n  materialClasses?: RefResourceClass[]\n}\n\nexport interface IngestedTwin {\n  board: any // BoardDef(+layout+spaceId) — 커널 소비\n  spaceContent: any // TwinSpace content — 뷰 소비\n  warnings: string[]\n}\n\n/**\n * 마스터 → 트윈 구조 매핑(순수). 노드타입을 카탈로그로 검증(모르는 타입은 warning, 버리진 않음 — 반영 우선).\n * @param catalog DOMAIN_CATALOG (커널 SSOT). 없으면 검증 생략.\n */\n/**\n * IANA 시간대 이름 → **그 시각의** UTC 오프셋(분). 의존성 없이 `Intl` 로 푼다.\n *\n * `Intl.DateTimeFormat` 의 `longOffset` 은 `\"GMT-07:00\"` 처럼 나오고, 이것은 **일광절약시간을 반영한**\n * 값이다. 그래서 8월의 `America/Tijuana` 는 −420(PDT), 1월은 −480(PST)이 된다.\n *\n * **한계를 밝힌다**: 여기서 나오는 것은 **한 시점의** 오프셋이다. 커널은 고정 오프셋으로 하루 중 분을\n * 읽으므로, 보드를 만든 계절과 다른 계절을 길게 예측하면 한 시간 어긋난다. 표준에 충실한 끝 모습은\n * 호스트가 절대 구간(`StartDateTime`/`FinishDateTime`)을 계산해 넣는 것이고, 그때 이 함수는 사라진다.\n *\n * 모르는 이름에는 **0 을 답하지 않는다**(`undefined`) — 0 은 \"UTC 라고 선언했다\" 는 뜻이고, 모르는 것을\n * 그렇게 바꾸면 판정이 조용히 틀린다.\n */\nexport function utcOffsetOf(timezone?: string, at: Date = new Date()): number | undefined {\n  if (!timezone) return undefined\n  try {\n    const parts = new Intl.DateTimeFormat('en-US', { timeZone: timezone, timeZoneName: 'longOffset' }).formatToParts(at)\n    const name = parts.find(p => p.type === 'timeZoneName')?.value ?? ''\n    if (name === 'GMT') return 0 // UTC 계열은 오프셋 표기가 없다\n    const m = /^GMT([+-])(\\d{1,2})(?::(\\d{2}))?$/.exec(name)\n    if (!m) return undefined\n    const sign = m[1] === '-' ? -1 : 1\n    return sign * (Number(m[2]) * 60 + Number(m[3] ?? 0))\n  } catch {\n    return undefined // 알 수 없는 이름 — Intl 이 던진다\n  }\n}\n\nexport function masterToTwin(master: ReferenceMaster, catalog?: any): IngestedTwin {\n  const warnings: string[] = []\n  const known: string[] = catalog?.[master.system]?.locationTypes ?? []\n\n  const locationEntries = master.locations.filter(l => l.role === 'location' || l.role === 'both')\n  const areaLocs = master.locations.filter(l => l.role === 'area' || l.role === 'both')\n\n  const locations = locationEntries.map(l => {\n    if (known.length && !known.includes(l.type)) warnings.push(`unknown ${master.system} location type \"${l.type}\" (${l.id}) — 카탈로그에 없음`)\n    // gs1Id(정식 정체성)를 보드 노드로 통과 — 결합(tag)/추적이 GS1 로(§J). 로컬 id 는 그대로 유지(name/xref).\n    return { id: l.id, type: l.type, capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), parentId: l.parentId, gs1Id: l.gs1Id }\n  })\n\n  const equipment = (master.equipment ?? []).map(e => ({\n    id: e.id, kind: e.kind, homeLocation: e.homeLocationId, mtbfMs: e.mtbfMs, mttrMs: e.mttrMs, gs1Id: e.gs1Id,\n    ...(e.window ? { window: e.window } : {}),\n    /* 속성은 손대지 않고 통과 — 이동시간 추정기가 kind 별 속도를 여기서 읽는다(단위 코드 그대로). */\n    ...(e.properties?.length ? { properties: e.properties } : {}), ...(e.workCalendar?.length ? { workCalendar: e.workCalendar } : {}), ...(e.testSpecificationIds?.length ? { testSpecificationIds: e.testSpecificationIds } : {}),\n    /* 유효 기간도 손대지 않고 통과 — 판정은 커널이 자기 시계로 한다(호스트가 미리 자르지 않는다). */\n    ...(e.effectiveStart ? { effectiveStart: e.effectiveStart } : {}), ...(e.effectiveEnd ? { effectiveEnd: e.effectiveEnd } : {})\n  }))\n\n  // 좌표(layout) — footprint 중심. 없으면 생략(coordinate-free 유지).\n  const layout: Record<string, { x: number; y: number }> = {}\n  for (const l of locationEntries) if (l.footprint) layout[l.id] = { x: l.footprint.x + l.footprint.w / 2, y: l.footprint.y + l.footprint.h / 2 }\n\n  const spaceId = master.space.spaceId ?? `${master.source}-site`\n  /*\n   * 시각 기준을 커널이 읽을 형태로 푼다 — 커널은 zero-dep 이라 시간대 데이터베이스를 들이지 않고\n   * **분 오프셋**만 받는다(계약 `BoardDef.utcOffsetMinutes`). 푸는 일은 호스트의 몫이다.\n   *\n   * 선언이 없으면 **필드를 만들지 않는다** — 그러면 커널이 UTC 로 읽고, 그 기본값은 계약에 밝혀져 있다.\n   * 여기서 0 을 넣으면 \"UTC 라고 선언했다\" 와 \"선언하지 않았다\" 가 구별되지 않는다.\n   */\n  const utcOffsetMinutes = utcOffsetOf(master.space.timezone)\n  if (master.space.timezone && utcOffsetMinutes === undefined) {\n    warnings.push(`space timezone \"${master.space.timezone}\" is not a known IANA zone — the twin will read times as UTC`)\n  }\n  /*\n   * 오퍼레이션 명세를 board 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(BoardDef 확장 필드,\n   * 모르는 커널은 무시). 여기서 값을 손대지 않는다: 기간은 표준 표기(ISO 8601)로 커널까지 그대로 간다.\n   */\n  const operations = master.operations\n  if (operations?.length) {\n    for (const o of operations) {\n      if (!o.duration && !o.parameters?.length) warnings.push(`operation \"${o.key}\" has no duration or parameters — kernel defaults will be used`)\n    }\n  }\n  /* 사람도 손대지 않고 통과 — 등급·교대 그대로 커널까지 간다(경계에서 어휘를 갈지 않는다). */\n  const persons = master.persons?.map(p => ({ id: p.id, personnelClassIds: p.personnelClassIds, ...(p.window ? { window: p.window } : {}), ...(p.workCalendar?.length ? { workCalendar: p.workCalendar } : {}), ...(p.homeLocationId ? { homeLocation: p.homeLocationId } : {}), ...(p.properties?.length ? { properties: p.properties } : {}), ...(p.testSpecificationIds?.length ? { testSpecificationIds: p.testSpecificationIds } : {}), ...(p.effectiveStart ? { effectiveStart: p.effectiveStart } : {}), ...(p.effectiveEnd ? { effectiveEnd: p.effectiveEnd } : {}) }))\n  /* 자산도 손대지 않고 통과 — 등급·자리 그대로 커널까지. */\n  const assets = master.assets?.map(a => ({ id: a.id, assetClassIds: a.assetClassIds, homeLocation: a.homeLocationId, gs1Id: a.gs1Id, ...(a.properties?.length ? { properties: a.properties } : {}), ...(a.testSpecificationIds?.length ? { testSpecificationIds: a.testSpecificationIds } : {}), ...(a.effectiveStart ? { effectiveStart: a.effectiveStart } : {}), ...(a.effectiveEnd ? { effectiveEnd: a.effectiveEnd } : {}) }))\n  /* 품목 정의·등급도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(환산 계수는 커널이 읽는다). */\n  const materialDefinitions = master.materialDefinitions?.map(d => ({\n    id: d.id,\n    ...(d.name ? { description: d.name } : {}),\n    ...(d.materialClassIds?.length ? { materialClassIds: d.materialClassIds } : {}),\n    ...(d.properties?.length ? { properties: d.properties } : {}),\n    ...(d.testSpecificationIds?.length ? { testSpecificationIds: d.testSpecificationIds } : {}),\n    ...(d.effectiveStart ? { effectiveStart: d.effectiveStart } : {}),\n    ...(d.effectiveEnd ? { effectiveEnd: d.effectiveEnd } : {})\n  }))\n  const board = {\n    locations, equipment, layout, spaceId,\n    /* 생산 정의도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(커널이 그대로 소비한다). */\n    ...(master.mesSpec ? { mesSpec: master.mesSpec } : {}),\n    ...(materialDefinitions?.length ? { materialDefinitions } : {}),\n    ...(master.materialClasses?.length ? { materialClasses: master.materialClasses } : {}),\n    ...(utcOffsetMinutes !== undefined ? { utcOffsetMinutes } : {}),\n    ...(operations?.length ? { operations } : {}),\n    ...(master.personnelClasses?.length ? { personnelClasses: master.personnelClasses } : {}),\n    ...(master.equipmentClasses?.length ? { equipmentClasses: master.equipmentClasses } : {}),\n    ...(master.assetClasses?.length ? { assetClasses: master.assetClasses } : {}),\n    ...(persons?.length ? { persons } : {}),\n    ...(assets?.length ? { assets } : {})\n  }\n\n  const areas = areaLocs.map(l => ({\n    id: l.id, type: l.type, name: l.name ?? l.id, parentId: l.parentId,\n    x: l.footprint?.x ?? 0, y: l.footprint?.y ?? 0, w: l.footprint?.w ?? 10, h: l.footprint?.h ?? 10\n  }))\n  // 인제스트 현장 물질화(space facet #4) — 표현이 없고 geo 가 있으면 기본 map 표현 합성.\n  // \"인제스트하면 알아볼 현장(내 place)이 뜬다\"는 공간 중심 정수 보장(zero-to-twin): 커넥터/템플릿이\n  // 표현을 안 줘도 geo 만 있으면 위성 지도로 착지. (area 폴리곤 물질화는 좌표 투영 필요 → space #3.)\n  const geo = master.space.geo\n  const givenReps = master.space.representations ?? []\n  const representations =\n    givenReps.length > 0\n      ? givenReps\n      : geo\n        ? [{ id: 'r-map', type: 'map', name: '위성 지도', primary: true, center: { lat: geo.lat, lon: geo.lon }, zoom: 17 }]\n        : []\n  if (representations.length === 0) {\n    warnings.push('space has no viewable representation (no representations and no geo) — add one manually or provide geo/board')\n  }\n  const spaceContent = {\n    width: master.space.width, depth: master.space.depth, unit: master.space.unit ?? 'm',\n    geo, representations, primaryId: master.space.primaryId ?? representations[0]?.id,\n    areas, landmarks: []\n  }\n\n  return { board, spaceContent, warnings }\n}\n"]}
+{"version":3,"file":"reference-master.js","sourceRoot":"","sources":["../../../server/service/reference/reference-master.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Face2 마스터 인제스트(ADR-0018 반영 모드) — 레퍼런스 시스템(실 WMS/YMS/MES 또는 가상 레퍼런스)의\n * 마스터를 읽어 트윈 구조(TwinModelDef) + 공간(Space content)을 생성. 손배선이 아니라 인제스트로 엔티티가 흐른다.\n *\n * 규율(ADR-0018): 도메인 타입(location.type=노드용)은 커널 카탈로그 어휘를 그대로 반영(발명 금지).\n * location 은 role 로 노드(운영점)·area(공간영역)·both 를 구분 — 노드→TwinModelDef, area→Space.areas.\n * 좌표·representations 는 트윈 공간층(보완/추가). 실 시스템이 좌표를 안 주면 layout 없이 위상만 인제스트.\n */\n\nimport type { DomainSystem, EquipmentLevel, WorkCalendarEntry } from '@operato/twin-kernel'\n\nexport interface RefLocation {\n  id: string\n  type: string // 노드는 커널 노드타입(dock/storage/yard-slot…), area 는 공간 region 타입\n  name?: string\n  description?: string\n  role: 'location' | 'area' | 'both'\n  parentId?: string\n  /**\n   * **전기적으로 어디서 받는가** — 이 자리에 전기를 주는 상류 자리(커널 계약의 `upstreamId`).\n   *\n   * `parentId`(공간 포함)와 따로 두는 이유는 커널 계약에 적혀 있다. 여기서 빠뜨리면 마스터가 말한 계통이\n   * 모델까지 오지 못하고, 뿌리 계량 판정이 분기 계량기까지 뿌리로 세어 **부하가 두 배로** 보인다.\n   */\n  upstreamId?: string\n  /** 저장 용량 — 이 자리에 동시에 놓일 수 있는 물품 수. */\n  capacity?: number\n  /**\n   * 동시 처리 수 — 이 자리에서 한 번에 진행될 수 있는 작업 수. **저장 용량과 다른 축**이다\n   * (자재를 20개 쌓아 두는 절단 스테이션이 한 번에 한 대만 깎는다). 미지정=제약 없음.\n   */\n  parallelism?: number\n  /**\n   * **ISA-95 설비 계층 단계** — `EquipmentLevel` 열거값(`ProductionLine`·`StorageZone`·`WorkCenter`…).\n   *\n   * `type` 은 현장의 낱말(`paint-booth`)이고 이것은 **표준이 정한 역할**이다. 둘은 다른 축이라 함께 든다 —\n   * 연동·집계는 표준 축으로, 화면은 현장 낱말로. 미지정이면 그 자리의 표준 역할을 아직 모른다는 뜻이고,\n   * 짐작해 채우지 않는다.\n   */\n  level?: EquipmentLevel\n  /**\n   * 자리의 **열린 속성** — 표준 `OperationalLocationProperty`(설비·사람·자산과 같은 모양).\n   *\n   * 무엇이 여기 실리나: **자리의 물리량**이다. 에너지의 계약전력(`contract.kW`)이 첫 사례다 —\n   * 그 값이 앉을 자리가 없어서 EMS 커널은 계약 대비 판정을 할 수 없었다(자리가 없으면 사실이\n   * 들어오지 못한다). 커널은 자기가 **읽는** 속성 id 만 선언하고(`EMS_PROPERTY`) 나머지는 나른다.\n   */\n  properties?: RefResourceProperty[]\n  footprint?: { x: number; y: number; w: number; h: number } // 있으면 area 기하 + 노드 중심좌표\n  gs1Id?: string // 정식 GS1 정체성(§J) — 위치=SGLN. 결합(tag)/추적 canonical id. 받아들이기 경계서 부여(로컬 id=name/xref 로 보존).\n}\n\n/**\n * 설비 속성 — **ISA-95 `EquipmentSpecificationProperty`(`OpEquipmentSpecificationPropertyType`) 1:1.**\n * 그 타입도 `ID` + `Value`(`ValueString`·`DataType`·`UnitOfMeasure`) 이므로 공정 모수와 같은 모양이다.\n *\n * 단위 코드는 **UN/CEFACT 권고 20 공통코드**(EPCIS `uom` 과 같은 코드계): 속도는 `MTS`(metre per\n * second) 또는 `KMH`(kilometre per hour). 코드를 우리가 발명하지 않는다.\n */\n/**\n * 자원 속성 — **커널 `ResourceProperty` 와 같은 모양**이고, 그 모양은 ISA-95 가 세 자원에 똑같이\n * 정의한 것이다(`EquipmentPropertyType` · `PersonPropertyType` · `PhysicalAssetPropertyType`).\n *\n * 그래서 자원마다 다른 속성 타입을 두지 않는다 — 예전에는 설비만 속성을 가졌고(RefEquipmentProperty),\n * 인원·자산에 붙는 사실은 **실을 자리가 없어서 들어오지 못했다.**\n */\nexport interface RefResourceProperty {\n  id: string\n  description?: string\n  value?: string\n  /** 표준 `Value.DataType`. */\n  dataType?: string\n  /** 표준 `Value.UnitOfMeasure` — UN/CEFACT 공통코드. 물리량에 단위가 없으면 소비처가 거절한다. */\n  uom?: string\n  /** 하위 속성(재귀) — 표준 `<X>PropertyChild`. */\n  children?: RefResourceProperty[]\n  /** 이 개체 속성이 구체화하는 등급 속성 — 표준 `<X>ClassPropertyID`. */\n  classPropertyId?: string\n}\n\n/** 옛 이름 — 설비 전용이던 시절의 별칭(소비처 호환). 신규 소싱은 `RefResourceProperty`. */\nexport type RefEquipmentProperty = RefResourceProperty\n\n/**\n * 자원 **등급 정의** — 커널 `ResourceClassDef` 와 같은 모양이고, 그 모양은 ISA-95 가 세 자원에 똑같이\n * 정의한 것이다(`PersonnelClassType`·`EquipmentClassType`·`PhysicalAssetClassType`).\n *\n * 왜 필요한가: 원 시스템은 등급 **체계**를 갖고 있다(\"6축 용접 자격자\" 는 \"용접 자격자\" 이고, 그것은\n * \"생산직\" 이다). 그 체계가 들어올 자리가 없으면 요구와 소속이 **문자열이 똑같을 때만** 맞아,\n * 현장에서는 되는 배정이 모델에서 막힌다.\n */\nexport interface RefResourceClass {\n  id: string\n  description?: string\n  /** 상위 등급들 — 표준 `<X>ClassBaseID`(복수 = 다중 상속). */\n  baseIds?: string[]\n  properties?: RefResourceProperty[]\n  testSpecificationIds?: string[]\n  /** 유효 기간(ISO) — 표준 `EffectiveStartDate`/`EffectiveEndDate`. 밖이면 자격이 성립하지 않는다. */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 검사 명세 — **자원이 가리키는 대상**(ISA-95 `TestSpecification`).\n *\n * 표준 필드는 셋만 담는다(`ID`·`Description`·`Version`) — 재는 속성과 합격 기준은 아직 1차 출처와\n * 대조하지 않았다(커널 계약의 머리말이 그 사실을 적어 두었다).\n */\n/**\n * 시험 결과 — **\"이 개체가 그 시험을 통과했다\"** 는 기록(ISA-95 결과).\n *\n * 결과를 낳는 곳은 트윈이 아니다(인사·정비 시스템이 기록한다) — 그래서 관측이면서 **선언 경로로** 온다.\n * 커널은 이 값이 있을 때만 자격을 판정한다: 없으면 제약이 아니고(라인이 굶지 않는다), 있으면 만료·\n * 불합격이 배정을 막는다.\n */\nexport interface RefTestResult {\n  specId: string\n  result: 'pass' | 'fail'\n  at?: string\n  /** 없으면 무기한 — 짐작으로 기한을 만들면 멀쩡한 자격자가 조용히 사라진다. */\n  expiresAt?: string\n}\n\nexport interface RefTestSpecification {\n  id: string\n  /** 표시명 — i18n 키일 수 있다. 읽는 어휘를 하나로 맞추려고 인제스트가 `name` 으로 옮긴다. */\n  description?: string\n  version?: string\n}\n\nexport interface RefEquipment {\n  id: string\n  kind: string\n  /** 사람이 부르는 이름 — 없으면 화면이 id 를 보인다(id 를 이름으로 베끼지 않는다). */\n  name?: string\n  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  description?: string\n  homeLocationId: string\n  mtbfMs?: number // 평균 고장 간격(확률적 고장) — 지정 시 커널이 breakdown 시뮬 → 주목(고장) 발생\n  mttrMs?: number // 평균 수리 시간\n  gs1Id?: string // 정식 GS1 정체성(§J) — 설비=GIAI.\n  /**\n   * 교대(가동시간) — 이 시간대에만 배정된다. `startHour <= endHour` 면 같은 날, 넘어가면 야간(22→6).\n   * 미지정=24시간 가용. 교대 밖 자원은 고장·계획정지와 **구별되는 이유**로 쉰다(상태에 드러난다).\n   */\n  window?: { startHour: number; endHour: number }\n  /**\n   * 근무 캘린더 — 표준 `WorkCalendarEntry`(복수). 있으면 `window` 보다 이것을 본다.\n   *\n   * 축을 프레임워크 `@things-factory/work-shift` 의 `WorkShift`(`fromDate`·`fromTime`·`toDate`·`toTime`)와\n   * 맞춰 두었다 — 그 엔티티를 교대의 정본으로 결선할 때 직선 매핑이 되게. **아직 결선하지 않았다**:\n   * 그 엔티티에는 자원 연결과 비근무(휴일)가 없어 확장이 함께 필요하고, operato-twin 의 의존성 추가는\n   * 앱 아키텍처 결정이다(커버리지 §4-7 에 결선 지점으로 기록).\n   */\n  workCalendar?: WorkCalendarEntry[]\n  /**\n   * 설비 속성(속도 등) — 없으면 **이동시간을 거리에서 계산할 수 없다**(속도 없이 거리만으로는 시간이\n   * 안 나온다). 그때는 커널 상수로 떨어지고 그 사실이 `specCoverage()` 에 남는다.\n   */\n  properties?: RefResourceProperty[]\n  /** 적격을 검증한 시험 명세들 — 표준 `TestSpecificationID`(교정 등). */\n  testSpecificationIds?: string[]\n  /**\n   * 유효 기간 — **표준 `EffectiveStartDate` / `EffectiveEndDate`**(개체 타입 셋 모두에 있다).\n   *\n   * 없으면 **폐기한 것이 영구히 살아 있다**: 배정 대상에 남고, 가용 수에 들어가고, 화면에 뜬다.\n   * 도입 예정인 것은 반대로 오늘부터 있는 것처럼 보인다. 기간 밖이면 커널이 그 시각의 모델에서\n   * 빼고 **이유를 달아 남긴다**(`effectivity: 'not-yet' | 'expired'`) — 조용히 지우지 않는다.\n   */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 공정 모수 — 커널 `OperationParameter`(= ISA-95 `ParameterSpecification`/`ParameterType`) 와 **같은 모양**.\n * 이름을 바꾸지 않는다: 인제스트 경계에서 어휘가 갈리면 그 자리에서 방언이 생긴다.\n * ID 어휘의 정본은 커널 `OP_PARAM`(표준이 파라미터 ID 를 정하지 않으므로 우리가 한 곳에서 정한다).\n */\nexport interface RefOperationParameter {\n  id: string\n  /** ISA-95 `Value.ValueString` — 표준이 문자열로 싣는다. 기간 모수는 ISO 8601(`PT8M`). */\n  value: string\n  /** ISA-95 `Value.UnitOfMeasure`. 무차원(비율)이면 생략. */\n  uom?: string\n}\n\n/**\n * 공정의 자재 요구·산출 — **ISA-95 `OperationsSegment.MaterialSpecification`** 과 같은 모양.\n * 인원·설비·자산 명세와 같은 자리에 있어야 4대 자원이 대칭이 된다(자재만 빠져 있었다).\n */\nexport interface RefOpMaterialSpecification {\n  id?: string\n  /** 품목 등급으로 요구 — 표준 `MaterialClassID`. */\n  materialClass?: string\n  /** 특정 품목으로 요구 — 표준 `MaterialDefinitionID`. */\n  materialDefinition?: string\n  /** 표준 `MaterialUse` — 이 공정에서의 쓰임. */\n  use: 'consumed' | 'produced' | 'consumable'\n  /** 표준 `Quantity`. 단위 미지정이면 개수. */\n  quantity: number\n  uom?: string\n}\n\n/** 소요시간 변동 — **표준 밖 확장**(ISA-95 Duration 은 스칼라). 커널 `DurationVariability` 와 동형. */\nexport interface RefOperationVariability {\n  distribution: 'constant' | 'exponential' | 'uniform' | 'triangular'\n  min?: string\n  max?: string\n  mode?: string\n}\n\n/**\n * 오퍼레이션 명세 — ISA-95 `OperationsSegment`. 커널 `OperationDef` 와 필드 이름이 1:1이다.\n *\n * **이것이 없으면 시뮬레이션의 시간은 우리가 코드에 고정한 상수다.** 원 시스템(또는 가상 레퍼런스)이\n * 공정별 소요·변동·수율을 말해 줘야 예측이 그 현장의 예측이 된다. 주지 않으면 커널 기본값으로\n * 굴러가고, **기본값을 썼다는 사실은 커널 `specCoverage()` 가 밝힌다**(조용히 넘어가지 않는다).\n */\nexport interface RefOperation {\n  /** 작업 종류 키 — 커널 `FlowTask.kind` 와 같은 값이어야 명세가 그 작업에 붙는다. */\n  key: string\n  label: string\n  intent: 'transport' | 'process' | 'dwell'\n  locationType?: string\n  resourceType?: string\n  bizStep?: string\n  /** ISA-95 `OperationsSegment.Duration` — ISO 8601 기간(`PT12M`). */\n  duration?: string\n  variability?: RefOperationVariability\n  parameters?: RefOperationParameter[]\n  /**\n   * 필요 인원 — ISA-95 `PersonnelSpecification`(`PersonnelClassID` + `Quantity`) 1:1.\n   * 없으면 사람 없이 도는 공정이다(설비만 잡는다).\n   */\n  personnelSpecification?: { personnelClass?: string; quantity: number }[]\n  /** 필요 물리 자산 — ISA-95 `PhysicalAssetSpecification`(등급 + 수량). 빈 팔레트가 없으면 못 나간다. */\n  physicalAssetSpecification?: { assetClass?: string; quantity: number }[]\n  /**\n   * 필요·산출 자재 — ISA-95 `MaterialSpecification`. **4대 자원 중 자재만 이 자리가 없었다** —\n   * 그래서 부품이 떨어져 라인이 서는 상황이 예측에 나타나지 않았다.\n   * BOM 의 \"몇 개\" 는 여기다(품목 정의의 조립 구조에는 수량이 없다 — 1차 출처 확인).\n   */\n  materialSpecification?: RefOpMaterialSpecification[]\n}\n\n/**\n * 사람 — **ISA-95 `Person`.** 설비와 별개 자원이다(고장·설비효율이 아니라 등급·교대로 산다).\n * `personnelClass` 가 ISA-95 `PersonnelClassID` — 공정은 특정인이 아니라 **등급으로** 인원을 요구한다.\n */\nexport interface RefPerson {\n  id: string\n  name?: string\n  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  /**\n   * 속한 등급들 — **표준 `Person.PersonnelClassID`, `maxOccurs=\"unbounded\"`**.\n   * 복수인 것이 표준이고 그것이 자격 표현이다: 한 사람이 용접 자격과 지게차 자격을 함께 갖는다.\n   */\n  personnelClassIds?: string[]\n  /** 교대 — 설비와 같은 모양. 미지정=24시간 가용. */\n  window?: { startHour: number; endHour: number }\n  /** 근무 캘린더 — 표준 `WorkCalendarEntry`(복수). 2교대·휴게·휴일을 함께 표현한다. */\n  workCalendar?: WorkCalendarEntry[]\n  /**\n   * 기본 위치 — 표준 `Person.OperationalLocation`. 없으면 \"이 라인에 몇 명 있나\" 를 물을 수 없다.\n   * 사람은 움직이므로 이 값은 **출발점**이고, 실제 위치는 관측(person.status)이 갱신한다.\n   */\n  homeLocationId?: string\n  /**\n   * 자원 속성 — 표준 `PersonProperty`. **자격증·숙련도가 여기 들어간다.**\n   *\n   * 표준에는 자격(Qualification)이라는 별도 요소가 없다(`B2MML-Personnel.xsd` 확인). 자격은\n   * ① 등급 복수 소속으로(`personnelClassIds: ['welder-certified','forklift-licensed']`) ②\n   * 증빙은 이 속성으로(자격증 번호·만료일), ③ 검증 시험은 표준 `TestSpecificationID`(아직 미구현).\n   */\n  properties?: RefResourceProperty[]\n  /** 자격을 검증한 시험 명세들 — 표준 `TestSpecificationID`(참조만; 시험 명세·결과 모델은 아직 없다). */\n  testSpecificationIds?: string[]\n  /** 유효 기간 — 사람에게는 **입사 전·퇴사 후**다(자격 만료는 등급 쪽 기간이다: 사람은 남고 자격만 끊긴다). */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 물리 자산(반복사용) — **ISA-95 `PhysicalAsset`, GS1 `GRAI`.**\n * 팔레트·랙·용기처럼 **나갔다 돌아오는** 것. 물류단위(SSCC)와 다르다: SSCC 는 그 팔레트에 실린 화물\n * 한 덩어리이고, GRAI 는 팔레트 자체다(오늘은 이 화물, 내일은 저 화물을 싣는다).\n */\nexport interface RefAsset {\n  id: string\n  name?: string\n  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  /**\n   * 속한 등급들 — 표준 `PhysicalAssetClassID`(복수). 팔레트가 'euro-pallet' 이면서 'food-grade' 일 수 있다.\n   * 공정의 요구는 등급 하나 + 수량이다(표준 `PhysicalAssetSpecification`).\n   */\n  assetClassIds?: string[]\n  /** 기본 위치. */\n  homeLocationId?: string\n  /** 정식 GS1 정체성 — 반복사용 자산=GRAI. */\n  gs1Id?: string\n  /** 자원 속성 — 표준 `PhysicalAssetProperty`(적재 한도·규격 등). */\n  properties?: RefResourceProperty[]\n  /** 적격을 검증한 시험 명세들 — 표준 `TestSpecificationID`. */\n  testSpecificationIds?: string[]\n  /** 유효 기간 — 자산에서는 **폐기한 팔레트가 풀에서 빠지는 것**이다(회수 대상 수가 부풀지 않게). */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 품목 정의 — **ISA-95 `MaterialDefinition`.**\n *\n * 없으면 로트만 관측으로 들어오고 **품목이 무엇인지는 아무 데도 없다.** 그래서 같은 로트를 100개로\n * 받아도 \"몇 kg 인가\" 에 답할 수 없다(커널 `quantityIn` 이 환산을 거부하는 근거).\n *\n * **표준에 단위 환산 요소는 없다**(1차 출처 전수 확인) — 속성 주머니뿐이다. 그래서 환산 계수는\n * 커널이 정한 속성 이름(`perBaseUnit`, `uom` 이 대상 단위)으로 `properties` 에 싣는다.\n */\nexport interface RefMaterialDefinition {\n  /** 표준 `ID` — GTIN(`urn:epc:idpat:sgtin:…`)을 쓴다(정체성의 정본이 EPCIS 다). */\n  id: string\n  name?: string\n  /** 속한 등급들 — 표준 `MaterialClassID`(복수). */\n  materialClassIds?: string[]\n  /** 품목 속성 — 표준 `MaterialDefinitionProperty`. 환산 계수가 여기 들어간다. */\n  properties?: RefResourceProperty[]\n  testSpecificationIds?: string[]\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * **이 마스터를 다시 만들 수 있는 방법** — 트윈이 자기 원본을 기억하는 자리.\n *\n * 트윈은 원본을 비출 뿐이므로(ADR-0028), 원본이 달라지면 **다시 읽어야** 합니다. 그런데 지금까지\n * 트윈은 \"내가 무엇에서 나왔나\" 를 남기지 않았다 — 어댑터로 들어온 트윈은 `TwinReference` 행이\n * 있었지만 템플릿으로 세운 트윈에는 아무것도 없었고, 그래서 **다시 읽을 대상이 없는 트윈**이\n * 만들어졌다. 원본을 잃은 트윈은 첫날의 모습에 영원히 머문다.\n *\n * 그래서 원천이 무엇이든 여기 한 자리에 남긴다. 다시 읽기는 이 값 하나만 보면 된다.\n */\nexport type MasterOrigin =\n  /**\n   * 등록된 레퍼런스(어댑터)에서 왔다 — 다시 읽기 = 그 어댑터로 마스터를 다시 가져온다.\n   *\n   * `source` 는 **레퍼런스 등록 이름**이고 그 참조가 보고하는 사이트 전부에 같다. 그래서 어느 사이트에서\n   * 온 트윈인지는 `siteId` 가 있어야 안다 — 없으면 다시 읽기가 사이트를 찾지 못한다(2026-08-18 실측:\n   * 사이트가 여러 개인 참조에서 온 트윈은 재동기가 전부 거절됐다. 참조 이름을 사이트별 마스터의\n   * `source`(=인스턴스 id)와 견주고 있었다 — 서로 다른 것을 비교한 것이다).\n   */\n  | { kind: 'reference'; source: string; siteId?: string; spaceId?: string }\n  /**\n   * 템플릿 + 노브로 합성했다 — 다시 읽기 = 같은 노브로 다시 짓는다(합성은 결정적이다).\n   *\n   * `spaceId` 는 **만들 때 고른 현장**이다(합쳐 넣기). 기억하지 않으면 다시 읽을 때 트윈이 조용히 자기\n   * 현장을 떠난다 — 템플릿이 낸 기본 공간으로 돌아가기 때문이다. 그러면 그 현장의 값(요금 등)도 함께\n   * 잃는다(2026-08-18 실측: 한 현장에 합쳐 둔 EMS 트윈 여덟이 재동기 뒤 각자 공간으로 흩어졌다).\n   */\n  | { kind: 'template'; templateId: string; params: Record<string, unknown>; spaceId?: string }\n\nexport interface ReferenceMaster {\n  source: string\n  /**\n   * 어느 종류의 트윈인가 — **커널 카탈로그가 정본**이다(`DomainSystem`).\n   *\n   * 예전에는 `'wms' | 'yms' | 'mes'` 를 여기 적어 뒀다. 커널에 종류가 하나 늘 때(에너지) 이 줄이\n   * 함께 움직여야 하는데, 손으로 적힌 목록은 그것을 알려 주지 않는다 — 어휘의 집은 한 곳이어야 한다.\n   */\n  system: DomainSystem\n  siteName: string\n  /** 검사 명세 — 자원·등급의 `testSpecificationIds` 가 가리키는 대상. */\n  testSpecifications?: RefTestSpecification[]\n  /**\n   * 이 마스터가 어디서 나왔나 — **다시 읽기의 유일한 근거.** 없으면 그 트윈은 다시 읽을 수 없고,\n   * 조회 화면이 그 사실을 그대로 말한다(없는 것을 있는 척하지 않는다).\n   */\n  origin?: MasterOrigin\n  /* spaceId 명시 시 그 공간을 참조(여러 트윈이 한 공간 공유, N:1). 없으면 source 에서 파생(1:1). */\n  /**\n   * 현장(공간). **시각 기준(`timezone`)이 여기 있는 이유**: 한 테넌트가 Rosarito(태평양)와 한국\n   * 공장을 함께 가질 수 있다. 테넌트 단위(`Domain.timezone`)로 두면 **둘 중 하나는 반드시 틀린다.**\n   * 시각 기준은 **물리 현장의 성질**이므로 공간이 그것을 갖는다(공간 중심 원칙).\n   *\n   * `timezone` 은 IANA 이름(`'America/Tijuana'`) — 오프셋 숫자가 아니다. 숫자로 두면 일광절약시간을\n   * 표현할 수 없고, 나중에 절대 구간으로 옮길 때도 이름이 있어야 계산할 수 있다.\n   */\n  space: { spaceId?: string; width: number; depth: number; unit?: string; timezone?: string; geo?: { lat: number; lon: number; rotation?: number }; representations?: any[]; primaryId?: string }\n  locations: RefLocation[]\n  equipment?: RefEquipment[]\n  /** 공정 명세(소요·변동·수율) — 없으면 커널 기본값으로 굴러간다(그 사실은 specCoverage 가 보고). */\n  operations?: RefOperation[]\n  /**\n   * **생산 정의**(레시피·라우트·자재 바인딩) — 커널의 정의-구동 MES 모드 입구.\n   *\n   * 없으면 커널은 레거시(하드코딩) 흐름으로 동작한다. 즉 **현장 레시피를 적어도 이 자리에 실리지 않으면\n   * 커널은 그것을 보지 못한다** — 선언과 실행이 어긋나는 지점이라 자리를 연다.\n   */\n  /**\n   * 생산 선언 — `TwinModelDef.productionSpec` 으로 통과한다(ISA-95 OperationsSegment + BOM).\n   *\n   * 예전 이름은 `mesSpec` 이었다. 담긴 것은 MES 만의 것이 아니라 \"자재를 소비해 자재를 산출하는\n   * 공정\" 이고, 이름이 MES 였기 때문에 창고 트윈은 이 자리를 쓸 생각조차 하지 못했다(유통가공 창고가\n   * BOM 을 설명 문서에만 적어 둔 채 키트를 못 만드는 트윈을 만든 원인). 근거는 커널 계약 주석에.\n   */\n  productionSpec?: unknown\n  /**\n   * 사람 — 선언하지 않으면 **인원 제약이 없는 트윈**이 된다(설비만 있으면 언제나 가동되는 공장).\n   * 공정이 인원을 요구하는데 사람이 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.\n   */\n  persons?: RefPerson[]\n  /**\n   * 물리 자산(반복사용) — 선언하지 않으면 자산 제약이 없는 트윈이다.\n   * 공정이 자산을 요구하는데 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.\n   */\n  assets?: RefAsset[]\n  /**\n   * 등급 정의 — 표준 `PersonnelClass`·`EquipmentClass`·`PhysicalAssetClass`.\n   * 안 실어도 트윈은 동작한다(소속 문자열 그대로 판정). 실으면 상속·유효기간이 살아난다.\n   */\n  personnelClasses?: RefResourceClass[]\n  equipmentClasses?: RefResourceClass[]\n  assetClasses?: RefResourceClass[]\n  /** 품목 정의·등급 — 표준 `MaterialDefinition` / `MaterialClass`. 없으면 단위 환산을 할 수 없다. */\n  materialDefinitions?: RefMaterialDefinition[]\n  materialClasses?: RefResourceClass[]\n  /**\n   * 커넥터가 **옮기는 동안 알게 된 것.** 외부 시스템의 값을 우리 어휘로 못 옮겨 기본값을 넣었다면\n   * 여기에 담아 보낸다 — 그러면 `masterToTwin` 의 경고와 한 줄기로 합쳐져 화면까지 간다.\n   *\n   * 이 자리가 없던 동안 커넥터는 할 말이 있어도 **말할 곳이 없었다.** 그래서 도크를 랙으로 바꿔\n   * 놓고도 조용히 성공했다. 옮기는 사람만 아는 사실은 옮기는 자리에서 실어야 한다.\n   */\n  warnings?: IngestWarning[]\n}\n\nexport interface IngestedTwin {\n  model: any // TwinModelDef(+layout+spaceId) — 커널 소비\n  spaceContent: any // TwinSpace content — 뷰 소비\n  warnings: IngestWarning[]\n}\n\n/**\n * 마스터 → 트윈 구조 매핑(순수). 노드타입을 카탈로그로 검증(모르는 타입은 warning, 버리진 않음 — 반영 우선).\n * @param catalog DOMAIN_CATALOG (커널 SSOT). 없으면 검증 생략.\n */\n/**\n * IANA 시간대 이름 → **그 시각의** UTC 오프셋(분). 의존성 없이 `Intl` 로 푼다.\n *\n * `Intl.DateTimeFormat` 의 `longOffset` 은 `\"GMT-07:00\"` 처럼 나오고, 이것은 **일광절약시간을 반영한**\n * 값이다. 그래서 8월의 `America/Tijuana` 는 −420(PDT), 1월은 −480(PST)이 된다.\n *\n * **한계를 밝힌다**: 여기서 나오는 것은 **한 시점의** 오프셋이다. 커널은 고정 오프셋으로 하루 중 분을\n * 읽으므로, 모델을 만든 계절과 다른 계절을 길게 예측하면 한 시간 어긋난다. 표준에 충실한 끝 모습은\n * 호스트가 절대 구간(`StartDateTime`/`FinishDateTime`)을 계산해 넣는 것이고, 그때 이 함수는 사라진다.\n *\n * 모르는 이름에는 **0 을 답하지 않는다**(`undefined`) — 0 은 \"UTC 라고 선언했다\" 는 뜻이고, 모르는 것을\n * 그렇게 바꾸면 판정이 조용히 틀린다.\n */\nexport function utcOffsetOf(timezone?: string, at: Date = new Date()): number | undefined {\n  if (!timezone) return undefined\n  try {\n    const parts = new Intl.DateTimeFormat('en-US', { timeZone: timezone, timeZoneName: 'longOffset' }).formatToParts(at)\n    const name = parts.find(p => p.type === 'timeZoneName')?.value ?? ''\n    if (name === 'GMT') return 0 // UTC 계열은 오프셋 표기가 없다\n    const m = /^GMT([+-])(\\d{1,2})(?::(\\d{2}))?$/.exec(name)\n    if (!m) return undefined\n    const sign = m[1] === '-' ? -1 : 1\n    return sign * (Number(m[2]) * 60 + Number(m[3] ?? 0))\n  } catch {\n    return undefined // 알 수 없는 이름 — Intl 이 던진다\n  }\n}\n\n\n/* ── 인제스트 경고 ──────────────────────────────────────────────────────────\n * 인제스트는 구조에 문제가 있어도 트윈을 만들어 준다(막지 않는 것이 옳다 — 부분적으로라도 세우고\n * 고쳐 나가는 것이 이 시스템의 방식이다). 그래서 **경고가 유일한 신호**인데, 그 경고를 화면이 하나도\n * 보여주지 않고 있었다: 유통가공 창고 템플릿은 커널이 모르는 자리 타입(`vas-station`)으로 트윈을\n * 만들면서 경고를 냈지만, 위자드는 그것을 버렸고 사용자는 아무 말 없이 막히는 트윈을 받았다.\n *\n * 문장이 아니라 코드로 실어 보낸다. 예전 경고는 프로즈였고 그중 하나에는 한글이 섞여 있었다\n * (`— 카탈로그에 없음`) — 다섯 언어 화면에 그대로 내보내면 이번에 걷어낸 문제를 다시 만든다.\n * 이 프로젝트가 이미 쓰는 규약과 같은 모양이다: 주의 신호(kind+params)·커맨드 거절(errorCode+params)·\n * 만만함 판정(code+영어 canonical message).\n *\n *   code    언어 중립 — 화면이 `twin.ingest.<code>` 로 사람 말을 만든다\n *   params  문장에 끼울 값 — 번역이 언어마다 어순을 바꿀 수 있게\n *   message 영어 canonical — 로그에 남고, 번역이 없을 때 그대로 보인다(빈칸보다 낫다)\n *\n * **여기 사는 이유**: 이 파일이 경고의 생산자이고, 테스트가 소스에서 직접 읽는 모듈이라\n * 런타임 상대 import 를 가질 수 없다(이 저장소의 규약 — 그런 모듈은 자기완결이다).\n * ────────────────────────────────────────────────────────────────────────── */\n/** 인제스트가 알리는 한 가지. */\nexport interface IngestWarning {\n  /** 언어 중립 코드. 화면은 `twin.ingest.<code>` 로 렌더한다. */\n  code: string\n  /** 문장에 끼울 값. 번역이 어순을 바꿀 수 있게 이름으로 넘긴다. */\n  params?: Record<string, string | number>\n  /** 영어 canonical 문장 — 로그·폴백용. 번역이 없어도 읽을 수 있어야 한다. */\n  message: string\n}\n\n/**\n * **시각을 모르는 채 시각으로 판정하려 한다** — 발전 형상은 하루의 시각을 읽는데 이 트윈의 공간이\n * 시간대를 말하지 않았다.\n *\n * ── 왜 경고인가 (2026-08-18) ────────────────────────────────────────────────\n * 커널은 시간대를 모르면 UTC 로 읽는다(계약에 밝혀 둔 규율 — 모르는 값을 지어내지 않는다). 그런데 발전\n * 형상은 **시각별 비율**이라, 시간대가 없으면 현장 정오가 아니라 UTC 정오에 피크가 선다(KST 현장이면\n * 밤 9시). 값이 그럴듯하게 나오므로 아무도 알아채지 못한다.\n *\n * 그래서 시간대를 **지어내지 않고**(서버 로컬이나 임의 기본값을 넣으면 그 트윈의 모든 시각 판정이 조용히\n * 그 가정 위에 선다) 대신 **그 조합을 말한다** — 공간에 시간대를 선언하면 사라지는 경고다.\n */\nexport const generationWithoutTimeZone = (spaceId: string, equipmentId: string): IngestWarning => ({\n  code: 'generation-without-time-zone',\n  params: { spaceId, equipmentId },\n  message:\n    `\"${equipmentId}\" declares a daily generation shape but space \"${spaceId}\" declares no time zone — the hourly fractions will be read in UTC, ` +\n    'so the generation peak will not land at local noon. Declare the space time zone (we do not guess one).'\n})\n\n/** 커널 카탈로그가 모르는 자리 타입 — 그 자리는 흐름에 참여하지 못할 수 있다. */\nexport const unknownLocationType = (system: string, type: string, id: string): IngestWarning => ({\n  code: 'unknown-location-type',\n  params: { system, type, id },\n  message: `\"${type}\" is not a known ${system} location type (${id}) — the kernel may not include this location in the flow`\n})\n\n/** 시간대 문자열을 못 읽었다 — 시각 해석이 UTC 로 떨어진다(조용히 현지 시각으로 가정하지 않는다). */\nexport const unknownTimezone = (timezone: string): IngestWarning => ({\n  code: 'unknown-timezone',\n  params: { timezone },\n  message: `space timezone \"${timezone}\" is not a known IANA zone — the twin will read times as UTC`\n})\n\n/** 작업 정의에 소요시간·파라미터가 없다 — 커널 기본값으로 동작한다. */\nexport const operationWithoutDuration = (operation: string): IngestWarning => ({\n  code: 'operation-without-duration',\n  params: { operation },\n  message: `operation \"${operation}\" has no duration or parameters — kernel defaults will be used`\n})\n\n/** 볼 수 있는 표현이 없다 — 현장이 화면에 뜨지 않는다. */\nexport const noViewableRepresentation = (): IngestWarning => ({\n  code: 'no-viewable-representation',\n  message: 'the space has no viewable representation (no representations and no geo) — add one, or provide geo/board'\n})\n\n/**\n * 구조 투영에서 **가리키는 대상을 못 찾았다.**\n *\n * 예전에는 이런 참조가 model JSON 안의 맨 문자열이라 화면만 경고할 수 있었고, 다른 경로로 들어온\n * 데이터는 아무도 안 봤다. 이제 행으로 풀면서 **인제스트가 직접 안다** — 그러니 인제스트가 말한다.\n * 막지는 않는다(트윈은 model 로 이미 동작한다). 다만 조용히 넘기지 않는다.\n */\nexport const unresolvedReference = (field: string, ref: string): IngestWarning => ({\n  code: 'unresolved-reference',\n  params: { field, ref },\n  message: `${field} points at something that is not in this twin (${ref}) — the link was left empty`\n})\n\n/**\n * 구조 투영 자체가 실패했다 — 조회는 못 하지만 **트윈은 동작한다**(커널은 model 를 이미 받았다).\n * 행은 원본에서 다시 그릴 수 있으므로 인제스트를 실패로 만들지 않되, 침묵하지도 않는다.\n */\nexport const projectionFailed = (reason: string): IngestWarning => ({\n  code: 'projection-failed',\n  params: { reason },\n  message: `structure projection failed (${reason}) — the twin runs, but model inspection will be stale until the next ingest`\n})\n\n/**\n * **동작 중에 공장을 전환했다** — 미러는 멈추지 않으므로, 무엇이 사라졌는지 여기서 말한다.\n *\n * 멈췄다 세우는 구조 전환이라면 사용자가 \"다시 세웠다\" 는 것을 안다. 미러는 그 마디가 없어서\n * 자리 하나·설비 한 대가 조용히 없어질 수 있다 — 자리가 수천인 현장에서 화면의 수를 세어\n * 눈치채기를 기대할 수는 없다. 늘어난 것도 함께 말한다(무엇이 반영되었나가 곧 인제스트의 답이다).\n */\nexport const structureAdopted = (rev: number, shift: { locationsAdded: number; locationsDropped: number; equipmentDropped: number; personsDropped: number; assetsDropped: number }): IngestWarning => ({\n  code: 'structure-adopted',\n  params: { rev, ...shift },\n  message:\n    `the running mirror adopted a new structure (revision ${rev}) — ` +\n    `+${shift.locationsAdded} location(s), -${shift.locationsDropped} location(s), ` +\n    `-${shift.equipmentDropped} equipment, -${shift.personsDropped} person(s), -${shift.assetsDropped} asset(s)`\n})\n\n/**\n * 커넥터가 외부 시스템의 값을 **우리 어휘로 옮기지 못해 기본값을 넣었다.**\n *\n * 예: Oracle WMS 가 우리 표에 없는 `locn_type` 을 주면 그 자리는 `storage` 가 된다 — 도크가 랙으로\n * 모델링되는 것이다. 인제스트를 통째로 실패시킬 일은 아니지만(로케이션 하나 때문에 현장 전체가\n * 안 들어오는 편이 더 나쁘다), **조용히 넘어가면 안 된다.** 트윈이 실물과 다르게 생겼는데\n * 아무도 그 사실을 모른 채 그 위에서 흐름을 논하게 된다.\n *\n * 값을 나열하는 이유: \"3건\" 만으로는 커넥터 매핑에 무엇을 더해야 하는지 알 수 없다.\n */\nexport const connectorMappingFallback = (field: string, fallback: string, values: readonly string[], count: number): IngestWarning => ({\n  code: 'connector-mapping-fallback',\n  params: { field, fallback, values: values.join(', '), count },\n  message: `${count} ${field} value(s) had no mapping and fell back to \"${fallback}\" (${values.join(', ')}) — the twin's shape differs from the source system here`\n})\n\n\n/** 로그 한 줄 — 개발자가 읽는 것이므로 영어 canonical 문장을 쓴다. */\nexport const describeWarnings = (warnings: readonly IngestWarning[]): string =>\n  warnings.map(w => `${w.code}: ${w.message}`).join(' | ')\n\n/**\n * 서버가 기본값으로 채운 노브들 — 사용자가 준 적 없는 값으로 트윈이 만들어졌음을 알린다.\n *\n * 조용히 채우면 나중에 \"왜 이 수치인가\" 를 아무도 답할 수 없다. 막을 일은 아니다(기본값은 템플릿이\n * 확신을 갖고 선언한 값이다) — 다만 밝힌다.\n */\nexport const knobDefaultsFilled = (keys: readonly string[]): IngestWarning => ({\n  code: 'knob-defaults-filled',\n  params: { keys: keys.join(', '), count: keys.length },\n  message: `values you did not provide were filled from the template defaults: ${keys.join(', ')}`\n})\n\n/**\n * 이 현장의 설비를 노브 값으로 채웠다 — **조용히 채우지 않는다.**\n *\n * 에너지 트윈의 부하를 이웃 설비 id 로 선언할 때 쓴다. 몇 개를 가져왔는지 말해 주지 않으면, 사용자는\n * 자기가 고르지 않은 설비들이 부하로 잡힌 것을 나중에 화면에서야 알게 된다.\n */\nexport const siteEquipmentAdopted = (key: string, count: number): IngestWarning => ({\n  code: 'site-equipment-adopted',\n  params: { key, count },\n  message: `${count} piece(s) of equipment already on this site were adopted as loads (knob \"${key}\") — set their coefficients before trusting the numbers`\n})\n\nexport function masterToTwin(master: ReferenceMaster, catalog?: any): IngestedTwin {\n  /* 커넥터가 옮기며 알게 된 것을 먼저 싣는다 — 원인이 앞에 오는 편이 읽기 쉽다(대체가 먼저, 그 결과가 뒤). */\n  const warnings: IngestWarning[] = [...(master.warnings ?? [])]\n  const known: string[] = catalog?.[master.system]?.locationTypes ?? []\n\n  const locationEntries = master.locations.filter(l => l.role === 'location' || l.role === 'both')\n  const areaLocs = master.locations.filter(l => l.role === 'area' || l.role === 'both')\n\n  const locations = locationEntries.map(l => {\n    if (known.length && !known.includes(l.type)) warnings.push(unknownLocationType(master.system, l.type, l.id))\n    // gs1Id(정식 정체성)를 모델의 자리로 통과 — 결합(tag)/추적이 GS1 로(§J). 로컬 id 는 그대로 유지(name/xref).\n    /*\n     * **이름을 통과시킨다.** 여기서 버리고 있었다 — 그래서 모델에도, 투영한 행에도 이름이 없고\n     * 화면은 자리 id 를 그대로 찍었다(`cut-station`). 목록·표·관계 그림에서 같은 결함이 따로\n     * 보였던 이유가 이 한 줄이다. 이름 없는 원본은 이름 없이 통과한다(id 로 메우지 않는다).\n     */\n    /*\n     * **속성도 통과시킨다** — 설비와 같은 규율(손대지 않고 나른다). 여기가 없으면 자리에 실은 값이\n     * 커널에 닿지 않는다: 에너지의 계약전력(`contract.kW`)이 그 경로이고, 통과하지 않으면 커널이\n     * 계약을 모르는 채로 서서 **판정을 아예 하지 않는다**(오류 없이 조용히).\n     */\n    return { id: l.id, type: l.type, ...(l.name ? { name: l.name } : {}), ...(l.description ? { description: l.description } : {}), capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), ...(l.properties?.length ? { properties: l.properties } : {}), parentId: l.parentId, ...(l.upstreamId ? { upstreamId: l.upstreamId } : {}), gs1Id: l.gs1Id }\n  })\n\n  const equipment = (master.equipment ?? []).map(e => ({\n    id: e.id, kind: e.kind, ...(e.name ? { name: e.name } : {}), ...(e.description ? { description: e.description } : {}), ...(e.testResults?.length ? { testResults: e.testResults } : {}),\n    homeLocation: e.homeLocationId, mtbfMs: e.mtbfMs, mttrMs: e.mttrMs, gs1Id: e.gs1Id,\n    ...(e.window ? { window: e.window } : {}),\n    /* 속성은 손대지 않고 통과 — 이동시간 추정기가 kind 별 속도를 여기서 읽는다(단위 코드 그대로). */\n    ...(e.properties?.length ? { properties: e.properties } : {}), ...(e.workCalendar?.length ? { workCalendar: e.workCalendar } : {}), ...(e.testSpecificationIds?.length ? { testSpecificationIds: e.testSpecificationIds } : {}),\n    /* 유효 기간도 손대지 않고 통과 — 판정은 커널이 자기 시계로 한다(호스트가 미리 자르지 않는다). */\n    ...(e.effectiveStart ? { effectiveStart: e.effectiveStart } : {}), ...(e.effectiveEnd ? { effectiveEnd: e.effectiveEnd } : {})\n  }))\n\n  // 좌표(layout) — footprint 중심. 없으면 생략(coordinate-free 유지).\n  const layout: Record<string, { x: number; y: number }> = {}\n  for (const l of locationEntries) if (l.footprint) layout[l.id] = { x: l.footprint.x + l.footprint.w / 2, y: l.footprint.y + l.footprint.h / 2 }\n\n  const spaceId = master.space.spaceId ?? `${master.source}-site`\n  /*\n   * 시각 기준을 커널이 읽을 형태로 푼다 — 커널은 zero-dep 이라 시간대 데이터베이스를 들이지 않고\n   * **분 오프셋**만 받는다(계약 `TwinModelDef.utcOffsetMinutes`). 푸는 일은 호스트의 몫이다.\n   *\n   * 선언이 없으면 **필드를 만들지 않는다** — 그러면 커널이 UTC 로 읽고, 그 기본값은 계약에 밝혀져 있다.\n   * 여기서 0 을 넣으면 \"UTC 라고 선언했다\" 와 \"선언하지 않았다\" 가 구별되지 않는다.\n   */\n  const utcOffsetMinutes = utcOffsetOf(master.space.timezone)\n  if (master.space.timezone && utcOffsetMinutes === undefined) {\n    warnings.push(unknownTimezone(String(master.space.timezone)))\n  }\n  /*\n   * 오퍼레이션 명세를 model 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(TwinModelDef 확장 필드,\n   * 모르는 커널은 무시). 여기서 값을 손대지 않는다: 기간은 표준 표기(ISO 8601)로 커널까지 그대로 간다.\n   */\n  const operations = master.operations\n  if (operations?.length) {\n    for (const o of operations) {\n      if (!o.duration && !o.parameters?.length) warnings.push(operationWithoutDuration(o.key))\n    }\n  }\n  /* 사람도 손대지 않고 통과 — 등급·교대 그대로 커널까지 간다(경계에서 어휘를 갈지 않는다). */\n  const persons = master.persons?.map(p => ({ id: p.id, ...(p.name ? { name: p.name } : {}), ...(p.testResults?.length ? { testResults: p.testResults } : {}), personnelClassIds: p.personnelClassIds, ...(p.window ? { window: p.window } : {}), ...(p.workCalendar?.length ? { workCalendar: p.workCalendar } : {}), ...(p.homeLocationId ? { homeLocation: p.homeLocationId } : {}), ...(p.properties?.length ? { properties: p.properties } : {}), ...(p.testSpecificationIds?.length ? { testSpecificationIds: p.testSpecificationIds } : {}), ...(p.effectiveStart ? { effectiveStart: p.effectiveStart } : {}), ...(p.effectiveEnd ? { effectiveEnd: p.effectiveEnd } : {}) }))\n  /* 자산도 손대지 않고 통과 — 등급·자리 그대로 커널까지. */\n  const assets = master.assets?.map(a => ({ id: a.id, ...(a.name ? { name: a.name } : {}), ...(a.testResults?.length ? { testResults: a.testResults } : {}), assetClassIds: a.assetClassIds, homeLocation: a.homeLocationId, gs1Id: a.gs1Id, ...(a.properties?.length ? { properties: a.properties } : {}), ...(a.testSpecificationIds?.length ? { testSpecificationIds: a.testSpecificationIds } : {}), ...(a.effectiveStart ? { effectiveStart: a.effectiveStart } : {}), ...(a.effectiveEnd ? { effectiveEnd: a.effectiveEnd } : {}) }))\n  /* 품목 정의·등급도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(환산 계수는 커널이 읽는다). */\n  const materialDefinitions = master.materialDefinitions?.map(d => ({\n    id: d.id,\n    /* 이름은 이름 자리에 — 예전에는 `name` 을 `description` 으로 옮겨 담았다(어휘가 뒤집혀 있었다). */\n    ...(d.name ? { name: d.name } : {}),\n    ...(d.materialClassIds?.length ? { materialClassIds: d.materialClassIds } : {}),\n    ...(d.properties?.length ? { properties: d.properties } : {}),\n    ...(d.testSpecificationIds?.length ? { testSpecificationIds: d.testSpecificationIds } : {}),\n    ...(d.effectiveStart ? { effectiveStart: d.effectiveStart } : {}),\n    ...(d.effectiveEnd ? { effectiveEnd: d.effectiveEnd } : {})\n  }))\n  /*\n   * **등급의 표시명은 `name` 이다.**\n   *\n   * 표준 마스터는 등급의 표시명을 `description` 에 담는다(`RefResourceClass.description` = i18n 키).\n   * 그것을 그대로 모델에 실으면 화면의 \"설명\" 열에 이름이 앉는다 — 사용자에게는 이름인데 머리글은\n   * 설명이라, 같은 것을 축마다 다른 이름으로 부르게 된다.\n   *\n   * 그래서 **문 하나에서 어휘를 맞춘다**: 표시명은 어느 축이든 `name`. 원래의 `description` 은\n   * 남겨 두지 않는다 — 두 자리에 같은 값이 있으면 어느 것이 정본인지 다시 헷갈린다.\n   */\n  const asName = (list?: RefResourceClass[]) =>\n    list?.map(({ description, ...rest }) => ({ ...rest, ...(description ? { name: description } : {}) }))\n  /*\n   * 검사 명세도 **표시명은 `name`** 이다 — 등급과 같은 규칙을 쓴다(어휘를 하나로). 표준 마스터는\n   * 표시명을 `description` 에 담으므로 문 하나에서 옮긴다. 그러지 않으면 화면의 \"설명\" 열에 이름이\n   * 앉아 축마다 다른 이름으로 같은 것을 부르게 된다(등급에서 이미 겪었다).\n   */\n  const testSpecifications = master.testSpecifications?.map(({ description, ...rest }) => ({\n    ...rest,\n    ...(description ? { name: description } : {})\n  }))\n  const personnelClasses = asName(master.personnelClasses)\n  const equipmentClasses = asName(master.equipmentClasses)\n  const assetClasses = asName(master.assetClasses)\n  const materialClasses = asName(master.materialClasses)\n\n  const model = {\n    locations, equipment, layout, spaceId,\n    /* 생산 정의도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(커널이 그대로 소비한다). */\n    ...(master.productionSpec ? { productionSpec: master.productionSpec } : {}),\n    ...(materialDefinitions?.length ? { materialDefinitions } : {}),\n    ...(materialClasses?.length ? { materialClasses } : {}),\n    ...(utcOffsetMinutes !== undefined ? { utcOffsetMinutes } : {}),\n    ...(operations?.length ? { operations } : {}),\n    ...(testSpecifications?.length ? { testSpecifications } : {}),\n    ...(personnelClasses?.length ? { personnelClasses } : {}),\n    ...(equipmentClasses?.length ? { equipmentClasses } : {}),\n    ...(assetClasses?.length ? { assetClasses } : {}),\n    ...(persons?.length ? { persons } : {}),\n    ...(assets?.length ? { assets } : {})\n  }\n\n  const areas = areaLocs.map(l => ({\n    id: l.id, type: l.type, name: l.name ?? l.id, parentId: l.parentId, ...(l.upstreamId ? { upstreamId: l.upstreamId } : {}),\n    x: l.footprint?.x ?? 0, y: l.footprint?.y ?? 0, w: l.footprint?.w ?? 10, h: l.footprint?.h ?? 10\n  }))\n  // 인제스트 현장 물질화(space facet #4) — 표현이 없고 geo 가 있으면 기본 map 표현 합성.\n  // \"인제스트하면 알아볼 현장(내 place)이 뜬다\"는 공간 중심 정수 보장(zero-to-twin): 커넥터/템플릿이\n  // 표현을 안 줘도 geo 만 있으면 위성 지도로 착지. (area 폴리곤 물질화는 좌표 투영 필요 → space #3.)\n  const geo = master.space.geo\n  const givenReps = master.space.representations ?? []\n  const representations =\n    givenReps.length > 0\n      ? givenReps\n      : geo\n        ? [{ id: 'r-map', type: 'map', name: '위성 지도', primary: true, center: { lat: geo.lat, lon: geo.lon }, zoom: 17 }]\n        : []\n  if (representations.length === 0) {\n    warnings.push(noViewableRepresentation())\n  }\n  const spaceContent = {\n    width: master.space.width, depth: master.space.depth, unit: master.space.unit ?? 'm',\n    geo, representations, primaryId: master.space.primaryId ?? representations[0]?.id,\n    areas\n  }\n\n  return { model, spaceContent, warnings }\n}\n\n/**\n * 다시 읽을 사이트를 고른다 — **기억해 둔 사이트 하나만**.\n *\n * 못 찾으면 **첫 사이트로 때우지 않는다**: 다른 현장의 구조를 이 트윈에 덮어쓰는 일이고, 그것은 오류가\n * 아니라 **조용히 틀린 공장**으로 나타난다. 기억이 없는 옛 트윈은 `undefined` 를 돌려주고, 부르는 쪽이\n * 마스터의 정체(`source` = 인스턴스 id)로 찾는 길을 택한다.\n */\nexport function pickOriginSite<T extends { siteId: string }>(\n  sites: readonly T[],\n  origin: { siteId?: string } | undefined | null\n): { site?: T; reason?: 'no-remembered-site' | 'site-gone' } {\n  const wanted = String(origin?.siteId ?? '').trim()\n  if (!wanted) return { reason: 'no-remembered-site' }\n  const site = sites.find(s => String(s.siteId) === wanted)\n  return site ? { site } : { reason: 'site-gone' }\n}\n"]}