@things-factory/ops-master 10.1.35 → 10.1.36

package/dist-server/service/assignment/applied-when.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 화면이 「언제부터」를 말하는 모양.
+ *
+ * ── 왜 날짜 칸 하나가 아닌가 ───────────────────────────────────────────────
+ * 과거 시각을 받으면 그것이 **지연 기록**인지 **이미 적은 것의 정정**인지 알 수 없다. 둘은 다른
+ * 일이다 — 앞은 「그때 옮겼는데 이제 적는다」이고 뒤는 「그때 적은 것이 틀렸다」다. 이력이 그
+ * 구분을 들어야 나중에 「무엇이 왜 바뀌었나」에 답한다.
+ *
+ * **기록 시각은 여기 없다.** 사람이 넣지 않고 서버가 붙인다.
+ */
+export interface AppliedWhen {
+    /** 언제부터. 없으면 지금부터다. */
+    at?: string;
+    /** 과거일 때 — 지연 기록인가 정정인가. 없으면 지연 기록으로 본다. */
+    kind?: 'change' | 'correction';
+    /** 정정이면 어느 구간까지인가. */
+    until?: string;
+}
+/** 화면이 준 것을 `saveMasterPatches` 의 선택지로. */
+export declare function appliedOptions(applied?: AppliedWhen): {
+    appliedUntil?: Date;
+    appliedKind?: "change" | "correction";
+    appliedAt?: Date;
+};

package/dist-server/service/assignment/applied-when.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appliedOptions = appliedOptions;
+const when = (said) => (said ? new Date(said) : undefined);
+/** 화면이 준 것을 `saveMasterPatches` 의 선택지로. */
+function appliedOptions(applied) {
+    if (!applied) {
+        return {};
+    }
+    return {
+        ...(applied.at ? { appliedAt: when(applied.at) } : {}),
+        ...(applied.kind ? { appliedKind: applied.kind } : {}),
+        ...(applied.until ? { appliedUntil: when(applied.until) } : {})
+    };
+}
+//# sourceMappingURL=applied-when.js.map

package/dist-server/service/assignment/applied-when.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applied-when.js","sourceRoot":"","sources":["../../../server/service/assignment/applied-when.ts"],"names":[],"mappings":";;AAsBA,wCAUC;AAbD,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AAEnE,2CAA2C;AAC3C,SAAgB,cAAc,CAAC,OAAqB;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAA;AACH,CAAC","sourcesContent":["/**\n * 화면이 「언제부터」를 말하는 모양.\n *\n * ── 왜 날짜 칸 하나가 아닌가 ───────────────────────────────────────────────\n * 과거 시각을 받으면 그것이 **지연 기록**인지 **이미 적은 것의 정정**인지 알 수 없다. 둘은 다른\n * 일이다 — 앞은 「그때 옮겼는데 이제 적는다」이고 뒤는 「그때 적은 것이 틀렸다」다. 이력이 그\n * 구분을 들어야 나중에 「무엇이 왜 바뀌었나」에 답한다.\n *\n * **기록 시각은 여기 없다.** 사람이 넣지 않고 서버가 붙인다.\n */\nexport interface AppliedWhen {\n  /** 언제부터. 없으면 지금부터다. */\n  at?: string\n  /** 과거일 때 — 지연 기록인가 정정인가. 없으면 지연 기록으로 본다. */\n  kind?: 'change' | 'correction'\n  /** 정정이면 어느 구간까지인가. */\n  until?: string\n}\n\nconst when = (said?: string) => (said ? new Date(said) : undefined)\n\n/** 화면이 준 것을 `saveMasterPatches` 의 선택지로. */\nexport function appliedOptions(applied?: AppliedWhen) {\n  if (!applied) {\n    return {}\n  }\n\n  return {\n    ...(applied.at ? { appliedAt: when(applied.at) } : {}),\n    ...(applied.kind ? { appliedKind: applied.kind } : {}),\n    ...(applied.until ? { appliedUntil: when(applied.until) } : {})\n  }\n}\n"]}

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

@@ -0,0 +1,111 @@
+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 AssignmentClaim {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** 어느 축의 무엇인가 — `equipment` · `operationalLocation`. */
+    axis: string;
+    /** 그 축의 어느 행인가. UUID 다. */
+    rowId: string;
+    /** 어느 칸인가 — 선언한 셋만 온다(§`ASSIGNMENT_FIELDS`). */
+    field: string;
+    /**
+     * 그때의 값.
+     *
+     * ```
+     * { ref, label }      관계를 가리키는 칸 — 식별자와 그때의 표시값
+     * { names: [...] }    이름 목록을 드는 칸 — 근무조 선언
+     * null                **선언 없음.** 「그때부터 부모가 없다」는 정상 값이고 결측이 아니다
+     * ```
+     */
+    value?: Record<string, unknown> | null;
+    /** 언제부터 그러했나 — 업무의 시간. */
+    validFrom: Date;
+    /** 언제까지. 비면 아직 끝나지 않았다. */
+    validTo?: Date;
+    /** 언제 그렇게 적었나. 서버가 붙인다 — 사람이 넣지 않는다. */
+    recordedAt: Date;
+    /** 언제 물러났나. 비면 지금도 서 있는 주장이다. */
+    supersededAt?: Date;
+    /**
+     * 왜 이 주장이 섰나 — 읽는 사람이 「지연 기록인가 정정인가」를 알아야 한다.
+     *
+     * ```
+     * initial     도입 시각에 확인된 초기 상태
+     * change      바꾼다는 선언
+     * correction  이미 적은 것을 고친다
+     * remainder   정정이 남긴 앞뒤 조각
+     * ```
+     */
+    reason: string;
+    recorder?: User;
+    recorderId?: string;
+    createdAt?: Date;
+}
+/**
+ * **이력을 받는 칸은 셋뿐이다.**
+ *
+ * 임의의 축·칸을 받는 범용 쓰기 문을 열지 않는다(설계 점검 2026-09-22). 칸마다 값의 모양과 검증이
+ * 다르고, 아무 칸이나 받는 문은 그 검증을 못 한다.
+ */
+export declare const ASSIGNMENT_FIELDS: ({
+    axis: string;
+    field: string;
+    kind: "relation";
+    target: string;
+} | {
+    axis: string;
+    field: string;
+    kind: "names";
+    target?: undefined;
+})[];
+export declare function assignmentField(axis: string, field: string): {
+    axis: string;
+    field: string;
+    kind: "relation";
+    target: string;
+} | {
+    axis: string;
+    field: string;
+    kind: "names";
+    target?: undefined;
+};

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

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASSIGNMENT_FIELDS = exports.AssignmentClaim = void 0;
+exports.assignmentField = assignmentField;
+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 AssignmentClaim = class AssignmentClaim {
+};
+exports.AssignmentClaim = AssignmentClaim;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], AssignmentClaim.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)
+], AssignmentClaim.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((claim) => claim.domain),
+    tslib_1.__metadata("design:type", String)
+], AssignmentClaim.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], AssignmentClaim.prototype, "axis", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], AssignmentClaim.prototype, "rowId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], AssignmentClaim.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)
+], AssignmentClaim.prototype, "value", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", Date
+    /** 언제까지. 비면 아직 끝나지 않았다. */
+    )
+], AssignmentClaim.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
+    /** 언제 그렇게 적었나. 서버가 붙인다 — 사람이 넣지 않는다. */
+    )
+], AssignmentClaim.prototype, "validTo", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", Date
+    /** 언제 물러났나. 비면 지금도 서 있는 주장이다. */
+    )
+], AssignmentClaim.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   정정이 남긴 앞뒤 조각
+     * ```
+     */
+    )
+], AssignmentClaim.prototype, "supersededAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], AssignmentClaim.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)
+], AssignmentClaim.prototype, "recorder", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((claim) => claim.recorder),
+    tslib_1.__metadata("design:type", String)
+], AssignmentClaim.prototype, "recorderId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], AssignmentClaim.prototype, "createdAt", void 0);
+exports.AssignmentClaim = AssignmentClaim = tslib_1.__decorate([
+    (0, typeorm_1.Entity)({ name: 'ops_assignment_claim' }),
+    (0, typeorm_1.Index)('ix_ops_assignment_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' })
+], AssignmentClaim);
+/**
+ * **이력을 받는 칸은 셋뿐이다.**
+ *
+ * 임의의 축·칸을 받는 범용 쓰기 문을 열지 않는다(설계 점검 2026-09-22). 칸마다 값의 모양과 검증이
+ * 다르고, 아무 칸이나 받는 문은 그 검증을 못 한다.
+ */
+exports.ASSIGNMENT_FIELDS = [
+    { axis: 'equipment', field: 'homeLocation', kind: 'relation', target: 'operationalLocation' },
+    { axis: 'operationalLocation', field: 'workShiftNames', kind: 'names' },
+    { axis: 'operationalLocation', field: 'parentId', kind: 'relation', target: 'operationalLocation' }
+];
+function assignmentField(axis, field) {
+    return exports.ASSIGNMENT_FIELDS.find(one => one.axis === axis && one.field === field);
+}
+//# sourceMappingURL=assignment-claim.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-claim.js","sourceRoot":"","sources":["../../../server/service/assignment/assignment-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_assignment_claim' })\n@Index('ix_ops_assignment_claim_0', (claim: AssignmentClaim) => [claim.domain, claim.axis, claim.rowId, claim.field])\n@ObjectType({ description: 'what an assignment or declaration was, from when, as recorded when' })\nexport class AssignmentClaim {\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: AssignmentClaim) => 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  /** 어느 칸인가 — 선언한 셋만 온다(§`ASSIGNMENT_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  @Column()\n  @Field()\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: AssignmentClaim) => 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 */\nexport const ASSIGNMENT_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\nexport function assignmentField(axis: string, field: string) {\n  return ASSIGNMENT_FIELDS.find(one => one.axis === axis && one.field === field)\n}\n"]}

package/dist-server/service/assignment/assignment-history.d.ts

@@ -0,0 +1,87 @@
+import { EntityManager } from 'typeorm';
+import { Domain } from '@things-factory/shell';
+import { AssignmentClaim } from './assignment-claim';
+/**
+ * 주장을 남기고 읽는 규칙 — **덮어쓰지 않는다.**
+ *
+ * ── 정정이 양옆을 남긴다 ───────────────────────────────────────────────────
+ * 겹치는 주장을 물러나게 하는 것만으로는 모자란다. `A [1일, ∞)` 에 「10~15는 B」를 정정하면 A 의
+ * **앞뒤 조각을 같은 값으로 다시 주장**해야 최신 답이 `A·B·A` 가 된다. 조각도 새 주장이므로 정정 전
+ * 기록시점으로 읽으면 원래 A 하나가 그대로 나온다.
+ *
+ * ── 동시 정정은 거절한다 ───────────────────────────────────────────────────
+ * 물러나게 하려던 주장이 이미 물러나 있으면 충돌이다. **자동으로 다시 시도하지 않는다** — 덮으면
+ * 한쪽의 판단이 사라진다. 다시 읽고 다시 정하는 것은 사람의 일이다.
+ */
+export interface ClaimAt {
+    /** 어느 업무시각의 이야기인가. */
+    asOfBusiness: Date;
+    /** 어느 기록시점까지 알려진 것만 볼 것인가. 안 주면 지금까지 아는 전부다. */
+    asOfRecord?: Date;
+}
+export interface ClaimTarget {
+    axis: string;
+    rowId: string;
+    field: string;
+}
+/**
+ * 그 업무시각에 유효했던 주장.
+ *
+ * **없으면 `undefined` 다 — 「선언 없음」과 다르다.** 선언 없음은 `value` 가 `null` 인 주장이 있는
+ * 것이고, 여기서 `undefined` 는 **그때 무엇이었는지 모른다**는 뜻이다.
+ */
+export declare function claimAt(manager: EntityManager, domain: Domain, target: ClaimTarget, at: ClaimAt): Promise<AssignmentClaim | undefined>;
+/** 한 창을 덮는 주장들 — **계산 구간을 나눌 경계**가 여기서 나온다. 시작 시각 순이다. */
+export declare function claimsDuring(manager: EntityManager, domain: Domain, target: ClaimTarget, window: {
+    from: Date;
+    to: Date;
+}, asOfRecord?: Date): Promise<AssignmentClaim[]>;
+export interface RecordClaim {
+    target: ClaimTarget;
+    value: Record<string, unknown> | null;
+    /** 언제부터 그러한가. 안 주면 지금부터다 — 그 기본값이 곧 「지금부터」라는 주장이다. */
+    validFrom?: Date;
+    /** 언제까지. 정정에서만 쓴다. */
+    validTo?: Date;
+    reason: 'initial' | 'change' | 'correction';
+    recorder?: unknown;
+    /**
+     * 내가 읽었을 때 서 있던 주장들의 id.
+     *
+     * 주면 **그 사이에 누가 바꿨는지** 본다 — 화면에서 읽고 고치는 동안 다른 사람이 같은 구간을
+     * 정정했으면 내 정정이 그것을 덮는다. 덮지 않고 거절한다.
+     */
+    expecting?: readonly string[];
+}
+/**
+ * 주장을 남긴다. **정정이면 겹치는 것을 물러나게 하고 앞뒤 조각을 다시 주장한다.**
+ *
+ * 부르는 쪽이 마스터 변경과 **같은 트랜잭션**으로 부른다 — 갈라지면 값은 바뀌고 이력은 없는 상태가
+ * 생긴다.
+ */
+export declare function recordClaim(manager: EntityManager, domain: Domain, said: RecordClaim, now?: Date): Promise<AssignmentClaim>;
+/**
+ * 도래한 미래 주장을 마스터 행에 옮긴다 — **앱의 주기 작업이 부른다.**
+ *
+ * ops-master 는 라이브러리라 스스로 돌지 않는다. 그 사이 본행은 낡아 있고, **정확해야 하는 소비처는
+ * 본행이 아니라 주장을 읽는다.**
+ */
+export declare function projectDueClaims(manager: EntityManager, domain: Domain, entities: {
+    axis: string;
+    entity: Function;
+}[], now?: Date): Promise<number>;
+/** 주장의 값을 마스터 칸이 드는 모양으로. 「선언 없음」은 `null` 이다. */
+export declare function valueOnRow(claim: AssignmentClaim): unknown;
+/**
+ * 도입할 때 — **지금 값을 초기 상태로 적는다.**
+ *
+ * 과거를 소급해 만드는 것과 다르다. 「도입 시각에 이 값이었다는 것을 확인했다」는 주장이고, **그
+ * 전은 결측 그대로** 둔다. 이것이 없으면 **한 번도 안 옮긴 설비가 영영 이력이 빈다** — 그런 설비가
+ * 가장 많다.
+ *
+ * 이미 주장이 있는 행은 건너뛴다. 두 번 불러도 같다.
+ */
+export declare function recordInitialAssignments(manager: EntityManager, domain: Domain, entities: {
+    axis: string;
+    entity: Function;
+}[], at?: Date, recorder?: unknown): Promise<number>;