@things-factory/ops-master 10.1.36 → 10.1.37

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

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assignmentField = void 0;
+exports.claimedField = void 0;
 exports.claimAssignmentChanges = claimAssignmentChanges;
 exports.toClaimValue = toClaimValue;
-const assignment_claim_1 = require("./assignment-claim");
-Object.defineProperty(exports, "assignmentField", { enumerable: true, get: function () { return assignment_claim_1.assignmentField; } });
+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");
 /**
  * 그리드가 보낸 변경에서 **배정·선언 칸을 골라 주장으로 남긴다.**
@@ -20,7 +22,7 @@ const assignment_history_1 = require("./assignment-history");
  */
 async function claimAssignmentChanges(manager, domain, axis, found, values, user, options) {
     const keepOnRow = {};
-    const fields = assignment_claim_1.ASSIGNMENT_FIELDS.filter(one => one.axis === axis);
+    const fields = master_value_claim_1.CLAIMED_FIELDS.filter(one => one.axis === axis);
     if (!fields.length) {
         return { keepOnRow };
     }
@@ -38,7 +40,9 @@ async function claimAssignmentChanges(manager, domain, axis, found, values, user
         }
         await (0, assignment_history_1.recordClaim)(manager, domain, {
             target: { axis, rowId: String(found.id), field: declared.field },
-            value: toClaimValue(declared.kind, next),
+            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',
@@ -50,16 +54,44 @@ async function claimAssignmentChanges(manager, domain, axis, found, values, user
     }
     return { keepOnRow };
 }
-/** 마스터 칸의 값 → 주장의 값. 「선언 없음」은 `null` 이다. */
-function toClaimValue(kind, value) {
+/**
+ * 마스터 칸의 값 → 주장의 값. 「선언 없음」은 `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 (kind === 'names') {
+    /* 값 그 자체인 칸 — 가리키는 것이 없으므로 푸는 일도 없다. */
+    if (declared.kind === 'literal') {
+        return { literal: String(value) };
+    }
+    if (declared.kind === 'names') {
         return { names: Array.isArray(value) ? value.map(String) : [String(value)] };
     }
-    return { ref: 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);

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

@@ -1 +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 { ASSIGNMENT_FIELDS, assignmentField } from './assignment-claim'\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 = ASSIGNMENT_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: toClaimValue(declared.kind, next),\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/** 마스터 칸의 값 → 주장의 값. 「선언 없음」은 `null` 이다. */\nexport function toClaimValue(kind: 'relation' | 'names', value: unknown): Record<string, unknown> | null {\n  if (value === null || value === undefined || value === '') {\n    return null\n  }\n\n  if (kind === 'names') {\n    return { names: Array.isArray(value) ? value.map(String) : [String(value)] }\n  }\n\n  return { ref: String(value) }\n}\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 { assignmentField }\n"]}
+{"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/{assignment-claim.d.ts → master-value-claim.d.ts}

@@ -38,7 +38,7 @@ import { User } from '@things-factory/auth-base';
  * 바꾼 날 과거 관계가 끊긴다(적용 가이드 §0-1 의 그 부류).
  * ═══════════════════════════════════════════════════════════════════════════
  */
-export declare class AssignmentClaim {
+export declare class MasterValueClaim {
     readonly id: string;
     domain?: Domain;
     domainId?: string;
@@ -46,7 +46,7 @@ export declare class AssignmentClaim {
     axis: string;
     /** 그 축의 어느 행인가. UUID 다. */
     rowId: string;
-    /** 어느 칸인가 — 선언한 셋만 온다(§`ASSIGNMENT_FIELDS`). */
+    /** 어느 칸인가 — 선언한 셋만 온다(§`CLAIMED_FIELDS`). */
     field: string;
     /**
      * 그때의 값.
@@ -58,8 +58,14 @@ export declare class AssignmentClaim {
      * ```
      */
     value?: Record<string, unknown> | null;
-    /** 언제부터 그러했나 — 업무의 시간. */
-    validFrom: Date;
+    /**
+     * 언제부터 그러했나 — 업무의 시간.
+     *
+     * **비어 있으면 「그때까지 쭉」이다.** 어느 칸이 처음 바뀔 때, 바뀌기 전 값도 같이 적는데 그 값이
+     * 언제부터였는지는 아무도 안 적었다. 1970 년 같은 시각을 넣으면 적은 적 없는 것을 적은 것이 되므로
+     * 비워 둔다(2026-09-23).
+     */
+    validFrom?: Date;
     /** 언제까지. 비면 아직 끝나지 않았다. */
     validTo?: Date;
     /** 언제 그렇게 적었나. 서버가 붙인다 — 사람이 넣지 않는다. */
@@ -82,12 +88,20 @@ export declare class AssignmentClaim {
     createdAt?: Date;
 }
 /**
- * **이력을 받는 칸은 셋뿐이다.**
+ * **이력을 받는 칸은 여기 적힌 것뿐이다.**
  *
  * 임의의 축·칸을 받는 범용 쓰기 문을 열지 않는다(설계 점검 2026-09-22). 칸마다 값의 모양과 검증이
  * 다르고, 아무 칸이나 받는 문은 그 검증을 못 한다.
+ *
+ * ── 셋에서 넷이 됐다 (2026-09-23) ─────────────────────────────────────────
+ * 앞의 셋은 **배정**이다 — 무엇이 어디에 속하나. 넷째는 아니다. 공정의 표준시간은 값 자체이고,
+ * 실적의 성능률이 그것을 나눈다. 지금은 **오늘 마스터를 다시 읽어서 지난달 성능이 움직인다**
+ * (`operation-effectivity-db.test.cjs` 가 그 거동을 적어 두고 있다).
+ *
+ * 그래서 이 표의 이름이 「배정」이 아니라 「마스터 값의 주장」이다. 기전은 같다 — 두 시각, 정정은
+ * 물리고 앞뒤를 다시 주장, 주장이 없으면 한 번도 안 바뀐 것.
  */
-export declare const ASSIGNMENT_FIELDS: ({
+export declare const CLAIMED_FIELDS: ({
     axis: string;
     field: string;
     kind: "relation";
@@ -97,8 +111,13 @@ export declare const ASSIGNMENT_FIELDS: ({
     field: string;
     kind: "names";
     target?: undefined;
+} | {
+    axis: string;
+    field: string;
+    kind: "literal";
+    target?: undefined;
 })[];
-export declare function assignmentField(axis: string, field: string): {
+export declare function claimedField(axis: string, field: string): {
     axis: string;
     field: string;
     kind: "relation";
@@ -108,4 +127,9 @@ export declare function assignmentField(axis: string, field: string): {
     field: string;
     kind: "names";
     target?: undefined;
+} | {
+    axis: string;
+    field: string;
+    kind: "literal";
+    target?: undefined;
 };

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ASSIGNMENT_FIELDS = exports.AssignmentClaim = void 0;
-exports.assignmentField = assignmentField;
+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");
@@ -45,64 +45,64 @@ const auth_base_1 = require("@things-factory/auth-base");
  * 바꾼 날 과거 관계가 끊긴다(적용 가이드 §0-1 의 그 부류).
  * ═══════════════════════════════════════════════════════════════════════════
  */
-let AssignmentClaim = class AssignmentClaim {
+let MasterValueClaim = class MasterValueClaim {
 };
-exports.AssignmentClaim = AssignmentClaim;
+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)
-], AssignmentClaim.prototype, "id", void 0);
+], 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)
-], AssignmentClaim.prototype, "domain", void 0);
+], MasterValueClaim.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);
+], MasterValueClaim.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);
+], MasterValueClaim.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);
+], MasterValueClaim.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);
+], 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)
-], AssignmentClaim.prototype, "value", void 0);
+], MasterValueClaim.prototype, "value", void 0);
 tslib_1.__decorate([
-    (0, typeorm_1.Column)(),
-    (0, type_graphql_1.Field)(),
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
     tslib_1.__metadata("design:type", Date
     /** 언제까지. 비면 아직 끝나지 않았다. */
     )
-], AssignmentClaim.prototype, "validFrom", void 0);
+], 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
     /** 언제 그렇게 적었나. 서버가 붙인다 — 사람이 넣지 않는다. */
     )
-], AssignmentClaim.prototype, "validTo", void 0);
+], MasterValueClaim.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);
+], MasterValueClaim.prototype, "recordedAt", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)({ nullable: true }),
     (0, type_graphql_1.Field)({ nullable: true }),
@@ -118,43 +118,57 @@ tslib_1.__decorate([
      * ```
      */
     )
-], AssignmentClaim.prototype, "supersededAt", void 0);
+], MasterValueClaim.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);
+], 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)
-], AssignmentClaim.prototype, "recorder", void 0);
+], MasterValueClaim.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);
+], 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)
-], 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]),
+], 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' })
-], AssignmentClaim);
+], MasterValueClaim);
 /**
- * **이력을 받는 칸은 셋뿐이다.**
+ * **이력을 받는 칸은 여기 적힌 것뿐이다.**
  *
  * 임의의 축·칸을 받는 범용 쓰기 문을 열지 않는다(설계 점검 2026-09-22). 칸마다 값의 모양과 검증이
  * 다르고, 아무 칸이나 받는 문은 그 검증을 못 한다.
+ *
+ * ── 셋에서 넷이 됐다 (2026-09-23) ─────────────────────────────────────────
+ * 앞의 셋은 **배정**이다 — 무엇이 어디에 속하나. 넷째는 아니다. 공정의 표준시간은 값 자체이고,
+ * 실적의 성능률이 그것을 나눈다. 지금은 **오늘 마스터를 다시 읽어서 지난달 성능이 움직인다**
+ * (`operation-effectivity-db.test.cjs` 가 그 거동을 적어 두고 있다).
+ *
+ * 그래서 이 표의 이름이 「배정」이 아니라 「마스터 값의 주장」이다. 기전은 같다 — 두 시각, 정정은
+ * 물리고 앞뒤를 다시 주장, 주장이 없으면 한 번도 안 바뀐 것.
  */
-exports.ASSIGNMENT_FIELDS = [
+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' }
+    { axis: 'operationalLocation', field: 'parentId', kind: 'relation', target: 'operationalLocation' },
+    /*
+     * ISO 8601 기간 문자열 그대로 담는다(`PT1M`). ms 로 바꿔 담으면 사람이 읽을 때 원문이 없고,
+     * 원문만 담으면 파싱 규칙이 바뀌는 날 값이 달라진다 — **읽는 쪽이 둘 다 내도록** 원문을 담고
+     * 부르는 쪽이 파싱한다(착수 카드 §3-1).
+     */
+    { axis: 'operationDefinition', field: 'duration', kind: 'literal' }
 ];
-function assignmentField(axis, field) {
-    return exports.ASSIGNMENT_FIELDS.find(one => one.axis === axis && one.field === field);
+function claimedField(axis, field) {
+    return exports.CLAIMED_FIELDS.find(one => one.axis === axis && one.field === field);
 }
-//# sourceMappingURL=assignment-claim.js.map
+//# 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/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,10 +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/assignment-claim';
+export * from './assignment/master-value-claim';
 export * from './assignment/assignment-history';
 export * from './assignment/assignment-write';

package/dist-server/service/index.js

@@ -15,6 +15,7 @@ tslib_1.__exportStar(require("./test-spec/test-spec-master-resolver"), exports);
 tslib_1.__exportStar(require("./master-crud"), exports);
 tslib_1.__exportStar(require("./master-axis"), exports);
 tslib_1.__exportStar(require("./master-change-policy"), exports);
+tslib_1.__exportStar(require("./approval-route"), exports);
 tslib_1.__exportStar(require("./master-conformance"), exports);
 tslib_1.__exportStar(require("./master-conformance-resolver"), exports);
 tslib_1.__exportStar(require("./master-list"), exports);
@@ -84,10 +85,16 @@ const status_1 = require("./status");
 /* 마스터 정합성 — 축을 가로지르므로 어느 축에도 안 속한다. */
 const master_conformance_resolver_1 = require("./master-conformance-resolver");
 const master_change_policy_1 = require("./master-change-policy");
+const master_value_claim_1 = require("./assignment/master-value-claim");
 const test_spec_1 = require("./test-spec");
 exports.entities = [
     /* ENTITIES */
     master_change_policy_1.MasterChangePolicy,
+    /*
+     * 배정 이력. **등록이 빠져 있었다**(2026-09-23 확인) — 표가 안 서니 이력을 쓰는 길이 실제
+     * 설치본에는 없었다. 시험 하네스가 자기 목록에 직접 넣어서 초록이었다.
+     */
+    master_value_claim_1.MasterValueClaim,
     ...personnel_1.entities,
     ...quality_1.entities,
     ...equipment_1.entities,
@@ -119,7 +126,7 @@ exports.schema = {
         master_conformance_resolver_1.MasterConformanceResolver
     ]
 };
-tslib_1.__exportStar(require("./assignment/assignment-claim"), exports);
+tslib_1.__exportStar(require("./assignment/master-value-claim"), exports);
 tslib_1.__exportStar(require("./assignment/assignment-history"), exports);
 tslib_1.__exportStar(require("./assignment/assignment-write"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,yBAAyB;AACzB,oEAAyC;AACzC,gFAAqD;AACrD,gFAAqD;AACrD,wEAA6C;AAC7C,8EAAmD;AACnD,8EAAmD;AACnD,gFAAqD;AACrD,0EAA+C;AAC/C,gFAAqD;AACrD,wDAA6B;AAC7B,wDAA6B;AAC7B,iEAAsC;AACtC,+DAAoC;AACpC,wEAA6C;AAC7C,wDAA6B;AAC7B,6DAAkC;AAClC,sEAA2C;AAC3C,uEAA4C;AAC5C,sEAA2C;AAC3C,oEAAyC;AACzC,gEAAqC;AACrC,sEAA2C;AAC3C,yEAA8C;AAC9C,kEAAuC;AACvC,uEAA4C;AAC5C,sEAA2C;AAC3C,kEAAuC;AACvC,iEAAsC;AACtC,uEAA4C;AAC5C,+DAAoC;AACpC,8DAAmC;AACnC,0EAA+C;AAC/C,qEAA0C;AAC1C,oEAAyC;AACzC,oEAAyC;AACzC,yEAA8C;AAC9C,uEAA4C;AAC5C,+EAAoD;AACpD,gFAAqD;AACrD,6EAAkD;AAClD,qEAA0C;AAC1C,oEAAyC;AACzC,2EAAgD;AAChD,uEAA4C;AAC5C,sEAA2C;AAC3C,0EAA+C;AAC/C,mFAAwD;AACxD,qEAA0C;AAC1C,mEAAwC;AACxC,wEAA6C;AAC7C,2EAAgD;AAChD,2EAAgD;AAChD,4EAAiD;AACjD,yEAA8C;AAC9C,oEAAyC;AACzC,iEAAsC;AACtC,gEAAqC;AACrC,yEAA8C;AAC9C,yEAA8C;AAC9C,iFAAsD;AACtD,kFAAuD;AACvD,+EAAoD;AACpD,uEAA4C;AAC5C,sEAA2C;AAC3C,8DAAmC;AACnC,iEAAsC;AACtC,yEAA8C;AAE9C,mCAAmC;AACnC,mCAAgF;AAChF,2CAA4F;AAC5F,yCAAyF;AACzF,yCAAyF;AACzF,2CAA4F;AAC5F,2CAA4F;AAC5F,uCAAsF;AACtF,wEAAwE;AACxE,qCAAmF;AACnF,qCAAuD;AACvD,uCAAuC;AACvC,+EAAyE;AACzE,iEAAuF;AACvF,2CAA0F;AAE7E,QAAA,QAAQ,GAAG;IACtB,cAAc;IACd,yCAAkB;IAClB,GAAG,oBAAiB;IACpB,GAAG,kBAAe;IAClB,GAAG,oBAAiB;IACpB,GAAG,gBAAa;IAChB,GAAG,mBAAgB;IACnB,GAAG,mBAAgB;IACnB,GAAG,oBAAiB;IACpB,GAAG,iBAAc;IACjB,GAAG,oBAAgB;CACpB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,iDAA0B;QAC1B,GAAG,qBAAkB;QACrB,GAAG,mBAAgB;QACnB,GAAG,qBAAkB;QACrB,GAAG,iBAAc;QACjB,GAAG,oBAAiB;QACpB,GAAG,oBAAiB;QACpB,GAAG,qBAAkB;QACrB,GAAG,kBAAe;QAClB,GAAG,qBAAiB;QACpB,GAAG,kBAAe;QAElB;;;WAGG;QACH,uDAAyB;KAC1B;CACF,CAAA;AACD,wEAA6C;AAC7C,0EAA+C;AAC/C,wEAA6C","sourcesContent":["/* EXPORT ENTITY TYPES */\nexport * from './resource/resource-class'\nexport * from './personnel/personnel-master-resolver'\nexport * from './equipment/equipment-master-resolver'\nexport * from './asset/asset-master-resolver'\nexport * from './material/material-master-resolver'\nexport * from './location/location-master-resolver'\nexport * from './operation/operation-master-resolver'\nexport * from './recipe/recipe-master-resolver'\nexport * from './test-spec/test-spec-master-resolver'\nexport * from './master-crud'\nexport * from './master-axis'\nexport * from './master-change-policy'\nexport * from './master-conformance'\nexport * from './master-conformance-resolver'\nexport * from './master-list'\nexport * from './personnel/person'\nexport * from './personnel/personnel-class'\nexport * from './personnel/personnel-master'\nexport * from './personnel/personnel-query'\nexport * from './personnel/qualification'\nexport * from './equipment/equipment'\nexport * from './equipment/equipment-class'\nexport * from './equipment/state-period-rules'\nexport * from './equipment/stop-reason'\nexport * from './equipment/equipment-master'\nexport * from './equipment/equipment-query'\nexport * from './asset/asset-lifecycle'\nexport * from './asset/physical-asset'\nexport * from './asset/physical-asset-class'\nexport * from './asset/asset-master'\nexport * from './asset/asset-query'\nexport * from './location/operational-location'\nexport * from './location/location-master'\nexport * from './location/location-query'\nexport * from './material/material-class'\nexport * from './material/material-definition'\nexport * from './material/material-revision'\nexport * from './material/material-revision-service'\nexport * from './material/material-revision-resolver'\nexport * from './material/material-effective-list'\nexport * from './material/material-master'\nexport * from './material/material-query'\nexport * from './operation/operation-definition'\nexport * from './operation/operation-master'\nexport * from './operation/operation-query'\nexport * from './operation/operation-readiness'\nexport * from './operation/operation-readiness-resolver'\nexport * from './recipe/recipe-definition'\nexport * from './recipe/recipe-revision'\nexport * from './recipe/recipe-revision-line'\nexport * from './recipe/recipe-revision-content'\nexport * from './recipe/recipe-revision-service'\nexport * from './recipe/recipe-revision-resolver'\nexport * from './recipe/recipe-effective-list'\nexport * from './recipe/route-definition'\nexport * from './recipe/recipe-master'\nexport * from './recipe/recipe-query'\nexport * from './test-spec/test-specification'\nexport * from './test-spec/test-spec-revision'\nexport * from './test-spec/test-spec-revision-service'\nexport * from './test-spec/test-spec-revision-resolver'\nexport * from './test-spec/test-spec-effective-list'\nexport * from './test-spec/test-spec-master'\nexport * from './test-spec/test-spec-query'\nexport * from './status/axis-stamp'\nexport * from './status/master-status'\nexport * from './quality/nonconformance-cause'\n\n/* IMPORT ENTITIES AND RESOLVERS */\nimport { entities as AssetEntities, resolvers as AssetResolvers } from './asset'\nimport { entities as EquipmentEntities, resolvers as EquipmentResolvers } from './equipment'\nimport { entities as LocationEntities, resolvers as LocationResolvers } from './location'\nimport { entities as MaterialEntities, resolvers as MaterialResolvers } from './material'\nimport { entities as OperationEntities, resolvers as OperationResolvers } from './operation'\nimport { entities as PersonnelEntities, resolvers as PersonnelResolvers } from './personnel'\nimport { entities as QualityEntities, resolvers as QualityResolvers } from './quality'\n/* 라우팅·레시피 — 품목→지시서를 이으려면 그 사이에 이 둘이 있어야 한다(§`recipe-definition.ts`). */\nimport { entities as RecipeEntities, resolvers as RecipeResolvers } from './recipe'\nimport { resolvers as StatusResolvers } from './status'\n/* 마스터 정합성 — 축을 가로지르므로 어느 축에도 안 속한다. */\nimport { MasterConformanceResolver } from './master-conformance-resolver'\nimport { MasterChangePolicy, MasterChangePolicyResolver } from './master-change-policy'\nimport { entities as TestSpecEntities, resolvers as TestSpecResolvers } from './test-spec'\n\nexport const entities = [\n  /* ENTITIES */\n  MasterChangePolicy,\n  ...PersonnelEntities,\n  ...QualityEntities,\n  ...EquipmentEntities,\n  ...AssetEntities,\n  ...LocationEntities,\n  ...MaterialEntities,\n  ...OperationEntities,\n  ...RecipeEntities,\n  ...TestSpecEntities\n]\n\nexport const schema = {\n  resolverClasses: [\n    /* RESOLVER CLASSES */\n    MasterChangePolicyResolver,\n    ...PersonnelResolvers,\n    ...QualityResolvers,\n    ...EquipmentResolvers,\n    ...AssetResolvers,\n    ...LocationResolvers,\n    ...MaterialResolvers,\n    ...OperationResolvers,\n    ...RecipeResolvers,\n    ...TestSpecResolvers,\n    ...StatusResolvers,\n\n    /*\n     * **파일을 export 하는 것만으로는 스키마에 안 올라온다.** 여기 적어야 한다 — 처음에 그것을\n     * 빠뜨려 `masterConformance` 가 「Cannot query field」로 나왔다. [확인함] 2026-09-04\n     */\n    MasterConformanceResolver\n  ]\n}\nexport * from './assignment/assignment-claim'\nexport * from './assignment/assignment-history'\nexport * from './assignment/assignment-write'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,yBAAyB;AACzB,oEAAyC;AACzC,gFAAqD;AACrD,gFAAqD;AACrD,wEAA6C;AAC7C,8EAAmD;AACnD,8EAAmD;AACnD,gFAAqD;AACrD,0EAA+C;AAC/C,gFAAqD;AACrD,wDAA6B;AAC7B,wDAA6B;AAC7B,iEAAsC;AACtC,2DAAgC;AAChC,+DAAoC;AACpC,wEAA6C;AAC7C,wDAA6B;AAC7B,6DAAkC;AAClC,sEAA2C;AAC3C,uEAA4C;AAC5C,sEAA2C;AAC3C,oEAAyC;AACzC,gEAAqC;AACrC,sEAA2C;AAC3C,yEAA8C;AAC9C,kEAAuC;AACvC,uEAA4C;AAC5C,sEAA2C;AAC3C,kEAAuC;AACvC,iEAAsC;AACtC,uEAA4C;AAC5C,+DAAoC;AACpC,8DAAmC;AACnC,0EAA+C;AAC/C,qEAA0C;AAC1C,oEAAyC;AACzC,oEAAyC;AACzC,yEAA8C;AAC9C,uEAA4C;AAC5C,+EAAoD;AACpD,gFAAqD;AACrD,6EAAkD;AAClD,qEAA0C;AAC1C,oEAAyC;AACzC,2EAAgD;AAChD,uEAA4C;AAC5C,sEAA2C;AAC3C,0EAA+C;AAC/C,mFAAwD;AACxD,qEAA0C;AAC1C,mEAAwC;AACxC,wEAA6C;AAC7C,2EAAgD;AAChD,2EAAgD;AAChD,4EAAiD;AACjD,yEAA8C;AAC9C,oEAAyC;AACzC,iEAAsC;AACtC,gEAAqC;AACrC,yEAA8C;AAC9C,yEAA8C;AAC9C,iFAAsD;AACtD,kFAAuD;AACvD,+EAAoD;AACpD,uEAA4C;AAC5C,sEAA2C;AAC3C,8DAAmC;AACnC,iEAAsC;AACtC,yEAA8C;AAE9C,mCAAmC;AACnC,mCAAgF;AAChF,2CAA4F;AAC5F,yCAAyF;AACzF,yCAAyF;AACzF,2CAA4F;AAC5F,2CAA4F;AAC5F,uCAAsF;AACtF,wEAAwE;AACxE,qCAAmF;AACnF,qCAAuD;AACvD,uCAAuC;AACvC,+EAAyE;AACzE,iEAAuF;AACvF,wEAAkE;AAClE,2CAA0F;AAE7E,QAAA,QAAQ,GAAG;IACtB,cAAc;IACd,yCAAkB;IAClB;;;OAGG;IACH,qCAAgB;IAChB,GAAG,oBAAiB;IACpB,GAAG,kBAAe;IAClB,GAAG,oBAAiB;IACpB,GAAG,gBAAa;IAChB,GAAG,mBAAgB;IACnB,GAAG,mBAAgB;IACnB,GAAG,oBAAiB;IACpB,GAAG,iBAAc;IACjB,GAAG,oBAAgB;CACpB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,iDAA0B;QAC1B,GAAG,qBAAkB;QACrB,GAAG,mBAAgB;QACnB,GAAG,qBAAkB;QACrB,GAAG,iBAAc;QACjB,GAAG,oBAAiB;QACpB,GAAG,oBAAiB;QACpB,GAAG,qBAAkB;QACrB,GAAG,kBAAe;QAClB,GAAG,qBAAiB;QACpB,GAAG,kBAAe;QAElB;;;WAGG;QACH,uDAAyB;KAC1B;CACF,CAAA;AACD,0EAA+C;AAC/C,0EAA+C;AAC/C,wEAA6C","sourcesContent":["/* EXPORT ENTITY TYPES */\nexport * from './resource/resource-class'\nexport * from './personnel/personnel-master-resolver'\nexport * from './equipment/equipment-master-resolver'\nexport * from './asset/asset-master-resolver'\nexport * from './material/material-master-resolver'\nexport * from './location/location-master-resolver'\nexport * from './operation/operation-master-resolver'\nexport * from './recipe/recipe-master-resolver'\nexport * from './test-spec/test-spec-master-resolver'\nexport * from './master-crud'\nexport * from './master-axis'\nexport * from './master-change-policy'\nexport * from './approval-route'\nexport * from './master-conformance'\nexport * from './master-conformance-resolver'\nexport * from './master-list'\nexport * from './personnel/person'\nexport * from './personnel/personnel-class'\nexport * from './personnel/personnel-master'\nexport * from './personnel/personnel-query'\nexport * from './personnel/qualification'\nexport * from './equipment/equipment'\nexport * from './equipment/equipment-class'\nexport * from './equipment/state-period-rules'\nexport * from './equipment/stop-reason'\nexport * from './equipment/equipment-master'\nexport * from './equipment/equipment-query'\nexport * from './asset/asset-lifecycle'\nexport * from './asset/physical-asset'\nexport * from './asset/physical-asset-class'\nexport * from './asset/asset-master'\nexport * from './asset/asset-query'\nexport * from './location/operational-location'\nexport * from './location/location-master'\nexport * from './location/location-query'\nexport * from './material/material-class'\nexport * from './material/material-definition'\nexport * from './material/material-revision'\nexport * from './material/material-revision-service'\nexport * from './material/material-revision-resolver'\nexport * from './material/material-effective-list'\nexport * from './material/material-master'\nexport * from './material/material-query'\nexport * from './operation/operation-definition'\nexport * from './operation/operation-master'\nexport * from './operation/operation-query'\nexport * from './operation/operation-readiness'\nexport * from './operation/operation-readiness-resolver'\nexport * from './recipe/recipe-definition'\nexport * from './recipe/recipe-revision'\nexport * from './recipe/recipe-revision-line'\nexport * from './recipe/recipe-revision-content'\nexport * from './recipe/recipe-revision-service'\nexport * from './recipe/recipe-revision-resolver'\nexport * from './recipe/recipe-effective-list'\nexport * from './recipe/route-definition'\nexport * from './recipe/recipe-master'\nexport * from './recipe/recipe-query'\nexport * from './test-spec/test-specification'\nexport * from './test-spec/test-spec-revision'\nexport * from './test-spec/test-spec-revision-service'\nexport * from './test-spec/test-spec-revision-resolver'\nexport * from './test-spec/test-spec-effective-list'\nexport * from './test-spec/test-spec-master'\nexport * from './test-spec/test-spec-query'\nexport * from './status/axis-stamp'\nexport * from './status/master-status'\nexport * from './quality/nonconformance-cause'\n\n/* IMPORT ENTITIES AND RESOLVERS */\nimport { entities as AssetEntities, resolvers as AssetResolvers } from './asset'\nimport { entities as EquipmentEntities, resolvers as EquipmentResolvers } from './equipment'\nimport { entities as LocationEntities, resolvers as LocationResolvers } from './location'\nimport { entities as MaterialEntities, resolvers as MaterialResolvers } from './material'\nimport { entities as OperationEntities, resolvers as OperationResolvers } from './operation'\nimport { entities as PersonnelEntities, resolvers as PersonnelResolvers } from './personnel'\nimport { entities as QualityEntities, resolvers as QualityResolvers } from './quality'\n/* 라우팅·레시피 — 품목→지시서를 이으려면 그 사이에 이 둘이 있어야 한다(§`recipe-definition.ts`). */\nimport { entities as RecipeEntities, resolvers as RecipeResolvers } from './recipe'\nimport { resolvers as StatusResolvers } from './status'\n/* 마스터 정합성 — 축을 가로지르므로 어느 축에도 안 속한다. */\nimport { MasterConformanceResolver } from './master-conformance-resolver'\nimport { MasterChangePolicy, MasterChangePolicyResolver } from './master-change-policy'\nimport { MasterValueClaim } from './assignment/master-value-claim'\nimport { entities as TestSpecEntities, resolvers as TestSpecResolvers } from './test-spec'\n\nexport const entities = [\n  /* ENTITIES */\n  MasterChangePolicy,\n  /*\n   * 배정 이력. **등록이 빠져 있었다**(2026-09-23 확인) — 표가 안 서니 이력을 쓰는 길이 실제\n   * 설치본에는 없었다. 시험 하네스가 자기 목록에 직접 넣어서 초록이었다.\n   */\n  MasterValueClaim,\n  ...PersonnelEntities,\n  ...QualityEntities,\n  ...EquipmentEntities,\n  ...AssetEntities,\n  ...LocationEntities,\n  ...MaterialEntities,\n  ...OperationEntities,\n  ...RecipeEntities,\n  ...TestSpecEntities\n]\n\nexport const schema = {\n  resolverClasses: [\n    /* RESOLVER CLASSES */\n    MasterChangePolicyResolver,\n    ...PersonnelResolvers,\n    ...QualityResolvers,\n    ...EquipmentResolvers,\n    ...AssetResolvers,\n    ...LocationResolvers,\n    ...MaterialResolvers,\n    ...OperationResolvers,\n    ...RecipeResolvers,\n    ...TestSpecResolvers,\n    ...StatusResolvers,\n\n    /*\n     * **파일을 export 하는 것만으로는 스키마에 안 올라온다.** 여기 적어야 한다 — 처음에 그것을\n     * 빠뜨려 `masterConformance` 가 「Cannot query field」로 나왔다. [확인함] 2026-09-04\n     */\n    MasterConformanceResolver\n  ]\n}\nexport * from './assignment/master-value-claim'\nexport * from './assignment/assignment-history'\nexport * from './assignment/assignment-write'\n"]}

package/dist-server/service/master-change-policy.d.ts

@@ -1,7 +1,13 @@
 import { EntityManager } from 'typeorm';
 import { Domain } from '@things-factory/shell';
 import { User } from '@things-factory/auth-base';
-/** Initial domain×axis declaration. Changing an established policy needs its own approved decision. */
+/**
+ * 정책을 정할 수 있는 축들 — 마스터 축 열다섯에 `workShift` 를 더한다.
+ *
+ * `workShift` 는 별도 모듈이라 `MASTER_AXES` 에 없는데 정책은 받는다(§`policyAxis`).
+ */
+export declare const POLICY_AXES: string[];
+/** 도메인 × 축의 기준정보 변경 정책 — 정하는 것도 바꾸는 것도 사업장 소유자의 몫이다. */
 export declare class MasterChangePolicy {
     id: string;
     domain: Domain;
@@ -9,15 +15,72 @@ export declare class MasterChangePolicy {
     axis: string;
     approvalRequired: boolean;
     reason: string;
+    /**
+     * 이 줄이 물러난 시각 — 비어 있는 줄이 **지금 정책**이다.
+     *
+     * 차례를 `createdAt` 으로 세우지 않는다. sqlite 의 `datetime('now')` 는 초까지라, 한 사람이 같은
+     * 초에 두 번 바꾸면 어느 줄이 나중인지 저장소가 못 가린다. 물러난 줄에 표를 하면 그 물음이 사라진다.
+     */
+    supersededAt: Date;
+    /**
+     * 누가 정했나 — **비어 있으면 아무도 안 정한 것**이고, 그 줄은 기본값으로 선 줄이다.
+     *
+     * 사람이 안 정한 줄에 사람을 적으면 그 사람이 정한 것이 된다. 사업장을 만든 사람도 이 축을 보고
+     * 고른 적이 없다.
+     */
     creator: User;
     creatorId: string;
     createdAt: Date;
 }
+/** 아무도 안 정한 축이 도는 방식 — 바꾸려면 여기 하나만 고치면 된다. */
+export declare const DEFAULT_APPROVAL_REQUIRED = false;
+/**
+ * 이 축이 지금 어떻게 도는가. **아무도 안 정했으면 기본값으로 한 줄을 세우고 그것을 답한다.**
+ *
+ * 전에는 거절했다(`MASTER_POLICY_REQUIRED`). 그래서 새 사업장은 축 열여섯이 전부 막힌 채로 시작했고,
+ * 기준정보를 만들려던 사람이 「정책을 먼저 정하라」는 말만 받았다 — 어디서 정하는지는 안 적혀 있었다.
+ *
+ * 값을 그때그때 지어내지 않고 **줄을 세우는** 까닭은, 개정본이 자기가 어느 정책 아래 만들어졌는지를
+ * 그 줄로 가리키기 때문이다(ADR-0090). 가리킬 줄이 없으면 그 물음에 나중에 답할 수 없다.
+ *
+ * 그 줄의 `creator` 는 비어 있다. 아무도 고른 적이 없다는 것이 사실이고, 사업장을 만든 사람을 적으면
+ * 그 사람이 정한 것이 된다.
+ */
 export declare function masterChangePolicy(manager: EntityManager, domainId: string, axis: string): Promise<MasterChangePolicy>;
+/**
+ * 지금 서 있는 줄.
+ *
+ * 둘 이상이 서 있으면 **가장 늦게 만들어진 것**을 답한다. 그 상태는 이 코드가 못 만들지만, 물러남
+ * 표를 두기 전에 쌓인 줄들이 그렇게 남아 있다. 다음 선언이 전부 물러나게 하고 하나로 정리한다.
+ */
+export declare function standingPolicy(manager: EntityManager, domainId: string, axis: string): Promise<MasterChangePolicy>;
+/** 이 도메인에서 지금 서 있는 줄 전부 — 축을 열쇠로. */
+export declare function standingPolicies(manager: EntityManager, domainId: string): Promise<Map<string, MasterChangePolicy>>;
 export declare function declareMasterChangePolicy(manager: EntityManager, domainId: string, actorId: string, axis: string, approvalRequired: boolean, reason: string): Promise<MasterChangePolicy>;
-/** The common mutation boundary also protects not-yet-revisioned axes when declared regulated. */
 export declare function assertDirectMasterChange(manager: EntityManager, domainId: string, axis: string): Promise<void>;
 export declare class MasterChangePolicyResolver {
     masterChangePolicy(axis: string, context: ResolverContext): Promise<MasterChangePolicy>;
+    /**
+     * 축 전부의 정책 상태 — **안 정한 것도 답한다.**
+     *
+     * `masterChangePolicy` 는 안 정했으면 거절한다. 그것은 「고치기 전에 정해라」를 말하는 자리라 맞지만,
+     * **정하러 들어가는 화면까지 막는다.** 그래서 목록은 따로 둔다 — 안 정한 축은 안 정했다고 답한다.
+     *
+     * `canDeclare` 는 **이 사람이 소유자인가**다. 화면이 스스로 판단하지 않게 서버가 말한다 —
+     * 눌러 보고 거절당하는 화면이 되지 않도록.
+     */
+    masterChangePolicies(context: ResolverContext): Promise<{
+        canDeclare: boolean;
+        axes: {
+            axis: string;
+            declared: boolean;
+            byDefault: boolean;
+            approvalRequired: boolean;
+            reason: string;
+            declaredAt: Date;
+            approvalReady: boolean;
+            approvalActivity: string;
+        }[];
+    }>;
     declareMasterChangePolicy(axis: string, approvalRequired: boolean, reason: string, context: ResolverContext): Promise<MasterChangePolicy>;
 }