@things-factory/ops-master 10.0.18

package/dist-server/service/equipment/equipment-master.d.ts

@@ -0,0 +1,29 @@
+import type { ResourceClassDef } from '@operato/ops-contract';
+import type { Equipment } from './equipment';
+import type { EquipmentClass } from './equipment-class';
+/** 트윈 `ReferenceMaster.equipment` 의 한 항목. */
+export interface EquipmentEntry {
+    id: string;
+    kind: string;
+    homeLocation: string;
+    identity?: string;
+    mtbfMs?: number;
+    mttrMs?: number;
+    workCalendar?: unknown[];
+    properties?: unknown[];
+    testSpecificationIds?: string[];
+    testResults?: unknown[];
+    effectiveStart?: string;
+    effectiveEnd?: string;
+}
+export declare function toEquipmentEntry(equipment: Equipment): EquipmentEntry;
+/**
+ * 설비 축 전체 — 트윈이 당겨 갈 조각.
+ *
+ * 설비가 자기 등급과 자리를 가리키므로 등급과 함께 나가야 한다. 한 건씩 밀면 설비가 먼저 도착하고
+ * 등급이 나중에 오는 순간이 생긴다.
+ */
+export declare function equipmentMaster(classes: EquipmentClass[], equipment: Equipment[]): {
+    equipmentClasses: ResourceClassDef[];
+    equipment: EquipmentEntry[];
+};

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toEquipmentEntry = toEquipmentEntry;
+exports.equipmentMaster = equipmentMaster;
+const resource_class_1 = require("../resource/resource-class");
+function toEquipmentEntry(equipment) {
+    /* `kind` 와 `homeLocation` 은 비울 수 없다 — 자리를 모르면 커널이 어디서 일하는지 정할 수 없다. */
+    const out = {
+        id: equipment.name,
+        kind: equipment.kind,
+        homeLocation: equipment.homeLocation
+    };
+    (0, resource_class_1.put)(out, 'identity', equipment.identity);
+    (0, resource_class_1.put)(out, 'mtbfMs', equipment.mtbfMs === undefined || equipment.mtbfMs === null ? undefined : Number(equipment.mtbfMs));
+    (0, resource_class_1.put)(out, 'mttrMs', equipment.mttrMs === undefined || equipment.mttrMs === null ? undefined : Number(equipment.mttrMs));
+    (0, resource_class_1.put)(out, 'workCalendar', equipment.workCalendar);
+    (0, resource_class_1.put)(out, 'properties', equipment.properties);
+    (0, resource_class_1.put)(out, 'testSpecificationIds', equipment.testSpecificationIds);
+    (0, resource_class_1.put)(out, 'testResults', equipment.testResults);
+    (0, resource_class_1.put)(out, 'effectiveStart', (0, resource_class_1.iso)(equipment.effectiveStart));
+    (0, resource_class_1.put)(out, 'effectiveEnd', (0, resource_class_1.iso)(equipment.effectiveEnd));
+    return out;
+}
+/**
+ * 설비 축 전체 — 트윈이 당겨 갈 조각.
+ *
+ * 설비가 자기 등급과 자리를 가리키므로 등급과 함께 나가야 한다. 한 건씩 밀면 설비가 먼저 도착하고
+ * 등급이 나중에 오는 순간이 생긴다.
+ */
+function equipmentMaster(classes, equipment) {
+    return {
+        equipmentClasses: classes.map(resource_class_1.toResourceClassDef),
+        equipment: equipment.map(toEquipmentEntry)
+    };
+}
+//# sourceMappingURL=equipment-master.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"equipment-master.js","sourceRoot":"","sources":["../../../server/service/equipment/equipment-master.ts"],"names":[],"mappings":";;AAsBA,4CAmBC;AAQD,0CAQC;AAvDD,+DAAyE;AAoBzE,SAAgB,gBAAgB,CAAC,SAAoB;IACnD,uEAAuE;IACvE,MAAM,GAAG,GAA4B;QACnC,EAAE,EAAE,SAAS,CAAC,IAAI;QAClB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,YAAY,EAAE,SAAS,CAAC,YAAY;KACrC,CAAA;IAED,IAAA,oBAAG,EAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAA;IACxC,IAAA,oBAAG,EAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;IACtH,IAAA,oBAAG,EAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;IACtH,IAAA,oBAAG,EAAC,GAAG,EAAE,cAAc,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;IAChD,IAAA,oBAAG,EAAC,GAAG,EAAE,YAAY,EAAE,SAAS,CAAC,UAAU,CAAC,CAAA;IAC5C,IAAA,oBAAG,EAAC,GAAG,EAAE,sBAAsB,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAA;IAChE,IAAA,oBAAG,EAAC,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,WAAW,CAAC,CAAA;IAC9C,IAAA,oBAAG,EAAC,GAAG,EAAE,gBAAgB,EAAE,IAAA,oBAAG,EAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAA;IACzD,IAAA,oBAAG,EAAC,GAAG,EAAE,cAAc,EAAE,IAAA,oBAAG,EAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAA;IAErD,OAAO,GAAgC,CAAA;AACzC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,OAAyB,EACzB,SAAsB;IAEtB,OAAO;QACL,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,mCAAkB,CAAC;QACjD,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAC3C,CAAA;AACH,CAAC","sourcesContent":["import type { ResourceClassDef } from '@operato/ops-contract'\n\nimport { iso, put, toResourceClassDef } from '../resource/resource-class'\nimport type { Equipment } from './equipment'\nimport type { EquipmentClass } from './equipment-class'\n\n/** 트윈 `ReferenceMaster.equipment` 의 한 항목. */\nexport interface EquipmentEntry {\n  id: string\n  kind: string\n  homeLocation: string\n  identity?: string\n  mtbfMs?: number\n  mttrMs?: number\n  workCalendar?: unknown[]\n  properties?: unknown[]\n  testSpecificationIds?: string[]\n  testResults?: unknown[]\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport function toEquipmentEntry(equipment: Equipment): EquipmentEntry {\n  /* `kind` 와 `homeLocation` 은 비울 수 없다 — 자리를 모르면 커널이 어디서 일하는지 정할 수 없다. */\n  const out: Record<string, unknown> = {\n    id: equipment.name,\n    kind: equipment.kind,\n    homeLocation: equipment.homeLocation\n  }\n\n  put(out, 'identity', equipment.identity)\n  put(out, 'mtbfMs', equipment.mtbfMs === undefined || equipment.mtbfMs === null ? undefined : Number(equipment.mtbfMs))\n  put(out, 'mttrMs', equipment.mttrMs === undefined || equipment.mttrMs === null ? undefined : Number(equipment.mttrMs))\n  put(out, 'workCalendar', equipment.workCalendar)\n  put(out, 'properties', equipment.properties)\n  put(out, 'testSpecificationIds', equipment.testSpecificationIds)\n  put(out, 'testResults', equipment.testResults)\n  put(out, 'effectiveStart', iso(equipment.effectiveStart))\n  put(out, 'effectiveEnd', iso(equipment.effectiveEnd))\n\n  return out as unknown as EquipmentEntry\n}\n\n/**\n * 설비 축 전체 — 트윈이 당겨 갈 조각.\n *\n * 설비가 자기 등급과 자리를 가리키므로 등급과 함께 나가야 한다. 한 건씩 밀면 설비가 먼저 도착하고\n * 등급이 나중에 오는 순간이 생긴다.\n */\nexport function equipmentMaster(\n  classes: EquipmentClass[],\n  equipment: Equipment[]\n): { equipmentClasses: ResourceClassDef[]; equipment: EquipmentEntry[] } {\n  return {\n    equipmentClasses: classes.map(toResourceClassDef),\n    equipment: equipment.map(toEquipmentEntry)\n  }\n}\n"]}

package/dist-server/service/equipment/equipment-query.d.ts

@@ -0,0 +1,8 @@
+export declare class EquipmentMaster {
+    equipmentClasses: string;
+    equipment: string;
+}
+export declare class EquipmentQuery {
+    /** 설비 축 전체를 한 번에 낸다 — 설비가 자기 등급과 자리를 가리키므로 함께 나가야 한다. */
+    equipmentMaster(context: ResolverContext): Promise<EquipmentMaster>;
+}

package/dist-server/service/equipment/equipment-query.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EquipmentQuery = exports.EquipmentMaster = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const equipment_1 = require("./equipment");
+const equipment_class_1 = require("./equipment-class");
+const equipment_master_1 = require("./equipment-master");
+let EquipmentMaster = class EquipmentMaster {
+};
+exports.EquipmentMaster = EquipmentMaster;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => String, { description: 'ResourceClassDef[] as JSON text' }),
+    tslib_1.__metadata("design:type", String)
+], EquipmentMaster.prototype, "equipmentClasses", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => String, { description: 'ReferenceMaster equipment[] as JSON text' }),
+    tslib_1.__metadata("design:type", String)
+], EquipmentMaster.prototype, "equipment", void 0);
+exports.EquipmentMaster = EquipmentMaster = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Equipment master as the twin receives it' })
+], EquipmentMaster);
+let EquipmentQuery = class EquipmentQuery {
+    /** 설비 축 전체를 한 번에 낸다 — 설비가 자기 등급과 자리를 가리키므로 함께 나가야 한다. */
+    async equipmentMaster(context) {
+        const { domain } = context.state;
+        const [classes, equipment] = await Promise.all([
+            (0, shell_1.getRepository)(equipment_class_1.EquipmentClass).find({ where: { domain: { id: domain.id } }, order: { name: 'ASC' } }),
+            (0, shell_1.getRepository)(equipment_1.Equipment).find({ where: { domain: { id: domain.id } }, order: { name: 'ASC' } })
+        ]);
+        const master = (0, equipment_master_1.equipmentMaster)(classes, equipment);
+        return {
+            equipmentClasses: JSON.stringify(master.equipmentClasses),
+            equipment: JSON.stringify(master.equipment)
+        };
+    }
+};
+exports.EquipmentQuery = EquipmentQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => EquipmentMaster, { description: 'Equipment master for the twin to pull' }),
+    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)
+], EquipmentQuery.prototype, "equipmentMaster", null);
+exports.EquipmentQuery = EquipmentQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(equipment_1.Equipment)
+], EquipmentQuery);
+//# sourceMappingURL=equipment-query.js.map

package/dist-server/service/equipment/equipment-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equipment-query.js","sourceRoot":"","sources":["../../../server/service/equipment/equipment-query.ts"],"names":[],"mappings":";;;;AAAA,+CAAsE;AAEtE,iDAAqD;AAErD,2CAAuC;AACvC,uDAAkD;AAClD,yDAA4E;AAGrE,IAAM,eAAe,GAArB,MAAM,eAAe;CAM3B,CAAA;AANY,0CAAe;AAE1B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC;;yDAClD;AAGxB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;;kDAClE;0BALN,eAAe;IAD3B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;GAC3D,eAAe,CAM3B;AAGM,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,yDAAyD;IAEnD,AAAN,KAAK,CAAC,eAAe,CAAQ,OAAwB;QACnD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7C,IAAA,qBAAa,EAAC,gCAAc,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpG,IAAA,qBAAa,EAAC,qBAAS,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;SAChG,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,IAAA,kCAAoB,EAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAEvD,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACzD,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;SAC5C,CAAA;IACH,CAAC;CACF,CAAA;AAlBY,wCAAc;AAGnB;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;IACrE,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;qDAc3B;yBAjBU,cAAc;IAD1B,IAAA,uBAAQ,EAAC,qBAAS,CAAC;GACP,cAAc,CAkB1B","sourcesContent":["import { Ctx, Field, ObjectType, Query, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { Equipment } from './equipment'\nimport { EquipmentClass } from './equipment-class'\nimport { equipmentMaster as buildEquipmentMaster } from './equipment-master'\n\n@ObjectType({ description: 'Equipment master as the twin receives it' })\nexport class EquipmentMaster {\n  @Field(type => String, { description: 'ResourceClassDef[] as JSON text' })\n  equipmentClasses: string\n\n  @Field(type => String, { description: 'ReferenceMaster equipment[] as JSON text' })\n  equipment: string\n}\n\n@Resolver(Equipment)\nexport class EquipmentQuery {\n  /** 설비 축 전체를 한 번에 낸다 — 설비가 자기 등급과 자리를 가리키므로 함께 나가야 한다. */\n  @Query(returns => EquipmentMaster, { description: 'Equipment master for the twin to pull' })\n  async equipmentMaster(@Ctx() context: ResolverContext): Promise<EquipmentMaster> {\n    const { domain } = context.state\n\n    const [classes, equipment] = await Promise.all([\n      getRepository(EquipmentClass).find({ where: { domain: { id: domain.id } }, order: { name: 'ASC' } }),\n      getRepository(Equipment).find({ where: { domain: { id: domain.id } }, order: { name: 'ASC' } })\n    ])\n\n    const master = buildEquipmentMaster(classes, equipment)\n\n    return {\n      equipmentClasses: JSON.stringify(master.equipmentClasses),\n      equipment: JSON.stringify(master.equipment)\n    }\n  }\n}\n"]}

package/dist-server/service/equipment/equipment.d.ts

@@ -0,0 +1,45 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/**
+ * 설비 — **ISA-95 `Equipment`**.
+ *
+ * 설비는 작업을 수행하는 자원이다. 배정을 받고, 가동률로 평가받고, 능력으로 찾힌다. **계측기는 설비가
+ * 아니다** — 저울과 센서는 그 어느 것도 하지 않고, 그것은 관측의 원천이다. 계측기를 설비로 세우면
+ * 가동률 화면이 저울을 기계로 세고 「설비가 논다」가 나온다.
+ */
+export declare class Equipment {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** 표준 `EquipmentID` — 트윈으로 나갈 때 `equipment[].id` 가 된다. */
+    name: string;
+    description?: string;
+    /** 속한 등급 — 표준 `EquipmentClassID`. 계약의 `kind` 자리다. */
+    kind: string;
+    /** 이 설비가 있는 자리 — 표준 `OperationalLocation`. */
+    homeLocation: string;
+    /** GS1 GIAI. 없으면 비워 둔다 — 회사 프리픽스를 지어내지 않는다. */
+    identity?: string;
+    /** 평균 고장 간격(밀리초) — 없으면 고장이 없는 설비로 예측된다. */
+    mtbfMs?: number;
+    /** 평균 수리 시간(밀리초). */
+    mttrMs?: number;
+    /** 근무 캘린더 — 표준 `WorkCalendar`. 교대 이름과 구간. */
+    workCalendar?: Record<string, unknown>[];
+    /** 개체 속성 — 표준 `EquipmentProperty`. 속도처럼 계산에 들어가는 속성이 여기 온다. */
+    properties?: Record<string, unknown>[];
+    /** 이 설비에 요구되는 `TestSpecification` 참조들 — 검정·교정이 이 모양에 맞는다. */
+    testSpecificationIds?: string[];
+    /** `TestResult` — 만료되었거나 떨어졌으면 그 설비에 작업이 가지 않는다. */
+    testResults?: Record<string, unknown>[];
+    /** 언제부터 이 설비가 현장에 있나 — 도입 예정 설비를 미리 등록할 수 있다. */
+    effectiveStart?: Date;
+    /** 언제까지 — 폐기한 설비가 영원히 배정 대상으로 남지 않게 한다. */
+    effectiveEnd?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}

package/dist-server/service/equipment/equipment.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Equipment = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+/**
+ * 설비 — **ISA-95 `Equipment`**.
+ *
+ * 설비는 작업을 수행하는 자원이다. 배정을 받고, 가동률로 평가받고, 능력으로 찾힌다. **계측기는 설비가
+ * 아니다** — 저울과 센서는 그 어느 것도 하지 않고, 그것은 관측의 원천이다. 계측기를 설비로 세우면
+ * 가동률 화면이 저울을 기계로 세고 「설비가 논다」가 나온다.
+ */
+let Equipment = class Equipment {
+};
+exports.Equipment = Equipment;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], Equipment.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((equipment) => equipment.domain),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "homeLocation", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "identity", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'bigint', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true }),
+    tslib_1.__metadata("design:type", Number)
+], Equipment.prototype, "mtbfMs", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'bigint', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true }),
+    tslib_1.__metadata("design:type", Number)
+], Equipment.prototype, "mttrMs", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'WorkCalendarEntry[] as JSON text' }),
+    tslib_1.__metadata("design:type", Array)
+], Equipment.prototype, "workCalendar", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'ResourceProperty[] as JSON text' }),
+    tslib_1.__metadata("design:type", Array)
+], Equipment.prototype, "properties", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
+    tslib_1.__metadata("design:type", Array)
+], Equipment.prototype, "testSpecificationIds", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'TestResult[] as JSON text' }),
+    tslib_1.__metadata("design:type", Array)
+], Equipment.prototype, "testResults", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date
+    /** 언제까지 — 폐기한 설비가 영원히 배정 대상으로 남지 않게 한다. */
+    )
+], Equipment.prototype, "effectiveStart", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], Equipment.prototype, "effectiveEnd", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], Equipment.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], Equipment.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], Equipment.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((equipment) => equipment.creator),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], Equipment.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((equipment) => equipment.updater),
+    tslib_1.__metadata("design:type", String)
+], Equipment.prototype, "updaterId", void 0);
+exports.Equipment = Equipment = tslib_1.__decorate([
+    (0, typeorm_1.Entity)({ name: 'ops_equipment' }),
+    (0, typeorm_1.Index)('ix_ops_equipment_0', (equipment) => [equipment.domain, equipment.name], { unique: true }),
+    (0, type_graphql_1.ObjectType)({ description: 'ISA-95 Equipment — a resource that performs work' })
+], Equipment);
+//# sourceMappingURL=equipment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"equipment.js","sourceRoot":"","sources":["../../../server/service/equipment/equipment.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, Int, ObjectType } from 'type-graphql'\n\nimport { Domain } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/**\n * 설비 — **ISA-95 `Equipment`**.\n *\n * 설비는 작업을 수행하는 자원이다. 배정을 받고, 가동률로 평가받고, 능력으로 찾힌다. **계측기는 설비가\n * 아니다** — 저울과 센서는 그 어느 것도 하지 않고, 그것은 관측의 원천이다. 계측기를 설비로 세우면\n * 가동률 화면이 저울을 기계로 세고 「설비가 논다」가 나온다.\n */\n@Entity({ name: 'ops_equipment' })\n@Index('ix_ops_equipment_0', (equipment: Equipment) => [equipment.domain, equipment.name], { unique: true })\n@ObjectType({ description: 'ISA-95 Equipment — a resource that performs work' })\nexport class Equipment {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain)\n  domain?: Domain\n\n  @RelationId((equipment: Equipment) => equipment.domain)\n  domainId?: string\n\n  /** 표준 `EquipmentID` — 트윈으로 나갈 때 `equipment[].id` 가 된다. */\n  @Column()\n  @Field()\n  name: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  description?: string\n\n  /** 속한 등급 — 표준 `EquipmentClassID`. 계약의 `kind` 자리다. */\n  @Column()\n  @Field()\n  kind: string\n\n  /** 이 설비가 있는 자리 — 표준 `OperationalLocation`. */\n  @Column()\n  @Field()\n  homeLocation: string\n\n  /** GS1 GIAI. 없으면 비워 둔다 — 회사 프리픽스를 지어내지 않는다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  identity?: string\n\n  /** 평균 고장 간격(밀리초) — 없으면 고장이 없는 설비로 예측된다. */\n  @Column({ type: 'bigint', nullable: true })\n  @Field(type => Int, { nullable: true })\n  mtbfMs?: number\n\n  /** 평균 수리 시간(밀리초). */\n  @Column({ type: 'bigint', nullable: true })\n  @Field(type => Int, { nullable: true })\n  mttrMs?: number\n\n  /** 근무 캘린더 — 표준 `WorkCalendar`. 교대 이름과 구간. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => String, { nullable: true, description: 'WorkCalendarEntry[] as JSON text' })\n  workCalendar?: Record<string, unknown>[]\n\n  /** 개체 속성 — 표준 `EquipmentProperty`. 속도처럼 계산에 들어가는 속성이 여기 온다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => String, { nullable: true, description: 'ResourceProperty[] as JSON text' })\n  properties?: Record<string, unknown>[]\n\n  /** 이 설비에 요구되는 `TestSpecification` 참조들 — 검정·교정이 이 모양에 맞는다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  testSpecificationIds?: string[]\n\n  /** `TestResult` — 만료되었거나 떨어졌으면 그 설비에 작업이 가지 않는다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => String, { nullable: true, description: 'TestResult[] as JSON text' })\n  testResults?: Record<string, unknown>[]\n\n  /** 언제부터 이 설비가 현장에 있나 — 도입 예정 설비를 미리 등록할 수 있다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveStart?: Date\n\n  /** 언제까지 — 폐기한 설비가 영원히 배정 대상으로 남지 않게 한다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveEnd?: Date\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  creator?: User\n\n  @RelationId((equipment: Equipment) => equipment.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  updater?: User\n\n  @RelationId((equipment: Equipment) => equipment.updater)\n  updaterId?: string\n}\n"]}

package/dist-server/service/equipment/index.d.ts

@@ -0,0 +1,8 @@
+import { Equipment } from './equipment';
+import { EquipmentClass } from './equipment-class';
+import { EquipmentQuery } from './equipment-query';
+import { StopReason } from './stop-reason';
+import { StopReasonQuery } from './stop-reason-query';
+import { EquipmentClassResolver, EquipmentResolver, StopReasonResolver } from './equipment-master-resolver';
+export declare const entities: (typeof Equipment | typeof EquipmentClass | typeof StopReason)[];
+export declare const resolvers: (typeof EquipmentClassResolver | typeof EquipmentResolver | typeof StopReasonResolver | typeof EquipmentQuery | typeof StopReasonQuery)[];

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvers = exports.entities = void 0;
+const equipment_1 = require("./equipment");
+const equipment_class_1 = require("./equipment-class");
+const equipment_query_1 = require("./equipment-query");
+const stop_reason_1 = require("./stop-reason");
+const stop_reason_query_1 = require("./stop-reason-query");
+const equipment_master_resolver_1 = require("./equipment-master-resolver");
+exports.entities = [equipment_class_1.EquipmentClass, equipment_1.Equipment, stop_reason_1.StopReason];
+exports.resolvers = [equipment_query_1.EquipmentQuery, stop_reason_query_1.StopReasonQuery, equipment_master_resolver_1.EquipmentClassResolver, equipment_master_resolver_1.EquipmentResolver, equipment_master_resolver_1.StopReasonResolver];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/equipment/index.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AACvC,uDAAkD;AAClD,uDAAkD;AAClD,+CAA0C;AAC1C,2DAAqD;AACrD,2EAA2G;AAE9F,QAAA,QAAQ,GAAG,CAAC,gCAAc,EAAE,qBAAS,EAAE,wBAAU,CAAC,CAAA;AAClD,QAAA,SAAS,GAAG,CAAC,gCAAc,EAAE,mCAAe,EAAE,kDAAsB,EAAE,6CAAiB,EAAE,8CAAkB,CAAC,CAAA","sourcesContent":["import { Equipment } from './equipment'\nimport { EquipmentClass } from './equipment-class'\nimport { EquipmentQuery } from './equipment-query'\nimport { StopReason } from './stop-reason'\nimport { StopReasonQuery } from './stop-reason-query'\nimport { EquipmentClassResolver, EquipmentResolver, StopReasonResolver } from './equipment-master-resolver'\n\nexport const entities = [EquipmentClass, Equipment, StopReason]\nexport const resolvers = [EquipmentQuery, StopReasonQuery, EquipmentClassResolver, EquipmentResolver, StopReasonResolver]\n"]}

package/dist-server/service/equipment/state-period-rules.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 상태 구간을 받아도 되나 — **순수 판단.**
+ *
+ * ── 왜 규칙이 필요한가 ──────────────────────────────────────────────────────
+ * 구간은 사람이 되돌아가 적는다. 그래서 겹치고, 거꾸로 되고, 미래로 간다. 그대로 받으면 가동률의
+ * 분자가 분모보다 커지는 날이 온다. 그때는 이미 잘못된 구간이 수백 개 쌓여 있다.
+ *
+ * ── 왜 사유와 상태를 맞춰 보나 ──────────────────────────────────────────────
+ * ISO 22400 에서 가동률을 깎느냐 마느냐는 **상태**가 정한다. 「점심시간」을 `down` 으로 적으면 가동률이
+ * 오류 보고 없이 낮아지고, 「고장」을 `planned-stop` 으로 적으면 오류 보고 없이 높아진다. 둘 다 조용한
+ * 거짓이라 나중에 찾을 방법이 없다.
+ */
+/** 계약의 `EQUIPMENT_STATUS` 와 같은 어휘. 여기서 새로 만들지 않는다. */
+export declare const EQUIPMENT_PERIOD_STATUS: readonly ["idle", "busy", "down", "setup", "planned-stop"];
+export type EquipmentPeriodStatus = (typeof EQUIPMENT_PERIOD_STATUS)[number];
+export type PeriodProblem = 
+/** 끝이 시작보다 앞이거나 같다 — 길이가 없는 구간은 셀 것이 없다. */
+'not-a-period'
+/** 아직 오지 않은 시각이다. */
+ | 'in-the-future'
+/** 같은 설비의 다른 구간과 겹친다 — 한 설비가 같은 시각에 두 상태일 수 없다. */
+ | 'overlaps'
+/** 계약이 모르는 상태다. */
+ | 'unknown-status'
+/** 사유가 사유 마스터에 없다. */
+ | 'unknown-reason'
+/** 사유가 이 상태의 사유가 아니다 — 가동률이 오류 보고 없이 틀어진다. */
+ | 'reason-status-mismatch'
+/** 이 사유는 상세를 함께 적어야 한다. */
+ | 'detail-required';
+export interface PeriodIssue {
+    problem: PeriodProblem;
+    /** 겹치는 것이면 어느 구간과 겹치나(시작 시각, ISO). */
+    conflictsWith?: string;
+    /** 사유 문제이면 어느 사유인가. */
+    reasonCode?: string;
+    /** 사유가 속한 상태와 적힌 상태. */
+    reasonStatus?: string;
+    status?: string;
+}
+export interface JudgeablePeriod {
+    status: string;
+    startTime: Date | string;
+    endTime: Date | string;
+    reasonCode?: string;
+    reasonDetail?: string;
+}
+/** 사유 마스터에서 필요한 것만. */
+export interface StopReasonFact {
+    name: string;
+    status: string;
+    detailRequired?: boolean;
+}
+/** 이미 적혀 있는 구간 — 겹침을 볼 때만 쓴다. */
+export interface ExistingPeriod {
+    startTime: Date | string;
+    endTime: Date | string;
+}
+/**
+ * 이 구간을 받아도 되나.
+ *
+ * `now` 를 부르는 쪽이 준다 — 이 함수가 시계를 읽으면 테스트가 시각에 흔들린다.
+ */
+export declare function judgePeriod(period: JudgeablePeriod, context: {
+    now: Date | string;
+    /** 같은 설비의 이미 적힌 구간들. 부르는 쪽이 시각으로 좁혀서 준다. */
+    existing?: readonly ExistingPeriod[];
+    /**
+     * 사유 마스터에서 읽은 것.
+     *
+     * **`undefined` 와 빈 배열의 뜻이 다르다.** `undefined` 는 「마스터를 아직 채우지 않았다」이고
+     * 확인하지 않는다. 빈 배열은 「채웠는데 이 사유가 없다」이고 막는다. 둘을 섞으면 오타로 적은
+     * 사유가 오류 보고 없이 통과한다.
+     */
+    reasons?: readonly StopReasonFact[];
+}): PeriodIssue[];

package/dist-server/service/equipment/state-period-rules.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * 상태 구간을 받아도 되나 — **순수 판단.**
+ *
+ * ── 왜 규칙이 필요한가 ──────────────────────────────────────────────────────
+ * 구간은 사람이 되돌아가 적는다. 그래서 겹치고, 거꾸로 되고, 미래로 간다. 그대로 받으면 가동률의
+ * 분자가 분모보다 커지는 날이 온다. 그때는 이미 잘못된 구간이 수백 개 쌓여 있다.
+ *
+ * ── 왜 사유와 상태를 맞춰 보나 ──────────────────────────────────────────────
+ * ISO 22400 에서 가동률을 깎느냐 마느냐는 **상태**가 정한다. 「점심시간」을 `down` 으로 적으면 가동률이
+ * 오류 보고 없이 낮아지고, 「고장」을 `planned-stop` 으로 적으면 오류 보고 없이 높아진다. 둘 다 조용한
+ * 거짓이라 나중에 찾을 방법이 없다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EQUIPMENT_PERIOD_STATUS = void 0;
+exports.judgePeriod = judgePeriod;
+/** 계약의 `EQUIPMENT_STATUS` 와 같은 어휘. 여기서 새로 만들지 않는다. */
+exports.EQUIPMENT_PERIOD_STATUS = ['idle', 'busy', 'down', 'setup', 'planned-stop'];
+/**
+ * 이 구간을 받아도 되나.
+ *
+ * `now` 를 부르는 쪽이 준다 — 이 함수가 시계를 읽으면 테스트가 시각에 흔들린다.
+ */
+function judgePeriod(period, context) {
+    const issues = [];
+    const start = ms(period.startTime);
+    const end = ms(period.endTime);
+    if (!(end > start)) {
+        issues.push({ problem: 'not-a-period' });
+    }
+    if (end > ms(context.now)) {
+        issues.push({ problem: 'in-the-future' });
+    }
+    if (!exports.EQUIPMENT_PERIOD_STATUS.includes(period.status)) {
+        issues.push({ problem: 'unknown-status', status: period.status });
+    }
+    for (const other of context.existing ?? []) {
+        const otherStart = ms(other.startTime);
+        const otherEnd = ms(other.endTime);
+        /* 끝과 시작이 맞닿는 것은 겹침이 아니다 — 한 구간이 끝나는 순간 다음이 시작한다. */
+        if (start < otherEnd && otherStart < end) {
+            issues.push({ problem: 'overlaps', conflictsWith: isoOf(other.startTime) });
+        }
+    }
+    issues.push(...reasonIssues(period, context.reasons));
+    return issues;
+}
+function reasonIssues(period, reasons) {
+    /*
+     * 사유를 적지 않은 것은 흠이 아니다. 정지는 일단 적고 사유는 나중에 정하는 것이 현장의 순서이고,
+     * 사유를 요구하면 그 순서를 막게 된다.
+     */
+    if (!period.reasonCode) {
+        return [];
+    }
+    /*
+     * 마스터를 아직 채우지 않은 현장은 확인하지 않는다 — 선언한 것만 걸린다.
+     *
+     * 빈 배열은 여기서 걸러지지 않는다. 채웠는데 이 사유가 없는 것이고, 아래에서 「모르는 사유」가 된다.
+     */
+    if (!reasons) {
+        return [];
+    }
+    const found = reasons.find(reason => reason.name === period.reasonCode);
+    if (!found) {
+        return [{ problem: 'unknown-reason', reasonCode: period.reasonCode }];
+    }
+    const issues = [];
+    if (found.status !== period.status) {
+        issues.push({
+            problem: 'reason-status-mismatch',
+            reasonCode: found.name,
+            reasonStatus: found.status,
+            status: period.status
+        });
+    }
+    if (found.detailRequired && !period.reasonDetail) {
+        issues.push({ problem: 'detail-required', reasonCode: found.name });
+    }
+    return issues;
+}
+function ms(at) {
+    return typeof at === 'string' ? Date.parse(at) : at.getTime();
+}
+function isoOf(at) {
+    return typeof at === 'string' ? at : at.toISOString();
+}
+//# sourceMappingURL=state-period-rules.js.map

package/dist-server/service/equipment/state-period-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-period-rules.js","sourceRoot":"","sources":["../../../server/service/equipment/state-period-rules.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 상태 구간을 받아도 되나 — **순수 판단.**\n *\n * ── 왜 규칙이 필요한가 ──────────────────────────────────────────────────────\n * 구간은 사람이 되돌아가 적는다. 그래서 겹치고, 거꾸로 되고, 미래로 간다. 그대로 받으면 가동률의\n * 분자가 분모보다 커지는 날이 온다. 그때는 이미 잘못된 구간이 수백 개 쌓여 있다.\n *\n * ── 왜 사유와 상태를 맞춰 보나 ──────────────────────────────────────────────\n * ISO 22400 에서 가동률을 깎느냐 마느냐는 **상태**가 정한다. 「점심시간」을 `down` 으로 적으면 가동률이\n * 오류 보고 없이 낮아지고, 「고장」을 `planned-stop` 으로 적으면 오류 보고 없이 높아진다. 둘 다 조용한\n * 거짓이라 나중에 찾을 방법이 없다.\n */\n\n/** 계약의 `EQUIPMENT_STATUS` 와 같은 어휘. 여기서 새로 만들지 않는다. */\nexport const EQUIPMENT_PERIOD_STATUS = ['idle', 'busy', 'down', 'setup', 'planned-stop'] as const\n\nexport type EquipmentPeriodStatus = (typeof EQUIPMENT_PERIOD_STATUS)[number]\n\nexport type PeriodProblem =\n  /** 끝이 시작보다 앞이거나 같다 — 길이가 없는 구간은 셀 것이 없다. */\n  | 'not-a-period'\n  /** 아직 오지 않은 시각이다. */\n  | 'in-the-future'\n  /** 같은 설비의 다른 구간과 겹친다 — 한 설비가 같은 시각에 두 상태일 수 없다. */\n  | 'overlaps'\n  /** 계약이 모르는 상태다. */\n  | 'unknown-status'\n  /** 사유가 사유 마스터에 없다. */\n  | 'unknown-reason'\n  /** 사유가 이 상태의 사유가 아니다 — 가동률이 오류 보고 없이 틀어진다. */\n  | 'reason-status-mismatch'\n  /** 이 사유는 상세를 함께 적어야 한다. */\n  | 'detail-required'\n\nexport interface PeriodIssue {\n  problem: PeriodProblem\n  /** 겹치는 것이면 어느 구간과 겹치나(시작 시각, ISO). */\n  conflictsWith?: string\n  /** 사유 문제이면 어느 사유인가. */\n  reasonCode?: string\n  /** 사유가 속한 상태와 적힌 상태. */\n  reasonStatus?: string\n  status?: string\n}\n\nexport interface JudgeablePeriod {\n  status: string\n  startTime: Date | string\n  endTime: Date | string\n  reasonCode?: string\n  reasonDetail?: string\n}\n\n/** 사유 마스터에서 필요한 것만. */\nexport interface StopReasonFact {\n  name: string\n  status: string\n  detailRequired?: boolean\n}\n\n/** 이미 적혀 있는 구간 — 겹침을 볼 때만 쓴다. */\nexport interface ExistingPeriod {\n  startTime: Date | string\n  endTime: Date | string\n}\n\n/**\n * 이 구간을 받아도 되나.\n *\n * `now` 를 부르는 쪽이 준다 — 이 함수가 시계를 읽으면 테스트가 시각에 흔들린다.\n */\nexport function judgePeriod(\n  period: JudgeablePeriod,\n  context: {\n    now: Date | string\n    /** 같은 설비의 이미 적힌 구간들. 부르는 쪽이 시각으로 좁혀서 준다. */\n    existing?: readonly ExistingPeriod[]\n    /**\n     * 사유 마스터에서 읽은 것.\n     *\n     * **`undefined` 와 빈 배열의 뜻이 다르다.** `undefined` 는 「마스터를 아직 채우지 않았다」이고\n     * 확인하지 않는다. 빈 배열은 「채웠는데 이 사유가 없다」이고 막는다. 둘을 섞으면 오타로 적은\n     * 사유가 오류 보고 없이 통과한다.\n     */\n    reasons?: readonly StopReasonFact[]\n  }\n): PeriodIssue[] {\n  const issues: PeriodIssue[] = []\n\n  const start = ms(period.startTime)\n  const end = ms(period.endTime)\n\n  if (!(end > start)) {\n    issues.push({ problem: 'not-a-period' })\n  }\n\n  if (end > ms(context.now)) {\n    issues.push({ problem: 'in-the-future' })\n  }\n\n  if (!(EQUIPMENT_PERIOD_STATUS as readonly string[]).includes(period.status)) {\n    issues.push({ problem: 'unknown-status', status: period.status })\n  }\n\n  for (const other of context.existing ?? []) {\n    const otherStart = ms(other.startTime)\n    const otherEnd = ms(other.endTime)\n\n    /* 끝과 시작이 맞닿는 것은 겹침이 아니다 — 한 구간이 끝나는 순간 다음이 시작한다. */\n    if (start < otherEnd && otherStart < end) {\n      issues.push({ problem: 'overlaps', conflictsWith: isoOf(other.startTime) })\n    }\n  }\n\n  issues.push(...reasonIssues(period, context.reasons))\n\n  return issues\n}\n\nfunction reasonIssues(period: JudgeablePeriod, reasons: readonly StopReasonFact[] | undefined): PeriodIssue[] {\n  /*\n   * 사유를 적지 않은 것은 흠이 아니다. 정지는 일단 적고 사유는 나중에 정하는 것이 현장의 순서이고,\n   * 사유를 요구하면 그 순서를 막게 된다.\n   */\n  if (!period.reasonCode) {\n    return []\n  }\n\n  /*\n   * 마스터를 아직 채우지 않은 현장은 확인하지 않는다 — 선언한 것만 걸린다.\n   *\n   * 빈 배열은 여기서 걸러지지 않는다. 채웠는데 이 사유가 없는 것이고, 아래에서 「모르는 사유」가 된다.\n   */\n  if (!reasons) {\n    return []\n  }\n\n  const found = reasons.find(reason => reason.name === period.reasonCode)\n\n  if (!found) {\n    return [{ problem: 'unknown-reason', reasonCode: period.reasonCode }]\n  }\n\n  const issues: PeriodIssue[] = []\n\n  if (found.status !== period.status) {\n    issues.push({\n      problem: 'reason-status-mismatch',\n      reasonCode: found.name,\n      reasonStatus: found.status,\n      status: period.status\n    })\n  }\n\n  if (found.detailRequired && !period.reasonDetail) {\n    issues.push({ problem: 'detail-required', reasonCode: found.name })\n  }\n\n  return issues\n}\n\nfunction ms(at: Date | string): number {\n  return typeof at === 'string' ? Date.parse(at) : at.getTime()\n}\n\nfunction isoOf(at: Date | string): string {\n  return typeof at === 'string' ? at : at.toISOString()\n}\n"]}

package/dist-server/service/equipment/stop-reason-query.d.ts

@@ -0,0 +1,11 @@
+import { ListParam } from '@things-factory/shell';
+import { StopReason } from './stop-reason';
+/**
+ * 정지 사유 목록.
+ *
+ * 트윈으로 내보내는 마스터에 넣지 않는다 — 사유는 **MES 가 사실을 적을 때 쓰는 분류**이고, 트윈은
+ * 상태 구간에 실려 오는 사유 코드를 그대로 받는다. 목록을 두 곳에 두면 한쪽만 늘어나는 날이 온다.
+ */
+export declare class StopReasonQuery {
+    stopReasons(params: ListParam, context: ResolverContext): Promise<StopReason[]>;
+}

package/dist-server/service/equipment/stop-reason-query.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StopReasonQuery = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const stop_reason_1 = require("./stop-reason");
+/**
+ * 정지 사유 목록.
+ *
+ * 트윈으로 내보내는 마스터에 넣지 않는다 — 사유는 **MES 가 사실을 적을 때 쓰는 분류**이고, 트윈은
+ * 상태 구간에 실려 오는 사유 코드를 그대로 받는다. 목록을 두 곳에 두면 한쪽만 늘어나는 날이 온다.
+ */
+let StopReasonQuery = class StopReasonQuery {
+    async stopReasons(params, context) {
+        const { domain } = context.state;
+        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+            repository: (0, shell_1.getRepository)(stop_reason_1.StopReason),
+            params,
+            domain,
+            searchables: ['name', 'description'],
+            alias: 'sr'
+        });
+        return queryBuilder.getMany();
+    }
+};
+exports.StopReasonQuery = StopReasonQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => [stop_reason_1.StopReason], { description: 'To fetch the classified reasons an equipment stops' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], StopReasonQuery.prototype, "stopReasons", null);
+exports.StopReasonQuery = StopReasonQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(stop_reason_1.StopReason)
+], StopReasonQuery);
+//# sourceMappingURL=stop-reason-query.js.map

package/dist-server/service/equipment/stop-reason-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-reason-query.js","sourceRoot":"","sources":["../../../server/service/equipment/stop-reason-query.ts"],"names":[],"mappings":";;;;AAAA,+CAAyD;AAEzD,iDAA+F;AAE/F,+CAA0C;AAE1C;;;;;GAKG;AAEI,IAAM,eAAe,GAArB,MAAM,eAAe;IAEpB,AAAN,KAAK,CAAC,WAAW,CAA0B,MAAiB,EAAS,OAAwB;QAC3F,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,MAAM,YAAY,GAAG,IAAA,qCAA6B,EAAC;YACjD,UAAU,EAAE,IAAA,qBAAa,EAAC,wBAAU,CAAC;YACrC,MAAM;YACN,MAAM;YACN,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;YACpC,KAAK,EAAE,IAAI;SACZ,CAAC,CAAA;QAEF,OAAO,YAAY,CAAC,OAAO,EAAE,CAAA;IAC/B,CAAC;CACF,CAAA;AAfY,0CAAe;AAEpB;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,wBAAU,CAAC,EAAE,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC;IACnF,mBAAA,IAAA,mBAAI,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAS,CAAC,CAAA;IAAqB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CAAjB,iBAAS;;kDAY3D;0BAdU,eAAe;IAD3B,IAAA,uBAAQ,EAAC,wBAAU,CAAC;GACR,eAAe,CAe3B","sourcesContent":["import { Args, Ctx, Query, Resolver } from 'type-graphql'\n\nimport { ListParam, getQueryBuilderFromListParams, getRepository } from '@things-factory/shell'\n\nimport { StopReason } from './stop-reason'\n\n/**\n * 정지 사유 목록.\n *\n * 트윈으로 내보내는 마스터에 넣지 않는다 — 사유는 **MES 가 사실을 적을 때 쓰는 분류**이고, 트윈은\n * 상태 구간에 실려 오는 사유 코드를 그대로 받는다. 목록을 두 곳에 두면 한쪽만 늘어나는 날이 온다.\n */\n@Resolver(StopReason)\nexport class StopReasonQuery {\n  @Query(returns => [StopReason], { description: 'To fetch the classified reasons an equipment stops' })\n  async stopReasons(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<StopReason[]> {\n    const { domain } = context.state\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(StopReason),\n      params,\n      domain,\n      searchables: ['name', 'description'],\n      alias: 'sr'\n    })\n\n    return queryBuilder.getMany()\n  }\n}\n"]}