@things-factory/headless-twin 10.0.8 → 10.0.10

package/dist-server/service/twin-space/move-space.js

@@ -0,0 +1,166 @@
+"use strict";
+/*
+ * 이미 있는 트윈을 다른 현장으로 옮긴다 — **판정만**. 순수.
+ *
+ * ── 왜 있나 (2026-08-13) ────────────────────────────────────────────────────
+ * 트윈↔현장 연결은 **만들 때만** 정할 수 있었다(템플릿 위자드·import 의 `spaceId`). 잘못 넣었거나,
+ * 나중에 "이 창고는 사실 저 공장과 같은 부지다" 를 알게 되면 지우고 다시 만드는 것이 유일한 길이었다 —
+ * 다시 만들면 그 트윈의 저널(일어난 일)이 사라진다. 고칠 수 있는 실수를 데이터 손실로 갚게 하는 설계다.
+ *
+ * ── 옮기는 것이 무엇을 옮기나 (엔티티 키를 보고 정했다) ──────────────────────
+ * 무엇이 트윈에 매여 있고 무엇이 공간에 매여 있는지가 답을 정한다:
+ *
+ *  · `TwinEvent`         `(domain, instanceId, …)`  → **따라온다.** 저널을 다시 쓰지 않는다.
+ *  · `TwinLocation/Equipment/Operation`  `(domain, instance, …)`  → **따라온다.**
+ *  · `TwinArea`          `(domain, space, areaId)`  → **남는다.** 구역은 공간의 것이다.
+ *  · `TwinSpaceRepresentation`(지도·이미지·보드)     → **남는다.** 표현도 공간의 것이다.
+ *
+ * 그래서 옮기기는 이력 이전이 아니라 **소속 갱신**이다(`instance.spaceId` + `model.spaceId`).
+ * 대신 공간에 매인 것들과의 연결이 끊길 수 있고, 그것을 **조용히 넘기지 않는 것**이 이 모듈의 일이다.
+ *
+ * ── 거절과 경고를 가른다 ────────────────────────────────────────────────────
+ * 거절: 되돌릴 수 없거나 뜻이 성립하지 않는 것(없는 공간·같은 공간·벤치 사본).
+ * 경고: 사용자가 알고 나면 정당할 수 있는 것(구역 소속이 끊긴다·시간대가 다르다·옛 표현이 남는다).
+ * 경고를 거절로 올리면 정당한 이전을 막고, 거절을 경고로 낮추면 조용한 사고가 된다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.judgeMoveTwinSpace = judgeMoveTwinSpace;
+exports.judgeDetachTwinSpace = judgeDetachTwinSpace;
+/** 옮겨도 되나 — 되면 무엇을 알려야 하나. */
+function judgeMoveTwinSpace(input) {
+    const to = (input.toSpaceId ?? '').trim();
+    const from = (input.fromSpaceId ?? '').trim();
+    if (!input.instanceId) {
+        return {
+            refusal: { code: 'twin-not-found', message: 'no such twin in this tenant' },
+            warnings: []
+        };
+    }
+    if (!to || !input.toSpaceExists) {
+        return {
+            refusal: {
+                code: 'space-not-found',
+                params: { spaceId: to },
+                message: `space "${to}" not found — cannot move a twin into a space that does not exist`
+            },
+            warnings: []
+        };
+    }
+    if (from && from === to) {
+        return {
+            refusal: {
+                code: 'same-space',
+                params: { spaceId: to },
+                message: `twin "${input.instanceId}" is already in space "${to}"`
+            },
+            warnings: []
+        };
+    }
+    /* 벤치 사본은 "이 공장이 이만큼 커지면" 을 재는 사본이라 원본의 현장에 매여 있다. 옮기면 그 측정이
+       무엇의 측정인지 말할 수 없게 된다 — 사본을 옮기는 대신 원본을 옮기고 사본을 다시 뜬다. */
+    if (input.purpose === 'bench') {
+        return {
+            refusal: {
+                code: 'bench-copy',
+                params: { instanceId: input.instanceId },
+                message: `twin "${input.instanceId}" is a bench copy — move its source twin instead`
+            },
+            warnings: []
+        };
+    }
+    const warnings = [];
+    /* 로케이션의 구역 소속 — 구역은 공간의 것이라 새 공간에 같은 id 가 없으면 소속이 끊긴다.
+       막지는 않는다(새 공간에서 구역을 다시 그리는 것이 정상 경로다). 다만 몇 개가 끊기는지 말한다. */
+    const refs = [...new Set((input.areaRefs ?? []).filter((x) => !!x && !!x.trim()))];
+    const have = new Set(input.toAreaIds ?? []);
+    const orphaned = refs.filter(r => !have.has(r)).sort();
+    if (orphaned.length) {
+        warnings.push({
+            code: 'areas-left-behind',
+            params: { count: orphaned.length, areas: orphaned.slice(0, 5).join(', ') },
+            message: `${orphaned.length} area reference(s) do not exist in the target space — those locations lose their grouping: ${orphaned
+                .slice(0, 5)
+                .join(', ')}`
+        });
+    }
+    /* 시간대 — 공간이 정하고 커널이 분 오프셋으로 받는다. 다르면 같은 저널이 다른 시각으로 읽힌다. */
+    const tzFrom = (input.fromTimezone ?? '').trim();
+    const tzTo = (input.toTimezone ?? '').trim();
+    if (tzFrom !== tzTo) {
+        warnings.push({
+            code: 'timezone-differs',
+            params: { from: tzFrom || '—', to: tzTo || '—' },
+            message: `time zone changes from "${tzFrom || 'unset'}" to "${tzTo || 'unset'}" — shift boundaries and day buckets will read differently`
+        });
+    }
+    /* 옛 공간의 표현 — 폴리곤 바인딩이 이 트윈의 로케이션·그룹을 가리키고 있었을 수 있다. 표현은
+       공간에 남으므로, 그 화면에서 이 트윈이 사라진다. 몇 개가 남는지 말해 두면 사람이 찾아갈 수 있다. */
+    if ((input.fromRepresentationCount ?? 0) > 0) {
+        warnings.push({
+            code: 'representations-left-behind',
+            params: { count: input.fromRepresentationCount, spaceId: from || '—' },
+            message: `${input.fromRepresentationCount} representation(s) stay with space "${from}" — bindings that pointed at this twin will no longer resolve there`
+        });
+    }
+    /* 실행 중 — 소속은 즉시 바뀌지만 시간대는 커널을 세울 때 실린다. 시간대가 같으면 말할 것이 없다. */
+    if (input.running && tzFrom !== tzTo) {
+        warnings.push({
+            code: 'running',
+            params: { instanceId: input.instanceId },
+            message: `twin "${input.instanceId}" is running — the new time zone applies after it is restarted`
+        });
+    }
+    return { warnings };
+}
+/** 떼도 되나 — 되면 무엇을 알려야 하나. */
+function judgeDetachTwinSpace(input) {
+    const from = (input.fromSpaceId ?? '').trim();
+    if (!input.instanceId) {
+        return { refusal: { code: 'twin-not-found', message: 'no such twin in this tenant' }, warnings: [] };
+    }
+    if (!from) {
+        return {
+            refusal: {
+                code: 'no-space',
+                params: { instanceId: input.instanceId },
+                message: `twin "${input.instanceId}" is not on any site — nothing to detach`
+            },
+            warnings: []
+        };
+    }
+    /* 벤치 사본은 원본의 현장을 따라야 측정이 무엇의 측정인지 말할 수 있다(옮기기와 같은 이유). */
+    if (input.purpose === 'bench') {
+        return {
+            refusal: {
+                code: 'bench-copy',
+                params: { instanceId: input.instanceId },
+                message: `twin "${input.instanceId}" is a bench copy — it must stay on the site it measures`
+            },
+            warnings: []
+        };
+    }
+    const warnings = [
+        {
+            code: 'no-stage',
+            params: { instanceId: input.instanceId },
+            message: `twin "${input.instanceId}" will have no site to be drawn on — it stays visible in lists and inspection only`
+        }
+    ];
+    if ((input.fromRepresentationCount ?? 0) > 0) {
+        warnings.push({
+            code: 'representations-left-behind',
+            params: { count: input.fromRepresentationCount, spaceId: from },
+            message: `${input.fromRepresentationCount} representation(s) stay with space "${from}" — bindings that pointed at this twin will no longer resolve there`
+        });
+    }
+    const tz = (input.fromTimezone ?? '').trim();
+    if (tz) {
+        warnings.push({
+            code: 'timebase-kept',
+            params: { timezone: tz },
+            message: `the time base stays as "${tz}" (the site it came from) — clearing it would silently read times as UTC`
+        });
+    }
+    return { warnings };
+}
+//# sourceMappingURL=move-space.js.map

package/dist-server/service/twin-space/move-space.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-space.js","sourceRoot":"","sources":["../../../server/service/twin-space/move-space.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;AAkDH,gDA2FC;AA2CD,oDAsDC;AA7LD,8BAA8B;AAC9B,SAAgB,kBAAkB,CAAC,KAAqB;IACtD,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACzC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAE7C,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,6BAA6B,EAAE;YAC3E,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IACD,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,iBAAiB;gBACvB,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;gBACvB,OAAO,EAAE,UAAU,EAAE,mEAAmE;aACzF;YACD,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;gBACvB,OAAO,EAAE,SAAS,KAAK,CAAC,UAAU,0BAA0B,EAAE,GAAG;aAClE;YACD,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IACD;6DACyD;IACzD,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;gBACxC,OAAO,EAAE,SAAS,KAAK,CAAC,UAAU,kDAAkD;aACrF;YACD,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAuB,EAAE,CAAA;IAEvC;iEAC6D;IAC7D,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAC/F,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACtD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC1E,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,8FAA8F,QAAQ;iBAC9H,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,IAAI,CAAC,IAAI,CAAC,EAAE;SAChB,CAAC,CAAA;IACJ,CAAC;IAED,4DAA4D;IAC5D,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAChD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,GAAG,EAAE;YAChD,OAAO,EAAE,2BAA2B,MAAM,IAAI,OAAO,SAAS,IAAI,IAAI,OAAO,4DAA4D;SAC1I,CAAC,CAAA;IACJ,CAAC;IAED;mEAC+D;IAC/D,IAAI,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,6BAA6B;YACnC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,uBAAiC,EAAE,OAAO,EAAE,IAAI,IAAI,GAAG,EAAE;YAChF,OAAO,EAAE,GAAG,KAAK,CAAC,uBAAuB,uCAAuC,IAAI,qEAAqE;SAC1J,CAAC,CAAA;IACJ,CAAC;IAED,8DAA8D;IAC9D,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;YACxC,OAAO,EAAE,SAAS,KAAK,CAAC,UAAU,gEAAgE;SACnG,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAA;AACrB,CAAC;AA0CD,6BAA6B;AAC7B,SAAgB,oBAAoB,CAAC,KAAuB;IAC1D,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAE7C,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,6BAA6B,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IACtG,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;gBACxC,OAAO,EAAE,SAAS,KAAK,CAAC,UAAU,0CAA0C;aAC7E;YACD,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IACD,0DAA0D;IAC1D,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;gBACxC,OAAO,EAAE,SAAS,KAAK,CAAC,UAAU,0DAA0D;aAC7F;YACD,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAyB;QACrC;YACE,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;YACxC,OAAO,EAAE,SAAS,KAAK,CAAC,UAAU,oFAAoF;SACvH;KACF,CAAA;IAED,IAAI,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,6BAA6B;YACnC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,uBAAiC,EAAE,OAAO,EAAE,IAAI,EAAE;YACzE,OAAO,EAAE,GAAG,KAAK,CAAC,uBAAuB,uCAAuC,IAAI,qEAAqE;SAC1J,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5C,IAAI,EAAE,EAAE,CAAC;QACP,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YACxB,OAAO,EAAE,2BAA2B,EAAE,0EAA0E;SACjH,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAA;AACrB,CAAC","sourcesContent":["/*\n * 이미 있는 트윈을 다른 현장으로 옮긴다 — **판정만**. 순수.\n *\n * ── 왜 있나 (2026-08-13) ────────────────────────────────────────────────────\n * 트윈↔현장 연결은 **만들 때만** 정할 수 있었다(템플릿 위자드·import 의 `spaceId`). 잘못 넣었거나,\n * 나중에 \"이 창고는 사실 저 공장과 같은 부지다\" 를 알게 되면 지우고 다시 만드는 것이 유일한 길이었다 —\n * 다시 만들면 그 트윈의 저널(일어난 일)이 사라진다. 고칠 수 있는 실수를 데이터 손실로 갚게 하는 설계다.\n *\n * ── 옮기는 것이 무엇을 옮기나 (엔티티 키를 보고 정했다) ──────────────────────\n * 무엇이 트윈에 매여 있고 무엇이 공간에 매여 있는지가 답을 정한다:\n *\n *  · `TwinEvent`         `(domain, instanceId, …)`  → **따라온다.** 저널을 다시 쓰지 않는다.\n *  · `TwinLocation/Equipment/Operation`  `(domain, instance, …)`  → **따라온다.**\n *  · `TwinArea`          `(domain, space, areaId)`  → **남는다.** 구역은 공간의 것이다.\n *  · `TwinSpaceRepresentation`(지도·이미지·보드)     → **남는다.** 표현도 공간의 것이다.\n *\n * 그래서 옮기기는 이력 이전이 아니라 **소속 갱신**이다(`instance.spaceId` + `model.spaceId`).\n * 대신 공간에 매인 것들과의 연결이 끊길 수 있고, 그것을 **조용히 넘기지 않는 것**이 이 모듈의 일이다.\n *\n * ── 거절과 경고를 가른다 ────────────────────────────────────────────────────\n * 거절: 되돌릴 수 없거나 뜻이 성립하지 않는 것(없는 공간·같은 공간·벤치 사본).\n * 경고: 사용자가 알고 나면 정당할 수 있는 것(구역 소속이 끊긴다·시간대가 다르다·옛 표현이 남는다).\n * 경고를 거절로 올리면 정당한 이전을 막고, 거절을 경고로 낮추면 조용한 사고가 된다.\n */\n\n/** 옮길 수 없는 이유 — 언어 중립 코드(발견 오류·인제스트 거절과 같은 규약). */\nexport type MoveSpaceRefusalCode = 'twin-not-found' | 'space-not-found' | 'same-space' | 'bench-copy'\n\n/** 옮겨도 되지만 알아야 하는 것 — 같은 규약. */\nexport type MoveSpaceWarningCode = 'areas-left-behind' | 'timezone-differs' | 'representations-left-behind' | 'running'\n\nexport interface MoveSpaceNote<C extends string> {\n  code: C\n  params?: Record<string, string | number>\n  /** 영어 canonical — 로그에 남고, 번역이 없으면 그대로 보인다. */\n  message: string\n}\n\nexport type MoveSpaceRefusal = MoveSpaceNote<MoveSpaceRefusalCode>\nexport type MoveSpaceWarning = MoveSpaceNote<MoveSpaceWarningCode>\n\nexport interface MoveSpaceInput {\n  /** 옮길 트윈. 없으면 거절한다. */\n  instanceId?: string\n  /** 지금 속한 공간(없을 수 있다 — 옛 트윈). */\n  fromSpaceId?: string\n  /** 옮겨 갈 공간. */\n  toSpaceId: string\n  /** 그 공간이 이 테넌트에 실제로 있나(호출측이 조회해 넘긴다). */\n  toSpaceExists: boolean\n  /** 운영 트윈인가 벤치 사본인가 — 사본은 원본의 공간을 따라야 하므로 옮기지 않는다. */\n  purpose?: string\n  /** 지금 실행 중인가 — 시간대 변화는 재기동 뒤에 커널에 실린다. */\n  running?: boolean\n  /** 두 공간의 시간대(IANA). 다르면 앞으로의 시각 해석이 달라진다. */\n  fromTimezone?: string\n  toTimezone?: string\n  /** 이 트윈의 로케이션들이 소속으로 가리키는 구역 id 들(중복 포함 가능). */\n  areaRefs?: readonly (string | undefined | null)[]\n  /** 옮겨 갈 공간에 있는 구역 id 들. */\n  toAreaIds?: readonly string[]\n  /** 옛 공간의 표현 수 — 그 표현의 폴리곤이 이 트윈을 가리키고 있었을 수 있다. */\n  fromRepresentationCount?: number\n}\n\nexport interface MoveSpaceJudgement {\n  /** 있으면 옮기지 않는다. */\n  refusal?: MoveSpaceRefusal\n  /** 옮기되 함께 알린다. 비어 있으면 잃는 것이 없다. */\n  warnings: MoveSpaceWarning[]\n}\n\n/** 옮겨도 되나 — 되면 무엇을 알려야 하나. */\nexport function judgeMoveTwinSpace(input: MoveSpaceInput): MoveSpaceJudgement {\n  const to = (input.toSpaceId ?? '').trim()\n  const from = (input.fromSpaceId ?? '').trim()\n\n  if (!input.instanceId) {\n    return {\n      refusal: { code: 'twin-not-found', message: 'no such twin in this tenant' },\n      warnings: []\n    }\n  }\n  if (!to || !input.toSpaceExists) {\n    return {\n      refusal: {\n        code: 'space-not-found',\n        params: { spaceId: to },\n        message: `space \"${to}\" not found — cannot move a twin into a space that does not exist`\n      },\n      warnings: []\n    }\n  }\n  if (from && from === to) {\n    return {\n      refusal: {\n        code: 'same-space',\n        params: { spaceId: to },\n        message: `twin \"${input.instanceId}\" is already in space \"${to}\"`\n      },\n      warnings: []\n    }\n  }\n  /* 벤치 사본은 \"이 공장이 이만큼 커지면\" 을 재는 사본이라 원본의 현장에 매여 있다. 옮기면 그 측정이\n     무엇의 측정인지 말할 수 없게 된다 — 사본을 옮기는 대신 원본을 옮기고 사본을 다시 뜬다. */\n  if (input.purpose === 'bench') {\n    return {\n      refusal: {\n        code: 'bench-copy',\n        params: { instanceId: input.instanceId },\n        message: `twin \"${input.instanceId}\" is a bench copy — move its source twin instead`\n      },\n      warnings: []\n    }\n  }\n\n  const warnings: MoveSpaceWarning[] = []\n\n  /* 로케이션의 구역 소속 — 구역은 공간의 것이라 새 공간에 같은 id 가 없으면 소속이 끊긴다.\n     막지는 않는다(새 공간에서 구역을 다시 그리는 것이 정상 경로다). 다만 몇 개가 끊기는지 말한다. */\n  const refs = [...new Set((input.areaRefs ?? []).filter((x): x is string => !!x && !!x.trim()))]\n  const have = new Set(input.toAreaIds ?? [])\n  const orphaned = refs.filter(r => !have.has(r)).sort()\n  if (orphaned.length) {\n    warnings.push({\n      code: 'areas-left-behind',\n      params: { count: orphaned.length, areas: orphaned.slice(0, 5).join(', ') },\n      message: `${orphaned.length} area reference(s) do not exist in the target space — those locations lose their grouping: ${orphaned\n        .slice(0, 5)\n        .join(', ')}`\n    })\n  }\n\n  /* 시간대 — 공간이 정하고 커널이 분 오프셋으로 받는다. 다르면 같은 저널이 다른 시각으로 읽힌다. */\n  const tzFrom = (input.fromTimezone ?? '').trim()\n  const tzTo = (input.toTimezone ?? '').trim()\n  if (tzFrom !== tzTo) {\n    warnings.push({\n      code: 'timezone-differs',\n      params: { from: tzFrom || '—', to: tzTo || '—' },\n      message: `time zone changes from \"${tzFrom || 'unset'}\" to \"${tzTo || 'unset'}\" — shift boundaries and day buckets will read differently`\n    })\n  }\n\n  /* 옛 공간의 표현 — 폴리곤 바인딩이 이 트윈의 로케이션·그룹을 가리키고 있었을 수 있다. 표현은\n     공간에 남으므로, 그 화면에서 이 트윈이 사라진다. 몇 개가 남는지 말해 두면 사람이 찾아갈 수 있다. */\n  if ((input.fromRepresentationCount ?? 0) > 0) {\n    warnings.push({\n      code: 'representations-left-behind',\n      params: { count: input.fromRepresentationCount as number, spaceId: from || '—' },\n      message: `${input.fromRepresentationCount} representation(s) stay with space \"${from}\" — bindings that pointed at this twin will no longer resolve there`\n    })\n  }\n\n  /* 실행 중 — 소속은 즉시 바뀌지만 시간대는 커널을 세울 때 실린다. 시간대가 같으면 말할 것이 없다. */\n  if (input.running && tzFrom !== tzTo) {\n    warnings.push({\n      code: 'running',\n      params: { instanceId: input.instanceId },\n      message: `twin \"${input.instanceId}\" is running — the new time zone applies after it is restarted`\n    })\n  }\n\n  return { warnings }\n}\n\n/*\n * ── 현장에서 떼기 (2026-08-13) ──────────────────────────────────────────────\n *\n * 더하기·옮기기만 있으면 잘못 넣은 것을 되돌릴 수 없다. 떼기는 \"어느 현장에도 속하지 않음\" 으로\n * 되돌리는 일이고, 데이터 모델이 그 상태를 이미 허용한다(`TwinInstance.spaceId` 는 선택 컬럼).\n *\n * 떼면 무엇이 달라지나 — 옮기기와 같은 규칙이지만 **갈 곳이 없다**는 점이 다르다:\n *  · 저널·로케이션·설비는 그대로 트윈에 남는다(잃는 것 없음).\n *  · 구역·표현은 옛 현장에 남는다 → 그 화면에서 이 트윈이 사라진다.\n *  · **볼 무대가 없어진다** — 현장 현황(지도·보드)은 현장의 표현으로 그리므로, 뗀 트윈은 목록과\n *    조회 화면에서만 보인다. 이것을 말하지 않으면 사용자는 트윈이 고장 났다고 읽는다.\n *  · 시간 기준(`utcOffsetMinutes`)은 **옛 현장의 것으로 남는다.** 지우면 조용히 UTC 로 읽히므로\n *    그쪽이 더 위험하다 — 남기고 그 사실을 말한다.\n */\n\n/** 뗄 수 없는 이유 — 언어 중립 코드. */\nexport type DetachSpaceRefusalCode = 'twin-not-found' | 'no-space' | 'bench-copy'\n\n/** 떼도 되지만 알아야 하는 것. */\nexport type DetachSpaceWarningCode = 'no-stage' | 'representations-left-behind' | 'timebase-kept'\n\nexport type DetachSpaceRefusal = MoveSpaceNote<DetachSpaceRefusalCode>\nexport type DetachSpaceWarning = MoveSpaceNote<DetachSpaceWarningCode>\n\nexport interface DetachSpaceInput {\n  instanceId?: string\n  /** 지금 속한 공간 — 없으면 뗄 것이 없다. */\n  fromSpaceId?: string\n  purpose?: string\n  /** 옛 공간의 표현 수. */\n  fromRepresentationCount?: number\n  /** 옛 공간의 시간대 — 있으면 그 기준이 model 에 남는다. */\n  fromTimezone?: string\n}\n\nexport interface DetachSpaceJudgement {\n  refusal?: DetachSpaceRefusal\n  warnings: DetachSpaceWarning[]\n}\n\n/** 떼도 되나 — 되면 무엇을 알려야 하나. */\nexport function judgeDetachTwinSpace(input: DetachSpaceInput): DetachSpaceJudgement {\n  const from = (input.fromSpaceId ?? '').trim()\n\n  if (!input.instanceId) {\n    return { refusal: { code: 'twin-not-found', message: 'no such twin in this tenant' }, warnings: [] }\n  }\n  if (!from) {\n    return {\n      refusal: {\n        code: 'no-space',\n        params: { instanceId: input.instanceId },\n        message: `twin \"${input.instanceId}\" is not on any site — nothing to detach`\n      },\n      warnings: []\n    }\n  }\n  /* 벤치 사본은 원본의 현장을 따라야 측정이 무엇의 측정인지 말할 수 있다(옮기기와 같은 이유). */\n  if (input.purpose === 'bench') {\n    return {\n      refusal: {\n        code: 'bench-copy',\n        params: { instanceId: input.instanceId },\n        message: `twin \"${input.instanceId}\" is a bench copy — it must stay on the site it measures`\n      },\n      warnings: []\n    }\n  }\n\n  const warnings: DetachSpaceWarning[] = [\n    {\n      code: 'no-stage',\n      params: { instanceId: input.instanceId },\n      message: `twin \"${input.instanceId}\" will have no site to be drawn on — it stays visible in lists and inspection only`\n    }\n  ]\n\n  if ((input.fromRepresentationCount ?? 0) > 0) {\n    warnings.push({\n      code: 'representations-left-behind',\n      params: { count: input.fromRepresentationCount as number, spaceId: from },\n      message: `${input.fromRepresentationCount} representation(s) stay with space \"${from}\" — bindings that pointed at this twin will no longer resolve there`\n    })\n  }\n\n  const tz = (input.fromTimezone ?? '').trim()\n  if (tz) {\n    warnings.push({\n      code: 'timebase-kept',\n      params: { timezone: tz },\n      message: `the time base stays as \"${tz}\" (the site it came from) — clearing it would silently read times as UTC`\n    })\n  }\n\n  return { warnings }\n}\n"]}

package/dist-server/service/twin-space/space-integrity.d.ts

@@ -0,0 +1,97 @@
+export type SpaceIntegrityCode = 
+/** 트윈이 없는 공간을 가리킨다 — 그 트윈은 무대가 사라졌다. */
+'twin-space-missing'
+/** 레지스트리와 model 의 공간이 다르다 — 어느 쪽이 사실인지 알 수 없다. */
+ | 'twin-space-mismatch'
+/** 폴리곤이 이 공간에 없는 구역을 가리킨다. */
+ | 'polygon-area-missing'
+/** 폴리곤이 이 공간에 사는 어느 트윈에도 없는 로케이션·설비를 가리킨다. */
+ | 'polygon-target-missing'
+/** 로케이션이 이 공간에 없는 구역에 소속되어 있다. */
+ | 'location-area-missing'
+/** 대표 표현이 이 공간의 표현이 아니다. */
+ | 'primary-representation-missing'
+/** 보드 표현이 보드를 가리키지 않는다(또는 없는 보드를 가리킨다). */
+ | 'board-representation-unbound'
+/** 표현이 하나도 없는 공간에 트윈이 산다 — 볼 화면이 없다. */
+ | 'space-without-representation'
+/** 어느 공간에도 속하지 않은 트윈 — 뗀 결과일 수 있다(사실이면 정상). */
+ | 'twin-without-space'
+/**
+ * 이 트윈이 **담을 줄 모르는 어휘**를 받고 있다 — 리비전은 오르는데 상태가 채워지지 않는다.
+ *
+ * 커널은 모르는 `eventType` 을 버리고(전방 호환) 종류별로 센다(`state.unhandled`). 그 수가 0이
+ * 아니면 둘 중 하나다: 커넥터가 엉뚱한 트윈에 붙었거나(예: `energy.*` 가 창고 트윈으로), 커널이
+ * 낡아 새 어휘를 모른다. 둘 다 사람이 손봐야 하는 것이고, 조용히 두면 「정상인데 빈」 트윈이 된다.
+ */
+ | 'twin-unhandled-vocabulary';
+export type SpaceIntegritySeverity = 'broken' | 'warn';
+export interface SpaceIntegrityFinding {
+    code: SpaceIntegrityCode;
+    severity: SpaceIntegritySeverity;
+    /** 어디의 문제인가 — 화면이 그 자리로 데려갈 수 있게. */
+    spaceId?: string;
+    instanceId?: string;
+    representationId?: string;
+    params?: Record<string, string | number>;
+    /** 영어 canonical — 로그·폴백. */
+    message: string;
+}
+export interface IntegritySpace {
+    spaceId: string;
+    primaryRepresentationId?: string | null;
+}
+export interface IntegrityInstance {
+    instanceId: string;
+    /** 레지스트리 컬럼. */
+    spaceId?: string | null;
+    /** 저장된 model 의 공간 — 레지스트리와 같아야 한다. */
+    modelSpaceId?: string | null;
+    purpose?: string | null;
+    /** 이 트윈의 로케이션 id 들. */
+    locationIds?: readonly string[];
+    /** 이 트윈의 설비 id 들. */
+    equipmentIds?: readonly string[];
+    /** 로케이션의 소속 구역 id 들(중복 가능). */
+    areaRefs?: readonly (string | undefined | null)[];
+    /**
+     * 커널이 담을 줄 몰라 버린 사건들 — 실행 중인 트윈의 상태에서 온다(`state.unhandled`).
+     *
+     * 정지한 트윈에서는 알 수 없으므로 `undefined` 다 — **없는 것과 모르는 것을 구별한다**(빈 배열을
+     * 넣으면 「받은 것이 없다」는 사실 주장이 되고, 그것은 우리가 확인한 바가 아니다).
+     */
+    unhandled?: readonly {
+        eventType: string;
+        count: number;
+    }[];
+}
+export interface IntegrityRepresentation {
+    id: string;
+    spaceId: string;
+    type: string;
+    /** 보드 표현이면 보드 id. */
+    boardId?: string | null;
+    /** 폴리곤 바인딩들. */
+    polygons?: readonly IntegrityPolygon[];
+}
+export interface IntegrityPolygon {
+    id?: string;
+    /** 논리 구역 바인딩(그룹). */
+    groupId?: string | null;
+    /** 개체 바인딩 — 로케이션 또는 설비. */
+    targetKind?: 'location' | 'equipment' | null;
+    targetId?: string | null;
+}
+export interface SpaceIntegrityInput {
+    spaces: readonly IntegritySpace[];
+    instances: readonly IntegrityInstance[];
+    representations: readonly IntegrityRepresentation[];
+    /** 공간별 구역 id 들. */
+    areasBySpace: Readonly<Record<string, readonly string[]>>;
+    /** 존재하는 보드 id 들 — 보드 표현이 실제 보드를 가리키는지 본다. */
+    boardIds?: readonly string[];
+}
+/** 세 축을 맞대어 어긋난 자리를 모두 낸다. 비어 있으면 정합하다. */
+export declare function checkSpaceIntegrity(input: SpaceIntegrityInput): SpaceIntegrityFinding[];
+/** 심각한 것부터 — 화면이 정렬을 다시 정하지 않게 한 곳에서 정한다. */
+export declare function sortFindings(findings: readonly SpaceIntegrityFinding[]): SpaceIntegrityFinding[];

package/dist-server/service/twin-space/space-integrity.js

@@ -0,0 +1,182 @@
+"use strict";
+/*
+ * 공간 ↔ 트윈 ↔ 가시화 정합성 — **순수**. 세 축이 서로 어긋난 자리를 찾는다.
+ *
+ * ── 왜 있나 (2026-08-13) ────────────────────────────────────────────────────
+ * 이 셋은 서로를 id 로만 가리킨다. 참조 무결성을 DB 가 지켜 주지 않는 지점이 많다:
+ * 공간·구역은 공간에 매이고, 로케이션·설비는 트윈에 매이고, 폴리곤은 **양쪽을 가리킨다.**
+ * 그래서 트윈을 옮기거나 떼거나(2026-08-13 추가) 원본을 다시 읽으면, 아무 오류 없이 **가리킬 것이
+ * 없는 도형**과 **소속 없는 로케이션**이 남는다. 증상은 "지도가 비었다" 뿐이고 원인은 화면에 없다.
+ *
+ * 그 어긋남을 사람이 눈으로 맞추고 있었다(spaceId 를 목록에서 대조). 기계가 대신 본다.
+ *
+ * ── 무엇을 사실로 보나 ─────────────────────────────────────────────────────
+ * 판정은 **조회 결과만** 받는다(DB 를 물지 않는다). 그래서 단위테스트로 전부 부를 수 있고, 호출측은
+ * 사실을 모으는 일만 한다. 각 발견은 언어 중립 코드 + 파라미터이고, 화면이 사람 말을 만든다.
+ *
+ * ── 심각도를 가른다 ────────────────────────────────────────────────────────
+ * `broken` 은 무언가 이미 보이지 않는 상태다(가리킬 대상이 없다). `warn` 은 아직 보이지만 뜻이
+ * 흐려진 상태다(소속 없음·대표 없음). 섞으면 사람이 무엇을 먼저 볼지 정할 수 없다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkSpaceIntegrity = checkSpaceIntegrity;
+exports.sortFindings = sortFindings;
+/** 세 축을 맞대어 어긋난 자리를 모두 낸다. 비어 있으면 정합하다. */
+function checkSpaceIntegrity(input) {
+    const out = [];
+    const spaceIds = new Set(input.spaces.map(s => s.spaceId));
+    const areasOf = (spaceId) => new Set(input.areasBySpace[spaceId] ?? []);
+    const repsOf = (spaceId) => input.representations.filter(r => r.spaceId === spaceId);
+    const boards = new Set(input.boardIds ?? []);
+    /* 벤치 사본은 측정용 사본이라 이 검사의 대상이 아니다 — 사본의 공간은 잠깐 살고 지워진다. */
+    const instances = input.instances.filter(i => i.purpose !== 'bench');
+    /* ── 트윈 → 공간 ─────────────────────────────────────────────────────── */
+    for (const t of instances) {
+        const sid = (t.spaceId ?? '').trim();
+        const msid = (t.modelSpaceId ?? '').trim();
+        if (!sid) {
+            out.push({
+                code: 'twin-without-space',
+                severity: 'warn',
+                instanceId: t.instanceId,
+                message: `twin "${t.instanceId}" is on no site — it has no map or board to be drawn on`
+            });
+        }
+        else if (!spaceIds.has(sid)) {
+            out.push({
+                code: 'twin-space-missing',
+                severity: 'broken',
+                instanceId: t.instanceId,
+                spaceId: sid,
+                message: `twin "${t.instanceId}" points at site "${sid}" which does not exist`
+            });
+        }
+        /* 두 곳이 어긋나면 어느 쪽이 사실인지 알 수 없다 — 보드는 model 을, 목록은 컬럼을 읽는다. */
+        if (sid !== msid) {
+            out.push({
+                code: 'twin-space-mismatch',
+                severity: 'broken',
+                instanceId: t.instanceId,
+                spaceId: sid || undefined,
+                params: { registry: sid || '—', model: msid || '—' },
+                message: `twin "${t.instanceId}" registry site "${sid || 'none'}" differs from its model site "${msid || 'none'}"`
+            });
+        }
+        /* 로케이션의 소속 구역은 **트윈이 속한 공간**의 것이어야 한다. */
+        if (sid && spaceIds.has(sid)) {
+            const have = areasOf(sid);
+            const refs = [...new Set((t.areaRefs ?? []).filter((x) => !!x && !!x.trim()))];
+            const missing = refs.filter(r => !have.has(r)).sort();
+            if (missing.length) {
+                out.push({
+                    code: 'location-area-missing',
+                    severity: 'warn',
+                    instanceId: t.instanceId,
+                    spaceId: sid,
+                    params: { count: missing.length, areas: missing.slice(0, 5).join(', ') },
+                    message: `${missing.length} area(s) referenced by locations of "${t.instanceId}" do not exist in site "${sid}": ${missing
+                        .slice(0, 5)
+                        .join(', ')}`
+                });
+            }
+        }
+        /*
+         * 어휘가 맞는가 — 저널이 들어오는데 상태가 채워지지 않는 경우를 잡는다.
+         *
+         * `undefined` 는 「모른다」다(정지한 트윈). 세지 않는다 — 확인하지 않은 것을 정합으로도, 결함으로도
+         * 세지 않는 것이 이 하네스의 규율이다.
+         */
+        if (t.unhandled?.length) {
+            const total = t.unhandled.reduce((n, u) => n + u.count, 0);
+            const kinds = [...t.unhandled].sort((a, b) => b.count - a.count);
+            out.push({
+                code: 'twin-unhandled-vocabulary',
+                severity: 'warn',
+                instanceId: t.instanceId,
+                spaceId: sid || undefined,
+                params: { events: total, kinds: kinds.length, types: kinds.slice(0, 3).map(u => u.eventType).join(', ') },
+                message: `twin "${t.instanceId}" received ${total} event(s) of ${kinds.length} type(s) its kernel does not handle: ${kinds
+                    .slice(0, 3)
+                    .map(u => u.eventType)
+                    .join(', ')}`
+            });
+        }
+    }
+    /* ── 공간 → 가시화 ───────────────────────────────────────────────────── */
+    for (const s of input.spaces) {
+        const reps = repsOf(s.spaceId);
+        const livesHere = instances.filter(t => (t.spaceId ?? '') === s.spaceId);
+        /* 트윈이 사는데 표현이 없으면 볼 화면이 없다. 트윈이 없는 빈 현장은 정상이므로 세지 않는다. */
+        if (livesHere.length && !reps.length) {
+            out.push({
+                code: 'space-without-representation',
+                severity: 'warn',
+                spaceId: s.spaceId,
+                params: { twins: livesHere.length },
+                message: `site "${s.spaceId}" has ${livesHere.length} twin(s) but no representation — there is nothing to draw them on`
+            });
+        }
+        const primary = (s.primaryRepresentationId ?? '').trim();
+        if (primary && !reps.some(r => r.id === primary)) {
+            out.push({
+                code: 'primary-representation-missing',
+                severity: 'broken',
+                spaceId: s.spaceId,
+                params: { representationId: primary },
+                message: `site "${s.spaceId}" points at primary representation "${primary}" which is not one of its representations`
+            });
+        }
+    }
+    /* ── 가시화 → 공간·트윈 ─────────────────────────────────────────────── */
+    for (const rep of input.representations) {
+        const have = areasOf(rep.spaceId);
+        /* 이 공간에 사는 트윈들의 개체 id — 폴리곤이 가리킬 수 있는 전부. */
+        const here = instances.filter(t => (t.spaceId ?? '') === rep.spaceId);
+        const locationIds = new Set(here.flatMap(t => [...(t.locationIds ?? [])]));
+        const equipmentIds = new Set(here.flatMap(t => [...(t.equipmentIds ?? [])]));
+        if (rep.type === 'board' && !(rep.boardId && boards.has(rep.boardId))) {
+            out.push({
+                code: 'board-representation-unbound',
+                severity: 'broken',
+                spaceId: rep.spaceId,
+                representationId: rep.id,
+                params: { boardId: rep.boardId ?? '—' },
+                message: `board representation "${rep.id}" of site "${rep.spaceId}" does not point at an existing board (${rep.boardId ?? 'none'})`
+            });
+        }
+        for (const p of rep.polygons ?? []) {
+            const gid = (p.groupId ?? '').trim();
+            if (gid && !have.has(gid)) {
+                out.push({
+                    code: 'polygon-area-missing',
+                    severity: 'broken',
+                    spaceId: rep.spaceId,
+                    representationId: rep.id,
+                    params: { areaId: gid, polygonId: p.id ?? '—' },
+                    message: `a polygon of representation "${rep.id}" binds area "${gid}" which does not exist in site "${rep.spaceId}"`
+                });
+            }
+            const tid = (p.targetId ?? '').trim();
+            if (tid && p.targetKind) {
+                const pool = p.targetKind === 'equipment' ? equipmentIds : locationIds;
+                if (!pool.has(tid)) {
+                    out.push({
+                        code: 'polygon-target-missing',
+                        severity: 'broken',
+                        spaceId: rep.spaceId,
+                        representationId: rep.id,
+                        params: { kind: p.targetKind, targetId: tid, polygonId: p.id ?? '—' },
+                        message: `a polygon of representation "${rep.id}" binds ${p.targetKind} "${tid}", which no twin on site "${rep.spaceId}" has`
+                    });
+                }
+            }
+        }
+    }
+    return out;
+}
+/** 심각한 것부터 — 화면이 정렬을 다시 정하지 않게 한 곳에서 정한다. */
+function sortFindings(findings) {
+    const rank = (s) => (s === 'broken' ? 0 : 1);
+    return [...findings].sort((a, b) => rank(a.severity) - rank(b.severity) || a.code.localeCompare(b.code) || (a.spaceId ?? '').localeCompare(b.spaceId ?? ''));
+}
+//# sourceMappingURL=space-integrity.js.map

package/dist-server/service/twin-space/space-integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-integrity.js","sourceRoot":"","sources":["../../../server/service/twin-space/space-integrity.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 공간 ↔ 트윈 ↔ 가시화 정합성 — **순수**. 세 축이 서로 어긋난 자리를 찾는다.\n *\n * ── 왜 있나 (2026-08-13) ────────────────────────────────────────────────────\n * 이 셋은 서로를 id 로만 가리킨다. 참조 무결성을 DB 가 지켜 주지 않는 지점이 많다:\n * 공간·구역은 공간에 매이고, 로케이션·설비는 트윈에 매이고, 폴리곤은 **양쪽을 가리킨다.**\n * 그래서 트윈을 옮기거나 떼거나(2026-08-13 추가) 원본을 다시 읽으면, 아무 오류 없이 **가리킬 것이\n * 없는 도형**과 **소속 없는 로케이션**이 남는다. 증상은 \"지도가 비었다\" 뿐이고 원인은 화면에 없다.\n *\n * 그 어긋남을 사람이 눈으로 맞추고 있었다(spaceId 를 목록에서 대조). 기계가 대신 본다.\n *\n * ── 무엇을 사실로 보나 ─────────────────────────────────────────────────────\n * 판정은 **조회 결과만** 받는다(DB 를 물지 않는다). 그래서 단위테스트로 전부 부를 수 있고, 호출측은\n * 사실을 모으는 일만 한다. 각 발견은 언어 중립 코드 + 파라미터이고, 화면이 사람 말을 만든다.\n *\n * ── 심각도를 가른다 ────────────────────────────────────────────────────────\n * `broken` 은 무언가 이미 보이지 않는 상태다(가리킬 대상이 없다). `warn` 은 아직 보이지만 뜻이\n * 흐려진 상태다(소속 없음·대표 없음). 섞으면 사람이 무엇을 먼저 볼지 정할 수 없다.\n */\n\nexport type SpaceIntegrityCode =\n  /** 트윈이 없는 공간을 가리킨다 — 그 트윈은 무대가 사라졌다. */\n  | 'twin-space-missing'\n  /** 레지스트리와 model 의 공간이 다르다 — 어느 쪽이 사실인지 알 수 없다. */\n  | 'twin-space-mismatch'\n  /** 폴리곤이 이 공간에 없는 구역을 가리킨다. */\n  | 'polygon-area-missing'\n  /** 폴리곤이 이 공간에 사는 어느 트윈에도 없는 로케이션·설비를 가리킨다. */\n  | 'polygon-target-missing'\n  /** 로케이션이 이 공간에 없는 구역에 소속되어 있다. */\n  | 'location-area-missing'\n  /** 대표 표현이 이 공간의 표현이 아니다. */\n  | 'primary-representation-missing'\n  /** 보드 표현이 보드를 가리키지 않는다(또는 없는 보드를 가리킨다). */\n  | 'board-representation-unbound'\n  /** 표현이 하나도 없는 공간에 트윈이 산다 — 볼 화면이 없다. */\n  | 'space-without-representation'\n  /** 어느 공간에도 속하지 않은 트윈 — 뗀 결과일 수 있다(사실이면 정상). */\n  | 'twin-without-space'\n  /**\n   * 이 트윈이 **담을 줄 모르는 어휘**를 받고 있다 — 리비전은 오르는데 상태가 채워지지 않는다.\n   *\n   * 커널은 모르는 `eventType` 을 버리고(전방 호환) 종류별로 센다(`state.unhandled`). 그 수가 0이\n   * 아니면 둘 중 하나다: 커넥터가 엉뚱한 트윈에 붙었거나(예: `energy.*` 가 창고 트윈으로), 커널이\n   * 낡아 새 어휘를 모른다. 둘 다 사람이 손봐야 하는 것이고, 조용히 두면 「정상인데 빈」 트윈이 된다.\n   */\n  | 'twin-unhandled-vocabulary'\n\nexport type SpaceIntegritySeverity = 'broken' | 'warn'\n\nexport interface SpaceIntegrityFinding {\n  code: SpaceIntegrityCode\n  severity: SpaceIntegritySeverity\n  /** 어디의 문제인가 — 화면이 그 자리로 데려갈 수 있게. */\n  spaceId?: string\n  instanceId?: string\n  representationId?: string\n  params?: Record<string, string | number>\n  /** 영어 canonical — 로그·폴백. */\n  message: string\n}\n\n/* ── 입력(조회 결과) ──────────────────────────────────────────────────────── */\n\nexport interface IntegritySpace {\n  spaceId: string\n  primaryRepresentationId?: string | null\n}\n\nexport interface IntegrityInstance {\n  instanceId: string\n  /** 레지스트리 컬럼. */\n  spaceId?: string | null\n  /** 저장된 model 의 공간 — 레지스트리와 같아야 한다. */\n  modelSpaceId?: string | null\n  purpose?: string | null\n  /** 이 트윈의 로케이션 id 들. */\n  locationIds?: readonly string[]\n  /** 이 트윈의 설비 id 들. */\n  equipmentIds?: readonly string[]\n  /** 로케이션의 소속 구역 id 들(중복 가능). */\n  areaRefs?: readonly (string | undefined | null)[]\n  /**\n   * 커널이 담을 줄 몰라 버린 사건들 — 실행 중인 트윈의 상태에서 온다(`state.unhandled`).\n   *\n   * 정지한 트윈에서는 알 수 없으므로 `undefined` 다 — **없는 것과 모르는 것을 구별한다**(빈 배열을\n   * 넣으면 「받은 것이 없다」는 사실 주장이 되고, 그것은 우리가 확인한 바가 아니다).\n   */\n  unhandled?: readonly { eventType: string; count: number }[]\n}\n\nexport interface IntegrityRepresentation {\n  id: string\n  spaceId: string\n  type: string\n  /** 보드 표현이면 보드 id. */\n  boardId?: string | null\n  /** 폴리곤 바인딩들. */\n  polygons?: readonly IntegrityPolygon[]\n}\n\nexport interface IntegrityPolygon {\n  id?: string\n  /** 논리 구역 바인딩(그룹). */\n  groupId?: string | null\n  /** 개체 바인딩 — 로케이션 또는 설비. */\n  targetKind?: 'location' | 'equipment' | null\n  targetId?: string | null\n}\n\nexport interface SpaceIntegrityInput {\n  spaces: readonly IntegritySpace[]\n  instances: readonly IntegrityInstance[]\n  representations: readonly IntegrityRepresentation[]\n  /** 공간별 구역 id 들. */\n  areasBySpace: Readonly<Record<string, readonly string[]>>\n  /** 존재하는 보드 id 들 — 보드 표현이 실제 보드를 가리키는지 본다. */\n  boardIds?: readonly string[]\n}\n\n/** 세 축을 맞대어 어긋난 자리를 모두 낸다. 비어 있으면 정합하다. */\nexport function checkSpaceIntegrity(input: SpaceIntegrityInput): SpaceIntegrityFinding[] {\n  const out: SpaceIntegrityFinding[] = []\n  const spaceIds = new Set(input.spaces.map(s => s.spaceId))\n  const areasOf = (spaceId: string) => new Set(input.areasBySpace[spaceId] ?? [])\n  const repsOf = (spaceId: string) => input.representations.filter(r => r.spaceId === spaceId)\n  const boards = new Set(input.boardIds ?? [])\n\n  /* 벤치 사본은 측정용 사본이라 이 검사의 대상이 아니다 — 사본의 공간은 잠깐 살고 지워진다. */\n  const instances = input.instances.filter(i => i.purpose !== 'bench')\n\n  /* ── 트윈 → 공간 ─────────────────────────────────────────────────────── */\n  for (const t of instances) {\n    const sid = (t.spaceId ?? '').trim()\n    const msid = (t.modelSpaceId ?? '').trim()\n\n    if (!sid) {\n      out.push({\n        code: 'twin-without-space',\n        severity: 'warn',\n        instanceId: t.instanceId,\n        message: `twin \"${t.instanceId}\" is on no site — it has no map or board to be drawn on`\n      })\n    } else if (!spaceIds.has(sid)) {\n      out.push({\n        code: 'twin-space-missing',\n        severity: 'broken',\n        instanceId: t.instanceId,\n        spaceId: sid,\n        message: `twin \"${t.instanceId}\" points at site \"${sid}\" which does not exist`\n      })\n    }\n\n    /* 두 곳이 어긋나면 어느 쪽이 사실인지 알 수 없다 — 보드는 model 을, 목록은 컬럼을 읽는다. */\n    if (sid !== msid) {\n      out.push({\n        code: 'twin-space-mismatch',\n        severity: 'broken',\n        instanceId: t.instanceId,\n        spaceId: sid || undefined,\n        params: { registry: sid || '—', model: msid || '—' },\n        message: `twin \"${t.instanceId}\" registry site \"${sid || 'none'}\" differs from its model site \"${msid || 'none'}\"`\n      })\n    }\n\n    /* 로케이션의 소속 구역은 **트윈이 속한 공간**의 것이어야 한다. */\n    if (sid && spaceIds.has(sid)) {\n      const have = areasOf(sid)\n      const refs = [...new Set((t.areaRefs ?? []).filter((x): x is string => !!x && !!x.trim()))]\n      const missing = refs.filter(r => !have.has(r)).sort()\n      if (missing.length) {\n        out.push({\n          code: 'location-area-missing',\n          severity: 'warn',\n          instanceId: t.instanceId,\n          spaceId: sid,\n          params: { count: missing.length, areas: missing.slice(0, 5).join(', ') },\n          message: `${missing.length} area(s) referenced by locations of \"${t.instanceId}\" do not exist in site \"${sid}\": ${missing\n            .slice(0, 5)\n            .join(', ')}`\n        })\n      }\n    }\n\n    /*\n     * 어휘가 맞는가 — 저널이 들어오는데 상태가 채워지지 않는 경우를 잡는다.\n     *\n     * `undefined` 는 「모른다」다(정지한 트윈). 세지 않는다 — 확인하지 않은 것을 정합으로도, 결함으로도\n     * 세지 않는 것이 이 하네스의 규율이다.\n     */\n    if (t.unhandled?.length) {\n      const total = t.unhandled.reduce((n, u) => n + u.count, 0)\n      const kinds = [...t.unhandled].sort((a, b) => b.count - a.count)\n      out.push({\n        code: 'twin-unhandled-vocabulary',\n        severity: 'warn',\n        instanceId: t.instanceId,\n        spaceId: sid || undefined,\n        params: { events: total, kinds: kinds.length, types: kinds.slice(0, 3).map(u => u.eventType).join(', ') },\n        message: `twin \"${t.instanceId}\" received ${total} event(s) of ${kinds.length} type(s) its kernel does not handle: ${kinds\n          .slice(0, 3)\n          .map(u => u.eventType)\n          .join(', ')}`\n      })\n    }\n  }\n\n  /* ── 공간 → 가시화 ───────────────────────────────────────────────────── */\n  for (const s of input.spaces) {\n    const reps = repsOf(s.spaceId)\n    const livesHere = instances.filter(t => (t.spaceId ?? '') === s.spaceId)\n\n    /* 트윈이 사는데 표현이 없으면 볼 화면이 없다. 트윈이 없는 빈 현장은 정상이므로 세지 않는다. */\n    if (livesHere.length && !reps.length) {\n      out.push({\n        code: 'space-without-representation',\n        severity: 'warn',\n        spaceId: s.spaceId,\n        params: { twins: livesHere.length },\n        message: `site \"${s.spaceId}\" has ${livesHere.length} twin(s) but no representation — there is nothing to draw them on`\n      })\n    }\n\n    const primary = (s.primaryRepresentationId ?? '').trim()\n    if (primary && !reps.some(r => r.id === primary)) {\n      out.push({\n        code: 'primary-representation-missing',\n        severity: 'broken',\n        spaceId: s.spaceId,\n        params: { representationId: primary },\n        message: `site \"${s.spaceId}\" points at primary representation \"${primary}\" which is not one of its representations`\n      })\n    }\n  }\n\n  /* ── 가시화 → 공간·트윈 ─────────────────────────────────────────────── */\n  for (const rep of input.representations) {\n    const have = areasOf(rep.spaceId)\n    /* 이 공간에 사는 트윈들의 개체 id — 폴리곤이 가리킬 수 있는 전부. */\n    const here = instances.filter(t => (t.spaceId ?? '') === rep.spaceId)\n    const locationIds = new Set(here.flatMap(t => [...(t.locationIds ?? [])]))\n    const equipmentIds = new Set(here.flatMap(t => [...(t.equipmentIds ?? [])]))\n\n    if (rep.type === 'board' && !(rep.boardId && boards.has(rep.boardId))) {\n      out.push({\n        code: 'board-representation-unbound',\n        severity: 'broken',\n        spaceId: rep.spaceId,\n        representationId: rep.id,\n        params: { boardId: rep.boardId ?? '—' },\n        message: `board representation \"${rep.id}\" of site \"${rep.spaceId}\" does not point at an existing board (${rep.boardId ?? 'none'})`\n      })\n    }\n\n    for (const p of rep.polygons ?? []) {\n      const gid = (p.groupId ?? '').trim()\n      if (gid && !have.has(gid)) {\n        out.push({\n          code: 'polygon-area-missing',\n          severity: 'broken',\n          spaceId: rep.spaceId,\n          representationId: rep.id,\n          params: { areaId: gid, polygonId: p.id ?? '—' },\n          message: `a polygon of representation \"${rep.id}\" binds area \"${gid}\" which does not exist in site \"${rep.spaceId}\"`\n        })\n      }\n      const tid = (p.targetId ?? '').trim()\n      if (tid && p.targetKind) {\n        const pool = p.targetKind === 'equipment' ? equipmentIds : locationIds\n        if (!pool.has(tid)) {\n          out.push({\n            code: 'polygon-target-missing',\n            severity: 'broken',\n            spaceId: rep.spaceId,\n            representationId: rep.id,\n            params: { kind: p.targetKind, targetId: tid, polygonId: p.id ?? '—' },\n            message: `a polygon of representation \"${rep.id}\" binds ${p.targetKind} \"${tid}\", which no twin on site \"${rep.spaceId}\" has`\n          })\n        }\n      }\n    }\n  }\n\n  return out\n}\n\n/** 심각한 것부터 — 화면이 정렬을 다시 정하지 않게 한 곳에서 정한다. */\nexport function sortFindings(findings: readonly SpaceIntegrityFinding[]): SpaceIntegrityFinding[] {\n  const rank = (s: SpaceIntegritySeverity) => (s === 'broken' ? 0 : 1)\n  return [...findings].sort(\n    (a, b) => rank(a.severity) - rank(b.severity) || a.code.localeCompare(b.code) || (a.spaceId ?? '').localeCompare(b.spaceId ?? '')\n  )\n}\n"]}

package/dist-server/service/twin-space/twin-space-area.js

@@ -8,8 +8,8 @@ const shell_1 = require("@things-factory/shell");
 const twin_space_representation_js_1 = require("./twin-space-representation.js");
 /*
  * TwinSpaceArea — map/image 표현 위의 폴리곤 구역(design/ui/space-composition.md).
- * geometry=폴리곤(map=위경도, image=px). drillTo=클릭 시 이동할 board/표현(폴리곤→보드 모니터/시뮬 뷰).
- * binding=트윈 엔티티/데이터 태그(라이브 상태 결합). board 표현은 씬 컴포넌트가 이 역할을 대신함.
+ * geometry=폴리곤(map=위경도, image=px). drillTo=클릭 시 이동할 model/표현(폴리곤→보드 모니터/시뮬 뷰).
+ * binding=트윈 엔티티/데이터 태그(라이브 상태 결합). model 표현은 씬 컴포넌트가 이 역할을 대신함.
  */
 let TwinSpaceArea = class TwinSpaceArea {
 };
@@ -54,7 +54,7 @@ tslib_1.__decorate([
 ], TwinSpaceArea.prototype, "geometry", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'Drill-down target { kind:"board"|"representation"|"space", id } — click navigates to a board monitor/sim view.' }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'Drill-down target { kind:"board"|"representation"|"space", id } — click navigates to a model monitor/sim view.' }),
     tslib_1.__metadata("design:type", Object)
 ], TwinSpaceArea.prototype, "drillTo", void 0);
 tslib_1.__decorate([
@@ -80,6 +80,6 @@ tslib_1.__decorate([
 exports.TwinSpaceArea = TwinSpaceArea = tslib_1.__decorate([
     (0, typeorm_1.Entity)(),
     (0, typeorm_1.Index)('ix_twin_space_area_0', (e) => [e.domain, e.representation]),
-    (0, type_graphql_1.ObjectType)({ description: 'A polygon region on a map/image representation, linked to a board (drill-down) and bound to a twin entity.' })
+    (0, type_graphql_1.ObjectType)({ description: 'A polygon region on a map/image representation, linked to a model (drill-down) and bound to a twin entity.' })
 ], TwinSpaceArea);
 //# sourceMappingURL=twin-space-area.js.map

package/dist-server/service/twin-space/twin-space-area.js.map

@@ -1 +1 @@
-{"version":3,"file":"twin-space-area.js","sourceRoot":"","sources":["../../../server/service/twin-space/twin-space-area.ts"],"names":[],"mappings":"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","sourcesContent":["import { CreateDateColumn, Entity, Index, Column, RelationId, ManyToOne, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm'\nimport { ObjectType, Field, ID } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\n\nimport { TwinSpaceRepresentation } from './twin-space-representation.js'\n\n/*\n * TwinSpaceArea — map/image 표현 위의 폴리곤 구역(design/ui/space-composition.md).\n * geometry=폴리곤(map=위경도, image=px). drillTo=클릭 시 이동할 board/표현(폴리곤→보드 모니터/시뮬 뷰).\n * binding=트윈 엔티티/데이터 태그(라이브 상태 결합). board 표현은 씬 컴포넌트가 이 역할을 대신함.\n */\n@Entity()\n@Index('ix_twin_space_area_0', (e: TwinSpaceArea) => [e.domain, e.representation])\n@ObjectType({ description: 'A polygon region on a map/image representation, linked to a board (drill-down) and bound to a twin entity.' })\nexport class TwinSpaceArea {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'Owning tenant domain.' })\n  domain?: Domain\n\n  @RelationId((e: TwinSpaceArea) => e.domain)\n  domainId?: string\n\n  @ManyToOne(type => TwinSpaceRepresentation)\n  @Field(type => TwinSpaceRepresentation, { nullable: true, description: 'Owning representation.' })\n  representation?: TwinSpaceRepresentation\n\n  @RelationId((e: TwinSpaceArea) => e.representation)\n  representationId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Area name.' })\n  name?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Region type (building/floor/zone/yard/dock…).' })\n  type?: string\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Polygon geometry { kind:\"polygon\", points:[[x,y]…] } (map=lat/lon, image=px).' })\n  geometry?: any\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Drill-down target { kind:\"board\"|\"representation\"|\"space\", id } — click navigates to a board monitor/sim view.' })\n  drillTo?: any\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Twin binding { locationId?|entityId?|tag? } for live state.' })\n  binding?: any\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Polygon decoration { stroke, fill, fillOpacity, strokeWidth } — line/fill color and opacity.' })\n  style?: any\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n}\n"]}
+{"version":3,"file":"twin-space-area.js","sourceRoot":"","sources":["../../../server/service/twin-space/twin-space-area.ts"],"names":[],"mappings":"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","sourcesContent":["import { CreateDateColumn, Entity, Index, Column, RelationId, ManyToOne, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm'\nimport { ObjectType, Field, ID } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\n\nimport { TwinSpaceRepresentation } from './twin-space-representation.js'\n\n/*\n * TwinSpaceArea — map/image 표현 위의 폴리곤 구역(design/ui/space-composition.md).\n * geometry=폴리곤(map=위경도, image=px). drillTo=클릭 시 이동할 model/표현(폴리곤→보드 모니터/시뮬 뷰).\n * binding=트윈 엔티티/데이터 태그(라이브 상태 결합). model 표현은 씬 컴포넌트가 이 역할을 대신함.\n */\n@Entity()\n@Index('ix_twin_space_area_0', (e: TwinSpaceArea) => [e.domain, e.representation])\n@ObjectType({ description: 'A polygon region on a map/image representation, linked to a model (drill-down) and bound to a twin entity.' })\nexport class TwinSpaceArea {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'Owning tenant domain.' })\n  domain?: Domain\n\n  @RelationId((e: TwinSpaceArea) => e.domain)\n  domainId?: string\n\n  @ManyToOne(type => TwinSpaceRepresentation)\n  @Field(type => TwinSpaceRepresentation, { nullable: true, description: 'Owning representation.' })\n  representation?: TwinSpaceRepresentation\n\n  @RelationId((e: TwinSpaceArea) => e.representation)\n  representationId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Area name.' })\n  name?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Region type (building/floor/zone/yard/dock…).' })\n  type?: string\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Polygon geometry { kind:\"polygon\", points:[[x,y]…] } (map=lat/lon, image=px).' })\n  geometry?: any\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Drill-down target { kind:\"board\"|\"representation\"|\"space\", id } — click navigates to a model monitor/sim view.' })\n  drillTo?: any\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Twin binding { locationId?|entityId?|tag? } for live state.' })\n  binding?: any\n\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'Polygon decoration { stroke, fill, fillOpacity, strokeWidth } — line/fill color and opacity.' })\n  style?: any\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n}\n"]}

package/dist-server/service/twin-space/twin-space-representation.js

@@ -7,9 +7,9 @@ const type_graphql_1 = require("type-graphql");
 const shell_1 = require("@things-factory/shell");
 const twin_space_js_1 = require("./twin-space.js");
 /*
- * TwinSpaceRepresentation — 공간을 보는 한 방식(map|image|board), 복수·1개 primary(공간구성 아키텍처, design/ui/space-composition.md).
- * config(simple-json): board={boardId}(board-service 참조) / image={attachmentId|boardId,width,height} / map={center,zoom,provider}.
- * 폴리곤 영역은 TwinSpaceArea(map/image), board 표현은 씬 컴포넌트가 대신.
+ * TwinSpaceRepresentation — 공간을 보는 한 방식(map|image|model), 복수·1개 primary(공간구성 아키텍처, design/ui/space-composition.md).
+ * config(simple-json): model={boardId}(board-service 참조) / image={attachmentId|boardId,width,height} / map={center,zoom,provider}.
+ * 폴리곤 영역은 TwinSpaceArea(map/image), model 표현은 씬 컴포넌트가 대신.
  */
 let TwinSpaceRepresentation = class TwinSpaceRepresentation {
 };
@@ -39,7 +39,7 @@ tslib_1.__decorate([
 ], TwinSpaceRepresentation.prototype, "spaceId", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)(),
-    (0, type_graphql_1.Field)({ description: 'Representation type: map | image | board.' }),
+    (0, type_graphql_1.Field)({ description: 'Representation type: map | image | model.' }),
     tslib_1.__metadata("design:type", String)
 ], TwinSpaceRepresentation.prototype, "type", void 0);
 tslib_1.__decorate([
@@ -59,7 +59,7 @@ tslib_1.__decorate([
 ], TwinSpaceRepresentation.prototype, "isPrimary", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'Type config: board {boardId} / image {attachmentId|boardId,width,height} / map {center,zoom,provider}.' }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'Type config: model {boardId} / image {attachmentId|boardId,width,height} / map {center,zoom,provider}.' }),
     tslib_1.__metadata("design:type", Object)
 ], TwinSpaceRepresentation.prototype, "config", void 0);
 tslib_1.__decorate([
@@ -75,6 +75,6 @@ tslib_1.__decorate([
 exports.TwinSpaceRepresentation = TwinSpaceRepresentation = tslib_1.__decorate([
     (0, typeorm_1.Entity)(),
     (0, typeorm_1.Index)('ix_twin_space_rep_0', (e) => [e.domain, e.space]),
-    (0, type_graphql_1.ObjectType)({ description: 'A way to view a Space (map | image | board). Multiple per space, one primary.' })
+    (0, type_graphql_1.ObjectType)({ description: 'A way to view a Space (map | image | model). Multiple per space, one primary.' })
 ], TwinSpaceRepresentation);
 //# sourceMappingURL=twin-space-representation.js.map