@things-factory/headless-twin 10.0.9 → 10.0.11

package/dist-server/service/twin-lifecycle/twin-lifecycle-mutation.js

@@ -12,20 +12,30 @@ const domain_catalog_js_1 = require("./domain-catalog.js");
  * 트윈 인스턴스 생명주기 채널 — 프로비저닝(상향, ADR-0015).
  * State/Command/Scenario 는 이미 running 인 인스턴스를 다루지만, 이 채널은 인스턴스 자체를 만들고/설정하고/없앤다.
  * 생명주기: provision(save, 미기동) → start → stop → delete. 모두 domain 스코프(context.state.domain.id).
- * board(BoardDef+layout)=구조, scenario=자극 은 분리 — 여기선 구조만 세운다. 자극은 controlTwinScenario 로.
+ * model(TwinModelDef+layout)=구조, scenario=자극 은 분리 — 여기선 구조만 세운다. 자극은 controlTwinScenario 로.
  */
 let TwinLifecycleMutation = class TwinLifecycleMutation {
-    /** 프로비저닝(저장, 미기동) — 구조를 레지스트리에 등록만. 재프로비전 시 구조 변경이면 저널 purge(엔진). */
-    async saveTwinInstance(instanceId, kind, board, context) {
-        await index_js_1.TwinEngine.provision(context.state.domain.id, instanceId, kind, board);
-        return true;
-    }
-    /** 기동 — board 를 주면 provision+start, 없으면 레지스트리에 저장된 구조로 start. */
-    async startTwinInstance(instanceId, context, kind, board) {
+    /*
+     * `saveTwinInstance` 는 **없앴다**(2026-08-08, ADR-0028).
+     *
+     * 트윈의 구조를 임의의 model 로 덮어쓰는 문이었고, 유일한 소비자는 손저작 편집기였다.
+     * 구조는 원본에서 온다 — 템플릿(`createFromTemplate`)이나 커넥터(`ingestMaster`)가 그 길이다.
+     * 문을 열어 두면 화면만 지워도 다음 소비자가 다시 생긴다.
+     *
+     * 시뮬 트윈을 세우는 것은 여전히 가능하다. 다만 그 입구는 **원본을 만드는 쪽**이지
+     * 트윈을 고치는 쪽이 아니다(ADR-0029 — 시뮬레이터는 원본의 한 종류).
+     */
+    /** 기동 — model 를 주면 provision+start, 없으면 레지스트리에 저장된 구조로 start. */
+    async startTwinInstance(instanceId, context, kind, model) {
         const domainId = context.state.domain.id;
         // 시각 기준은 **공간**이 갖는다(테넌트 아님) — 교대의 HH:MM 을 어느 기준으로 읽나.
-        if (board)
-            index_js_1.TwinEngine.start(instanceId, domainId, kind ?? 'wms', await index_js_1.TwinEngine.withSpaceTimeBase(board, domainId));
+        if (model) {
+            /* model 를 함께 주는 것은 프로비저닝이다 — 그러면 종류도 말해야 한다.
+               예전에는 `kind ?? 'wms'` 로 메웠는데, 종류를 빠뜨린 야드/생산 트윈이 **창고로 조용히 기동**했다. */
+            if (!kind)
+                throw new Error('kind is required when model is given — it decides which domain kernel runs this twin');
+            index_js_1.TwinEngine.start(instanceId, domainId, kind, await index_js_1.TwinEngine.withSpaceTimeBase(model, domainId));
+        }
         else
             await index_js_1.TwinEngine.startFromRegistry(domainId, instanceId);
         return true;
@@ -55,7 +65,7 @@ let TwinLifecycleMutation = class TwinLifecycleMutation {
     async twinInstanceList(context) {
         return index_js_1.TwinEngine.list(context.state.domain.id);
     }
-    /** 단건 상세 — 프로비저닝 에디터용 board(구조+layout) 포함. */
+    /** 단건 상세 — 프로비저닝 에디터용 model(구조+layout) 포함. */
     async twinInstanceDetail(instanceId, context) {
         return index_js_1.TwinEngine.detail(context.state.domain.id, instanceId);
     }
@@ -80,25 +90,12 @@ exports.TwinLifecycleMutation = TwinLifecycleMutation;
 tslib_1.__decorate([
     (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
     (0, type_graphql_1.Mutation)(returns => Boolean, {
-        description: 'Provision (save) a twin instance structure (kind: wms|yms|mes) from a BoardDef without starting it.'
-    }),
-    tslib_1.__param(0, (0, type_graphql_1.Arg)('instanceId')),
-    tslib_1.__param(1, (0, type_graphql_1.Arg)('kind')),
-    tslib_1.__param(2, (0, type_graphql_1.Arg)('board', type => shell_1.ScalarObject)),
-    tslib_1.__param(3, (0, type_graphql_1.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [String, String, Object, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], TwinLifecycleMutation.prototype, "saveTwinInstance", null);
-tslib_1.__decorate([
-    (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
-    (0, type_graphql_1.Mutation)(returns => Boolean, {
-        description: 'Start a twin runtime instance and begin the worker tick. If board is given it provisions first; otherwise it starts from the saved registry board.'
+        description: 'Start a twin runtime instance and begin the worker tick. If model is given it provisions first; otherwise it starts from the saved registry model.'
     }),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('instanceId')),
     tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
     tslib_1.__param(2, (0, type_graphql_1.Arg)('kind', { nullable: true })),
-    tslib_1.__param(3, (0, type_graphql_1.Arg)('board', type => shell_1.ScalarObject, { nullable: true })),
+    tslib_1.__param(3, (0, type_graphql_1.Arg)('model', type => shell_1.ScalarObject, { nullable: true })),
     tslib_1.__metadata("design:type", Function),
     tslib_1.__metadata("design:paramtypes", [String, Object, String, Object]),
     tslib_1.__metadata("design:returntype", Promise)
@@ -137,7 +134,7 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:returntype", Promise)
 ], TwinLifecycleMutation.prototype, "twinInstanceList", null);
 tslib_1.__decorate([
-    (0, type_graphql_1.Query)(returns => shell_1.ScalarObject, { nullable: true, description: 'Get one provisioned twin instance with its BoardDef (structure + layout) for editing.' }),
+    (0, type_graphql_1.Query)(returns => shell_1.ScalarObject, { nullable: true, description: 'Get one provisioned twin instance with its TwinModelDef (structure + layout) for editing.' }),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('instanceId')),
     tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
     tslib_1.__metadata("design:type", Function),

package/dist-server/service/twin-lifecycle/twin-lifecycle-mutation.js.map

@@ -1 +1 @@
-{"version":3,"file":"twin-lifecycle-mutation.js","sourceRoot":"","sources":["../../../server/service/twin-lifecycle/twin-lifecycle-mutation.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Mutation, Query, Resolver, Directive} from 'type-graphql'\n\nimport { ScalarObject } from '@things-factory/shell'\n\nimport { TwinEngine } from '../../engine/index.js'\n\nimport type { BoardDef } from '@operato/twin-kernel'\n\n/* 도메인 어휘 카탈로그(시스템별 노드 타입) — 커널이 SSOT. 앱/UI 는 이걸 소싱하고 재선언하지 않는다(방언 금지).\n * 조합은 domain-catalog.ts 가 소유 — 리졸버와 서버측 소비자(board-ai 도구 등)가 같은 형태를 본다. */\nimport { domainCatalog } from './domain-catalog.js'\n\n/*\n * 트윈 인스턴스 생명주기 채널 — 프로비저닝(상향, ADR-0015).\n * State/Command/Scenario 는 이미 running 인 인스턴스를 다루지만, 이 채널은 인스턴스 자체를 만들고/설정하고/없앤다.\n * 생명주기: provision(save, 미기동) → start → stop → delete. 모두 domain 스코프(context.state.domain.id).\n * board(BoardDef+layout)=구조, scenario=자극 은 분리 — 여기선 구조만 세운다. 자극은 controlTwinScenario 로.\n */\n@Resolver()\nexport class TwinLifecycleMutation {\n  /** 프로비저닝(저장, 미기동) — 구조를 레지스트리에 등록만. 재프로비전 시 구조 변경이면 저널 purge(엔진). */\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\", domainOwnerGranted: true, superUserGranted: true)')\n  @Mutation(returns => Boolean, {\n    description: 'Provision (save) a twin instance structure (kind: wms|yms|mes) from a BoardDef without starting it.'\n  })\n  async saveTwinInstance(\n    @Arg('instanceId') instanceId: string,\n    @Arg('kind') kind: string,\n    @Arg('board', type => ScalarObject) board: any,\n    @Ctx() context: ResolverContext\n  ): Promise<boolean> {\n    await TwinEngine.provision(context.state.domain.id, instanceId, kind, board as BoardDef)\n    return true\n  }\n\n  /** 기동 — board 를 주면 provision+start, 없으면 레지스트리에 저장된 구조로 start. */\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\", domainOwnerGranted: true, superUserGranted: true)')\n  @Mutation(returns => Boolean, {\n    description: 'Start a twin runtime instance and begin the worker tick. If board is given it provisions first; otherwise it starts from the saved registry board.'\n  })\n  async startTwinInstance(\n    @Arg('instanceId') instanceId: string,\n    @Ctx() context: ResolverContext,\n    @Arg('kind', { nullable: true }) kind?: string,\n    @Arg('board', type => ScalarObject, { nullable: true }) board?: any\n  ): Promise<boolean> {\n    const domainId = context.state.domain.id\n    // 시각 기준은 **공간**이 갖는다(테넌트 아님) — 교대의 HH:MM 을 어느 기준으로 읽나.\n    if (board) TwinEngine.start(instanceId, domainId, kind ?? 'wms', await TwinEngine.withSpaceTimeBase(board as BoardDef, domainId))\n    else await TwinEngine.startFromRegistry(domainId, instanceId)\n    return true\n  }\n\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\", domainOwnerGranted: true, superUserGranted: true)')\n  @Mutation(returns => Boolean, { description: 'Stop a running twin runtime instance by its id (only if it belongs to the current domain).' })\n  async stopTwinInstance(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    if (!TwinEngine.owns(context.state.domain.id, instanceId)) return false // 테넌트 격리 — 남의 도메인 트윈 정지 차단\n    await TwinEngine.stop(context.state.domain.id, instanceId)\n    return true\n  }\n\n  /** 삭제 — 정지 + 레지스트리 삭제 + 저널 purge(domain 스코프). */\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\", domainOwnerGranted: true, superUserGranted: true)')\n  @Mutation(returns => Boolean, { description: 'Delete a twin instance: stop it, remove the registry entry and purge its event journal.' })\n  async deleteTwinInstance(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    await TwinEngine.remove(context.state.domain.id, instanceId)\n    return true\n  }\n\n  /** 관리 목록 — 등록된 인스턴스 전체(kind/status/running/revision/노드·무버 수). 데이터 없으면 빈 배열. */\n  /**\n   * **이 공간의 트윈 id 들** — 한 현실을 여러 렌즈가 비추므로 공간을 물으면 그 렌즈 전부를 답한다.\n   *\n   * 화면이 전체 목록을 받아 걸러 쓰던 규칙을 서버로 모은다. 예측 화면은 같은 확장을 한 파일에서\n   * **두 번** 복제하고 있었고, 규칙이 흩어지면 한쪽만 고쳐진다. 떠 있지 않은 것도 포함한다 —\n   * 공간에 무엇이 있는지는 기동 여부와 다른 사실이다.\n   */\n  @Query(returns => [String], { description: 'Ids of the twins that live in a space (all its lenses), running or not.' })\n  async twinSpaceInstanceIds(@Arg('spaceId') spaceId: string, @Ctx() context: ResolverContext): Promise<string[]> {\n    return TwinEngine.instanceIdsOfSpace(context.state.domain.id, spaceId)\n  }\n\n  @Query(returns => [ScalarObject], { description: 'List provisioned twin instances in the current domain with management metadata.' })\n  async twinInstanceList(@Ctx() context: ResolverContext): Promise<any[]> {\n    return TwinEngine.list(context.state.domain.id)\n  }\n\n  /** 단건 상세 — 프로비저닝 에디터용 board(구조+layout) 포함. */\n  @Query(returns => ScalarObject, { nullable: true, description: 'Get one provisioned twin instance with its BoardDef (structure + layout) for editing.' })\n  async twinInstanceDetail(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): Promise<any | null> {\n    return TwinEngine.detail(context.state.domain.id, instanceId)\n  }\n\n  /**\n   * 라이브(메모리) 인스턴스 id 목록 — 콘솔 셀렉터·포트폴리오용. **현재 도메인만**(테넌트 격리).\n   * 과거엔 Object.keys(TwinEngine.instances) 로 전역 반환 → 다른 도메인 트윈이 종합현황/셀렉터에 새던 버그.\n   * 도메인 스코프 목록(twinInstanceList 와 동일 소스)에서 running 만 추린다.\n   */\n  @Query(returns => [String], { description: 'List ids of running (in-memory) twin runtime instances in the current domain (tenant-isolated).' })\n  async twinInstances(@Ctx() context: ResolverContext): Promise<string[]> {\n    const list = await TwinEngine.list(context.state.domain.id)\n    return list.filter((x: any) => x.running).map((x: any) => x.instanceId)\n  }\n\n  /**\n   * 도메인 어휘 카탈로그 — 커널(레퍼런스) SSOT 를 그대로 노출. { wms:{label,locationTypes[]}, yms:…, mes:… }.\n   * 프로비저닝 UI 는 이걸 소싱해 노드 타입/시스템을 채운다(앱 내 하드코딩 금지).\n   */\n  @Query(returns => ScalarObject, { description: 'Domain vocabulary catalog (per-system location location types) sourced from the twin kernel — SSOT for provisioning UI.' })\n  twinDomainCatalog(): any {\n    return domainCatalog()\n  }\n}\n"]}
+{"version":3,"file":"twin-lifecycle-mutation.js","sourceRoot":"","sources":["../../../server/service/twin-lifecycle/twin-lifecycle-mutation.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Mutation, Query, Resolver, Directive} from 'type-graphql'\n\nimport { ScalarObject } from '@things-factory/shell'\n\nimport { TwinEngine } from '../../engine/index.js'\n\nimport type { TwinModelDef } from '@operato/twin-kernel'\n\n/* 도메인 어휘 카탈로그(시스템별 노드 타입) — 커널이 SSOT. 앱/UI 는 이걸 소싱하고 재선언하지 않는다(방언 금지).\n * 조합은 domain-catalog.ts 가 소유 — 리졸버와 서버측 소비자(board-ai 도구 등)가 같은 형태를 본다. */\nimport { domainCatalog } from './domain-catalog.js'\n\n/*\n * 트윈 인스턴스 생명주기 채널 — 프로비저닝(상향, ADR-0015).\n * State/Command/Scenario 는 이미 running 인 인스턴스를 다루지만, 이 채널은 인스턴스 자체를 만들고/설정하고/없앤다.\n * 생명주기: provision(save, 미기동) → start → stop → delete. 모두 domain 스코프(context.state.domain.id).\n * model(TwinModelDef+layout)=구조, scenario=자극 은 분리 — 여기선 구조만 세운다. 자극은 controlTwinScenario 로.\n */\n@Resolver()\nexport class TwinLifecycleMutation {\n  /*\n   * `saveTwinInstance` 는 **없앴다**(2026-08-08, ADR-0028).\n   *\n   * 트윈의 구조를 임의의 model 로 덮어쓰는 문이었고, 유일한 소비자는 손저작 편집기였다.\n   * 구조는 원본에서 온다 — 템플릿(`createFromTemplate`)이나 커넥터(`ingestMaster`)가 그 길이다.\n   * 문을 열어 두면 화면만 지워도 다음 소비자가 다시 생긴다.\n   *\n   * 시뮬 트윈을 세우는 것은 여전히 가능하다. 다만 그 입구는 **원본을 만드는 쪽**이지\n   * 트윈을 고치는 쪽이 아니다(ADR-0029 — 시뮬레이터는 원본의 한 종류).\n   */\n\n  /** 기동 — model 를 주면 provision+start, 없으면 레지스트리에 저장된 구조로 start. */\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\", domainOwnerGranted: true, superUserGranted: true)')\n  @Mutation(returns => Boolean, {\n    description: 'Start a twin runtime instance and begin the worker tick. If model is given it provisions first; otherwise it starts from the saved registry model.'\n  })\n  async startTwinInstance(\n    @Arg('instanceId') instanceId: string,\n    @Ctx() context: ResolverContext,\n    @Arg('kind', { nullable: true }) kind?: string,\n    @Arg('model', type => ScalarObject, { nullable: true }) model?: any\n  ): Promise<boolean> {\n    const domainId = context.state.domain.id\n    // 시각 기준은 **공간**이 갖는다(테넌트 아님) — 교대의 HH:MM 을 어느 기준으로 읽나.\n    if (model) {\n      /* model 를 함께 주는 것은 프로비저닝이다 — 그러면 종류도 말해야 한다.\n         예전에는 `kind ?? 'wms'` 로 메웠는데, 종류를 빠뜨린 야드/생산 트윈이 **창고로 조용히 기동**했다. */\n      if (!kind) throw new Error('kind is required when model is given — it decides which domain kernel runs this twin')\n      TwinEngine.start(instanceId, domainId, kind, await TwinEngine.withSpaceTimeBase(model as TwinModelDef, domainId))\n    }\n    else await TwinEngine.startFromRegistry(domainId, instanceId)\n    return true\n  }\n\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\", domainOwnerGranted: true, superUserGranted: true)')\n  @Mutation(returns => Boolean, { description: 'Stop a running twin runtime instance by its id (only if it belongs to the current domain).' })\n  async stopTwinInstance(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    if (!TwinEngine.owns(context.state.domain.id, instanceId)) return false // 테넌트 격리 — 남의 도메인 트윈 정지 차단\n    await TwinEngine.stop(context.state.domain.id, instanceId)\n    return true\n  }\n\n  /** 삭제 — 정지 + 레지스트리 삭제 + 저널 purge(domain 스코프). */\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\", domainOwnerGranted: true, superUserGranted: true)')\n  @Mutation(returns => Boolean, { description: 'Delete a twin instance: stop it, remove the registry entry and purge its event journal.' })\n  async deleteTwinInstance(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    await TwinEngine.remove(context.state.domain.id, instanceId)\n    return true\n  }\n\n  /** 관리 목록 — 등록된 인스턴스 전체(kind/status/running/revision/노드·무버 수). 데이터 없으면 빈 배열. */\n  /**\n   * **이 공간의 트윈 id 들** — 한 현실을 여러 렌즈가 비추므로 공간을 물으면 그 렌즈 전부를 답한다.\n   *\n   * 화면이 전체 목록을 받아 걸러 쓰던 규칙을 서버로 모은다. 예측 화면은 같은 확장을 한 파일에서\n   * **두 번** 복제하고 있었고, 규칙이 흩어지면 한쪽만 고쳐진다. 떠 있지 않은 것도 포함한다 —\n   * 공간에 무엇이 있는지는 기동 여부와 다른 사실이다.\n   */\n  @Query(returns => [String], { description: 'Ids of the twins that live in a space (all its lenses), running or not.' })\n  async twinSpaceInstanceIds(@Arg('spaceId') spaceId: string, @Ctx() context: ResolverContext): Promise<string[]> {\n    return TwinEngine.instanceIdsOfSpace(context.state.domain.id, spaceId)\n  }\n\n  @Query(returns => [ScalarObject], { description: 'List provisioned twin instances in the current domain with management metadata.' })\n  async twinInstanceList(@Ctx() context: ResolverContext): Promise<any[]> {\n    return TwinEngine.list(context.state.domain.id)\n  }\n\n  /** 단건 상세 — 프로비저닝 에디터용 model(구조+layout) 포함. */\n  @Query(returns => ScalarObject, { nullable: true, description: 'Get one provisioned twin instance with its TwinModelDef (structure + layout) for editing.' })\n  async twinInstanceDetail(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): Promise<any | null> {\n    return TwinEngine.detail(context.state.domain.id, instanceId)\n  }\n\n  /**\n   * 라이브(메모리) 인스턴스 id 목록 — 콘솔 셀렉터·포트폴리오용. **현재 도메인만**(테넌트 격리).\n   * 과거엔 Object.keys(TwinEngine.instances) 로 전역 반환 → 다른 도메인 트윈이 종합현황/셀렉터에 새던 버그.\n   * 도메인 스코프 목록(twinInstanceList 와 동일 소스)에서 running 만 추린다.\n   */\n  @Query(returns => [String], { description: 'List ids of running (in-memory) twin runtime instances in the current domain (tenant-isolated).' })\n  async twinInstances(@Ctx() context: ResolverContext): Promise<string[]> {\n    const list = await TwinEngine.list(context.state.domain.id)\n    return list.filter((x: any) => x.running).map((x: any) => x.instanceId)\n  }\n\n  /**\n   * 도메인 어휘 카탈로그 — 커널(레퍼런스) SSOT 를 그대로 노출. { wms:{label,locationTypes[]}, yms:…, mes:… }.\n   * 프로비저닝 UI 는 이걸 소싱해 노드 타입/시스템을 채운다(앱 내 하드코딩 금지).\n   */\n  @Query(returns => ScalarObject, { description: 'Domain vocabulary catalog (per-system location location types) sourced from the twin kernel — SSOT for provisioning UI.' })\n  twinDomainCatalog(): any {\n    return domainCatalog()\n  }\n}\n"]}

package/dist-server/service/twin-metrics/twin-metrics-query.d.ts

@@ -1,4 +1,5 @@
 export declare class TwinMetricsQuery {
     twinMetrics(instanceId: string, context: ResolverContext): any;
     twinMetricsAll(context: ResolverContext): Promise<any[]>;
+    twinLoad(context: ResolverContext): Promise<any>;
 }

package/dist-server/service/twin-metrics/twin-metrics-query.js

@@ -3,13 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TwinMetricsQuery = void 0;
 const tslib_1 = require("tslib");
 const type_graphql_1 = require("type-graphql");
+const typeorm_1 = require("typeorm");
 const shell_1 = require("@things-factory/shell");
 const index_js_1 = require("../../engine/index.js");
+const load_meter_js_1 = require("../../engine/load-meter.js");
 /*
  * 트윈 처리량 계측(모니터, ④-1) — 라이브 동기 인터페이스 부하를 읽는 일급 지표.
  * 유입률(ingestRate)·방송률(broadcastRate)·저널률(journalRate)·백로그(backlog)·누적. 폴링으로 라이브 관측.
  * (부하가 화면에 안 보인다던 문제의 정공법 — "얼마나 들어오고 얼마나 방송/기록되나"를 수치로.)
  */
+/* CPU 는 누적값이라 **표본 사이의 차이**로만 점유율이 나온다. 그래서 호출 사이에 상태가 남아야 한다. */
+const CPU_SAMPLER = (0, load_meter_js_1.newCpuSampler)();
 let TwinMetricsQuery = class TwinMetricsQuery {
     twinMetrics(instanceId, context) {
         if (!index_js_1.TwinEngine.owns(context.state.domain.id, instanceId))
@@ -19,6 +23,54 @@ let TwinMetricsQuery = class TwinMetricsQuery {
     async twinMetricsAll(context) {
         return index_js_1.TwinEngine.allMetrics(context.state.domain.id); // 도메인 스코프
     }
+    /*
+     * ── 이벤트 루프 부하 — **운영 계기판이다. 테넌트 기능이 아니다.** ─────────────
+     *
+     * `twinMetrics` 는 "얼마나 들어오고 나가나"(초당 이벤트)를 답한다. 여기서 묻는 것은 "그 일을 하느라
+     * 이벤트 루프를 얼마나 붙잡고 있나" 다. 시뮬 틱은 트윈마다 setInterval 로 **메인 루프에서 동기로**
+     * 돌기 때문에, 한 트윈이 느려지면 HTTP·구독이 함께 느려진다. 실제로 그 상태를 겪었는데 볼 계기판이
+     * 없어서 "포트는 열렸는데 응답이 없다" 로만 보였다.
+     *
+     * ── 왜 도메인으로 자르지 않나 ───────────────────────────────────────────────
+     * 처음에는 호출자의 도메인만 냈다. 테넌트 격리로는 맞아 보이지만 **이벤트 루프는 프로세스 하나가
+     * 공유한다.** 실측으로 드러났다: 한 도메인 트윈 22개가 CPU 를 110% 쓰는 동안, 다른 도메인 화면은
+     * `실행 중 0 · 루프 점유 —` 였다. "내 도메인은 한가한데 왜 느리지" 를 설명할 수 없었다.
+     *
+     * 그렇다고 테넌트에게 남의 부하를 조금 보여 주는 것도 답이 아니다 — 쓸 수 없는 정보이고 봐서도 안 된다.
+     * 층이 잘못이었다: 이것은 **프로세스를 운영하는 사람의 계기판**이다. 그래서 도메인으로 자르지 않고
+     * (전 테넌트 합산) **슈퍼유저에게만** 연다.
+     */
+    async twinLoad(context) {
+        const fleet = index_js_1.TwinEngine.fleet(); // 프로세스 전체 — 도메인으로 자르지 않는다(위 주석)
+        /* 도메인 id 는 UUID 라 사람이 못 읽는다. 읽을 수 있는 이름을 채운다 — **모르면 id 를 그대로 둔다**
+           (지어내지 않는다). 라이브 인스턴스에는 이미 붙어 있고, 시뮬은 여기서 한 번 조회한다. */
+        const ids = [...new Set((fleet.byDomain ?? []).map((d) => d.domainId).filter((v) => v && v !== '(unknown)'))];
+        if (ids.length) {
+            const found = await (0, shell_1.getRepository)(shell_1.Domain).find({ where: { id: (0, typeorm_1.In)(ids) } });
+            const nameOf = new Map(found.map(d => [d.id, d.subdomain || d.name]));
+            for (const d of fleet.byDomain)
+                if (nameOf.get(d.domainId))
+                    d.label = nameOf.get(d.domainId);
+            for (const r of fleet.slowest ?? [])
+                if (r.domainId && nameOf.get(r.domainId))
+                    r.domainLabel = nameOf.get(r.domainId);
+            for (const r of fleet.details ?? [])
+                if (r.domainId && nameOf.get(r.domainId))
+                    r.domainLabel = nameOf.get(r.domainId);
+        }
+        /*
+         * 프로세스가 실제로 쓴 CPU — **계기판의 다른 숫자와 뜻이 다르다.**
+         *
+         * 위의 값들은 트윈의 계측된 작업만 잰 것이라, 그 밖의 일(GraphQL·TypeORM·GC·webpack·HTTP)은
+         * 분모에도 분자에도 없다. "루프 점유 <1%" 인데 CPU 는 110% 였던 상태를 실제로 겪었다. 두 숫자를
+         * 나란히 두어야 **트윈이 범인인지** 가릴 수 있다.
+         *
+         * 표본 간 차이라 첫 호출은 `null` 이다 — 0 이 아니다.
+         */
+        const usage = process.cpuUsage();
+        const cpu = (0, load_meter_js_1.sampleCpu)(CPU_SAMPLER, usage.user + usage.system, Date.now());
+        return { ...fleet, processCpuRatio: cpu?.ratio ?? null, processCpuSpanMs: cpu?.spanMs ?? null };
+    }
 };
 exports.TwinMetricsQuery = TwinMetricsQuery;
 tslib_1.__decorate([
@@ -36,6 +88,16 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], TwinMetricsQuery.prototype, "twinMetricsAll", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(superUserGranted: true)'),
+    (0, type_graphql_1.Query)(returns => shell_1.ScalarObject, {
+        description: 'Event-loop load of every twin in this process, for system operators (superuser only). Deliberately NOT scoped to the caller\'s domain: the event loop is shared by the whole process, so a tenant-scoped view reports an idle domain while the machine is saturated by someone else. Reports how many instances are running (by mode), how many forecast forks have been created, and per instance how long each kind of work takes (kernel tick, state snapshot, broadcast payload, publish, journal write, live ingest, Monte-Carlo forecast, fork trajectory). Each instance reports both `recent` (the last closed sampling window — what it is doing now) and `total` (cumulative since boot), with `busyRatio` telling how much of the window that twin held the loop. `fleetBusyRatio` above 1 means the twins together cannot finish inside one tick interval, which is when HTTP and subscriptions start to stall. Work that has never been measured is reported as null rather than zero, because zero would read as "instant".'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinMetricsQuery.prototype, "twinLoad", null);
 exports.TwinMetricsQuery = TwinMetricsQuery = tslib_1.__decorate([
     (0, type_graphql_1.Resolver)()
 ], TwinMetricsQuery);

package/dist-server/service/twin-metrics/twin-metrics-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"twin-metrics-query.js","sourceRoot":"","sources":["../../../server/service/twin-metrics/twin-metrics-query.ts"],"names":[],"mappings":";;;;AAAA,+CAAwD;AAExD,iDAAoD;AAEpD,oDAAkD;AAElD;;;;GAIG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAE3B,WAAW,CAAoB,UAAkB,EAAS,OAAwB;QAChF,IAAI,CAAC,qBAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC;YAAE,OAAO,IAAI,CAAA,CAAC,SAAS;QAChF,OAAO,qBAAU,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,CAAA;IAChE,CAAC;IAGK,AAAN,KAAK,CAAC,cAAc,CAAQ,OAAwB;QAClD,OAAO,qBAAU,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA,CAAC,UAAU;IAClE,CAAC;CACF,CAAA;AAXY,4CAAgB;AAE3B;IADC,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kJAAkJ,EAAE,CAAC;IACvM,mBAAA,IAAA,kBAAG,EAAC,YAAY,CAAC,CAAA;IAAsB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;mDAGxD;AAGK;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,oBAAY,CAAC,EAAE,EAAE,WAAW,EAAE,uGAAuG,EAAE,CAAC;IACrI,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;sDAE1B;2BAVU,gBAAgB;IAD5B,IAAA,uBAAQ,GAAE;GACE,gBAAgB,CAW5B","sourcesContent":["import { Arg, Ctx, Query, Resolver } from 'type-graphql'\n\nimport { ScalarObject } from '@things-factory/shell'\n\nimport { TwinEngine } from '../../engine/index.js'\n\n/*\n * 트윈 처리량 계측(모니터, ④-1) — 라이브 동기 인터페이스 부하를 읽는 일급 지표.\n * 유입률(ingestRate)·방송률(broadcastRate)·저널률(journalRate)·백로그(backlog)·누적. 폴링으로 라이브 관측.\n * (부하가 화면에 안 보인다던 문제의 정공법 — \"얼마나 들어오고 얼마나 방송/기록되나\"를 수치로.)\n */\n@Resolver()\nexport class TwinMetricsQuery {\n  @Query(returns => ScalarObject, { nullable: true, description: 'Live throughput metrics of one twin instance (ingest/broadcast/journal rate, backlog). Null if not a live instance or not in the current domain.' })\n  twinMetrics(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): any {\n    if (!TwinEngine.owns(context.state.domain.id, instanceId)) return null // 테넌트 격리\n    return TwinEngine.metrics(context.state.domain.id, instanceId)\n  }\n\n  @Query(returns => [ScalarObject], { description: 'Live throughput metrics of all running live twin instances in the current domain (monitor dashboard).' })\n  async twinMetricsAll(@Ctx() context: ResolverContext): Promise<any[]> {\n    return TwinEngine.allMetrics(context.state.domain.id) // 도메인 스코프\n  }\n}\n"]}
+{"version":3,"file":"twin-metrics-query.js","sourceRoot":"","sources":["../../../server/service/twin-metrics/twin-metrics-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Directive, Query, Resolver } from 'type-graphql'\n\nimport { In } from 'typeorm'\n\nimport { Domain, getRepository, ScalarObject } from '@things-factory/shell'\n\nimport { TwinEngine } from '../../engine/index.js'\nimport { newCpuSampler, sampleCpu } from '../../engine/load-meter.js'\n\n/*\n * 트윈 처리량 계측(모니터, ④-1) — 라이브 동기 인터페이스 부하를 읽는 일급 지표.\n * 유입률(ingestRate)·방송률(broadcastRate)·저널률(journalRate)·백로그(backlog)·누적. 폴링으로 라이브 관측.\n * (부하가 화면에 안 보인다던 문제의 정공법 — \"얼마나 들어오고 얼마나 방송/기록되나\"를 수치로.)\n */\n/* CPU 는 누적값이라 **표본 사이의 차이**로만 점유율이 나온다. 그래서 호출 사이에 상태가 남아야 한다. */\nconst CPU_SAMPLER = newCpuSampler()\n\n@Resolver()\nexport class TwinMetricsQuery {\n  @Query(returns => ScalarObject, { nullable: true, description: 'Live throughput metrics of one twin instance (ingest/broadcast/journal rate, backlog). Null if not a live instance or not in the current domain.' })\n  twinMetrics(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): any {\n    if (!TwinEngine.owns(context.state.domain.id, instanceId)) return null // 테넌트 격리\n    return TwinEngine.metrics(context.state.domain.id, instanceId)\n  }\n\n  @Query(returns => [ScalarObject], { description: 'Live throughput metrics of all running live twin instances in the current domain (monitor dashboard).' })\n  async twinMetricsAll(@Ctx() context: ResolverContext): Promise<any[]> {\n    return TwinEngine.allMetrics(context.state.domain.id) // 도메인 스코프\n  }\n\n  /*\n   * ── 이벤트 루프 부하 — **운영 계기판이다. 테넌트 기능이 아니다.** ─────────────\n   *\n   * `twinMetrics` 는 \"얼마나 들어오고 나가나\"(초당 이벤트)를 답한다. 여기서 묻는 것은 \"그 일을 하느라\n   * 이벤트 루프를 얼마나 붙잡고 있나\" 다. 시뮬 틱은 트윈마다 setInterval 로 **메인 루프에서 동기로**\n   * 돌기 때문에, 한 트윈이 느려지면 HTTP·구독이 함께 느려진다. 실제로 그 상태를 겪었는데 볼 계기판이\n   * 없어서 \"포트는 열렸는데 응답이 없다\" 로만 보였다.\n   *\n   * ── 왜 도메인으로 자르지 않나 ───────────────────────────────────────────────\n   * 처음에는 호출자의 도메인만 냈다. 테넌트 격리로는 맞아 보이지만 **이벤트 루프는 프로세스 하나가\n   * 공유한다.** 실측으로 드러났다: 한 도메인 트윈 22개가 CPU 를 110% 쓰는 동안, 다른 도메인 화면은\n   * `실행 중 0 · 루프 점유 —` 였다. \"내 도메인은 한가한데 왜 느리지\" 를 설명할 수 없었다.\n   *\n   * 그렇다고 테넌트에게 남의 부하를 조금 보여 주는 것도 답이 아니다 — 쓸 수 없는 정보이고 봐서도 안 된다.\n   * 층이 잘못이었다: 이것은 **프로세스를 운영하는 사람의 계기판**이다. 그래서 도메인으로 자르지 않고\n   * (전 테넌트 합산) **슈퍼유저에게만** 연다.\n   */\n  @Directive('@privilege(superUserGranted: true)')\n  @Query(returns => ScalarObject, {\n    description:\n      'Event-loop load of every twin in this process, for system operators (superuser only). Deliberately NOT scoped to the caller\\'s domain: the event loop is shared by the whole process, so a tenant-scoped view reports an idle domain while the machine is saturated by someone else. Reports how many instances are running (by mode), how many forecast forks have been created, and per instance how long each kind of work takes (kernel tick, state snapshot, broadcast payload, publish, journal write, live ingest, Monte-Carlo forecast, fork trajectory). Each instance reports both `recent` (the last closed sampling window — what it is doing now) and `total` (cumulative since boot), with `busyRatio` telling how much of the window that twin held the loop. `fleetBusyRatio` above 1 means the twins together cannot finish inside one tick interval, which is when HTTP and subscriptions start to stall. Work that has never been measured is reported as null rather than zero, because zero would read as \"instant\".'\n  })\n  async twinLoad(@Ctx() context: ResolverContext): Promise<any> {\n    const fleet = TwinEngine.fleet() // 프로세스 전체 — 도메인으로 자르지 않는다(위 주석)\n\n    /* 도메인 id 는 UUID 라 사람이 못 읽는다. 읽을 수 있는 이름을 채운다 — **모르면 id 를 그대로 둔다**\n       (지어내지 않는다). 라이브 인스턴스에는 이미 붙어 있고, 시뮬은 여기서 한 번 조회한다. */\n    const ids = [...new Set((fleet.byDomain ?? []).map((d: any) => d.domainId).filter((v: any) => v && v !== '(unknown)'))]\n    if (ids.length) {\n      const found = await getRepository(Domain).find({ where: { id: In(ids as string[]) } })\n      const nameOf = new Map(found.map(d => [d.id, d.subdomain || d.name]))\n      for (const d of fleet.byDomain) if (nameOf.get(d.domainId)) d.label = nameOf.get(d.domainId) as string\n      for (const r of fleet.slowest ?? []) if (r.domainId && nameOf.get(r.domainId)) r.domainLabel = nameOf.get(r.domainId)\n      for (const r of fleet.details ?? []) if (r.domainId && nameOf.get(r.domainId)) r.domainLabel = nameOf.get(r.domainId)\n    }\n\n    /*\n     * 프로세스가 실제로 쓴 CPU — **계기판의 다른 숫자와 뜻이 다르다.**\n     *\n     * 위의 값들은 트윈의 계측된 작업만 잰 것이라, 그 밖의 일(GraphQL·TypeORM·GC·webpack·HTTP)은\n     * 분모에도 분자에도 없다. \"루프 점유 <1%\" 인데 CPU 는 110% 였던 상태를 실제로 겪었다. 두 숫자를\n     * 나란히 두어야 **트윈이 범인인지** 가릴 수 있다.\n     *\n     * 표본 간 차이라 첫 호출은 `null` 이다 — 0 이 아니다.\n     */\n    const usage = process.cpuUsage()\n    const cpu = sampleCpu(CPU_SAMPLER, usage.user + usage.system, Date.now())\n\n    return { ...fleet, processCpuRatio: cpu?.ratio ?? null, processCpuSpanMs: cpu?.spanMs ?? null }\n  }\n}\n"]}

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

@@ -0,0 +1,14 @@
+import type { Isa95Concept } from './isa95-coverage.js';
+export declare const EPCIS_CONCEPTS: Isa95Concept[];
+export declare function epcisCoverage(axes: string[]): {
+    model: string;
+    concepts: (Isa95Concept & {
+        axisMissing?: boolean;
+    })[];
+    totals: {
+        concepts: number;
+        structure: number;
+        behavior: number;
+        surface: number;
+    };
+};

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

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EPCIS_CONCEPTS = void 0;
+exports.epcisCoverage = epcisCoverage;
+/* Part: EPCIS 2.0 의 사건 종류 — 무엇이 일어났는가. */
+const EVENTS = [
+    {
+        std: 'ObjectEvent',
+        part: 'events',
+        label: 'twin.epcis.ObjectEvent',
+        axis: 'items',
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.epcis.note.ObjectEvent'
+    },
+    {
+        std: 'AggregationEvent',
+        part: 'events',
+        label: 'twin.epcis.AggregationEvent',
+        axis: null,
+        shownOn: ['items'],
+        structure: 'full',
+        behavior: 'full',
+        surface: 'partial',
+        note: 'twin.epcis.note.AggregationEvent'
+    },
+    {
+        std: 'TransactionEvent',
+        part: 'events',
+        label: 'twin.epcis.TransactionEvent',
+        axis: 'orders',
+        structure: 'full',
+        behavior: 'full',
+        surface: 'partial',
+        note: 'twin.epcis.note.TransactionEvent'
+    },
+    {
+        std: 'TransformationEvent',
+        part: 'events',
+        label: 'twin.epcis.TransformationEvent',
+        axis: null,
+        shownOn: ['items', 'operations'],
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.epcis.note.TransformationEvent'
+    },
+    /* EPCIS 2.0 이 더한 사건 — 우리는 타입조차 두지 않았다. 없는 것은 없다고 적는다. */
+    {
+        std: 'AssociationEvent',
+        part: 'events',
+        label: 'twin.epcis.AssociationEvent',
+        axis: null,
+        structure: 'none',
+        behavior: 'none',
+        surface: 'none',
+        note: 'twin.epcis.note.AssociationEvent'
+    }
+];
+/* Part: 사건이 답하는 다섯 가지 — 무엇을·어디서·언제·왜, 그리고 어떤 거래로. */
+const FIELDS = [
+    {
+        std: 'epcList / quantityList',
+        part: 'fields',
+        label: 'twin.epcis.identity',
+        axis: 'items',
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.epcis.note.identity'
+    },
+    {
+        std: 'bizStep / disposition (CBV)',
+        part: 'fields',
+        label: 'twin.epcis.cbv',
+        axis: null,
+        shownOn: ['items', 'tasks'],
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.epcis.note.cbv'
+    },
+    {
+        std: 'readPoint / bizLocation',
+        part: 'fields',
+        label: 'twin.epcis.where',
+        axis: 'locations',
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.epcis.note.where'
+    },
+    {
+        std: 'bizTransactionList',
+        part: 'fields',
+        label: 'twin.epcis.bizTransaction',
+        axis: 'orders',
+        structure: 'full',
+        behavior: 'full',
+        surface: 'partial',
+        note: 'twin.epcis.note.bizTransaction'
+    },
+    {
+        std: 'ilmd',
+        part: 'fields',
+        label: 'twin.epcis.ilmd',
+        axis: null,
+        shownOn: ['items'],
+        structure: 'full',
+        behavior: 'full',
+        surface: 'partial',
+        note: 'twin.epcis.note.ilmd'
+    },
+    {
+        std: 'errorDeclaration',
+        part: 'fields',
+        label: 'twin.epcis.errorDeclaration',
+        axis: null,
+        shownOn: ['items'],
+        structure: 'full',
+        behavior: 'partial',
+        surface: 'none',
+        note: 'twin.epcis.note.errorDeclaration'
+    },
+    /* 모양만 있고 아무도 채우지 않는 것들 — 구조만 있음. */
+    {
+        std: 'sourceList / destinationList',
+        part: 'fields',
+        label: 'twin.epcis.sourceDestination',
+        axis: null,
+        structure: 'partial',
+        behavior: 'none',
+        surface: 'none',
+        note: 'twin.epcis.note.sourceDestination'
+    },
+    {
+        std: 'persistentDisposition',
+        part: 'fields',
+        label: 'twin.epcis.persistentDisposition',
+        axis: null,
+        structure: 'partial',
+        behavior: 'none',
+        surface: 'none',
+        note: 'twin.epcis.note.persistentDisposition'
+    },
+    {
+        std: 'sensorElementList',
+        part: 'fields',
+        label: 'twin.epcis.sensorElement',
+        axis: null,
+        structure: 'partial',
+        behavior: 'none',
+        surface: 'none',
+        note: 'twin.epcis.note.sensorElement'
+    }
+];
+exports.EPCIS_CONCEPTS = [...EVENTS, ...FIELDS];
+function epcisCoverage(axes) {
+    const known = new Set(axes);
+    const concepts = exports.EPCIS_CONCEPTS.map(c => {
+        const axisMissing = !!c.axis && !known.has(c.axis);
+        const shownOn = c.shownOn?.filter(a => known.has(a));
+        const fixed = shownOn && shownOn.length !== c.shownOn?.length ? { ...c, shownOn } : c;
+        return axisMissing ? { ...fixed, structure: 'none', axisMissing } : fixed;
+    });
+    const count = (k) => concepts.filter(c => c[k] === 'full').length;
+    return {
+        model: 'GS1 EPCIS 2.0',
+        concepts,
+        totals: { concepts: concepts.length, structure: count('structure'), behavior: count('behavior'), surface: count('surface') }
+    };
+}
+//# sourceMappingURL=epcis-coverage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"epcis-coverage.js","sourceRoot":"","sources":["../../../server/service/twin-model/epcis-coverage.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * GS1 EPCIS 2.0 적합성 기준 — **물류·제조 트윈이 표준의 어디를 채우고 있나.**\n *\n * ── 왜 따로 있나 ────────────────────────────────────────────────────────────\n * 적합성 패널이 ISA-95 하나만 말하고 있었다. 그런데 창고·야드·공장 트윈에서 「무슨 일이 있었나」와\n * 「이 번호가 무엇을 가리키나」를 정하는 것은 EPCIS 다. ISA-95 표만 보이면 그 트윈이 기대는 기준의\n * 절반이 화면에 없다.\n *\n * ── 수준은 근거를 보고 적었다 ───────────────────────────────────────────────\n * 「있다/없다」를 기억으로 적지 않는다. 각 줄의 판단 근거:\n *  · 타입 선언 — 커널 `epcis.ts`(이벤트·필드의 모양)\n *  · 실제 사용 — 커널 도메인(`mes-kernel`·`face2-adapter`·`observed-reducer`)과 호스트 인제스트\n *  · 화면 노출 — 저널·계보·엔티티 360\n * 모양만 있고 아무도 채우지 않는 필드는 **구조만 있음**으로 적는다(그게 사실이다).\n *\n * ISA-95 표와 같은 규율이다(`isa95-coverage.ts` 머리말): 사람이 판단해 적고, 틀리면 여기를 고친다.\n */\nimport type { Isa95Concept, CoverageLevel } from './isa95-coverage.js'\n\n/* Part: EPCIS 2.0 의 사건 종류 — 무엇이 일어났는가. */\nconst EVENTS: Isa95Concept[] = [\n  {\n    std: 'ObjectEvent',\n    part: 'events',\n    label: 'twin.epcis.ObjectEvent',\n    axis: 'items',\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.epcis.note.ObjectEvent'\n  },\n  {\n    std: 'AggregationEvent',\n    part: 'events',\n    label: 'twin.epcis.AggregationEvent',\n    axis: null,\n    shownOn: ['items'],\n    structure: 'full',\n    behavior: 'full',\n    surface: 'partial',\n    note: 'twin.epcis.note.AggregationEvent'\n  },\n  {\n    std: 'TransactionEvent',\n    part: 'events',\n    label: 'twin.epcis.TransactionEvent',\n    axis: 'orders',\n    structure: 'full',\n    behavior: 'full',\n    surface: 'partial',\n    note: 'twin.epcis.note.TransactionEvent'\n  },\n  {\n    std: 'TransformationEvent',\n    part: 'events',\n    label: 'twin.epcis.TransformationEvent',\n    axis: null,\n    shownOn: ['items', 'operations'],\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.epcis.note.TransformationEvent'\n  },\n  /* EPCIS 2.0 이 더한 사건 — 우리는 타입조차 두지 않았다. 없는 것은 없다고 적는다. */\n  {\n    std: 'AssociationEvent',\n    part: 'events',\n    label: 'twin.epcis.AssociationEvent',\n    axis: null,\n    structure: 'none',\n    behavior: 'none',\n    surface: 'none',\n    note: 'twin.epcis.note.AssociationEvent'\n  }\n]\n\n/* Part: 사건이 답하는 다섯 가지 — 무엇을·어디서·언제·왜, 그리고 어떤 거래로. */\nconst FIELDS: Isa95Concept[] = [\n  {\n    std: 'epcList / quantityList',\n    part: 'fields',\n    label: 'twin.epcis.identity',\n    axis: 'items',\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.epcis.note.identity'\n  },\n  {\n    std: 'bizStep / disposition (CBV)',\n    part: 'fields',\n    label: 'twin.epcis.cbv',\n    axis: null,\n    shownOn: ['items', 'tasks'],\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.epcis.note.cbv'\n  },\n  {\n    std: 'readPoint / bizLocation',\n    part: 'fields',\n    label: 'twin.epcis.where',\n    axis: 'locations',\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.epcis.note.where'\n  },\n  {\n    std: 'bizTransactionList',\n    part: 'fields',\n    label: 'twin.epcis.bizTransaction',\n    axis: 'orders',\n    structure: 'full',\n    behavior: 'full',\n    surface: 'partial',\n    note: 'twin.epcis.note.bizTransaction'\n  },\n  {\n    std: 'ilmd',\n    part: 'fields',\n    label: 'twin.epcis.ilmd',\n    axis: null,\n    shownOn: ['items'],\n    structure: 'full',\n    behavior: 'full',\n    surface: 'partial',\n    note: 'twin.epcis.note.ilmd'\n  },\n  {\n    std: 'errorDeclaration',\n    part: 'fields',\n    label: 'twin.epcis.errorDeclaration',\n    axis: null,\n    shownOn: ['items'],\n    structure: 'full',\n    behavior: 'partial',\n    surface: 'none',\n    note: 'twin.epcis.note.errorDeclaration'\n  },\n  /* 모양만 있고 아무도 채우지 않는 것들 — 구조만 있음. */\n  {\n    std: 'sourceList / destinationList',\n    part: 'fields',\n    label: 'twin.epcis.sourceDestination',\n    axis: null,\n    structure: 'partial',\n    behavior: 'none',\n    surface: 'none',\n    note: 'twin.epcis.note.sourceDestination'\n  },\n  {\n    std: 'persistentDisposition',\n    part: 'fields',\n    label: 'twin.epcis.persistentDisposition',\n    axis: null,\n    structure: 'partial',\n    behavior: 'none',\n    surface: 'none',\n    note: 'twin.epcis.note.persistentDisposition'\n  },\n  {\n    std: 'sensorElementList',\n    part: 'fields',\n    label: 'twin.epcis.sensorElement',\n    axis: null,\n    structure: 'partial',\n    behavior: 'none',\n    surface: 'none',\n    note: 'twin.epcis.note.sensorElement'\n  }\n]\n\nexport const EPCIS_CONCEPTS: Isa95Concept[] = [...EVENTS, ...FIELDS]\n\nexport function epcisCoverage(axes: string[]): {\n  model: string\n  concepts: (Isa95Concept & { axisMissing?: boolean })[]\n  totals: { concepts: number; structure: number; behavior: number; surface: number }\n} {\n  const known = new Set(axes)\n  const concepts = EPCIS_CONCEPTS.map(c => {\n    const axisMissing = !!c.axis && !known.has(c.axis)\n    const shownOn = c.shownOn?.filter(a => known.has(a))\n    const fixed = shownOn && shownOn.length !== c.shownOn?.length ? { ...c, shownOn } : c\n    return axisMissing ? { ...fixed, structure: 'none' as CoverageLevel, axisMissing } : fixed\n  })\n  const count = (k: 'structure' | 'behavior' | 'surface') => concepts.filter(c => c[k] === 'full').length\n  return {\n    model: 'GS1 EPCIS 2.0',\n    concepts,\n    totals: { concepts: concepts.length, structure: count('structure'), behavior: count('behavior'), surface: count('surface') }\n  }\n}\n"]}

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

@@ -0,0 +1,14 @@
+import type { Isa95Concept } from './isa95-coverage.js';
+export declare const IEC61850_CONCEPTS: Isa95Concept[];
+export declare function iec61850Coverage(axes: string[]): {
+    model: string;
+    concepts: (Isa95Concept & {
+        axisMissing?: boolean;
+    })[];
+    totals: {
+        concepts: number;
+        structure: number;
+        behavior: number;
+        surface: number;
+    };
+};

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

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IEC61850_CONCEPTS = void 0;
+exports.iec61850Coverage = iec61850Coverage;
+/*
+ * Part 7-4 — 논리 노드 클래스. 이 프로파일이 쓰는 것만 적는다(표준 전체를 옮기지 않는다):
+ * 계량·계측·개폐·발전·저장.
+ */
+const LOGICAL_NODES = [
+    /*
+     * 계량(적산) — 커넥터가 누적 전력량을 실어 오고 상태가 지점별로 들고 있다. 화면은 계량 컴포넌트가
+     * 지점의 값을 보인다.
+     */
+    {
+        std: 'MMTR',
+        part: '7-4',
+        label: 'twin.iec61850.MMTR',
+        axis: 'equipment',
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.iec61850.note.MMTR'
+    },
+    /*
+     * 계측(유효전력·역률) — 표본이 수요 구간으로 접히고, 구간·피크·계약 대비가 그 위에 선다.
+     * 이 프로파일에서 가장 두껍게 채운 자리다.
+     */
+    {
+        std: 'MMXU',
+        part: '7-4',
+        label: 'twin.iec61850.MMXU',
+        axis: 'demandWindows',
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.iec61850.note.MMXU'
+    },
+    /*
+     * ── 셋이 함께 올라갔다 (2026-08-15) ──────────────────────────────────────
+     * 개폐·발전·저장은 오래 「구조만 있음」이었다. 능력이 상태 필드를 선언해 두었는데 **값을 받는 문이
+     * 없었기 때문**이다. 이제 셋 다 실제로 돈다: 설비 상태가 계약에 서고(`EquipmentState`), 커널이
+     * `energy.equipment` 로 받아 그 설비에 적고, 씬 컴포넌트가 그린다.
+     *
+     * 세 층을 함께 올리는 이유: 값이 없는데 화면만 만들면 영원히 「—」인 카드가 되고, 화면이 없는데
+     * 기능만 올리면 아무도 그 값을 보지 못한다. 「값이 먼저, 컴포넌트는 그 다음」의 결과다.
+     */
+    {
+        std: 'XCBR',
+        part: '7-4',
+        label: 'twin.iec61850.XCBR',
+        axis: null,
+        shownOn: ['equipment'],
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.iec61850.note.XCBR'
+    },
+    {
+        std: 'DPVA',
+        part: '7-4',
+        label: 'twin.iec61850.DPVA',
+        axis: null,
+        shownOn: ['equipment'],
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.iec61850.note.DPVA'
+    },
+    {
+        std: 'ZBAT',
+        part: '7-4',
+        label: 'twin.iec61850.ZBAT',
+        axis: null,
+        shownOn: ['equipment'],
+        structure: 'full',
+        behavior: 'full',
+        surface: 'full',
+        note: 'twin.iec61850.note.ZBAT'
+    }
+];
+exports.IEC61850_CONCEPTS = [...LOGICAL_NODES]; // vocabulary-guard: allow — 표준 용어(위 주석)
+function iec61850Coverage(axes) {
+    const known = new Set(axes);
+    const concepts = exports.IEC61850_CONCEPTS.map(c => {
+        const axisMissing = !!c.axis && !known.has(c.axis);
+        const shownOn = c.shownOn?.filter(a => known.has(a));
+        const fixed = shownOn && shownOn.length !== c.shownOn?.length ? { ...c, shownOn } : c;
+        return axisMissing ? { ...fixed, structure: 'none', axisMissing } : fixed;
+    });
+    const count = (k) => concepts.filter(c => c[k] === 'full').length;
+    return {
+        /* 이름에 (vocabulary) 를 달아 둔다 — 프로토콜 적합성으로 읽히지 않게. */
+        model: 'IEC 61850 (vocabulary)',
+        concepts,
+        totals: { concepts: concepts.length, structure: count('structure'), behavior: count('behavior'), surface: count('surface') }
+    };
+}
+//# sourceMappingURL=iec61850-coverage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iec61850-coverage.js","sourceRoot":"","sources":["../../../server/service/twin-model/iec61850-coverage.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * IEC 61850 적합성 기준 — **에너지 트윈이 표준의 어디를 채우고 있나.**\n *\n * ── 왜 따로 있나 ────────────────────────────────────────────────────────────\n * 인스펙션의 적합성 패널은 트윈 종류와 무관하게 ISA-95 하나만 말하고 있었다. 에너지 트윈에서 그것은\n * 거짓은 아니지만(설비·계층·속성은 에너지에서도 ISA-95 자원이다) **부족하다** — 계량기·차단기·태양광·\n * 축전지의 어휘를 주는 것은 IEC 61850 이고, 무엇이 비었는지도 그 목록으로만 셀 수 있다.\n *\n * ── 주장 수준을 못 박는다 ───────────────────────────────────────────────────\n * 여기서 재는 것은 **어휘와 모델**이다. 프로토콜(MMS·GOOSE·샘플드값)을 구현했다는 뜻이 아니며,\n * 그 주장은 적합성 시험이 뒷받침해야 한다. 표 이름을 「IEC 61850 (vocabulary)」로 쓰는 이유다.\n *\n * ── 값은 관측이 아니라 선언이다 ─────────────────────────────────────────────\n * ISA-95 표와 같은 규율이다(`isa95-coverage.ts` 머리말): 사람이 판단해 적고, 틀리면 여기를 고친다.\n * 자동으로 알 수 있는 것 하나만 자동으로 한다 — 축 이름이 커널 축 목록에 없으면 구조가 없는 것이다.\n */\nimport type { Isa95Concept, CoverageLevel } from './isa95-coverage.js'\n\n/*\n * Part 7-4 — 논리 노드 클래스. 이 프로파일이 쓰는 것만 적는다(표준 전체를 옮기지 않는다):\n * 계량·계측·개폐·발전·저장.\n */\nconst LOGICAL_NODES: Isa95Concept[] = [ // vocabulary-guard: allow — IEC 61850 의 「논리 노드(logical node)」는 표준 용어다(우리가 은퇴시킨 node 어휘가 아니다)\n  /*\n   * 계량(적산) — 커넥터가 누적 전력량을 실어 오고 상태가 지점별로 들고 있다. 화면은 계량 컴포넌트가\n   * 지점의 값을 보인다.\n   */\n  {\n    std: 'MMTR',\n    part: '7-4',\n    label: 'twin.iec61850.MMTR',\n    axis: 'equipment',\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.iec61850.note.MMTR'\n  },\n  /*\n   * 계측(유효전력·역률) — 표본이 수요 구간으로 접히고, 구간·피크·계약 대비가 그 위에 선다.\n   * 이 프로파일에서 가장 두껍게 채운 자리다.\n   */\n  {\n    std: 'MMXU',\n    part: '7-4',\n    label: 'twin.iec61850.MMXU',\n    axis: 'demandWindows',\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.iec61850.note.MMXU'\n  },\n  /*\n   * ── 셋이 함께 올라갔다 (2026-08-15) ──────────────────────────────────────\n   * 개폐·발전·저장은 오래 「구조만 있음」이었다. 능력이 상태 필드를 선언해 두었는데 **값을 받는 문이\n   * 없었기 때문**이다. 이제 셋 다 실제로 돈다: 설비 상태가 계약에 서고(`EquipmentState`), 커널이\n   * `energy.equipment` 로 받아 그 설비에 적고, 씬 컴포넌트가 그린다.\n   *\n   * 세 층을 함께 올리는 이유: 값이 없는데 화면만 만들면 영원히 「—」인 카드가 되고, 화면이 없는데\n   * 기능만 올리면 아무도 그 값을 보지 못한다. 「값이 먼저, 컴포넌트는 그 다음」의 결과다.\n   */\n  {\n    std: 'XCBR',\n    part: '7-4',\n    label: 'twin.iec61850.XCBR',\n    axis: null,\n    shownOn: ['equipment'],\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.iec61850.note.XCBR'\n  },\n  {\n    std: 'DPVA',\n    part: '7-4',\n    label: 'twin.iec61850.DPVA',\n    axis: null,\n    shownOn: ['equipment'],\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.iec61850.note.DPVA'\n  },\n  {\n    std: 'ZBAT',\n    part: '7-4',\n    label: 'twin.iec61850.ZBAT',\n    axis: null,\n    shownOn: ['equipment'],\n    structure: 'full',\n    behavior: 'full',\n    surface: 'full',\n    note: 'twin.iec61850.note.ZBAT'\n  }\n]\n\nexport const IEC61850_CONCEPTS: Isa95Concept[] = [...LOGICAL_NODES] // vocabulary-guard: allow — 표준 용어(위 주석)\n\nexport function iec61850Coverage(axes: string[]): {\n  model: string\n  concepts: (Isa95Concept & { axisMissing?: boolean })[]\n  totals: { concepts: number; structure: number; behavior: number; surface: number }\n} {\n  const known = new Set(axes)\n  const concepts = IEC61850_CONCEPTS.map(c => {\n    const axisMissing = !!c.axis && !known.has(c.axis)\n    const shownOn = c.shownOn?.filter(a => known.has(a))\n    const fixed = shownOn && shownOn.length !== c.shownOn?.length ? { ...c, shownOn } : c\n    return axisMissing ? { ...fixed, structure: 'none' as CoverageLevel, axisMissing } : fixed\n  })\n  const count = (k: 'structure' | 'behavior' | 'surface') => concepts.filter(c => c[k] === 'full').length\n  return {\n    /* 이름에 (vocabulary) 를 달아 둔다 — 프로토콜 적합성으로 읽히지 않게. */\n    model: 'IEC 61850 (vocabulary)',\n    concepts,\n    totals: { concepts: concepts.length, structure: count('structure'), behavior: count('behavior'), surface: count('surface') }\n  }\n}\n"]}