@things-factory/ops-master 10.1.35 → 10.1.37

package/dist-server/service/assignment/assignment-write.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimedField = void 0;
+exports.claimAssignmentChanges = claimAssignmentChanges;
+exports.toClaimValue = toClaimValue;
+exports.rowOf = rowOf;
+const master_value_claim_1 = require("./master-value-claim");
+Object.defineProperty(exports, "claimedField", { enumerable: true, get: function () { return master_value_claim_1.claimedField; } });
+const master_axis_1 = require("../master-axis");
+const assignment_history_1 = require("./assignment-history");
+/**
+ * 그리드가 보낸 변경에서 **배정·선언 칸을 골라 주장으로 남긴다.**
+ *
+ * ── 왜 본행을 되돌려 놓나 ──────────────────────────────────────────────────
+ * 적용 시각이 미래면 **본행은 그대로여야 한다.** 그리드는 값을 보냈지만 그것은 「다음 달부터」라는
+ * 뜻이고, 오늘의 값이 아니다. 그래서 `keepOnRow` 로 옛 값을 되돌려 저장에 얹는다 — 도래하면
+ * `projectDueClaims` 가 옮긴다.
+ *
+ * ── 마스터 변경과 한 트랜잭션이다 ──────────────────────────────────────────
+ * 부르는 쪽이 `saveMasterPatches` 안이므로 같은 `manager` 다. 갈라지면 값은 바뀌고 이력은 없는
+ * 상태가 생긴다.
+ */
+async function claimAssignmentChanges(manager, domain, axis, found, values, user, options) {
+    const keepOnRow = {};
+    const fields = master_value_claim_1.CLAIMED_FIELDS.filter(one => one.axis === axis);
+    if (!fields.length) {
+        return { keepOnRow };
+    }
+    const now = new Date();
+    const appliedAt = options.appliedAt ?? now;
+    const future = appliedAt.getTime() > now.getTime();
+    for (const declared of fields) {
+        if (!(declared.field in values)) {
+            continue;
+        }
+        const next = values[declared.field];
+        /* 안 바뀐 칸은 주장을 남기지 않는다 — 같은 값을 다시 적으면 이력이 뜻 없이 길어진다. */
+        if (sameValue(found[declared.field], next)) {
+            continue;
+        }
+        await (0, assignment_history_1.recordClaim)(manager, domain, {
+            target: { axis, rowId: String(found.id), field: declared.field },
+            value: await toClaimValue(manager, domain, declared, next),
+            /* 바뀌기 전 값 — 첫 주장이면 그 앞을 덮는 줄이 같이 선다(§`recordClaim`). */
+            previous: await toClaimValue(manager, domain, declared, found[declared.field]),
+            validFrom: appliedAt,
+            validTo: options.appliedUntil,
+            reason: options.appliedKind === 'correction' ? 'correction' : 'change',
+            recorder: user
+        }, now);
+        if (future) {
+            keepOnRow[declared.field] = found[declared.field] ?? null;
+        }
+    }
+    return { keepOnRow };
+}
+/**
+ * 마스터 칸의 값 → 주장의 값. 「선언 없음」은 `null` 이다.
+ *
+ * ⚠ **관계 칸은 UUID 가 아니라 이름을 담는다.** `ops_equipment.home_location` 에 `UNCOIL-01` 이
+ * 들어 있고, `parentId` 는 id 일 수도 이름일 수도 있다(이 제품의 규약). 처음에 칸 값을 그대로
+ * 식별자로 썼다가 **정상 편집이 전부 거절됐다**(2026-09-22, 화면에서 드러남).
+ *
+ * 그래서 여기서 **가리키는 행을 찾아 식별자와 그때의 이름을 함께 담는다.** 마스터 칸은 그대로
+ * 이름을 들고, 주장은 이름이 바뀌어도 안 끊긴다.
+ */
+async function toClaimValue(manager, domain, declared, value) {
+    if (value === null || value === undefined || value === '') {
+        return null;
+    }
+    /* 값 그 자체인 칸 — 가리키는 것이 없으므로 푸는 일도 없다. */
+    if (declared.kind === 'literal') {
+        return { literal: String(value) };
+    }
+    if (declared.kind === 'names') {
+        return { names: Array.isArray(value) ? value.map(String) : [String(value)] };
+    }
+    const found = await rowOf(manager, domain, declared.target, String(value));
+    /* 못 찾으면 그대로 담는다 — 검증이 그 다음에 거절한다. 여기서 지어내지 않는다. */
+    return found ? { ref: found.id, label: found.name } : { ref: String(value) };
+}
+/** 이름으로도 id 로도 찾는다 — 이 제품의 관계 칸이 둘 다 담는다. */
+async function rowOf(manager, domain, targetAxis, given) {
+    const axis = master_axis_1.MASTER_AXES.find(one => one.key === targetAxis);
+    if (!axis) {
+        return undefined;
+    }
+    const byId = UUID.test(given)
+        ? await manager.findOne(axis.entity, { where: { id: given, domain: { id: domain.id } } })
+        : undefined;
+    const found = byId ?? (await manager.findOne(axis.entity, { where: { name: given, domain: { id: domain.id } } }));
+    return found;
+}
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function sameValue(before, after) {
+    if (Array.isArray(before) || Array.isArray(after)) {
+        return JSON.stringify(before ?? null) === JSON.stringify(after ?? null);
+    }
+    return (before ?? null) === (after ?? null);
+}
+//# sourceMappingURL=assignment-write.js.map

package/dist-server/service/assignment/assignment-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-write.js","sourceRoot":"","sources":["../../../server/service/assignment/assignment-write.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, ObjectLiteral } from 'typeorm'\nimport { Domain } from '@things-factory/shell'\n\nimport { CLAIMED_FIELDS, claimedField } from './master-value-claim'\nimport { MASTER_AXES } from '../master-axis'\nimport { recordClaim } from './assignment-history'\n\n/**\n * 그리드가 보낸 변경에서 **배정·선언 칸을 골라 주장으로 남긴다.**\n *\n * ── 왜 본행을 되돌려 놓나 ──────────────────────────────────────────────────\n * 적용 시각이 미래면 **본행은 그대로여야 한다.** 그리드는 값을 보냈지만 그것은 「다음 달부터」라는\n * 뜻이고, 오늘의 값이 아니다. 그래서 `keepOnRow` 로 옛 값을 되돌려 저장에 얹는다 — 도래하면\n * `projectDueClaims` 가 옮긴다.\n *\n * ── 마스터 변경과 한 트랜잭션이다 ──────────────────────────────────────────\n * 부르는 쪽이 `saveMasterPatches` 안이므로 같은 `manager` 다. 갈라지면 값은 바뀌고 이력은 없는\n * 상태가 생긴다.\n */\nexport async function claimAssignmentChanges(\n  manager: EntityManager,\n  domain: Domain,\n  axis: string,\n  found: ObjectLiteral,\n  values: ObjectLiteral,\n  user: unknown,\n  options: { appliedAt?: Date; appliedKind?: 'change' | 'correction'; appliedUntil?: Date }\n): Promise<{ keepOnRow: ObjectLiteral }> {\n  const keepOnRow: ObjectLiteral = {}\n  const fields = CLAIMED_FIELDS.filter(one => one.axis === axis)\n\n  if (!fields.length) {\n    return { keepOnRow }\n  }\n\n  const now = new Date()\n  const appliedAt = options.appliedAt ?? now\n  const future = appliedAt.getTime() > now.getTime()\n\n  for (const declared of fields) {\n    if (!(declared.field in values)) {\n      continue\n    }\n\n    const next = values[declared.field]\n\n    /* 안 바뀐 칸은 주장을 남기지 않는다 — 같은 값을 다시 적으면 이력이 뜻 없이 길어진다. */\n    if (sameValue(found[declared.field], next)) {\n      continue\n    }\n\n    await recordClaim(\n      manager,\n      domain,\n      {\n        target: { axis, rowId: String(found.id), field: declared.field },\n        value: await toClaimValue(manager, domain, declared, next),\n        /* 바뀌기 전 값 — 첫 주장이면 그 앞을 덮는 줄이 같이 선다(§`recordClaim`). */\n        previous: await toClaimValue(manager, domain, declared, found[declared.field]),\n        validFrom: appliedAt,\n        validTo: options.appliedUntil,\n        reason: options.appliedKind === 'correction' ? 'correction' : 'change',\n        recorder: user\n      },\n      now\n    )\n\n    if (future) {\n      keepOnRow[declared.field] = found[declared.field] ?? null\n    }\n  }\n\n  return { keepOnRow }\n}\n\n/**\n * 마스터 칸의 값 → 주장의 값. 「선언 없음」은 `null` 이다.\n *\n * ⚠ **관계 칸은 UUID 가 아니라 이름을 담는다.** `ops_equipment.home_location` 에 `UNCOIL-01` 이\n * 들어 있고, `parentId` 는 id 일 수도 이름일 수도 있다(이 제품의 규약). 처음에 칸 값을 그대로\n * 식별자로 썼다가 **정상 편집이 전부 거절됐다**(2026-09-22, 화면에서 드러남).\n *\n * 그래서 여기서 **가리키는 행을 찾아 식별자와 그때의 이름을 함께 담는다.** 마스터 칸은 그대로\n * 이름을 들고, 주장은 이름이 바뀌어도 안 끊긴다.\n */\nexport async function toClaimValue(\n  manager: EntityManager,\n  domain: Domain,\n  declared: { kind: 'relation' | 'names' | 'literal'; target?: string },\n  value: unknown\n): Promise<Record<string, unknown> | null> {\n  if (value === null || value === undefined || value === '') {\n    return null\n  }\n\n  /* 값 그 자체인 칸 — 가리키는 것이 없으므로 푸는 일도 없다. */\n  if (declared.kind === 'literal') {\n    return { literal: String(value) }\n  }\n\n  if (declared.kind === 'names') {\n    return { names: Array.isArray(value) ? value.map(String) : [String(value)] }\n  }\n\n  const found = await rowOf(manager, domain, declared.target, String(value))\n\n  /* 못 찾으면 그대로 담는다 — 검증이 그 다음에 거절한다. 여기서 지어내지 않는다. */\n  return found ? { ref: found.id, label: found.name } : { ref: String(value) }\n}\n\n/** 이름으로도 id 로도 찾는다 — 이 제품의 관계 칸이 둘 다 담는다. */\nexport async function rowOf(\n  manager: EntityManager,\n  domain: Domain,\n  targetAxis: string | undefined,\n  given: string\n): Promise<{ id: string; name: string } | undefined> {\n  const axis = MASTER_AXES.find(one => one.key === targetAxis)\n\n  if (!axis) {\n    return undefined\n  }\n\n  const byId = UUID.test(given)\n    ? await manager.findOne(axis.entity as never, { where: { id: given, domain: { id: domain.id } } } as never)\n    : undefined\n\n  const found = byId ?? (await manager.findOne(axis.entity as never, { where: { name: given, domain: { id: domain.id } } } as never))\n\n  return found as unknown as { id: string; name: string } | undefined\n}\n\nconst UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\nfunction sameValue(before: unknown, after: unknown): boolean {\n  if (Array.isArray(before) || Array.isArray(after)) {\n    return JSON.stringify(before ?? null) === JSON.stringify(after ?? null)\n  }\n\n  return (before ?? null) === (after ?? null)\n}\n\nexport { claimedField }\n"]}

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-master-resolver.d.ts

@@ -1,3 +1,4 @@
+import { AppliedWhen } from '../assignment/applied-when';
 import { ListParam } from '@things-factory/shell';
 import { MasterPatch } from '../master-crud';
 import { EquipmentClass } from './equipment-class';
@@ -50,7 +51,14 @@ export declare class EquipmentResolver {
      * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
      * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
      */
-    updateMultipleEquipment(patches: MasterPatch[], context: ResolverContext): Promise<Equipment[]>;
+    updateMultipleEquipment(patches: MasterPatch[], context: ResolverContext, 
+    /**
+     * **언제부터 그러한가** — 배정·선언 칸을 고칠 때만 온다.
+     *
+     * 안 오면 지금부터다. 미래면 주장만 남고 본행은 그 시각이 올 때까지 그대로다
+     * (§`claimAssignmentChanges`).
+     */
+    applied?: AppliedWhen): Promise<Equipment[]>;
 }
 export declare class StopReasonList {
     items: StopReason[];

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StopReasonResolver = exports.StopReasonList = exports.EquipmentResolver = exports.EquipmentList = exports.EquipmentClassResolver = exports.EquipmentClassList = void 0;
 const tslib_1 = require("tslib");
 const type_graphql_1 = require("type-graphql");
+const applied_when_1 = require("../assignment/applied-when");
 const shell_1 = require("@things-factory/shell");
 const type_graphql_2 = require("type-graphql");
 const state_period_rules_js_1 = require("./state-period-rules.js");
@@ -153,11 +154,12 @@ let EquipmentResolver = class EquipmentResolver {
      * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
      * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
      */
-    async updateMultipleEquipment(patches, context) {
+    async updateMultipleEquipment(patches, context, applied) {
         const { domain, user, tx } = context.state;
         const axis = (0, master_axis_1.masterAxisOf)('equipment');
         const saved = await (0, master_crud_1.saveMasterPatches)(tx, domain, axis.entity, patches, user, {
-            hasEffectivePeriod: axis.hasEffectivePeriod
+            hasEffectivePeriod: axis.hasEffectivePeriod,
+            ...(0, applied_when_1.appliedOptions)(applied)
         });
         return saved;
     }
@@ -178,8 +180,9 @@ tslib_1.__decorate([
     (0, type_graphql_2.Mutation)(returns => [equipment_1.Equipment], { description: 'To create, change or retire equipment' }),
     tslib_1.__param(0, (0, type_graphql_2.Arg)('patches', type => [shell_2.ScalarObject])),
     tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
+    tslib_1.__param(2, (0, type_graphql_2.Arg)('applied', type => shell_2.ScalarObject, { nullable: true })),
     tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [Array, Object]),
+    tslib_1.__metadata("design:paramtypes", [Array, Object, Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], EquipmentResolver.prototype, "updateMultipleEquipment", null);
 exports.EquipmentResolver = EquipmentResolver = tslib_1.__decorate([

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

@@ -1 +1 @@
-{"version":3,"file":"equipment-master-resolver.js","sourceRoot":"","sources":["../../../server/service/equipment/equipment-master-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { UseMiddleware } from 'type-graphql'\nimport { SpeakRefusals } from '@things-factory/shell'\nimport { FieldResolver, Root, Args, Arg, Ctx, Directive, Int, Mutation, ObjectType, Field, Query, Resolver } from 'type-graphql'\nimport { stopReasonStatusGap } from './state-period-rules.js'\n\nimport { Domain, ListParam, ScalarObject } from '@things-factory/shell'\n\nimport { MasterPatch, saveMasterPatches } from '../master-crud'\nimport { masterAxisOf } from '../master-axis'\nimport { listMaster } from '../master-list'\nimport { ClassMembers, scanClassMembers } from '../resource/class-members'\nimport { EquipmentClass } from './equipment-class'\nimport { Equipment } from './equipment'\nimport { StopReason } from './stop-reason'\n\n/**\n * 설비 축을 채우고 고친다.\n *\n * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────\n * 업무 기록과 달리 마스터는 **선언**이다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 지금의\n * 규정이고, 규정은 바뀐다. 없앨 때 행을 지우지 않고 유효 기간의 끝을 채우는 것이 그래서다 —\n * 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.\n *\n * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다.\n */\n\n@ObjectType({ description: 'A page of equipment classes' })\nexport class EquipmentClassList {\n  @Field(type => [EquipmentClass])\n  items: EquipmentClass[]\n\n  @Field(type => Int)\n  total: number\n}\n\n/**\n * **이 등급에 무엇이 드나** — 들어오는 관계.\n *\n * 등급을 만들어 놓고 아무도 안 들어 있는 일이 실제로 있었다. 화면에는 등급 이름만 있어서 그 사실이\n * 안 보였다. 없앨 때 무엇이 딸려 자격을 잃는지도 알 수 없었다.\n *\n * 세는 방식과 상한은 `class-members.ts` 머리말에 적었다 — 등급 넷이 같은 함수를 쓴다.\n */\nfunction equipmentClassMembersOf(context: ResolverContext): Promise<ClassMembers> {\n  const state = context.state as { domain: Domain; equipmentClassMembers?: Promise<ClassMembers> }\n\n  state.equipmentClassMembers = state.equipmentClassMembers || scanClassMembers(Equipment, 'equipmentClassIds', state.domain)\n\n  return state.equipmentClassMembers\n}\n\n@Resolver(EquipmentClass)\n@UseMiddleware(SpeakRefusals)\nexport class EquipmentClassResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => EquipmentClassList, { description: 'To fetch equipment classes' })\n  async equipmentClasses(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<EquipmentClassList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('equipmentClass', params, domain)\n\n    return { items: items as EquipmentClass[], total }\n  }\n\n  /**\n   * 이 등급에 든 설비들\n   *\n   * 아무도 안 들면 빈 목록이다. 다만 그것이 「없다」인지 「다 못 봤다」인지는 `memberScanCapped`\n   * 가 말한다 — 조용히 자르면 고쳐야 할 선언과 멀쩡한 등급이 같아 보인다.\n   */\n  @FieldResolver(type => [String], { description: 'Equipment belonging to this class' })\n  async members(@Root() klass: EquipmentClass, @Ctx() context: ResolverContext): Promise<string[]> {\n    return (await equipmentClassMembersOf(context)).members.get(klass.name) ?? []\n  }\n\n  /** 소속을 다 보지 못했나. */\n  @FieldResolver(type => Boolean, { description: 'True when members were too many to scan fully' })\n  async memberScanCapped(@Root() klass: EquipmentClass, @Ctx() context: ResolverContext): Promise<boolean> {\n    return (await equipmentClassMembersOf(context)).capped\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [EquipmentClass], { description: 'To create, change or retire equipment classes' })\n  async updateMultipleEquipmentClass(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<EquipmentClass[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('equipmentClass')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as EquipmentClass[]\n  }\n}\n\n@ObjectType({ description: 'A page of equipment' })\nexport class EquipmentList {\n  @Field(type => [Equipment])\n  items: Equipment[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@Resolver(Equipment)\n@UseMiddleware(SpeakRefusals)\nexport class EquipmentResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => EquipmentList, { description: 'To fetch equipment' })\n  async equipmentList(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<EquipmentList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('equipment', params, domain)\n\n    return { items: items as Equipment[], total }\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [Equipment], { description: 'To create, change or retire equipment' })\n  async updateMultipleEquipment(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<Equipment[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('equipment')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as Equipment[]\n  }\n}\n\n@ObjectType({ description: 'A page of stop reasons' })\nexport class StopReasonList {\n  @Field(type => [StopReason])\n  items: StopReason[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@Resolver(StopReason)\n@UseMiddleware(SpeakRefusals)\nexport class StopReasonResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => StopReasonList, { description: 'To fetch stop reasons' })\n  async stopReasonList(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<StopReasonList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('stopReason', params, domain)\n\n    return { items: items as StopReason[], total }\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [StopReason], { description: 'To create, change or retire stop reasons' })\n  async updateMultipleStopReason(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<StopReason[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('stopReason')\n\n    /*\n     * **모르는 상태로는 저장하지 않는다.** 이 값이 가동률을 깎느냐 마느냐를 정하므로, 목록 밖 값이\n     * 들어오면 그 사유를 쓴 구간이 전부 어긋남으로 걸린다 — 잘못은 여기서 났는데 불은 거기서 켜진다.\n     *\n     * 지우는 패치(`retire`)는 상태를 다시 말하지 않으므로 값이 있을 때만 본다.\n     */\n    for (const patch of patches) {\n      const said = (patch as any)?.status\n      if (said === undefined || said === null) continue\n\n      const gap = stopReasonStatusGap(said)\n      if (gap) throw new Error(`정지 사유 \"${(patch as any)?.name ?? ''}\" — ${gap}`)\n    }\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as StopReason[]\n  }\n}\n"]}
+{"version":3,"file":"equipment-master-resolver.js","sourceRoot":"","sources":["../../../server/service/equipment/equipment-master-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { UseMiddleware } from 'type-graphql'\nimport { AppliedWhen, appliedOptions } from '../assignment/applied-when'\nimport { SpeakRefusals } from '@things-factory/shell'\nimport { FieldResolver, Root, Args, Arg, Ctx, Directive, Int, Mutation, ObjectType, Field, Query, Resolver } from 'type-graphql'\nimport { stopReasonStatusGap } from './state-period-rules.js'\n\nimport { Domain, ListParam, ScalarObject } from '@things-factory/shell'\n\nimport { MasterPatch, saveMasterPatches } from '../master-crud'\nimport { masterAxisOf } from '../master-axis'\nimport { listMaster } from '../master-list'\nimport { ClassMembers, scanClassMembers } from '../resource/class-members'\nimport { EquipmentClass } from './equipment-class'\nimport { Equipment } from './equipment'\nimport { StopReason } from './stop-reason'\n\n/**\n * 설비 축을 채우고 고친다.\n *\n * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────\n * 업무 기록과 달리 마스터는 **선언**이다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 지금의\n * 규정이고, 규정은 바뀐다. 없앨 때 행을 지우지 않고 유효 기간의 끝을 채우는 것이 그래서다 —\n * 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.\n *\n * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다.\n */\n\n@ObjectType({ description: 'A page of equipment classes' })\nexport class EquipmentClassList {\n  @Field(type => [EquipmentClass])\n  items: EquipmentClass[]\n\n  @Field(type => Int)\n  total: number\n}\n\n/**\n * **이 등급에 무엇이 드나** — 들어오는 관계.\n *\n * 등급을 만들어 놓고 아무도 안 들어 있는 일이 실제로 있었다. 화면에는 등급 이름만 있어서 그 사실이\n * 안 보였다. 없앨 때 무엇이 딸려 자격을 잃는지도 알 수 없었다.\n *\n * 세는 방식과 상한은 `class-members.ts` 머리말에 적었다 — 등급 넷이 같은 함수를 쓴다.\n */\nfunction equipmentClassMembersOf(context: ResolverContext): Promise<ClassMembers> {\n  const state = context.state as { domain: Domain; equipmentClassMembers?: Promise<ClassMembers> }\n\n  state.equipmentClassMembers = state.equipmentClassMembers || scanClassMembers(Equipment, 'equipmentClassIds', state.domain)\n\n  return state.equipmentClassMembers\n}\n\n@Resolver(EquipmentClass)\n@UseMiddleware(SpeakRefusals)\nexport class EquipmentClassResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => EquipmentClassList, { description: 'To fetch equipment classes' })\n  async equipmentClasses(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<EquipmentClassList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('equipmentClass', params, domain)\n\n    return { items: items as EquipmentClass[], total }\n  }\n\n  /**\n   * 이 등급에 든 설비들\n   *\n   * 아무도 안 들면 빈 목록이다. 다만 그것이 「없다」인지 「다 못 봤다」인지는 `memberScanCapped`\n   * 가 말한다 — 조용히 자르면 고쳐야 할 선언과 멀쩡한 등급이 같아 보인다.\n   */\n  @FieldResolver(type => [String], { description: 'Equipment belonging to this class' })\n  async members(@Root() klass: EquipmentClass, @Ctx() context: ResolverContext): Promise<string[]> {\n    return (await equipmentClassMembersOf(context)).members.get(klass.name) ?? []\n  }\n\n  /** 소속을 다 보지 못했나. */\n  @FieldResolver(type => Boolean, { description: 'True when members were too many to scan fully' })\n  async memberScanCapped(@Root() klass: EquipmentClass, @Ctx() context: ResolverContext): Promise<boolean> {\n    return (await equipmentClassMembersOf(context)).capped\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [EquipmentClass], { description: 'To create, change or retire equipment classes' })\n  async updateMultipleEquipmentClass(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<EquipmentClass[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('equipmentClass')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as EquipmentClass[]\n  }\n}\n\n@ObjectType({ description: 'A page of equipment' })\nexport class EquipmentList {\n  @Field(type => [Equipment])\n  items: Equipment[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@Resolver(Equipment)\n@UseMiddleware(SpeakRefusals)\nexport class EquipmentResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => EquipmentList, { description: 'To fetch equipment' })\n  async equipmentList(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<EquipmentList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('equipment', params, domain)\n\n    return { items: items as Equipment[], total }\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [Equipment], { description: 'To create, change or retire equipment' })\n  async updateMultipleEquipment(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext,\n    /**\n     * **언제부터 그러한가** — 배정·선언 칸을 고칠 때만 온다.\n     *\n     * 안 오면 지금부터다. 미래면 주장만 남고 본행은 그 시각이 올 때까지 그대로다\n     * (§`claimAssignmentChanges`).\n     */\n    @Arg('applied', type => ScalarObject, { nullable: true }) applied?: AppliedWhen\n  ): Promise<Equipment[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('equipment')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod,\n      ...appliedOptions(applied)\n    })\n\n    return saved as Equipment[]\n  }\n}\n\n@ObjectType({ description: 'A page of stop reasons' })\nexport class StopReasonList {\n  @Field(type => [StopReason])\n  items: StopReason[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@Resolver(StopReason)\n@UseMiddleware(SpeakRefusals)\nexport class StopReasonResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => StopReasonList, { description: 'To fetch stop reasons' })\n  async stopReasonList(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<StopReasonList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('stopReason', params, domain)\n\n    return { items: items as StopReason[], total }\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [StopReason], { description: 'To create, change or retire stop reasons' })\n  async updateMultipleStopReason(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<StopReason[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('stopReason')\n\n    /*\n     * **모르는 상태로는 저장하지 않는다.** 이 값이 가동률을 깎느냐 마느냐를 정하므로, 목록 밖 값이\n     * 들어오면 그 사유를 쓴 구간이 전부 어긋남으로 걸린다 — 잘못은 여기서 났는데 불은 거기서 켜진다.\n     *\n     * 지우는 패치(`retire`)는 상태를 다시 말하지 않으므로 값이 있을 때만 본다.\n     */\n    for (const patch of patches) {\n      const said = (patch as any)?.status\n      if (said === undefined || said === null) continue\n\n      const gap = stopReasonStatusGap(said)\n      if (gap) throw new Error(`정지 사유 \"${(patch as any)?.name ?? ''}\" — ${gap}`)\n    }\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as StopReason[]\n  }\n}\n"]}

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

@@ -10,6 +10,7 @@ export * from './test-spec/test-spec-master-resolver';
 export * from './master-crud';
 export * from './master-axis';
 export * from './master-change-policy';
+export * from './approval-route';
 export * from './master-conformance';
 export * from './master-conformance-resolver';
 export * from './master-list';
@@ -67,7 +68,11 @@ export * from './status/master-status';
 export * from './quality/nonconformance-cause';
 import { MasterConformanceResolver } from './master-conformance-resolver';
 import { MasterChangePolicy, MasterChangePolicyResolver } from './master-change-policy';
-export declare const entities: (typeof import("./equipment/equipment").Equipment | typeof import("./equipment/equipment-class").EquipmentClass | typeof import("./quality/nonconformance-cause").NonconformanceCause | typeof import("./material/material-definition").MaterialDefinition | typeof import("./operation/operation-definition").OperationDefinition | typeof import("./location/operational-location").OperationalLocation | typeof import("./personnel/person").Person | typeof import("./asset/physical-asset").PhysicalAsset | typeof import("./recipe").RecipeDefinition | typeof import("./recipe").RouteDefinition | typeof import("./test-spec/test-specification").TestSpecification | typeof MasterChangePolicy | typeof import("./recipe/recipe-revision-line").RecipeRevisionOutput | typeof import("./recipe/recipe-revision").RecipeRevision | typeof import("./recipe/recipe-revision").RecipePlan | typeof import("./recipe/recipe-revision").RecipeSegment | typeof import("./recipe/recipe-revision").RecipeBasis | typeof import("./material/material-revision").MaterialDefinitionRevision | typeof import("./material/material-revision").MaterialDefinitionPlan | typeof import("./material/material-revision").MaterialDefinitionSegment | typeof import("./material/material-revision").MaterialDefinitionBasis | typeof import("./test-spec/test-spec-revision").TestSpecificationRevision | typeof import("./test-spec/test-spec-revision").TestSpecificationPlan | typeof import("./test-spec/test-spec-revision").TestSpecificationSegment | typeof import("./test-spec/test-spec-revision").TestSpecificationBasis)[];
+import { MasterValueClaim } from './assignment/master-value-claim';
+export declare const entities: (typeof import("./equipment/equipment").Equipment | typeof import("./equipment/equipment-class").EquipmentClass | typeof import("./quality/nonconformance-cause").NonconformanceCause | typeof import("./material/material-definition").MaterialDefinition | typeof import("./operation/operation-definition").OperationDefinition | typeof import("./location/operational-location").OperationalLocation | typeof import("./personnel/person").Person | typeof import("./asset/physical-asset").PhysicalAsset | typeof import("./recipe").RecipeDefinition | typeof import("./recipe").RouteDefinition | typeof import("./test-spec/test-specification").TestSpecification | typeof MasterChangePolicy | typeof MasterValueClaim | typeof import("./recipe/recipe-revision-line").RecipeRevisionOutput | typeof import("./recipe/recipe-revision").RecipeRevision | typeof import("./recipe/recipe-revision").RecipePlan | typeof import("./recipe/recipe-revision").RecipeSegment | typeof import("./recipe/recipe-revision").RecipeBasis | typeof import("./material/material-revision").MaterialDefinitionRevision | typeof import("./material/material-revision").MaterialDefinitionPlan | typeof import("./material/material-revision").MaterialDefinitionSegment | typeof import("./material/material-revision").MaterialDefinitionBasis | typeof import("./test-spec/test-spec-revision").TestSpecificationRevision | typeof import("./test-spec/test-spec-revision").TestSpecificationPlan | typeof import("./test-spec/test-spec-revision").TestSpecificationSegment | typeof import("./test-spec/test-spec-revision").TestSpecificationBasis)[];
 export declare const schema: {
     resolverClasses: (typeof MasterChangePolicyResolver | typeof import("./personnel/personnel-master-resolver").PersonnelClassResolver | typeof import("./personnel/personnel-master-resolver").PersonResolver | typeof import("./equipment/equipment-master-resolver").EquipmentClassResolver | typeof import("./equipment/equipment-master-resolver").EquipmentResolver | typeof import("./equipment/equipment-master-resolver").StopReasonResolver | typeof import("./asset/asset-master-resolver").PhysicalAssetClassResolver | typeof import("./asset/asset-master-resolver").PhysicalAssetResolver | typeof import("./material/material-master-resolver").MaterialClassResolver | typeof import("./material/material-master-resolver").MaterialDefinitionResolver | typeof import("./location/location-master-resolver").OperationalLocationResolver | typeof import("./operation/operation-master-resolver").OperationDefinitionResolver | typeof import("./recipe/recipe-master-resolver").RecipeDefinitionResolver | typeof import("./recipe/recipe-master-resolver").RouteDefinitionResolver | typeof import("./test-spec/test-spec-master-resolver").TestSpecificationResolver | typeof MasterConformanceResolver | typeof import("./personnel/personnel-query").PersonnelQuery | typeof import("./equipment/equipment-query").EquipmentQuery | typeof import("./asset/asset-query").AssetQuery | typeof import("./location/location-query").LocationQuery | typeof import("./material/material-revision-resolver").MaterialDefinitionRevisionResolver | typeof import("./material/material-query").MaterialQuery | typeof import("./operation/operation-query").OperationQuery | typeof import("./operation/operation-readiness-resolver").OperationReadinessResolver | typeof import("./recipe/recipe-revision-resolver").RecipeRevisionResolver | typeof import("./recipe/recipe-query").RecipeQuery | typeof import("./test-spec/test-spec-revision-resolver").TestSpecificationRevisionResolver | typeof import("./test-spec/test-spec-query").TestSpecificationQuery | typeof import("./status/master-status").OpsMasterStatusQuery | typeof import("./equipment/stop-reason-query").StopReasonQuery | typeof import("./quality/nonconformance-cause-resolver").NonconformanceCauseResolver)[];
 };
+export * from './assignment/master-value-claim';
+export * from './assignment/assignment-history';
+export * from './assignment/assignment-write';