@fmsim/fmsim 2.0.0-beta.9 → 2.0.0-beta.91

package/dist-server/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+require("./routes");
 tslib_1.__exportStar(require("./service"), exports);
 //# sourceMappingURL=index.js.map

package/dist-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA,oDAAyB","sourcesContent":["export * from './service'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA,oBAAiB;AAEjB,oDAAyB","sourcesContent":["import './routes'\n\nexport * from './service'\n"]}

package/dist-server/routes.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * fmsim 테스트 환경 mock 서버 REST 라우트.
+ *
+ * 프로덕션(fmsim-restful)은 MCS LV RESTful 서비스가 GET /machineUnits/{type} 를 응답한다.
+ * fmsim 은 테스트 환경이므로, 클라이언트(@fmsim/api 의 fetchMachineUnits)가 lv_server_ip_port
+ * 미설정 상태에서 same-origin 으로 호출하는 동일 경로를 이 라우트가 mock 으로 응답한다.
+ *
+ *   GET /machineUnits?type={type}[&machine={parentMachine}]
+ *   - type   : 컴포넌트 타입 (query 파라미터)
+ *   - machine: unit 타입일 때만 — 부모 머신 id (조회 범위 한정)
+ *   - keyword 는 받지 않는다 (클라이언트가 후보 목록을 받아 로컬 필터)
+ *
+ * @things-factory 모듈 라우트 등록 규약: shell 이 부팅 시 emit 하는
+ * 'bootstrap-module-global-public-route' 이벤트로 globalPublicRouter(koa-router) 를 받아
+ * 라우트를 추가한다. (server/index.ts 가 이 모듈을 import 하여 리스너를 등록한다.)
+ */
+const machine_units_mock_1 = require("./service/machine-units/machine-units-mock");
+/** 테스트용 의도적 지연 (0.1 ~ 1.0초) — 클라이언트 비동기 처리 검증용. */
+function mockLatency() {
+    const ms = 100 + Math.floor(Math.random() * 900);
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+process.on('bootstrap-module-global-public-route', (_app, globalPublicRouter) => {
+    globalPublicRouter.get('/machineUnits', async (ctx) => {
+        const type = typeof ctx.query.type === 'string' ? ctx.query.type : '';
+        const machine = typeof ctx.query.machine === 'string' ? ctx.query.machine : undefined;
+        // 테스트 환경 mock — 실제 서버 지연을 모사해 클라이언트 비동기 흐름(로딩 표시 등) 확인.
+        await mockLatency();
+        ctx.type = 'application/json';
+        ctx.body = (0, machine_units_mock_1.searchMockMachineUnits)(type, machine ? { machine } : {});
+    });
+});
+//# sourceMappingURL=routes.js.map

package/dist-server/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../server/routes.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;GAeG;AACH,mFAAmF;AAEnF,mDAAmD;AACnD,SAAS,WAAW;IAClB,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAA;IAChD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AACxD,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,sCAA6C,EAAE,CAAC,IAAS,EAAE,kBAAuB,EAAE,EAAE;IAC/F,kBAAkB,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;QACzD,MAAM,IAAI,GAAW,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7E,MAAM,OAAO,GAAuB,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;QAEzG,wDAAwD;QACxD,MAAM,WAAW,EAAE,CAAA;QAEnB,GAAG,CAAC,IAAI,GAAG,kBAAkB,CAAA;QAC7B,GAAG,CAAC,IAAI,GAAG,IAAA,2CAAsB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["/**\n * fmsim 테스트 환경 mock 서버 REST 라우트.\n *\n * 프로덕션(fmsim-restful)은 MCS LV RESTful 서비스가 GET /machineUnits/{type} 를 응답한다.\n * fmsim 은 테스트 환경이므로, 클라이언트(@fmsim/api 의 fetchMachineUnits)가 lv_server_ip_port\n * 미설정 상태에서 same-origin 으로 호출하는 동일 경로를 이 라우트가 mock 으로 응답한다.\n *\n *   GET /machineUnits?type={type}[&machine={parentMachine}]\n *   - type   : 컴포넌트 타입 (query 파라미터)\n *   - machine: unit 타입일 때만 — 부모 머신 id (조회 범위 한정)\n *   - keyword 는 받지 않는다 (클라이언트가 후보 목록을 받아 로컬 필터)\n *\n * @things-factory 모듈 라우트 등록 규약: shell 이 부팅 시 emit 하는\n * 'bootstrap-module-global-public-route' 이벤트로 globalPublicRouter(koa-router) 를 받아\n * 라우트를 추가한다. (server/index.ts 가 이 모듈을 import 하여 리스너를 등록한다.)\n */\nimport { searchMockMachineUnits } from './service/machine-units/machine-units-mock'\n\n/** 테스트용 의도적 지연 (0.1 ~ 1.0초) — 클라이언트 비동기 처리 검증용. */\nfunction mockLatency(): Promise<void> {\n  const ms = 100 + Math.floor(Math.random() * 900)\n  return new Promise(resolve => setTimeout(resolve, ms))\n}\n\nprocess.on('bootstrap-module-global-public-route' as any, (_app: any, globalPublicRouter: any) => {\n  globalPublicRouter.get('/machineUnits', async (ctx: any) => {\n    const type: string = typeof ctx.query.type === 'string' ? ctx.query.type : ''\n    const machine: string | undefined = typeof ctx.query.machine === 'string' ? ctx.query.machine : undefined\n\n    // 테스트 환경 mock — 실제 서버 지연을 모사해 클라이언트 비동기 흐름(로딩 표시 등) 확인.\n    await mockLatency()\n\n    ctx.type = 'application/json'\n    ctx.body = searchMockMachineUnits(type, machine ? { machine } : {})\n  })\n})\n"]}

package/dist-server/service/index.js

@@ -4,14 +4,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.schema = exports.entities = void 0;
 /* IMPORT ENTITIES AND RESOLVERS */
 const board_favorite_1 = require("./board-favorite");
+const playback_1 = require("./playback");
 exports.entities = [
     /* ENTITIES */
-    ...board_favorite_1.entities
+    ...board_favorite_1.entities,
+    ...playback_1.entities
 ];
 exports.schema = {
     resolverClasses: [
         /* RESOLVER CLASSES */
-        ...board_favorite_1.resolvers
+        ...board_favorite_1.resolvers,
+        ...playback_1.resolvers
     ]
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";AAAA,yBAAyB;;;AAEzB,mCAAmC;AACnC,qDAAyG;AAE5F,QAAA,QAAQ,GAAG;IACtB,cAAc;IACd,GAAG,yBAAqB;CACzB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,GAAG,0BAAsB;KAC1B;CACF,CAAA","sourcesContent":["/* EXPORT ENTITY TYPES */\n\n/* IMPORT ENTITIES AND RESOLVERS */\nimport { entities as BoardFavoriteEntities, resolvers as BoardFavoriteResolvers } from './board-favorite'\n\nexport const entities = [\n  /* ENTITIES */\n  ...BoardFavoriteEntities\n]\n\nexport const schema = {\n  resolverClasses: [\n    /* RESOLVER CLASSES */\n    ...BoardFavoriteResolvers\n  ]\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";AAAA,yBAAyB;;;AAEzB,mCAAmC;AACnC,qDAAyG;AACzG,yCAAyF;AAE5E,QAAA,QAAQ,GAAG;IACtB,cAAc;IACd,GAAG,yBAAqB;IACxB,GAAG,mBAAgB;CACpB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,GAAG,0BAAsB;QACzB,GAAG,oBAAiB;KACrB;CACF,CAAA","sourcesContent":["/* EXPORT ENTITY TYPES */\n\n/* IMPORT ENTITIES AND RESOLVERS */\nimport { entities as BoardFavoriteEntities, resolvers as BoardFavoriteResolvers } from './board-favorite'\nimport { entities as PlaybackEntities, resolvers as PlaybackResolvers } from './playback'\n\nexport const entities = [\n  /* ENTITIES */\n  ...BoardFavoriteEntities,\n  ...PlaybackEntities\n]\n\nexport const schema = {\n  resolverClasses: [\n    /* RESOLVER CLASSES */\n    ...BoardFavoriteResolvers,\n    ...PlaybackResolvers\n  ]\n}\n"]}

package/dist-server/service/machine-units/machine-units-mock.js

@@ -0,0 +1,83 @@
+"use strict";
+/*
+ * 머신/유닛 ID 검색 — 서버측 가상(mock) 데이터.
+ *
+ * 프로덕션(fmsim-restful)은 MCS LV RESTful 서비스가 /machineUnits/{type} 를 응답한다.
+ * fmsim 은 테스트 환경이므로 이 모듈이 같은 형태의 가상 응답을 만들어 mock 라우트가 응답한다.
+ *
+ * 엔티티는 machine 과 unit 으로 나뉜다 (키 = 실제 모델 타입):
+ *   - machine: 독립 엔티티 (STOCKER, Conveyor, Equipment, Buffer, AGV, OHT, Shuttle, …)
+ *   - unit:    어떤 machine 에 소속되는 엔티티 (Port, Shelf, Crane).
+ *
+ * 결과는 **1차원 id 리스트(string[])**:
+ *   - machine 조회 → 머신 id 리스트.
+ *   - unit 조회   → unit id 리스트 (머신별 그룹핑 없음). unit id 는 부모 머신을 접두로
+ *                  포함한다(예: STK01-P03). opts.machine 지정 시 그 머신 소속으로 좁힌다.
+ *
+ * 외부 의존 없는 순수 함수.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MACHINE_UNIT_SEARCH_LIMIT = void 0;
+exports.searchMockMachineUnits = searchMockMachineUnits;
+function seq(prefix, count, pad = 2) {
+    return Array.from({ length: count }, (_, i) => `${prefix}${String(i + 1).padStart(pad, '0')}`);
+}
+/**
+ * machine 타입 → 머신 id 후보 selector.
+ * 키는 **실제 모델 타입(@sceneComponent 등록명)** — 'STOCKER'(대문자) 등 등록 그대로.
+ */
+const MACHINE_TYPES = {
+    STOCKER: () => seq('STK', 10),
+    Equipment: () => seq('EQP', 20),
+    Buffer: () => seq('BUF', 10),
+    Conveyor: () => seq('CNV', 30),
+    ConveyorJoin: () => seq('CNVJ', 10),
+    CraneRail: () => seq('CRAIL', 6),
+    OHTLine: () => seq('OHTLINE', 3),
+    AGVLine: () => seq('AGVLINE', 6),
+    AGV: () => seq('AGV', 20),
+    OHT: () => seq('OHT', 10),
+    Shuttle: () => seq('SHTL', 8)
+};
+/**
+ * unit 타입 → 부모 machine 에 소속. 키는 실제 모델 타입. id = `{machine}-{prefix}{nn}`.
+ */
+const UNIT_TYPES = {
+    Port: { prefix: 'P', count: 20 },
+    Shelf: { prefix: 'SH', count: 30 },
+    Crane: { prefix: 'CR', count: 2 }
+};
+/** machine 미지정 시 unit 을 펼칠 표본 부모 머신 (Stocker). */
+const SAMPLE_UNIT_PARENTS = seq('STK', 10);
+/** 응답 ID 총 개수 상한. */
+exports.MACHINE_UNIT_SEARCH_LIMIT = 50;
+/**
+ * 컴포넌트 타입으로 후보 id 리스트를 생성 (가상). **1차원 string[]** 반환.
+ *
+ * @param type 실제 모델 타입 (예: 'STOCKER', 'AGV', 'Port'). 정확 매칭.
+ * @param opts machine(부모 머신 id, unit 조회 시) / limit.
+ * @returns string[] (총 id 개수 limit 까지). 매핑 없는 타입은 빈 배열.
+ */
+function searchMockMachineUnits(type, opts = {}) {
+    const t = String(type || '');
+    const { machine, limit = exports.MACHINE_UNIT_SEARCH_LIMIT } = opts;
+    const cap = Math.max(0, limit);
+    const unitSpec = UNIT_TYPES[t];
+    if (unitSpec) {
+        // unit 조회 — 부모 머신 접두를 포함한 unit id 평면 리스트
+        const parents = machine ? [machine] : SAMPLE_UNIT_PARENTS;
+        const out = [];
+        for (const parent of parents) {
+            if (out.length >= cap)
+                break;
+            out.push(...seq(`${parent}-${unitSpec.prefix}`, unitSpec.count).slice(0, cap - out.length));
+        }
+        return out;
+    }
+    // machine 조회 — 머신 id 평면 리스트
+    const selector = MACHINE_TYPES[t];
+    if (!selector)
+        return [];
+    return selector().slice(0, cap);
+}
+//# sourceMappingURL=machine-units-mock.js.map

package/dist-server/service/machine-units/machine-units-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-units-mock.js","sourceRoot":"","sources":["../../../server/service/machine-units/machine-units-mock.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 머신/유닛 ID 검색 — 서버측 가상(mock) 데이터.\n *\n * 프로덕션(fmsim-restful)은 MCS LV RESTful 서비스가 /machineUnits/{type} 를 응답한다.\n * fmsim 은 테스트 환경이므로 이 모듈이 같은 형태의 가상 응답을 만들어 mock 라우트가 응답한다.\n *\n * 엔티티는 machine 과 unit 으로 나뉜다 (키 = 실제 모델 타입):\n *   - machine: 독립 엔티티 (STOCKER, Conveyor, Equipment, Buffer, AGV, OHT, Shuttle, …)\n *   - unit:    어떤 machine 에 소속되는 엔티티 (Port, Shelf, Crane).\n *\n * 결과는 **1차원 id 리스트(string[])**:\n *   - machine 조회 → 머신 id 리스트.\n *   - unit 조회   → unit id 리스트 (머신별 그룹핑 없음). unit id 는 부모 머신을 접두로\n *                  포함한다(예: STK01-P03). opts.machine 지정 시 그 머신 소속으로 좁힌다.\n *\n * 외부 의존 없는 순수 함수.\n */\n\nexport interface MachineUnitSearchOptions {\n  /** 부모 machine id — unit 조회를 그 machine 소속으로 좁힌다 (선택). */\n  machine?: string\n  /** 결과 id 총 개수 상한 (기본 MACHINE_UNIT_SEARCH_LIMIT). */\n  limit?: number\n}\n\nfunction seq(prefix: string, count: number, pad: number = 2): string[] {\n  return Array.from({ length: count }, (_, i) => `${prefix}${String(i + 1).padStart(pad, '0')}`)\n}\n\n/**\n * machine 타입 → 머신 id 후보 selector.\n * 키는 **실제 모델 타입(@sceneComponent 등록명)** — 'STOCKER'(대문자) 등 등록 그대로.\n */\nconst MACHINE_TYPES: Record<string, () => string[]> = {\n  STOCKER: () => seq('STK', 10),\n  Equipment: () => seq('EQP', 20),\n  Buffer: () => seq('BUF', 10),\n  Conveyor: () => seq('CNV', 30),\n  ConveyorJoin: () => seq('CNVJ', 10),\n  CraneRail: () => seq('CRAIL', 6),\n  OHTLine: () => seq('OHTLINE', 3),\n  AGVLine: () => seq('AGVLINE', 6),\n  AGV: () => seq('AGV', 20),\n  OHT: () => seq('OHT', 10),\n  Shuttle: () => seq('SHTL', 8)\n}\n\n/**\n * unit 타입 → 부모 machine 에 소속. 키는 실제 모델 타입. id = `{machine}-{prefix}{nn}`.\n */\nconst UNIT_TYPES: Record<string, { prefix: string; count: number }> = {\n  Port: { prefix: 'P', count: 20 },\n  Shelf: { prefix: 'SH', count: 30 },\n  Crane: { prefix: 'CR', count: 2 }\n}\n\n/** machine 미지정 시 unit 을 펼칠 표본 부모 머신 (Stocker). */\nconst SAMPLE_UNIT_PARENTS = seq('STK', 10)\n\n/** 응답 ID 총 개수 상한. */\nexport const MACHINE_UNIT_SEARCH_LIMIT = 50\n\n/**\n * 컴포넌트 타입으로 후보 id 리스트를 생성 (가상). **1차원 string[]** 반환.\n *\n * @param type 실제 모델 타입 (예: 'STOCKER', 'AGV', 'Port'). 정확 매칭.\n * @param opts machine(부모 머신 id, unit 조회 시) / limit.\n * @returns string[] (총 id 개수 limit 까지). 매핑 없는 타입은 빈 배열.\n */\nexport function searchMockMachineUnits(type: string, opts: MachineUnitSearchOptions = {}): string[] {\n  const t = String(type || '')\n  const { machine, limit = MACHINE_UNIT_SEARCH_LIMIT } = opts\n  const cap = Math.max(0, limit)\n\n  const unitSpec = UNIT_TYPES[t]\n  if (unitSpec) {\n    // unit 조회 — 부모 머신 접두를 포함한 unit id 평면 리스트\n    const parents = machine ? [machine] : SAMPLE_UNIT_PARENTS\n    const out: string[] = []\n    for (const parent of parents) {\n      if (out.length >= cap) break\n      out.push(...seq(`${parent}-${unitSpec.prefix}`, unitSpec.count).slice(0, cap - out.length))\n    }\n    return out\n  }\n\n  // machine 조회 — 머신 id 평면 리스트\n  const selector = MACHINE_TYPES[t]\n  if (!selector) return []\n  return selector().slice(0, cap)\n}\n"]}

package/dist-server/service/playback/index.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvers = exports.entities = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const mock_data_1 = require("./mock-data");
+let PlaybackRecord = class PlaybackRecord {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], PlaybackRecord.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], PlaybackRecord.prototype, "time", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], PlaybackRecord.prototype, "data", void 0);
+PlaybackRecord = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], PlaybackRecord);
+let PlaybackScenarioType = class PlaybackScenarioType {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], PlaybackScenarioType.prototype, "scenarioName", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [PlaybackRecord]),
+    tslib_1.__metadata("design:type", Array)
+], PlaybackScenarioType.prototype, "snapshots", void 0);
+PlaybackScenarioType = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], PlaybackScenarioType);
+let PlaybackResult = class PlaybackResult {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [PlaybackScenarioType]),
+    tslib_1.__metadata("design:type", Array)
+], PlaybackResult.prototype, "scenarios", void 0);
+PlaybackResult = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], PlaybackResult);
+let PlaybackResponse = class PlaybackResponse {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", Boolean)
+], PlaybackResponse.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], PlaybackResponse.prototype, "errorMessage", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => PlaybackResult, { nullable: true }),
+    tslib_1.__metadata("design:type", PlaybackResult)
+], PlaybackResponse.prototype, "playback", void 0);
+PlaybackResponse = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], PlaybackResponse);
+let MockVehicles = class MockVehicles {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String]),
+    tslib_1.__metadata("design:type", Array)
+], MockVehicles.prototype, "agvs", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String]),
+    tslib_1.__metadata("design:type", Array)
+], MockVehicles.prototype, "ohts", void 0);
+MockVehicles = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], MockVehicles);
+let MockEntities = class MockEntities {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => MockVehicles),
+    tslib_1.__metadata("design:type", MockVehicles)
+], MockEntities.prototype, "vehicles", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String]),
+    tslib_1.__metadata("design:type", Array)
+], MockEntities.prototype, "ports", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String]),
+    tslib_1.__metadata("design:type", Array)
+], MockEntities.prototype, "zones", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String]),
+    tslib_1.__metadata("design:type", Array)
+], MockEntities.prototype, "stockers", void 0);
+MockEntities = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], MockEntities);
+let CarrierLocation = class CarrierLocation {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], CarrierLocation.prototype, "time", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], CarrierLocation.prototype, "machineName", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], CarrierLocation.prototype, "unitName", void 0);
+CarrierLocation = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], CarrierLocation);
+let CarrierLocationHistoryResponse = class CarrierLocationHistoryResponse {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], CarrierLocationHistoryResponse.prototype, "errorMessage", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [CarrierLocation]),
+    tslib_1.__metadata("design:type", Array)
+], CarrierLocationHistoryResponse.prototype, "carrierLocHistory", void 0);
+CarrierLocationHistoryResponse = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], CarrierLocationHistoryResponse);
+let PlaybackResolver = class PlaybackResolver {
+    async playback(startTime, endTime, count, includeSnapshot) {
+        try {
+            // endTime 또는 count 중 하나로 조회 범위 지정.
+            // 둘 다 없으면 기본 1시간 (endTime 기반).
+            let opts;
+            if (endTime) {
+                opts = { endTime };
+            }
+            else if (count && count > 0) {
+                opts = { count };
+            }
+            else {
+                const start = new Date(startTime.replace(' ', 'T'));
+                const defaultEnd = new Date(start.getTime() + 3600000)
+                    .toISOString()
+                    .replace('T', ' ')
+                    .replace(/\.\d+Z$/, '');
+                opts = { endTime: defaultEnd };
+            }
+            const scenarios = (0, mock_data_1.generatePlaybackData)(startTime, opts);
+            // includeSnapshot=false이면 snapshot 프레임 제거
+            if (!includeSnapshot) {
+                for (const s of scenarios) {
+                    s.snapshots = s.snapshots.filter(f => f.type !== 'snapshot');
+                }
+            }
+            // data 배열을 JSON string으로 직렬화
+            const serialized = scenarios.map(s => (Object.assign(Object.assign({}, s), { snapshots: s.snapshots.map(f => ({
+                    type: f.type,
+                    time: f.time,
+                    data: JSON.stringify(f.data)
+                })) })));
+            return {
+                status: true,
+                playback: { scenarios: serialized }
+            };
+        }
+        catch (e) {
+            return {
+                status: false,
+                errorMessage: e.message || String(e)
+            };
+        }
+    }
+    async playbackEntities() {
+        return mock_data_1.MOCK_ENTITIES;
+    }
+    async carrierLocationHistory(startTime, endTime, carrierName) {
+        try {
+            const carrierLocHistory = (0, mock_data_1.generateCarrierLocationHistory)(startTime, endTime, carrierName);
+            return { errorMessage: null, carrierLocHistory };
+        }
+        catch (e) {
+            return { errorMessage: (e === null || e === void 0 ? void 0 : e.message) || String(e), carrierLocHistory: [] };
+        }
+    }
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => PlaybackResponse, { description: 'Playback 데이터 조회 (목업)' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('startTime')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('endTime', { nullable: true })),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('count', () => type_graphql_1.Int, { nullable: true })),
+    tslib_1.__param(3, (0, type_graphql_1.Arg)('includeSnapshot', { nullable: true, defaultValue: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Number, Boolean]),
+    tslib_1.__metadata("design:returntype", Promise)
+], PlaybackResolver.prototype, "playback", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => MockEntities, { description: '목업 엔티티 목록 (보드 작화용)' }),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], PlaybackResolver.prototype, "playbackEntities", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => CarrierLocationHistoryResponse, {
+        description: 'Carrier 위치 이력 조회 (목업). 영구추적 fallback 용.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('startTime')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('endTime')),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('carrierName')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], PlaybackResolver.prototype, "carrierLocationHistory", null);
+PlaybackResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)()
+], PlaybackResolver);
+exports.entities = [];
+exports.resolvers = [PlaybackResolver];
+//# sourceMappingURL=index.js.map

package/dist-server/service/playback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/playback/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Resolver, Query, Arg, ObjectType, Field, Int } from 'type-graphql'\nimport { generatePlaybackData, generateCarrierLocationHistory, MOCK_ENTITIES } from './mock-data'\n\n@ObjectType()\nclass PlaybackRecord {\n  @Field() type!: string\n  @Field() time!: string\n  @Field() data!: string  // JSON string\n}\n\n@ObjectType()\nclass PlaybackScenarioType {\n  @Field() scenarioName!: string\n  @Field(() => [PlaybackRecord]) snapshots!: PlaybackRecord[]\n}\n\n@ObjectType()\nclass PlaybackResult {\n  @Field(() => [PlaybackScenarioType]) scenarios!: PlaybackScenarioType[]\n}\n\n@ObjectType()\nclass PlaybackResponse {\n  @Field() status!: boolean\n  @Field({ nullable: true }) errorMessage?: string\n  @Field(() => PlaybackResult, { nullable: true }) playback?: PlaybackResult\n}\n\n@ObjectType()\nclass MockVehicles {\n  @Field(() => [String]) agvs!: string[]\n  @Field(() => [String]) ohts!: string[]\n}\n\n@ObjectType()\nclass MockEntities {\n  @Field(() => MockVehicles) vehicles!: MockVehicles\n  @Field(() => [String]) ports!: string[]\n  @Field(() => [String]) zones!: string[]\n  @Field(() => [String]) stockers!: string[]\n}\n\n@ObjectType()\nclass CarrierLocation {\n  @Field() time!: string\n  @Field() machineName!: string\n  @Field() unitName!: string\n}\n\n@ObjectType()\nclass CarrierLocationHistoryResponse {\n  @Field({ nullable: true }) errorMessage?: string | null\n  @Field(() => [CarrierLocation]) carrierLocHistory!: CarrierLocation[]\n}\n\n@Resolver()\nclass PlaybackResolver {\n  @Query(() => PlaybackResponse, { description: 'Playback 데이터 조회 (목업)' })\n  async playback(\n    @Arg('startTime') startTime: string,\n    @Arg('endTime', { nullable: true }) endTime: string,\n    @Arg('count', () => Int, { nullable: true }) count: number,\n    @Arg('includeSnapshot', { nullable: true, defaultValue: true }) includeSnapshot: boolean\n  ): Promise<PlaybackResponse> {\n    try {\n      // endTime 또는 count 중 하나로 조회 범위 지정.\n      // 둘 다 없으면 기본 1시간 (endTime 기반).\n      let opts: { endTime?: string; count?: number }\n      if (endTime) {\n        opts = { endTime }\n      } else if (count && count > 0) {\n        opts = { count }\n      } else {\n        const start = new Date(startTime.replace(' ', 'T'))\n        const defaultEnd = new Date(start.getTime() + 3600000)\n          .toISOString()\n          .replace('T', ' ')\n          .replace(/\\.\\d+Z$/, '')\n        opts = { endTime: defaultEnd }\n      }\n\n      const scenarios = generatePlaybackData(startTime, opts)\n\n      // includeSnapshot=false이면 snapshot 프레임 제거\n      if (!includeSnapshot) {\n        for (const s of scenarios) {\n          s.snapshots = s.snapshots.filter(f => f.type !== 'snapshot')\n        }\n      }\n\n      // data 배열을 JSON string으로 직렬화\n      const serialized = scenarios.map(s => ({\n        ...s,\n        snapshots: s.snapshots.map(f => ({\n          type: f.type,\n          time: f.time,\n          data: JSON.stringify(f.data)\n        }))\n      }))\n\n      return {\n        status: true,\n        playback: { scenarios: serialized }\n      }\n    } catch (e: any) {\n      return {\n        status: false,\n        errorMessage: e.message || String(e)\n      }\n    }\n  }\n\n  @Query(() => MockEntities, { description: '목업 엔티티 목록 (보드 작화용)' })\n  async playbackEntities(): Promise<MockEntities> {\n    return MOCK_ENTITIES\n  }\n\n  @Query(() => CarrierLocationHistoryResponse, {\n    description: 'Carrier 위치 이력 조회 (목업). 영구추적 fallback 용.'\n  })\n  async carrierLocationHistory(\n    @Arg('startTime') startTime: string,\n    @Arg('endTime') endTime: string,\n    @Arg('carrierName') carrierName: string\n  ): Promise<CarrierLocationHistoryResponse> {\n    try {\n      const carrierLocHistory = generateCarrierLocationHistory(startTime, endTime, carrierName)\n      return { errorMessage: null, carrierLocHistory }\n    } catch (e: any) {\n      return { errorMessage: e?.message || String(e), carrierLocHistory: [] }\n    }\n  }\n}\n\nexport const entities = []\nexport const resolvers = [PlaybackResolver]\n"]}