@things-factory/ops-master 10.1.36 → 10.1.37

package/dist-server/service/master-change-policy.js

@@ -1,21 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MasterChangePolicyResolver = exports.MasterChangePolicy = void 0;
+exports.MasterChangePolicyResolver = exports.DEFAULT_APPROVAL_REQUIRED = exports.MasterChangePolicy = exports.POLICY_AXES = void 0;
 exports.masterChangePolicy = masterChangePolicy;
+exports.standingPolicy = standingPolicy;
+exports.standingPolicies = standingPolicies;
 exports.declareMasterChangePolicy = declareMasterChangePolicy;
 exports.assertDirectMasterChange = assertDirectMasterChange;
 const tslib_1 = require("tslib");
 const typeorm_1 = require("typeorm");
+const typeorm_2 = 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");
 const master_axis_1 = require("./master-axis");
+const approval_route_1 = require("./approval-route");
 // WorkShift owns a domain-wide arrangement, not a row in the generic master CRUD registry.
 function policyAxis(axis) {
     if (axis !== 'workShift')
         (0, master_axis_1.masterAxisOf)(axis);
 }
-/** Initial domain×axis declaration. Changing an established policy needs its own approved decision. */
+/**
+ * 정책을 정할 수 있는 축들 — 마스터 축 열다섯에 `workShift` 를 더한다.
+ *
+ * `workShift` 는 별도 모듈이라 `MASTER_AXES` 에 없는데 정책은 받는다(§`policyAxis`).
+ */
+exports.POLICY_AXES = [...master_axis_1.MASTER_AXES.map(one => one.key), 'workShift'];
+/** 도메인 × 축의 기준정보 변경 정책 — 정하는 것도 바꾸는 것도 사업장 소유자의 몫이다. */
 let MasterChangePolicy = class MasterChangePolicy {
 };
 exports.MasterChangePolicy = MasterChangePolicy;
@@ -44,7 +54,18 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:type", String)
 ], MasterChangePolicy.prototype, "reason", void 0);
 tslib_1.__decorate([
-    (0, typeorm_1.ManyToOne)(() => auth_base_1.User, { nullable: false }),
+    (0, typeorm_1.Column)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date
+    /**
+     * 누가 정했나 — **비어 있으면 아무도 안 정한 것**이고, 그 줄은 기본값으로 선 줄이다.
+     *
+     * 사람이 안 정한 줄에 사람을 적으면 그 사람이 정한 것이 된다. 사업장을 만든 사람도 이 축을 보고
+     * 고른 적이 없다.
+     */
+    )
+], MasterChangePolicy.prototype, "supersededAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(() => auth_base_1.User, { nullable: true }),
     tslib_1.__metadata("design:type", auth_base_1.User)
 ], MasterChangePolicy.prototype, "creator", void 0);
 tslib_1.__decorate([
@@ -56,16 +77,71 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:type", Date)
 ], MasterChangePolicy.prototype, "createdAt", void 0);
 exports.MasterChangePolicy = MasterChangePolicy = tslib_1.__decorate([
-    (0, typeorm_1.Entity)('ops_master_change_policy'),
-    (0, typeorm_1.Index)('ix_master_change_policy_axis', ['domain', 'axis'], { unique: true }),
+    (0, typeorm_1.Entity)('ops_master_change_policy')
+    /*
+     * 도메인 × 축에 **줄이 여럿 선다.** 정책은 바뀌고, 바뀌면 새 줄이 서고, 지난 개정본은 자기가 만들어질
+     * 때의 줄을 그대로 가리킨다 — 그래야 「그때는 무슨 규칙이었나」가 안 흔들린다.
+     *
+     * 전에는 유니크였다. 그래서 바꾸려면 그 줄을 덮어야 했고, 덮으면 승인받고 만든 개정본이 소급해서
+     * 승인 없이 만든 것이 됐다. 그래서 코드가 바꾸기를 거절했고, **정책을 영영 못 바꿨다.**
+     *
+     * ⚠ **이 정책을 바꾸는 일 자체는 결재에 안 태운다**(2026-09-22). 사업장 소유자가 정하는 것이라
+     * 소유자 확인만 받고 바로 선다. 태울 필요가 생기면 그때 결재 활동을 붙인다 — 줄이 여럿 서는
+     * 구조라 붙이는 자리는 이미 있다.
+     */
+    ,
+    (0, typeorm_1.Index)('ix_master_change_policy_axis', ['domain', 'axis']),
     (0, typeorm_1.Index)('ix_master_change_policy_identity', ['domain', 'id'], { unique: true })
 ], MasterChangePolicy);
+/** 아무도 안 정한 축이 도는 방식 — 바꾸려면 여기 하나만 고치면 된다. */
+exports.DEFAULT_APPROVAL_REQUIRED = false;
+/**
+ * 이 축이 지금 어떻게 도는가. **아무도 안 정했으면 기본값으로 한 줄을 세우고 그것을 답한다.**
+ *
+ * 전에는 거절했다(`MASTER_POLICY_REQUIRED`). 그래서 새 사업장은 축 열여섯이 전부 막힌 채로 시작했고,
+ * 기준정보를 만들려던 사람이 「정책을 먼저 정하라」는 말만 받았다 — 어디서 정하는지는 안 적혀 있었다.
+ *
+ * 값을 그때그때 지어내지 않고 **줄을 세우는** 까닭은, 개정본이 자기가 어느 정책 아래 만들어졌는지를
+ * 그 줄로 가리키기 때문이다(ADR-0090). 가리킬 줄이 없으면 그 물음에 나중에 답할 수 없다.
+ *
+ * 그 줄의 `creator` 는 비어 있다. 아무도 고른 적이 없다는 것이 사실이고, 사업장을 만든 사람을 적으면
+ * 그 사람이 정한 것이 된다.
+ */
 async function masterChangePolicy(manager, domainId, axis) {
     policyAxis(axis);
-    const policy = await manager.findOneBy(MasterChangePolicy, { domain: { id: domainId }, axis });
-    if (!policy)
-        throw new shell_1.Refusal('MASTER_POLICY_REQUIRED', { axis }, 'Declare the domain policy for this master axis before publishing changes.');
-    return policy;
+    const policy = await standingPolicy(manager, domainId, axis);
+    if (policy) {
+        return policy;
+    }
+    if (!manager.queryRunner?.isTransactionActive)
+        throw new shell_1.Refusal('TRANSACTION_REQUIRED', {}, 'A transaction is required.');
+    return manager.save(MasterChangePolicy, manager.create(MasterChangePolicy, {
+        domain: { id: domainId },
+        axis,
+        approvalRequired: exports.DEFAULT_APPROVAL_REQUIRED,
+        reason: 'nobody set this axis; it runs on the default'
+    }));
+}
+/** 이 축에서 물러나지 않은 줄 전부 — 보통 하나다. */
+function standingRows(manager, domainId, axis) {
+    return manager.findBy(MasterChangePolicy, { domain: { id: domainId }, axis, supersededAt: (0, typeorm_2.IsNull)() });
+}
+/**
+ * 지금 서 있는 줄.
+ *
+ * 둘 이상이 서 있으면 **가장 늦게 만들어진 것**을 답한다. 그 상태는 이 코드가 못 만들지만, 물러남
+ * 표를 두기 전에 쌓인 줄들이 그렇게 남아 있다. 다음 선언이 전부 물러나게 하고 하나로 정리한다.
+ */
+async function standingPolicy(manager, domainId, axis) {
+    const rows = await standingRows(manager, domainId, axis);
+    return rows.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime()).pop() ?? null;
+}
+/** 이 도메인에서 지금 서 있는 줄 전부 — 축을 열쇠로. */
+async function standingPolicies(manager, domainId) {
+    const rows = await manager.findBy(MasterChangePolicy, { domain: { id: domainId }, supersededAt: (0, typeorm_2.IsNull)() });
+    /* 이른 것부터 담아서 같은 축은 늦은 것이 이긴다 — `standingPolicy` 와 같은 답이 되도록. */
+    rows.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+    return new Map(rows.map(one => [one.axis, one]));
 }
 async function declareMasterChangePolicy(manager, domainId, actorId, axis, approvalRequired, reason) {
     if (!manager.queryRunner?.isTransactionActive)
@@ -73,32 +149,93 @@ async function declareMasterChangePolicy(manager, domainId, actorId, axis, appro
     policyAxis(axis);
     const domain = await manager.findOneByOrFail(shell_1.Domain, { id: domainId });
     if (domain.owner !== actorId)
-        throw new shell_1.Refusal('MASTER_POLICY_OWNER_REQUIRED', {}, 'Only the domain owner may make the initial policy declaration.');
+        throw new shell_1.Refusal('MASTER_POLICY_OWNER_REQUIRED', {}, 'Only the domain owner may declare or change the master change policy.');
     if (!reason?.trim())
-        throw new shell_1.Refusal('MASTER_POLICY_REASON_REQUIRED', {}, 'Explain the initial policy declaration.');
-    const existing = await manager.findOneBy(MasterChangePolicy, { domain: { id: domainId }, axis });
-    if (existing) {
-        if (existing.approvalRequired === approvalRequired)
-            return existing;
-        throw new shell_1.Refusal('MASTER_POLICY_CHANGE_REQUIRES_APPROVAL', {}, 'An established regulation policy cannot be changed through initial declaration.');
+        throw new shell_1.Refusal('MASTER_POLICY_REASON_REQUIRED', {}, 'Explain the policy declaration.');
+    /*
+     * 규제를 **거는** 쪽만 본다. 푸는 쪽은 결재선이 비어 있어도 되고, 오히려 비어서 멈춘 축을 푸는 것이
+     * 이 화면으로 할 수 있는 일이어야 한다.
+     */
+    if (approvalRequired) {
+        await (0, approval_route_1.assertApprovalRouteReady)(manager, domainId, axis);
+    }
+    const standing = await standingRows(manager, domainId, axis);
+    /*
+     * 같은 값을 다시 정하는 것은 아무 일도 아니다 — **하나만 서 있을 때** 그렇다. 여럿이 서 있으면
+     * 어느 것이 지금 것인지가 안 정해진 상태이므로, 값이 같아 보여도 전부 물리고 하나로 다시 세운다.
+     */
+    if (standing.length === 1 && standing[0].approvalRequired === approvalRequired) {
+        return standing[0];
+    }
+    const supersededAt = new Date();
+    for (const row of standing) {
+        row.supersededAt = supersededAt;
+        await manager.save(MasterChangePolicy, row);
     }
+    /*
+     * 바뀌면 **새 줄을 세운다. 있던 줄은 그대로 둔다.**
+     *
+     * 지난 개정본들이 그 줄을 가리키고 있다(`RecipeRevision.policy`, RESTRICT). 덮으면 그것들이
+     * 소급해서 다른 규칙 아래 만들어진 것이 된다 — 그래서 덮지 않고 새로 세운다. 오늘부터는 새 줄이
+     * 현재 정책이고, 지난 것은 자기 때의 줄을 계속 가리킨다.
+     */
     return manager.save(MasterChangePolicy, manager.create(MasterChangePolicy, {
-        domain,
+        domain: { id: domainId },
         axis,
         approvalRequired,
-        reason: reason.trim(),
+        reason,
         creator: { id: actorId }
     }));
 }
-/** The common mutation boundary also protects not-yet-revisioned axes when declared regulated. */
 async function assertDirectMasterChange(manager, domainId, axis) {
-    const policy = await manager.findOneBy(MasterChangePolicy, { domain: { id: domainId }, axis });
+    const policy = await standingPolicy(manager, domainId, axis);
     if (policy?.approvalRequired)
         throw new shell_1.Refusal('MASTER_APPROVAL_REQUIRED', { axis }, 'This master axis requires approval in this domain.');
 }
 let MasterChangePolicyResolver = class MasterChangePolicyResolver {
     async masterChangePolicy(axis, context) {
-        return masterChangePolicy((0, shell_1.getRepository)(MasterChangePolicy).manager, context.state.domain.id, axis);
+        /* 읽기만 하는 자리다. 안 정한 축에 줄을 세우지 않는다 — 그것은 고치러 들어간 쪽이 할 일이다. */
+        return standingPolicy((0, shell_1.getRepository)(MasterChangePolicy).manager, context.state.domain.id, axis);
+    }
+    /**
+     * 축 전부의 정책 상태 — **안 정한 것도 답한다.**
+     *
+     * `masterChangePolicy` 는 안 정했으면 거절한다. 그것은 「고치기 전에 정해라」를 말하는 자리라 맞지만,
+     * **정하러 들어가는 화면까지 막는다.** 그래서 목록은 따로 둔다 — 안 정한 축은 안 정했다고 답한다.
+     *
+     * `canDeclare` 는 **이 사람이 소유자인가**다. 화면이 스스로 판단하지 않게 서버가 말한다 —
+     * 눌러 보고 거절당하는 화면이 되지 않도록.
+     */
+    async masterChangePolicies(context) {
+        const { domain, user } = context.state;
+        const manager = (0, shell_1.getRepository)(MasterChangePolicy).manager;
+        /*
+         * **물러나지 않은 줄만** 읽는다. 축마다 줄이 여럿이라, 전부 담으면 저장소가 주는 차례대로 덮여서
+         * 바꾼 뒤에도 화면에 옛 값이 떴다(2026-09-22 화면에서 확인).
+         */
+        const byAxis = await standingPolicies(manager, domain.id);
+        return {
+            canDeclare: domain.owner === user?.id,
+            axes: await Promise.all(exports.POLICY_AXES.map(async (axis) => {
+                const policy = byAxis.get(axis);
+                /*
+                 * 결재 길이 준비됐나 — **화면이 누르기 전에 알아야 한다.** 답이 없는 축은 이 앱이 아직 이
+                 * 물음에 답할 길이 없다는 뜻이라 막지 않는다(`inspectApprovalRoute`).
+                 */
+                const route = await (0, approval_route_1.inspectApprovalRoute)(manager, domain.id, axis);
+                return {
+                    axis,
+                    declared: !!policy,
+                    /* 줄은 섰지만 사람이 고른 적은 없다 — 화면이 그것을 다르게 보인다. */
+                    byDefault: !!policy && !policy.creatorId,
+                    approvalRequired: policy?.approvalRequired ?? null,
+                    reason: policy?.reason ?? null,
+                    declaredAt: policy?.createdAt ?? null,
+                    approvalReady: route ? route.ready : true,
+                    approvalActivity: route?.activity ?? null
+                };
+            }))
+        };
     }
     async declareMasterChangePolicy(axis, approvalRequired, reason, context) {
         const { tx, domain, user } = context.state;
@@ -115,6 +252,14 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [String, Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], MasterChangePolicyResolver.prototype, "masterChangePolicy", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(() => shell_1.ScalarObject),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], MasterChangePolicyResolver.prototype, "masterChangePolicies", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
     (0, type_graphql_1.Directive)('@transaction'),

package/dist-server/service/master-change-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"master-change-policy.js","sourceRoot":"","sources":["../../server/service/master-change-policy.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  Entity,\n  EntityManager,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId\n} from 'typeorm'\nimport { Arg, Ctx, Directive, Mutation, Query, Resolver, UseMiddleware } from 'type-graphql'\nimport { Domain, getRepository, Refusal, ScalarObject, SpeakRefusals } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { masterAxisOf } from './master-axis'\n\n// WorkShift owns a domain-wide arrangement, not a row in the generic master CRUD registry.\nfunction policyAxis(axis: string) {\n  if (axis !== 'workShift') masterAxisOf(axis)\n}\n\n/** Initial domain×axis declaration. Changing an established policy needs its own approved decision. */\n@Entity('ops_master_change_policy')\n@Index('ix_master_change_policy_axis', ['domain', 'axis'], { unique: true })\n@Index('ix_master_change_policy_identity', ['domain', 'id'], { unique: true })\nexport class MasterChangePolicy {\n  @PrimaryGeneratedColumn('uuid') id: string\n  @ManyToOne(() => Domain, { nullable: false }) domain: Domain\n  @RelationId((row: MasterChangePolicy) => row.domain) domainId: string\n  @Column() axis: string\n  @Column() approvalRequired: boolean\n  @Column('text') reason: string\n  @ManyToOne(() => User, { nullable: false }) creator: User\n  @RelationId((row: MasterChangePolicy) => row.creator) creatorId: string\n  @CreateDateColumn() createdAt: Date\n}\n\nexport async function masterChangePolicy(manager: EntityManager, domainId: string, axis: string) {\n  policyAxis(axis)\n  const policy = await manager.findOneBy(MasterChangePolicy, { domain: { id: domainId }, axis })\n  if (!policy)\n    throw new Refusal(\n      'MASTER_POLICY_REQUIRED',\n      { axis },\n      'Declare the domain policy for this master axis before publishing changes.'\n    )\n  return policy\n}\n\nexport async function declareMasterChangePolicy(\n  manager: EntityManager,\n  domainId: string,\n  actorId: string,\n  axis: string,\n  approvalRequired: boolean,\n  reason: string\n) {\n  if (!manager.queryRunner?.isTransactionActive)\n    throw new Refusal('TRANSACTION_REQUIRED', {}, 'A transaction is required.')\n  policyAxis(axis)\n  const domain = await manager.findOneByOrFail(Domain, { id: domainId })\n  if (domain.owner !== actorId)\n    throw new Refusal(\n      'MASTER_POLICY_OWNER_REQUIRED',\n      {},\n      'Only the domain owner may make the initial policy declaration.'\n    )\n  if (!reason?.trim()) throw new Refusal('MASTER_POLICY_REASON_REQUIRED', {}, 'Explain the initial policy declaration.')\n  const existing = await manager.findOneBy(MasterChangePolicy, { domain: { id: domainId }, axis })\n  if (existing) {\n    if (existing.approvalRequired === approvalRequired) return existing\n    throw new Refusal(\n      'MASTER_POLICY_CHANGE_REQUIRES_APPROVAL',\n      {},\n      'An established regulation policy cannot be changed through initial declaration.'\n    )\n  }\n  return manager.save(\n    MasterChangePolicy,\n    manager.create(MasterChangePolicy, {\n      domain,\n      axis,\n      approvalRequired,\n      reason: reason.trim(),\n      creator: { id: actorId }\n    })\n  )\n}\n\n/** The common mutation boundary also protects not-yet-revisioned axes when declared regulated. */\nexport async function assertDirectMasterChange(manager: EntityManager, domainId: string, axis: string) {\n  const policy = await manager.findOneBy(MasterChangePolicy, { domain: { id: domainId }, axis })\n  if (policy?.approvalRequired)\n    throw new Refusal('MASTER_APPROVAL_REQUIRED', { axis }, 'This master axis requires approval in this domain.')\n}\n\n@Resolver()\n@UseMiddleware(SpeakRefusals)\nexport class MasterChangePolicyResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(() => ScalarObject)\n  async masterChangePolicy(@Arg('axis') axis: string, @Ctx() context: ResolverContext) {\n    return masterChangePolicy(getRepository(MasterChangePolicy).manager, context.state.domain.id, axis)\n  }\n\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(() => ScalarObject)\n  async declareMasterChangePolicy(\n    @Arg('axis') axis: string,\n    @Arg('approvalRequired') approvalRequired: boolean,\n    @Arg('reason') reason: string,\n    @Ctx() context: ResolverContext\n  ) {\n    const { tx, domain, user } = context.state\n    return declareMasterChangePolicy(tx, domain.id, user.id, axis, approvalRequired, reason)\n  }\n}\n"]}
+{"version":3,"file":"master-change-policy.js","sourceRoot":"","sources":["../../server/service/master-change-policy.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  Entity,\n  EntityManager,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId\n} from 'typeorm'\nimport { IsNull } from 'typeorm'\nimport { Arg, Ctx, Directive, Mutation, Query, Resolver, UseMiddleware } from 'type-graphql'\nimport { Domain, getRepository, Refusal, ScalarObject, SpeakRefusals } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { MASTER_AXES, masterAxisOf } from './master-axis'\nimport { assertApprovalRouteReady, inspectApprovalRoute } from './approval-route'\n\n// WorkShift owns a domain-wide arrangement, not a row in the generic master CRUD registry.\nfunction policyAxis(axis: string) {\n  if (axis !== 'workShift') masterAxisOf(axis)\n}\n\n/**\n * 정책을 정할 수 있는 축들 — 마스터 축 열다섯에 `workShift` 를 더한다.\n *\n * `workShift` 는 별도 모듈이라 `MASTER_AXES` 에 없는데 정책은 받는다(§`policyAxis`).\n */\nexport const POLICY_AXES = [...MASTER_AXES.map(one => one.key), 'workShift']\n\n/** 도메인 × 축의 기준정보 변경 정책 — 정하는 것도 바꾸는 것도 사업장 소유자의 몫이다. */\n@Entity('ops_master_change_policy')\n/*\n * 도메인 × 축에 **줄이 여럿 선다.** 정책은 바뀌고, 바뀌면 새 줄이 서고, 지난 개정본은 자기가 만들어질\n * 때의 줄을 그대로 가리킨다 — 그래야 「그때는 무슨 규칙이었나」가 안 흔들린다.\n *\n * 전에는 유니크였다. 그래서 바꾸려면 그 줄을 덮어야 했고, 덮으면 승인받고 만든 개정본이 소급해서\n * 승인 없이 만든 것이 됐다. 그래서 코드가 바꾸기를 거절했고, **정책을 영영 못 바꿨다.**\n *\n * ⚠ **이 정책을 바꾸는 일 자체는 결재에 안 태운다**(2026-09-22). 사업장 소유자가 정하는 것이라\n * 소유자 확인만 받고 바로 선다. 태울 필요가 생기면 그때 결재 활동을 붙인다 — 줄이 여럿 서는\n * 구조라 붙이는 자리는 이미 있다.\n */\n@Index('ix_master_change_policy_axis', ['domain', 'axis'])\n@Index('ix_master_change_policy_identity', ['domain', 'id'], { unique: true })\nexport class MasterChangePolicy {\n  @PrimaryGeneratedColumn('uuid') id: string\n  @ManyToOne(() => Domain, { nullable: false }) domain: Domain\n  @RelationId((row: MasterChangePolicy) => row.domain) domainId: string\n  @Column() axis: string\n  @Column() approvalRequired: boolean\n  @Column('text') reason: string\n  /**\n   * 이 줄이 물러난 시각 — 비어 있는 줄이 **지금 정책**이다.\n   *\n   * 차례를 `createdAt` 으로 세우지 않는다. sqlite 의 `datetime('now')` 는 초까지라, 한 사람이 같은\n   * 초에 두 번 바꾸면 어느 줄이 나중인지 저장소가 못 가린다. 물러난 줄에 표를 하면 그 물음이 사라진다.\n   */\n  @Column({ nullable: true }) supersededAt: Date\n  /**\n   * 누가 정했나 — **비어 있으면 아무도 안 정한 것**이고, 그 줄은 기본값으로 선 줄이다.\n   *\n   * 사람이 안 정한 줄에 사람을 적으면 그 사람이 정한 것이 된다. 사업장을 만든 사람도 이 축을 보고\n   * 고른 적이 없다.\n   */\n  @ManyToOne(() => User, { nullable: true }) creator: User\n  @RelationId((row: MasterChangePolicy) => row.creator) creatorId: string\n  @CreateDateColumn() createdAt: Date\n}\n\n/** 아무도 안 정한 축이 도는 방식 — 바꾸려면 여기 하나만 고치면 된다. */\nexport const DEFAULT_APPROVAL_REQUIRED = false\n\n/**\n * 이 축이 지금 어떻게 도는가. **아무도 안 정했으면 기본값으로 한 줄을 세우고 그것을 답한다.**\n *\n * 전에는 거절했다(`MASTER_POLICY_REQUIRED`). 그래서 새 사업장은 축 열여섯이 전부 막힌 채로 시작했고,\n * 기준정보를 만들려던 사람이 「정책을 먼저 정하라」는 말만 받았다 — 어디서 정하는지는 안 적혀 있었다.\n *\n * 값을 그때그때 지어내지 않고 **줄을 세우는** 까닭은, 개정본이 자기가 어느 정책 아래 만들어졌는지를\n * 그 줄로 가리키기 때문이다(ADR-0090). 가리킬 줄이 없으면 그 물음에 나중에 답할 수 없다.\n *\n * 그 줄의 `creator` 는 비어 있다. 아무도 고른 적이 없다는 것이 사실이고, 사업장을 만든 사람을 적으면\n * 그 사람이 정한 것이 된다.\n */\nexport async function masterChangePolicy(manager: EntityManager, domainId: string, axis: string) {\n  policyAxis(axis)\n  const policy = await standingPolicy(manager, domainId, axis)\n  if (policy) {\n    return policy\n  }\n\n  if (!manager.queryRunner?.isTransactionActive)\n    throw new Refusal('TRANSACTION_REQUIRED', {}, 'A transaction is required.')\n\n  return manager.save(\n    MasterChangePolicy,\n    manager.create(MasterChangePolicy, {\n      domain: { id: domainId },\n      axis,\n      approvalRequired: DEFAULT_APPROVAL_REQUIRED,\n      reason: 'nobody set this axis; it runs on the default'\n    })\n  )\n}\n\n/** 이 축에서 물러나지 않은 줄 전부 — 보통 하나다. */\nfunction standingRows(manager: EntityManager, domainId: string, axis: string) {\n  return manager.findBy(MasterChangePolicy, { domain: { id: domainId }, axis, supersededAt: IsNull() })\n}\n\n/**\n * 지금 서 있는 줄.\n *\n * 둘 이상이 서 있으면 **가장 늦게 만들어진 것**을 답한다. 그 상태는 이 코드가 못 만들지만, 물러남\n * 표를 두기 전에 쌓인 줄들이 그렇게 남아 있다. 다음 선언이 전부 물러나게 하고 하나로 정리한다.\n */\nexport async function standingPolicy(manager: EntityManager, domainId: string, axis: string) {\n  const rows = await standingRows(manager, domainId, axis)\n\n  return rows.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime()).pop() ?? null\n}\n\n/** 이 도메인에서 지금 서 있는 줄 전부 — 축을 열쇠로. */\nexport async function standingPolicies(manager: EntityManager, domainId: string) {\n  const rows = await manager.findBy(MasterChangePolicy, { domain: { id: domainId }, supersededAt: IsNull() })\n\n  /* 이른 것부터 담아서 같은 축은 늦은 것이 이긴다 — `standingPolicy` 와 같은 답이 되도록. */\n  rows.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime())\n\n  return new Map(rows.map(one => [one.axis, one]))\n}\n\nexport async function declareMasterChangePolicy(\n  manager: EntityManager,\n  domainId: string,\n  actorId: string,\n  axis: string,\n  approvalRequired: boolean,\n  reason: string\n) {\n  if (!manager.queryRunner?.isTransactionActive)\n    throw new Refusal('TRANSACTION_REQUIRED', {}, 'A transaction is required.')\n  policyAxis(axis)\n  const domain = await manager.findOneByOrFail(Domain, { id: domainId })\n  if (domain.owner !== actorId)\n    throw new Refusal(\n      'MASTER_POLICY_OWNER_REQUIRED',\n      {},\n      'Only the domain owner may declare or change the master change policy.'\n    )\n  if (!reason?.trim()) throw new Refusal('MASTER_POLICY_REASON_REQUIRED', {}, 'Explain the policy declaration.')\n\n  /*\n   * 규제를 **거는** 쪽만 본다. 푸는 쪽은 결재선이 비어 있어도 되고, 오히려 비어서 멈춘 축을 푸는 것이\n   * 이 화면으로 할 수 있는 일이어야 한다.\n   */\n  if (approvalRequired) {\n    await assertApprovalRouteReady(manager, domainId, axis)\n  }\n\n  const standing = await standingRows(manager, domainId, axis)\n\n  /*\n   * 같은 값을 다시 정하는 것은 아무 일도 아니다 — **하나만 서 있을 때** 그렇다. 여럿이 서 있으면\n   * 어느 것이 지금 것인지가 안 정해진 상태이므로, 값이 같아 보여도 전부 물리고 하나로 다시 세운다.\n   */\n  if (standing.length === 1 && standing[0].approvalRequired === approvalRequired) {\n    return standing[0]\n  }\n\n  const supersededAt = new Date()\n  for (const row of standing) {\n    row.supersededAt = supersededAt\n    await manager.save(MasterChangePolicy, row)\n  }\n\n  /*\n   * 바뀌면 **새 줄을 세운다. 있던 줄은 그대로 둔다.**\n   *\n   * 지난 개정본들이 그 줄을 가리키고 있다(`RecipeRevision.policy`, RESTRICT). 덮으면 그것들이\n   * 소급해서 다른 규칙 아래 만들어진 것이 된다 — 그래서 덮지 않고 새로 세운다. 오늘부터는 새 줄이\n   * 현재 정책이고, 지난 것은 자기 때의 줄을 계속 가리킨다.\n   */\n  return manager.save(\n    MasterChangePolicy,\n    manager.create(MasterChangePolicy, {\n      domain: { id: domainId },\n      axis,\n      approvalRequired,\n      reason,\n      creator: { id: actorId }\n    })\n  )\n}\n\nexport async function assertDirectMasterChange(manager: EntityManager, domainId: string, axis: string) {\n  const policy = await standingPolicy(manager, domainId, axis)\n  if (policy?.approvalRequired)\n    throw new Refusal('MASTER_APPROVAL_REQUIRED', { axis }, 'This master axis requires approval in this domain.')\n}\n\n@Resolver()\n@UseMiddleware(SpeakRefusals)\nexport class MasterChangePolicyResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(() => ScalarObject)\n  async masterChangePolicy(@Arg('axis') axis: string, @Ctx() context: ResolverContext) {\n    /* 읽기만 하는 자리다. 안 정한 축에 줄을 세우지 않는다 — 그것은 고치러 들어간 쪽이 할 일이다. */\n    return standingPolicy(getRepository(MasterChangePolicy).manager, context.state.domain.id, axis)\n  }\n\n  /**\n   * 축 전부의 정책 상태 — **안 정한 것도 답한다.**\n   *\n   * `masterChangePolicy` 는 안 정했으면 거절한다. 그것은 「고치기 전에 정해라」를 말하는 자리라 맞지만,\n   * **정하러 들어가는 화면까지 막는다.** 그래서 목록은 따로 둔다 — 안 정한 축은 안 정했다고 답한다.\n   *\n   * `canDeclare` 는 **이 사람이 소유자인가**다. 화면이 스스로 판단하지 않게 서버가 말한다 —\n   * 눌러 보고 거절당하는 화면이 되지 않도록.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(() => ScalarObject)\n  async masterChangePolicies(@Ctx() context: ResolverContext) {\n    const { domain, user } = context.state\n    const manager = getRepository(MasterChangePolicy).manager\n    /*\n     * **물러나지 않은 줄만** 읽는다. 축마다 줄이 여럿이라, 전부 담으면 저장소가 주는 차례대로 덮여서\n     * 바꾼 뒤에도 화면에 옛 값이 떴다(2026-09-22 화면에서 확인).\n     */\n    const byAxis = await standingPolicies(manager, domain.id)\n\n    return {\n      canDeclare: domain.owner === user?.id,\n      axes: await Promise.all(\n        POLICY_AXES.map(async axis => {\n        const policy = byAxis.get(axis)\n        /*\n         * 결재 길이 준비됐나 — **화면이 누르기 전에 알아야 한다.** 답이 없는 축은 이 앱이 아직 이\n         * 물음에 답할 길이 없다는 뜻이라 막지 않는다(`inspectApprovalRoute`).\n         */\n        const route = await inspectApprovalRoute(manager, domain.id, axis)\n\n        return {\n          axis,\n          declared: !!policy,\n          /* 줄은 섰지만 사람이 고른 적은 없다 — 화면이 그것을 다르게 보인다. */\n          byDefault: !!policy && !policy.creatorId,\n          approvalRequired: policy?.approvalRequired ?? null,\n          reason: policy?.reason ?? null,\n          declaredAt: policy?.createdAt ?? null,\n          approvalReady: route ? route.ready : true,\n          approvalActivity: route?.activity ?? null\n        }\n        })\n      )\n    }\n  }\n\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(() => ScalarObject)\n  async declareMasterChangePolicy(\n    @Arg('axis') axis: string,\n    @Arg('approvalRequired') approvalRequired: boolean,\n    @Arg('reason') reason: string,\n    @Ctx() context: ResolverContext\n  ) {\n    const { tx, domain, user } = context.state\n    return declareMasterChangePolicy(tx, domain.id, user.id, axis, approvalRequired, reason)\n  }\n}\n"]}