@things-factory/ops-master 10.1.248 → 10.1.250

package/dist-server/service/assignment/master-value-claim.d.ts

@@ -0,0 +1,135 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/**
+ * **언제부터 그러했고, 언제 그렇게 적었나** — 배정과 선언의 주장 한 줄.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 무엇이 없었나 ──────────────────────────────────────────────────────────
+ * 가동률의 분모는 **설비가 어느 자리에 있었나 · 그 자리가 어느 근무조로 돌았나 · 그 자리가 어디에
+ * 속했나**로 정해진다. 셋 다 칸 하나였다. 그래서 설비를 옮기면 **지난달 가동률이 바뀌었고**, 아무도
+ * 아무것도 정정하지 않았는데 숫자가 달라진 까닭을 말할 수 없었다.
+ *
+ * ── 시각이 둘인 까닭 ───────────────────────────────────────────────────────
+ * 「언제부터 그렇게 하기로 했나」와 「언제 그렇게 적었나」는 다르다.
+ *
+ * ```
+ * validFrom · validTo   적용 시각 — 업무의 시간. 분모를 나누는 경계가 이것이다
+ * recordedAt            기록 시각 — 우리가 그것을 안 시각
+ * supersededAt          이 주장이 물러난 시각. 덮어쓰지 않고 물러나게 한다
+ * ```
+ *
+ * 사흘 전에 옮긴 것을 오늘 적으면 둘이 갈라진다. **이틀 전 기록시점으로 물으면 옛 자리가 나와야
+ * 한다** — 그때 우리가 알던 것이 그것이기 때문이다(ADR-0088 결정 2 ③).
+ *
+ * ── 정정은 덮지 않고 조각을 남긴다 ─────────────────────────────────────────
+ * ```
+ * 지금까지    A [1일, ∞)
+ * 오늘 정정    「10~15일은 B 였다」
+ * 최신         A [1일, 10일) · B [10일, 15일) · A [15일, ∞)
+ * 정정 전 시점  A [1일, ∞)        ← 조각은 그때 아직 기록되지 않았다
+ * ```
+ *
+ * ── 이 표가 기준이 되는 원본이고, 마스터 행은 투영이다 ─────────────────────
+ * 미래 주장은 마스터 행을 **안 건드린다.** 다음 달 이동을 지금 적었다고 다른 제품이 오늘부터 새
+ * 자리를 읽으면 안 된다. 도래하면 투영이 행을 맞춘다(§`projectDueClaims`).
+ *
+ * ── 이름이 아니라 식별자로 가리킨다 ────────────────────────────────────────
+ * `value.ref` 가 안정된 식별자이고 `value.label` 은 **그때 뭐라고 불렀나**다. 이름을 담으면 이름을
+ * 바꾼 날 과거 관계가 끊긴다(적용 가이드 §0-1 의 그 부류).
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+export declare class MasterValueClaim {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** 어느 축의 무엇인가 — `equipment` · `operationalLocation`. */
+    axis: string;
+    /** 그 축의 어느 행인가. UUID 다. */
+    rowId: string;
+    /** 어느 칸인가 — 선언한 셋만 온다(§`CLAIMED_FIELDS`). */
+    field: string;
+    /**
+     * 그때의 값.
+     *
+     * ```
+     * { ref, label }      관계를 가리키는 칸 — 식별자와 그때의 표시값
+     * { names: [...] }    이름 목록을 드는 칸 — 근무조 선언
+     * null                **선언 없음.** 「그때부터 부모가 없다」는 정상 값이고 결측이 아니다
+     * ```
+     */
+    value?: Record<string, unknown> | null;
+    /**
+     * 언제부터 그러했나 — 업무의 시간.
+     *
+     * **비어 있으면 「그때까지 쭉」이다.** 어느 칸이 처음 바뀔 때, 바뀌기 전 값도 같이 적는데 그 값이
+     * 언제부터였는지는 아무도 안 적었다. 1970 년 같은 시각을 넣으면 적은 적 없는 것을 적은 것이 되므로
+     * 비워 둔다(2026-09-23).
+     */
+    validFrom?: Date;
+    /** 언제까지. 비면 아직 끝나지 않았다. */
+    validTo?: Date;
+    /** 언제 그렇게 적었나. 서버가 붙인다 — 사람이 넣지 않는다. */
+    recordedAt: Date;
+    /** 언제 물러났나. 비면 지금도 서 있는 주장이다. */
+    supersededAt?: Date;
+    /**
+     * 왜 이 주장이 섰나 — 읽는 사람이 「지연 기록인가 정정인가」를 알아야 한다.
+     *
+     * ```
+     * initial     도입 시각에 확인된 초기 상태
+     * change      바꾼다는 선언
+     * correction  이미 적은 것을 고친다
+     * remainder   정정이 남긴 앞뒤 조각
+     * ```
+     */
+    reason: string;
+    recorder?: User;
+    recorderId?: string;
+    createdAt?: Date;
+}
+/**
+ * **이력을 받는 칸은 여기 적힌 것뿐이다.**
+ *
+ * 임의의 축·칸을 받는 범용 쓰기 문을 열지 않는다(설계 점검 2026-09-22). 칸마다 값의 모양과 검증이
+ * 다르고, 아무 칸이나 받는 문은 그 검증을 못 한다.
+ *
+ * ── 셋에서 넷이 됐다 (2026-09-23) ─────────────────────────────────────────
+ * 앞의 셋은 **배정**이다 — 무엇이 어디에 속하나. 넷째는 아니다. 공정의 표준시간은 값 자체이고,
+ * 실적의 성능률이 그것을 나눈다. 지금은 **오늘 마스터를 다시 읽어서 지난달 성능이 움직인다**
+ * (`operation-effectivity-db.test.cjs` 가 그 거동을 적어 두고 있다).
+ *
+ * 그래서 이 표의 이름이 「배정」이 아니라 「마스터 값의 주장」이다. 기전은 같다 — 두 시각, 정정은
+ * 물리고 앞뒤를 다시 주장, 주장이 없으면 한 번도 안 바뀐 것.
+ */
+export declare const CLAIMED_FIELDS: ({
+    axis: string;
+    field: string;
+    kind: "relation";
+    target: string;
+} | {
+    axis: string;
+    field: string;
+    kind: "names";
+    target?: undefined;
+} | {
+    axis: string;
+    field: string;
+    kind: "literal";
+    target?: undefined;
+})[];
+export declare function claimedField(axis: string, field: string): {
+    axis: string;
+    field: string;
+    kind: "relation";
+    target: string;
+} | {
+    axis: string;
+    field: string;
+    kind: "names";
+    target?: undefined;
+} | {
+    axis: string;
+    field: string;
+    kind: "literal";
+    target?: undefined;
+};

package/dist-server/service/assignment/master-value-claim.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLAIMED_FIELDS = exports.MasterValueClaim = void 0;
+exports.claimedField = claimedField;
+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");
+/**
+ * **언제부터 그러했고, 언제 그렇게 적었나** — 배정과 선언의 주장 한 줄.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 무엇이 없었나 ──────────────────────────────────────────────────────────
+ * 가동률의 분모는 **설비가 어느 자리에 있었나 · 그 자리가 어느 근무조로 돌았나 · 그 자리가 어디에
+ * 속했나**로 정해진다. 셋 다 칸 하나였다. 그래서 설비를 옮기면 **지난달 가동률이 바뀌었고**, 아무도
+ * 아무것도 정정하지 않았는데 숫자가 달라진 까닭을 말할 수 없었다.
+ *
+ * ── 시각이 둘인 까닭 ───────────────────────────────────────────────────────
+ * 「언제부터 그렇게 하기로 했나」와 「언제 그렇게 적었나」는 다르다.
+ *
+ * ```
+ * validFrom · validTo   적용 시각 — 업무의 시간. 분모를 나누는 경계가 이것이다
+ * recordedAt            기록 시각 — 우리가 그것을 안 시각
+ * supersededAt          이 주장이 물러난 시각. 덮어쓰지 않고 물러나게 한다
+ * ```
+ *
+ * 사흘 전에 옮긴 것을 오늘 적으면 둘이 갈라진다. **이틀 전 기록시점으로 물으면 옛 자리가 나와야
+ * 한다** — 그때 우리가 알던 것이 그것이기 때문이다(ADR-0088 결정 2 ③).
+ *
+ * ── 정정은 덮지 않고 조각을 남긴다 ─────────────────────────────────────────
+ * ```
+ * 지금까지    A [1일, ∞)
+ * 오늘 정정    「10~15일은 B 였다」
+ * 최신         A [1일, 10일) · B [10일, 15일) · A [15일, ∞)
+ * 정정 전 시점  A [1일, ∞)        ← 조각은 그때 아직 기록되지 않았다
+ * ```
+ *
+ * ── 이 표가 기준이 되는 원본이고, 마스터 행은 투영이다 ─────────────────────
+ * 미래 주장은 마스터 행을 **안 건드린다.** 다음 달 이동을 지금 적었다고 다른 제품이 오늘부터 새
+ * 자리를 읽으면 안 된다. 도래하면 투영이 행을 맞춘다(§`projectDueClaims`).
+ *
+ * ── 이름이 아니라 식별자로 가리킨다 ────────────────────────────────────────
+ * `value.ref` 가 안정된 식별자이고 `value.label` 은 **그때 뭐라고 불렀나**다. 이름을 담으면 이름을
+ * 바꾼 날 과거 관계가 끊긴다(적용 가이드 §0-1 의 그 부류).
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+let MasterValueClaim = class MasterValueClaim {
+};
+exports.MasterValueClaim = MasterValueClaim;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], MasterValueClaim.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)
+], MasterValueClaim.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((claim) => claim.domain),
+    tslib_1.__metadata("design:type", String)
+], MasterValueClaim.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterValueClaim.prototype, "axis", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterValueClaim.prototype, "rowId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterValueClaim.prototype, "field", 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 }),
+    tslib_1.__metadata("design:type", Object)
+], MasterValueClaim.prototype, "value", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date
+    /** 언제까지. 비면 아직 끝나지 않았다. */
+    )
+], MasterValueClaim.prototype, "validFrom", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date
+    /** 언제 그렇게 적었나. 서버가 붙인다 — 사람이 넣지 않는다. */
+    )
+], MasterValueClaim.prototype, "validTo", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", Date
+    /** 언제 물러났나. 비면 지금도 서 있는 주장이다. */
+    )
+], MasterValueClaim.prototype, "recordedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date
+    /**
+     * 왜 이 주장이 섰나 — 읽는 사람이 「지연 기록인가 정정인가」를 알아야 한다.
+     *
+     * ```
+     * initial     도입 시각에 확인된 초기 상태
+     * change      바꾼다는 선언
+     * correction  이미 적은 것을 고친다
+     * remainder   정정이 남긴 앞뒤 조각
+     * ```
+     */
+    )
+], MasterValueClaim.prototype, "supersededAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterValueClaim.prototype, "reason", 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)
+], MasterValueClaim.prototype, "recorder", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((claim) => claim.recorder),
+    tslib_1.__metadata("design:type", String)
+], MasterValueClaim.prototype, "recorderId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], MasterValueClaim.prototype, "createdAt", void 0);
+exports.MasterValueClaim = MasterValueClaim = tslib_1.__decorate([
+    (0, typeorm_1.Entity)({ name: 'ops_master_value_claim' }),
+    (0, typeorm_1.Index)('ix_ops_master_value_claim_0', (claim) => [claim.domain, claim.axis, claim.rowId, claim.field]),
+    (0, type_graphql_1.ObjectType)({ description: 'what an assignment or declaration was, from when, as recorded when' })
+], MasterValueClaim);
+/**
+ * **이력을 받는 칸은 여기 적힌 것뿐이다.**
+ *
+ * 임의의 축·칸을 받는 범용 쓰기 문을 열지 않는다(설계 점검 2026-09-22). 칸마다 값의 모양과 검증이
+ * 다르고, 아무 칸이나 받는 문은 그 검증을 못 한다.
+ *
+ * ── 셋에서 넷이 됐다 (2026-09-23) ─────────────────────────────────────────
+ * 앞의 셋은 **배정**이다 — 무엇이 어디에 속하나. 넷째는 아니다. 공정의 표준시간은 값 자체이고,
+ * 실적의 성능률이 그것을 나눈다. 지금은 **오늘 마스터를 다시 읽어서 지난달 성능이 움직인다**
+ * (`operation-effectivity-db.test.cjs` 가 그 거동을 적어 두고 있다).
+ *
+ * 그래서 이 표의 이름이 「배정」이 아니라 「마스터 값의 주장」이다. 기전은 같다 — 두 시각, 정정은
+ * 물리고 앞뒤를 다시 주장, 주장이 없으면 한 번도 안 바뀐 것.
+ */
+exports.CLAIMED_FIELDS = [
+    { axis: 'equipment', field: 'homeLocation', kind: 'relation', target: 'operationalLocation' },
+    { axis: 'operationalLocation', field: 'workShiftNames', kind: 'names' },
+    { axis: 'operationalLocation', field: 'parentId', kind: 'relation', target: 'operationalLocation' },
+    /*
+     * ISO 8601 기간 문자열 그대로 담는다(`PT1M`). ms 로 바꿔 담으면 사람이 읽을 때 원문이 없고,
+     * 원문만 담으면 파싱 규칙이 바뀌는 날 값이 달라진다 — **읽는 쪽이 둘 다 내도록** 원문을 담고
+     * 부르는 쪽이 파싱한다(착수 카드 §3-1).
+     */
+    { axis: 'operationDefinition', field: 'duration', kind: 'literal' }
+];
+function claimedField(axis, field) {
+    return exports.CLAIMED_FIELDS.find(one => one.axis === axis && one.field === field);
+}
+//# sourceMappingURL=master-value-claim.js.map

package/dist-server/service/assignment/master-value-claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-value-claim.js","sourceRoot":"","sources":["../../../server/service/assignment/master-value-claim.ts"],"names":[],"mappings":"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","sourcesContent":["import { Column, CreateDateColumn, Entity, Index, ManyToOne, PrimaryGeneratedColumn, RelationId } from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/**\n * **언제부터 그러했고, 언제 그렇게 적었나** — 배정과 선언의 주장 한 줄.\n *\n * ═══════════════════════════════════════════════════════════════════════════\n * ── 무엇이 없었나 ──────────────────────────────────────────────────────────\n * 가동률의 분모는 **설비가 어느 자리에 있었나 · 그 자리가 어느 근무조로 돌았나 · 그 자리가 어디에\n * 속했나**로 정해진다. 셋 다 칸 하나였다. 그래서 설비를 옮기면 **지난달 가동률이 바뀌었고**, 아무도\n * 아무것도 정정하지 않았는데 숫자가 달라진 까닭을 말할 수 없었다.\n *\n * ── 시각이 둘인 까닭 ───────────────────────────────────────────────────────\n * 「언제부터 그렇게 하기로 했나」와 「언제 그렇게 적었나」는 다르다.\n *\n * ```\n * validFrom · validTo   적용 시각 — 업무의 시간. 분모를 나누는 경계가 이것이다\n * recordedAt            기록 시각 — 우리가 그것을 안 시각\n * supersededAt          이 주장이 물러난 시각. 덮어쓰지 않고 물러나게 한다\n * ```\n *\n * 사흘 전에 옮긴 것을 오늘 적으면 둘이 갈라진다. **이틀 전 기록시점으로 물으면 옛 자리가 나와야\n * 한다** — 그때 우리가 알던 것이 그것이기 때문이다(ADR-0088 결정 2 ③).\n *\n * ── 정정은 덮지 않고 조각을 남긴다 ─────────────────────────────────────────\n * ```\n * 지금까지    A [1일, ∞)\n * 오늘 정정    「10~15일은 B 였다」\n * 최신         A [1일, 10일) · B [10일, 15일) · A [15일, ∞)\n * 정정 전 시점  A [1일, ∞)        ← 조각은 그때 아직 기록되지 않았다\n * ```\n *\n * ── 이 표가 기준이 되는 원본이고, 마스터 행은 투영이다 ─────────────────────\n * 미래 주장은 마스터 행을 **안 건드린다.** 다음 달 이동을 지금 적었다고 다른 제품이 오늘부터 새\n * 자리를 읽으면 안 된다. 도래하면 투영이 행을 맞춘다(§`projectDueClaims`).\n *\n * ── 이름이 아니라 식별자로 가리킨다 ────────────────────────────────────────\n * `value.ref` 가 안정된 식별자이고 `value.label` 은 **그때 뭐라고 불렀나**다. 이름을 담으면 이름을\n * 바꾼 날 과거 관계가 끊긴다(적용 가이드 §0-1 의 그 부류).\n * ═══════════════════════════════════════════════════════════════════════════\n */\n@Entity({ name: 'ops_master_value_claim' })\n@Index('ix_ops_master_value_claim_0', (claim: MasterValueClaim) => [claim.domain, claim.axis, claim.rowId, claim.field])\n@ObjectType({ description: 'what an assignment or declaration was, from when, as recorded when' })\nexport class MasterValueClaim {\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((claim: MasterValueClaim) => claim.domain)\n  domainId?: string\n\n  /** 어느 축의 무엇인가 — `equipment` · `operationalLocation`. */\n  @Column()\n  @Field()\n  axis: string\n\n  /** 그 축의 어느 행인가. UUID 다. */\n  @Column()\n  @Field()\n  rowId: string\n\n  /** 어느 칸인가 — 선언한 셋만 온다(§`CLAIMED_FIELDS`). */\n  @Column()\n  @Field()\n  field: string\n\n  /**\n   * 그때의 값.\n   *\n   * ```\n   * { ref, label }      관계를 가리키는 칸 — 식별자와 그때의 표시값\n   * { names: [...] }    이름 목록을 드는 칸 — 근무조 선언\n   * null                **선언 없음.** 「그때부터 부모가 없다」는 정상 값이고 결측이 아니다\n   * ```\n   */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true })\n  value?: Record<string, unknown> | null\n\n  /**\n   * 언제부터 그러했나 — 업무의 시간.\n   *\n   * **비어 있으면 「그때까지 쭉」이다.** 어느 칸이 처음 바뀔 때, 바뀌기 전 값도 같이 적는데 그 값이\n   * 언제부터였는지는 아무도 안 적었다. 1970 년 같은 시각을 넣으면 적은 적 없는 것을 적은 것이 되므로\n   * 비워 둔다(2026-09-23).\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  validFrom?: Date\n\n  /** 언제까지. 비면 아직 끝나지 않았다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  validTo?: Date\n\n  /** 언제 그렇게 적었나. 서버가 붙인다 — 사람이 넣지 않는다. */\n  @Column()\n  @Field()\n  recordedAt: Date\n\n  /** 언제 물러났나. 비면 지금도 서 있는 주장이다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  supersededAt?: Date\n\n  /**\n   * 왜 이 주장이 섰나 — 읽는 사람이 「지연 기록인가 정정인가」를 알아야 한다.\n   *\n   * ```\n   * initial     도입 시각에 확인된 초기 상태\n   * change      바꾼다는 선언\n   * correction  이미 적은 것을 고친다\n   * remainder   정정이 남긴 앞뒤 조각\n   * ```\n   */\n  @Column()\n  @Field()\n  reason: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  recorder?: User\n\n  @RelationId((claim: MasterValueClaim) => claim.recorder)\n  recorderId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n}\n\n/**\n * **이력을 받는 칸은 여기 적힌 것뿐이다.**\n *\n * 임의의 축·칸을 받는 범용 쓰기 문을 열지 않는다(설계 점검 2026-09-22). 칸마다 값의 모양과 검증이\n * 다르고, 아무 칸이나 받는 문은 그 검증을 못 한다.\n *\n * ── 셋에서 넷이 됐다 (2026-09-23) ─────────────────────────────────────────\n * 앞의 셋은 **배정**이다 — 무엇이 어디에 속하나. 넷째는 아니다. 공정의 표준시간은 값 자체이고,\n * 실적의 성능률이 그것을 나눈다. 지금은 **오늘 마스터를 다시 읽어서 지난달 성능이 움직인다**\n * (`operation-effectivity-db.test.cjs` 가 그 거동을 적어 두고 있다).\n *\n * 그래서 이 표의 이름이 「배정」이 아니라 「마스터 값의 주장」이다. 기전은 같다 — 두 시각, 정정은\n * 물리고 앞뒤를 다시 주장, 주장이 없으면 한 번도 안 바뀐 것.\n */\nexport const CLAIMED_FIELDS = [\n  { axis: 'equipment', field: 'homeLocation', kind: 'relation' as const, target: 'operationalLocation' },\n  { axis: 'operationalLocation', field: 'workShiftNames', kind: 'names' as const },\n  { axis: 'operationalLocation', field: 'parentId', kind: 'relation' as const, target: 'operationalLocation' },\n  /*\n   * ISO 8601 기간 문자열 그대로 담는다(`PT1M`). ms 로 바꿔 담으면 사람이 읽을 때 원문이 없고,\n   * 원문만 담으면 파싱 규칙이 바뀌는 날 값이 달라진다 — **읽는 쪽이 둘 다 내도록** 원문을 담고\n   * 부르는 쪽이 파싱한다(착수 카드 §3-1).\n   */\n  { axis: 'operationDefinition', field: 'duration', kind: 'literal' as const }\n]\n\nexport function claimedField(axis: string, field: string) {\n  return CLAIMED_FIELDS.find(one => one.axis === axis && one.field === field)\n}\n"]}

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

@@ -0,0 +1,34 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/**
+ * 설비 등급 — **ISA-95 `EquipmentClass`**.
+ *
+ * 공정은 특정 설비를 지목하지 않고 등급으로 요구한다 — 「용접기 1대」. 등급이 없으면 그 요구를 적을 수
+ * 없고, 대체 설비를 찾을 수도 없다.
+ *
+ * 구조는 인원 등급과 같다(표준이 셋을 같은 모양으로 정의한다). 옮기는 함수도 같은 것을 쓴다.
+ */
+export declare class EquipmentClass {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** 표준 `EquipmentClassID`. */
+    name: string;
+    description?: string;
+    /** 상위 등급들 — 표준 `EquipmentClassBaseID`(복수). 「6축 용접기」가 「용접기」를 상속한다. */
+    baseIds?: string[];
+    /** 이 등급의 적격을 정하는 `TestSpecification` 참조들 — 표준 `TestSpecificationID`. */
+    testSpecificationIds?: string[];
+    /** 등급 속성 — 표준 `EquipmentClassProperty`. */
+    properties?: Record<string, unknown>[];
+    /** 언제부터 유효한가 — 표준 `EffectiveStartDate`. */
+    effectiveStart?: Date;
+    /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. */
+    effectiveEnd?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}

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

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EquipmentClass = 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 `EquipmentClass`**.
+ *
+ * 공정은 특정 설비를 지목하지 않고 등급으로 요구한다 — 「용접기 1대」. 등급이 없으면 그 요구를 적을 수
+ * 없고, 대체 설비를 찾을 수도 없다.
+ *
+ * 구조는 인원 등급과 같다(표준이 셋을 같은 모양으로 정의한다). 옮기는 함수도 같은 것을 쓴다.
+ */
+let EquipmentClass = class EquipmentClass {
+};
+exports.EquipmentClass = EquipmentClass;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], EquipmentClass.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)
+], EquipmentClass.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((klass) => klass.domain),
+    tslib_1.__metadata("design:type", String)
+], EquipmentClass.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], EquipmentClass.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)
+], EquipmentClass.prototype, "description", 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)
+], EquipmentClass.prototype, "baseIds", 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)
+], EquipmentClass.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: 'ResourceProperty[]' }),
+    tslib_1.__metadata("design:type", Array)
+], EquipmentClass.prototype, "properties", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date
+    /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. */
+    )
+], EquipmentClass.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)
+], EquipmentClass.prototype, "effectiveEnd", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], EquipmentClass.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], EquipmentClass.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)
+], EquipmentClass.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((klass) => klass.creator),
+    tslib_1.__metadata("design:type", String)
+], EquipmentClass.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)
+], EquipmentClass.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((klass) => klass.updater),
+    tslib_1.__metadata("design:type", String)
+], EquipmentClass.prototype, "updaterId", void 0);
+exports.EquipmentClass = EquipmentClass = tslib_1.__decorate([
+    (0, typeorm_1.Entity)({ name: 'ops_equipment_class' }),
+    (0, typeorm_1.Index)('ix_ops_equipment_class_0', (klass) => [klass.domain, klass.name], { unique: true }),
+    (0, type_graphql_1.ObjectType)({ description: 'ISA-95 EquipmentClass — a kind of equipment that operations require' })
+], EquipmentClass);
+//# sourceMappingURL=equipment-class.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"equipment-class.js","sourceRoot":"","sources":["../../../server/service/equipment/equipment-class.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, ObjectType } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/**\n * 설비 등급 — **ISA-95 `EquipmentClass`**.\n *\n * 공정은 특정 설비를 지목하지 않고 등급으로 요구한다 — 「용접기 1대」. 등급이 없으면 그 요구를 적을 수\n * 없고, 대체 설비를 찾을 수도 없다.\n *\n * 구조는 인원 등급과 같다(표준이 셋을 같은 모양으로 정의한다). 옮기는 함수도 같은 것을 쓴다.\n */\n@Entity({ name: 'ops_equipment_class' })\n@Index('ix_ops_equipment_class_0', (klass: EquipmentClass) => [klass.domain, klass.name], { unique: true })\n@ObjectType({ description: 'ISA-95 EquipmentClass — a kind of equipment that operations require' })\nexport class EquipmentClass {\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((klass: EquipmentClass) => klass.domain)\n  domainId?: string\n\n  /** 표준 `EquipmentClassID`. */\n  @Column()\n  @Field()\n  name: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  description?: string\n\n  /** 상위 등급들 — 표준 `EquipmentClassBaseID`(복수). 「6축 용접기」가 「용접기」를 상속한다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  baseIds?: string[]\n\n  /** 이 등급의 적격을 정하는 `TestSpecification` 참조들 — 표준 `TestSpecificationID`. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  testSpecificationIds?: string[]\n\n  /** 등급 속성 — 표준 `EquipmentClassProperty`. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'ResourceProperty[]' })\n  properties?: Record<string, unknown>[]\n\n  /** 언제부터 유효한가 — 표준 `EffectiveStartDate`. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveStart?: Date\n\n  /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. */\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((klass: EquipmentClass) => klass.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  updater?: User\n\n  @RelationId((klass: EquipmentClass) => klass.updater)\n  updaterId?: string\n}\n"]}

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

@@ -0,0 +1,77 @@
+import { AppliedWhen } from '../assignment/applied-when';
+import { ListParam } from '@things-factory/shell';
+import { MasterPatch } from '../master-crud';
+import { EquipmentClass } from './equipment-class';
+import { Equipment } from './equipment';
+import { StopReason } from './stop-reason';
+/**
+ * 설비 축을 채우고 고친다.
+ *
+ * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────
+ * 업무 기록과 달리 마스터는 **선언**이다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 지금의
+ * 규정이고, 규정은 바뀐다. 없앨 때 행을 지우지 않고 유효 기간의 끝을 채우는 것이 그래서다 —
+ * 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.
+ *
+ * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다.
+ */
+export declare class EquipmentClassList {
+    items: EquipmentClass[];
+    total: number;
+}
+export declare class EquipmentClassResolver {
+    equipmentClasses(params: ListParam, context: ResolverContext): Promise<EquipmentClassList>;
+    /**
+     * 이 등급에 든 설비들
+     *
+     * 아무도 안 들면 빈 목록이다. 다만 그것이 「없다」인지 「다 못 봤다」인지는 `memberScanCapped`
+     * 가 말한다 — 조용히 자르면 고쳐야 할 선언과 멀쩡한 등급이 같아 보인다.
+     */
+    members(klass: EquipmentClass, context: ResolverContext): Promise<string[]>;
+    /** 소속을 다 보지 못했나. */
+    memberScanCapped(klass: EquipmentClass, context: ResolverContext): Promise<boolean>;
+    /**
+     * 그리드가 보낸 변경을 한 번에 적용한다.
+     *
+     * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을
+     * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
+     * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
+     */
+    updateMultipleEquipmentClass(patches: MasterPatch[], context: ResolverContext): Promise<EquipmentClass[]>;
+}
+export declare class EquipmentList {
+    items: Equipment[];
+    total: number;
+}
+export declare class EquipmentResolver {
+    equipmentList(params: ListParam, context: ResolverContext): Promise<EquipmentList>;
+    /**
+     * 그리드가 보낸 변경을 한 번에 적용한다.
+     *
+     * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을
+     * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
+     * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
+     */
+    updateMultipleEquipment(patches: MasterPatch[], context: ResolverContext, 
+    /**
+     * **언제부터 그러한가** — 배정·선언 칸을 고칠 때만 온다.
+     *
+     * 안 오면 지금부터다. 미래면 주장만 남고 본행은 그 시각이 올 때까지 그대로다
+     * (§`claimAssignmentChanges`).
+     */
+    applied?: AppliedWhen): Promise<Equipment[]>;
+}
+export declare class StopReasonList {
+    items: StopReason[];
+    total: number;
+}
+export declare class StopReasonResolver {
+    stopReasonList(params: ListParam, context: ResolverContext): Promise<StopReasonList>;
+    /**
+     * 그리드가 보낸 변경을 한 번에 적용한다.
+     *
+     * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을
+     * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
+     * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
+     */
+    updateMultipleStopReason(patches: MasterPatch[], context: ResolverContext): Promise<StopReason[]>;
+}