@things-factory/ops-master 10.1.248 → 10.1.250

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

@@ -0,0 +1,138 @@
+"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)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
+    tslib_1.__metadata("design:type", Array)
+], Equipment.prototype, "equipmentClassIds", 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 => shell_1.ScalarObject, { nullable: true, description: 'WorkCalendarEntry[]' }),
+    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 => shell_1.ScalarObject, { nullable: true, description: 'ResourceProperty[]' }),
+    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 => shell_1.ScalarObject, { nullable: true, description: 'TestResult[]' }),
+    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, ScalarObject } 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  /**\n   * 종류 — 계약의 `kind` 자리다.\n   *\n   * **등급이기도 하고 종류이기도 한 칸이다.** 등급을 담을 칸이 따로 없던 동안 이 한 낱말이 둘을\n   * 다 했고, 지금도 하중을 받고 있다 — 설비를 이름으로 부르는 공정들이 이 값을 가리킨다. 그래서\n   * 아래에 `equipmentClassIds` 를 열면서도 이 칸을 빼지 않았다.\n   *\n   * 커널은 소속을 `equipmentClassIds ∪ {kind}` 로 본다(계약의 `equipmentClassMembership`).\n   */\n  @Column()\n  @Field()\n  kind: string\n\n  /**\n   * 속한 등급들 — 표준 `EquipmentClassID`(복수).\n   *\n   * ── 왜 복수인가 ──────────────────────────────────────────────────────────\n   * 인원과 자산이 이미 복수다(`personnelClassIds` · `assetClassIds`). 설비만 없어서 판정이\n   * `kind` 하나를 소속으로 썼고, 그래서 표준 요구가 **종류와 이름이 같을 때만** 채워졌다.\n   *\n   * ```\n   * equipmentSpecification: { equipmentClass: 'welding-equipment', quantity: 2 }\n   * → kind 가 'welding-equipment' 인 설비만 세어졌다\n   * → 6축 로봇과 수동 용접기를 「용접설비 2대」로 함께 세는 것이 불가능했다\n   * ```\n   *\n   * 요구가 조용히 안 채워지고 작업이 서 있었다. 오류는 나지 않았다.\n   *\n   * 비워 두면 예전과 똑같이 돈다 — `kind` 만으로 소속이 정해진다.\n   */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  equipmentClassIds?: 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 => ScalarObject, { nullable: true, description: 'WorkCalendarEntry[]' })\n  workCalendar?: Record<string, unknown>[]\n\n  /** 개체 속성 — 표준 `EquipmentProperty`. 속도처럼 계산에 들어가는 속성이 여기 온다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'ResourceProperty[]' })\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 => ScalarObject, { nullable: true, description: 'TestResult[]' })\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,95 @@
+/**
+ * 상태 구간을 받아도 되나 — **순수 판단.**
+ *
+ * ── 왜 규칙이 필요한가 ──────────────────────────────────────────────────────
+ * 구간은 사람이 되돌아가 적는다. 그래서 겹치고, 거꾸로 되고, 미래로 간다. 그대로 받으면 가동률의
+ * 분자가 분모보다 커지는 날이 온다. 그때는 이미 잘못된 구간이 수백 개 쌓여 있다.
+ *
+ * ── 왜 사유와 상태를 맞춰 보나 ──────────────────────────────────────────────
+ * 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];
+/**
+ * 정지 사유가 붙을 수 있는 상태 — **`busy` 는 빠진다.**
+ *
+ * 돌고 있는 것에는 사유가 없다(§`StopReason.status` 주석). 그래서 구간이 가질 수 있는 상태는 다섯인데
+ * 사유가 가질 수 있는 상태는 넷이다.
+ */
+export declare const STOP_REASON_STATUS: ("idle" | "down" | "setup" | "planned-stop")[];
+/**
+ * 이 사유를 마스터에 적을 수 있나 — **적을 수 없으면 왜인지, 그리고 무엇이 되는지.**
+ *
+ * ── 왜 마스터에서 막나 (2026-09-03) ────────────────────────────────────────
+ * 사유의 `status` 가 자유 문자열이라 `broken` 이 그대로 저장됐다. 그러면 **그 사유를 쓴 모든 구간이**
+ * 「사유와 상태가 어긋난다」로 걸린다(§`reasonIssues`). 잘못은 마스터 한 줄에서 났는데 불은 구간
+ * 수백 개에서 켜지고, 그 문장은 마스터를 가리키지 않는다.
+ *
+ * 그래서 틀린 자리에서 막는다. 구간 쪽 검사는 그대로 둔다 — 마스터를 채우기 전에 쓰인 지난 줄과,
+ * 사유를 나중에 고친 경우가 거기서 걸린다.
+ */
+export declare function stopReasonStatusGap(status: unknown): string | undefined;
+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,122 @@
+"use strict";
+/**
+ * 상태 구간을 받아도 되나 — **순수 판단.**
+ *
+ * ── 왜 규칙이 필요한가 ──────────────────────────────────────────────────────
+ * 구간은 사람이 되돌아가 적는다. 그래서 겹치고, 거꾸로 되고, 미래로 간다. 그대로 받으면 가동률의
+ * 분자가 분모보다 커지는 날이 온다. 그때는 이미 잘못된 구간이 수백 개 쌓여 있다.
+ *
+ * ── 왜 사유와 상태를 맞춰 보나 ──────────────────────────────────────────────
+ * ISO 22400 에서 가동률을 깎느냐 마느냐는 **상태**가 정한다. 「점심시간」을 `down` 으로 적으면 가동률이
+ * 오류 보고 없이 낮아지고, 「고장」을 `planned-stop` 으로 적으면 오류 보고 없이 높아진다. 둘 다 조용한
+ * 거짓이라 나중에 찾을 방법이 없다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STOP_REASON_STATUS = exports.EQUIPMENT_PERIOD_STATUS = void 0;
+exports.stopReasonStatusGap = stopReasonStatusGap;
+exports.judgePeriod = judgePeriod;
+/** 계약의 `EQUIPMENT_STATUS` 와 같은 어휘. 여기서 새로 만들지 않는다. */
+exports.EQUIPMENT_PERIOD_STATUS = ['idle', 'busy', 'down', 'setup', 'planned-stop'];
+/**
+ * 정지 사유가 붙을 수 있는 상태 — **`busy` 는 빠진다.**
+ *
+ * 돌고 있는 것에는 사유가 없다(§`StopReason.status` 주석). 그래서 구간이 가질 수 있는 상태는 다섯인데
+ * 사유가 가질 수 있는 상태는 넷이다.
+ */
+exports.STOP_REASON_STATUS = exports.EQUIPMENT_PERIOD_STATUS.filter(status => status !== 'busy');
+/**
+ * 이 사유를 마스터에 적을 수 있나 — **적을 수 없으면 왜인지, 그리고 무엇이 되는지.**
+ *
+ * ── 왜 마스터에서 막나 (2026-09-03) ────────────────────────────────────────
+ * 사유의 `status` 가 자유 문자열이라 `broken` 이 그대로 저장됐다. 그러면 **그 사유를 쓴 모든 구간이**
+ * 「사유와 상태가 어긋난다」로 걸린다(§`reasonIssues`). 잘못은 마스터 한 줄에서 났는데 불은 구간
+ * 수백 개에서 켜지고, 그 문장은 마스터를 가리키지 않는다.
+ *
+ * 그래서 틀린 자리에서 막는다. 구간 쪽 검사는 그대로 둔다 — 마스터를 채우기 전에 쓰인 지난 줄과,
+ * 사유를 나중에 고친 경우가 거기서 걸린다.
+ */
+function stopReasonStatusGap(status) {
+    const said = typeof status === 'string' ? status.trim() : '';
+    if (!said) {
+        return ('정지 사유에는 어느 상태에 쓰이는지가 있어야 합니다 — 가동률을 깎느냐 마느냐를 그 값이 정합니다 ' +
+            `(쓸 수 있는 것: ${exports.STOP_REASON_STATUS.join(' · ')})`);
+    }
+    if (said === 'busy') {
+        return '돌고 있는 상태에는 정지 사유가 없습니다 — busy 는 정지가 아닙니다';
+    }
+    if (!exports.STOP_REASON_STATUS.includes(said)) {
+        return (`모르는 상태입니다: "${said}" — 이 값으로 저장하면 그 사유를 쓴 모든 구간이 어긋남으로 걸립니다 ` +
+            `(쓸 수 있는 것: ${exports.STOP_REASON_STATUS.join(' · ')})`);
+    }
+    return undefined;
+}
+/**
+ * 이 구간을 받아도 되나.
+ *
+ * `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\n/**\n * 정지 사유가 붙을 수 있는 상태 — **`busy` 는 빠진다.**\n *\n * 돌고 있는 것에는 사유가 없다(§`StopReason.status` 주석). 그래서 구간이 가질 수 있는 상태는 다섯인데\n * 사유가 가질 수 있는 상태는 넷이다.\n */\nexport const STOP_REASON_STATUS = EQUIPMENT_PERIOD_STATUS.filter(status => status !== 'busy')\n\n/**\n * 이 사유를 마스터에 적을 수 있나 — **적을 수 없으면 왜인지, 그리고 무엇이 되는지.**\n *\n * ── 왜 마스터에서 막나 (2026-09-03) ────────────────────────────────────────\n * 사유의 `status` 가 자유 문자열이라 `broken` 이 그대로 저장됐다. 그러면 **그 사유를 쓴 모든 구간이**\n * 「사유와 상태가 어긋난다」로 걸린다(§`reasonIssues`). 잘못은 마스터 한 줄에서 났는데 불은 구간\n * 수백 개에서 켜지고, 그 문장은 마스터를 가리키지 않는다.\n *\n * 그래서 틀린 자리에서 막는다. 구간 쪽 검사는 그대로 둔다 — 마스터를 채우기 전에 쓰인 지난 줄과,\n * 사유를 나중에 고친 경우가 거기서 걸린다.\n */\nexport function stopReasonStatusGap(status: unknown): string | undefined {\n  const said = typeof status === 'string' ? status.trim() : ''\n\n  if (!said) {\n    return (\n      '정지 사유에는 어느 상태에 쓰이는지가 있어야 합니다 — 가동률을 깎느냐 마느냐를 그 값이 정합니다 ' +\n      `(쓸 수 있는 것: ${STOP_REASON_STATUS.join(' · ')})`\n    )\n  }\n\n  if (said === 'busy') {\n    return '돌고 있는 상태에는 정지 사유가 없습니다 — busy 는 정지가 아닙니다'\n  }\n\n  if (!(STOP_REASON_STATUS as readonly string[]).includes(said)) {\n    return (\n      `모르는 상태입니다: \"${said}\" — 이 값으로 저장하면 그 사유를 쓴 모든 구간이 어긋남으로 걸립니다 ` +\n      `(쓸 수 있는 것: ${STOP_REASON_STATUS.join(' · ')})`\n    )\n  }\n\n  return undefined\n}\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"]}

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

@@ -0,0 +1,58 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/**
+ * 설비가 왜 섰나 — **사유의 목록.**
+ *
+ * ── 왜 마스터로 두나 ────────────────────────────────────────────────────────
+ * 사유를 자유 문장으로 받으면 「금형교체」 · 「금형 교체」 · 「몰드교환」이 서로 다른 사유가 된다. 그러면
+ * 「무엇 때문에 가장 많이 멈추나」에 답할 수 없다 — 그 답이 정지 사유를 적는 유일한 이유다.
+ *
+ * ── `status` 가 가동률을 정하고, 사유는 무엇을 고칠지 정한다 ────────────────
+ * ISO 22400 에서 가동률을 깎느냐 마느냐는 **상태**가 정한다(`down` · `idle` 은 깎고 `planned-stop` 은
+ * 깎지 않는다). 사유는 그 상태 안에서 **무엇을 고쳐야 하나**를 말한다.
+ *
+ * 그래서 사유마다 어느 상태에 쓰이는지 적어 둔다. 「점심시간」을 `down` 으로 적으면 가동률이 알리지
+ * 않고 낮아지고, 「고장」을 `planned-stop` 으로 적으면 알리지 않고 높아진다. 둘 다 조용한 거짓이다.
+ */
+export declare class StopReason {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** 사유 코드 — 상태 구간이 이 값을 가리킨다. */
+    name: string;
+    description?: string;
+    /**
+     * 이 사유가 쓰이는 상태 — `down` · `idle` · `setup` · `planned-stop`.
+     *
+     * 어휘는 계약의 `EQUIPMENT_STATUS` 다. `busy` 는 여기 오지 않는다 — 돌고 있는 것에는 사유가 없다.
+     */
+    status: string;
+    /**
+     * 상위 사유 — 사유는 나무다.
+     *
+     * 「설비 고장」 아래 「금형 파손」 · 「모터 과열」이 온다. 위로 모아 보면 「고장으로 몇 시간」이 나오고,
+     * 아래로 내려가면 「무엇을 고칠까」가 나온다. 한 단으로만 두면 둘 중 하나를 잃는다.
+     */
+    parentName?: string;
+    /**
+     * 이 사유를 적을 때 상세를 함께 받나.
+     *
+     * 「기타」로만 적히는 사유가 목록의 절반을 차지하면 분류가 없는 것과 같다. 상세를 요구하는 사유를
+     * 표시해 두어 화면이 그때만 묻게 한다.
+     */
+    detailRequired?: boolean;
+    /** 언제부터 — 표준 `EffectiveStartDate`. */
+    effectiveStart?: Date;
+    /**
+     * 언제까지 — 표준 `EffectiveEndDate`.
+     *
+     * 쓰지 않는 사유는 지우지 않고 이 칸을 채운다. 지우면 그 사유로 적힌 지난 구간이 가리킬 것을 잃는다.
+     */
+    effectiveEnd?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}