@things-factory/ops-master 10.1.248 → 10.1.249

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

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MasterChangePolicyResolver = exports.DEFAULT_APPROVAL_REQUIRED = exports.MasterChangePolicy = exports.POLICY_AXES = void 0;
+exports.axisHasRevision = axisHasRevision;
+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);
+}
+/**
+ * 정책을 정할 수 있는 축들 — 마스터 축 열다섯에 `workShift` 를 더한다.
+ *
+ * `workShift` 는 별도 모듈이라 `MASTER_AXES` 에 없는데 정책은 받는다(§`policyAxis`).
+ */
+exports.POLICY_AXES = [...master_axis_1.MASTER_AXES.map(one => one.key), 'workShift'];
+/**
+ * 이 축의 바뀜을 **개정본으로 결재에 보낼 수 있나** — 승인으로 켤 수 있는 축인가.
+ *
+ * 마스터 축은 자기 선언(`MasterAxis.revisable`)이 답한다. `workShift` 는 그 표 밖에서 자기 패키지가
+ * 개정 체계를 지었으므로 참이다(`work-shift-revision-service`). 앱이 답하지 않는다 — 문이 없으면
+ * 어느 앱에서도 보낼 곳이 없다.
+ */
+function axisHasRevision(axis) {
+    if (axis === 'workShift')
+        return true;
+    return (0, master_axis_1.masterAxisOf)(axis).revisable;
+}
+/** 도메인 × 축의 기준정보 변경 정책 — 정하는 것도 바꾸는 것도 사업장 소유자의 몫이다. */
+let MasterChangePolicy = class MasterChangePolicy {
+};
+exports.MasterChangePolicy = MasterChangePolicy;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    tslib_1.__metadata("design:type", String)
+], MasterChangePolicy.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(() => shell_1.Domain, { nullable: false }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], MasterChangePolicy.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((row) => row.domain),
+    tslib_1.__metadata("design:type", String)
+], MasterChangePolicy.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    tslib_1.__metadata("design:type", String)
+], MasterChangePolicy.prototype, "axis", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    tslib_1.__metadata("design:type", Boolean)
+], MasterChangePolicy.prototype, "approvalRequired", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('text'),
+    tslib_1.__metadata("design:type", String)
+], MasterChangePolicy.prototype, "reason", void 0);
+tslib_1.__decorate([
+    (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([
+    (0, typeorm_1.RelationId)((row) => row.creator),
+    tslib_1.__metadata("design:type", String)
+], MasterChangePolicy.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    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')
+    /*
+     * 도메인 × 축에 **줄이 여럿 선다.** 정책은 바뀌고, 바뀌면 새 줄이 서고, 지난 개정본은 자기가 만들어질
+     * 때의 줄을 그대로 가리킨다 — 그래야 「그때는 무슨 규칙이었나」가 안 흔들린다.
+     *
+     * 전에는 유니크였다. 그래서 바꾸려면 그 줄을 덮어야 했고, 덮으면 승인받고 만든 개정본이 소급해서
+     * 승인 없이 만든 것이 됐다. 그래서 코드가 바꾸기를 거절했고, **정책을 영영 못 바꿨다.**
+     *
+     * ⚠ **이 정책을 바꾸는 일 자체는 결재에 안 태운다**(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 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)
+        throw new shell_1.Refusal('TRANSACTION_REQUIRED', {}, 'A transaction is required.');
+    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 declare or change the master change policy.');
+    if (!reason?.trim())
+        throw new shell_1.Refusal('MASTER_POLICY_REASON_REQUIRED', {}, 'Explain the policy declaration.');
+    /*
+     * 규제를 **거는** 쪽만 본다. 푸는 쪽은 결재선이 비어 있어도 되고, 오히려 비어서 멈춘 축을 푸는 것이
+     * 이 화면으로 할 수 있는 일이어야 한다.
+     */
+    if (approvalRequired) {
+        /*
+         * 개정본 문이 없는 축은 **켜는 것부터 막는다**(2026-09-24). 켜면 직접 쓰기가 전부 거절되는데 결재로
+         * 보낼 곳이 없어서 그 축이 통째로 잠긴다. 결재선을 묻기 전에 본다 — 결재선이 있어도 보낼 문이 없다.
+         */
+        if (!axisHasRevision(axis))
+            throw new shell_1.Refusal('MASTER_AXIS_HAS_NO_REVISION', { axis }, 'This master cannot be sent for approval yet, so it cannot be set to change only after approval.');
+        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: { id: domainId },
+        axis,
+        approvalRequired,
+        reason,
+        creator: { id: actorId }
+    }));
+}
+async function assertDirectMasterChange(manager, 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) {
+        /* 읽기만 하는 자리다. 안 정한 축에 줄을 세우지 않는다 — 그것은 고치러 들어간 쪽이 할 일이다. */
+        policyAxis(axis);
+        const policy = await standingPolicy((0, shell_1.getRepository)(MasterChangePolicy).manager, context.state.domain.id, axis);
+        // A fresh site's editor must see the same default the first write will use, without inventing a policy id.
+        return policy
+            ? { ...policy, declared: true }
+            : { axis, declared: false, approvalRequired: exports.DEFAULT_APPROVAL_REQUIRED };
+    }
+    /**
+     * 축 전부의 정책 상태 — **안 정한 것도 답한다.**
+     *
+     * 단일 조회처럼 안 정한 축은 기본값과 미선언 상태를 답한다. 목록에는 관리 권한과 결재 경로 상태도 담는다.
+     *
+     * `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,
+                    /* 승인으로 켤 수 있는 축인가 — 아니면 화면은 누르기 전에 그 까닭을 말한다. */
+                    revisable: axisHasRevision(axis),
+                    approvalReady: route ? route.ready : true,
+                    approvalActivity: route?.activity ?? null
+                };
+            }))
+        };
+    }
+    async declareMasterChangePolicy(axis, approvalRequired, reason, context) {
+        const { tx, domain, user } = context.state;
+        return declareMasterChangePolicy(tx, domain.id, user.id, axis, approvalRequired, reason);
+    }
+};
+exports.MasterChangePolicyResolver = MasterChangePolicyResolver;
+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.Arg)('axis')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    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'),
+    (0, type_graphql_1.Mutation)(() => shell_1.ScalarObject),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('axis')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('approvalRequired')),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('reason')),
+    tslib_1.__param(3, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Boolean, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], MasterChangePolicyResolver.prototype, "declareMasterChangePolicy", null);
+exports.MasterChangePolicyResolver = MasterChangePolicyResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], MasterChangePolicyResolver);
+//# sourceMappingURL=master-change-policy.js.map

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

@@ -0,0 +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 { 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 * 이 축의 바뀜을 **개정본으로 결재에 보낼 수 있나** — 승인으로 켤 수 있는 축인가.\n *\n * 마스터 축은 자기 선언(`MasterAxis.revisable`)이 답한다. `workShift` 는 그 표 밖에서 자기 패키지가\n * 개정 체계를 지었으므로 참이다(`work-shift-revision-service`). 앱이 답하지 않는다 — 문이 없으면\n * 어느 앱에서도 보낼 곳이 없다.\n */\nexport function axisHasRevision(axis: string): boolean {\n  if (axis === 'workShift') return true\n  return masterAxisOf(axis).revisable\n}\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    /*\n     * 개정본 문이 없는 축은 **켜는 것부터 막는다**(2026-09-24). 켜면 직접 쓰기가 전부 거절되는데 결재로\n     * 보낼 곳이 없어서 그 축이 통째로 잠긴다. 결재선을 묻기 전에 본다 — 결재선이 있어도 보낼 문이 없다.\n     */\n    if (!axisHasRevision(axis))\n      throw new Refusal(\n        'MASTER_AXIS_HAS_NO_REVISION',\n        { axis },\n        'This master cannot be sent for approval yet, so it cannot be set to change only after approval.'\n      )\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    policyAxis(axis)\n    const policy = await standingPolicy(getRepository(MasterChangePolicy).manager, context.state.domain.id, axis)\n    // A fresh site's editor must see the same default the first write will use, without inventing a policy id.\n    return policy\n      ? { ...policy, declared: true }\n      : { axis, declared: false, approvalRequired: DEFAULT_APPROVAL_REQUIRED }\n  }\n\n  /**\n   * 축 전부의 정책 상태 — **안 정한 것도 답한다.**\n   *\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          /* 승인으로 켤 수 있는 축인가 — 아니면 화면은 누르기 전에 그 까닭을 말한다. */\n          revisable: axisHasRevision(axis),\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"]}

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

@@ -0,0 +1,34 @@
+/**
+ * 마스터 정합성 — **사람이 눌러서 도는 검사.**
+ *
+ * 목록 화면이 매번 부르는 것이 아니다. 표를 통째로 읽어야 답이 나오고, 상한을 두면 「어긋남 0건」이
+ * 거짓이 되기 때문이다. 정합성은 「전부 봤나」가 곧 답이다.
+ */
+export declare class MasterFinding {
+    axis: string;
+    subject?: string;
+    kind: string;
+    field: string;
+    value?: string;
+}
+export declare class MasterFindingCount {
+    axis: string;
+    kind: string;
+    count: number;
+}
+export declare class MasterScanned {
+    axis: string;
+    rows: number;
+}
+export declare class MasterConformance {
+    /**
+     * 무엇을 몇 개 봤나. **어긋남 0건이 「멀쩡하다」인지 「안 돌았다」인지는 이것으로만 갈린다.**
+     */
+    scanned: MasterScanned[];
+    total: number;
+    counts: MasterFindingCount[];
+    findings: MasterFinding[];
+}
+export declare class MasterConformanceResolver {
+    masterConformance(context: ResolverContext): Promise<MasterConformance>;
+}

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

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MasterConformanceResolver = exports.MasterConformance = exports.MasterScanned = exports.MasterFindingCount = exports.MasterFinding = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const physical_asset_1 = require("./asset/physical-asset");
+const physical_asset_class_1 = require("./asset/physical-asset-class");
+const equipment_1 = require("./equipment/equipment");
+const equipment_class_1 = require("./equipment/equipment-class");
+const stop_reason_1 = require("./equipment/stop-reason");
+const operational_location_1 = require("./location/operational-location");
+const material_class_1 = require("./material/material-class");
+const material_definition_1 = require("./material/material-definition");
+const operation_definition_1 = require("./operation/operation-definition");
+const person_1 = require("./personnel/person");
+const personnel_class_1 = require("./personnel/personnel-class");
+const recipe_definition_1 = require("./recipe/recipe-definition");
+const route_definition_1 = require("./recipe/route-definition");
+const test_specification_1 = require("./test-spec/test-specification");
+const master_conformance_1 = require("./master-conformance");
+const recipe_effective_list_1 = require("./recipe/recipe-effective-list");
+const material_effective_list_1 = require("./material/material-effective-list");
+/**
+ * 마스터 정합성 — **사람이 눌러서 도는 검사.**
+ *
+ * 목록 화면이 매번 부르는 것이 아니다. 표를 통째로 읽어야 답이 나오고, 상한을 두면 「어긋남 0건」이
+ * 거짓이 되기 때문이다. 정합성은 「전부 봤나」가 곧 답이다.
+ */
+let MasterFinding = class MasterFinding {
+};
+exports.MasterFinding = MasterFinding;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterFinding.prototype, "axis", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], MasterFinding.prototype, "subject", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterFinding.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterFinding.prototype, "field", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], MasterFinding.prototype, "value", void 0);
+exports.MasterFinding = MasterFinding = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'One master data conformance finding' })
+], MasterFinding);
+let MasterFindingCount = class MasterFindingCount {
+};
+exports.MasterFindingCount = MasterFindingCount;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterFindingCount.prototype, "axis", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterFindingCount.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], MasterFindingCount.prototype, "count", void 0);
+exports.MasterFindingCount = MasterFindingCount = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'How many findings per axis and kind' })
+], MasterFindingCount);
+let MasterScanned = class MasterScanned {
+};
+exports.MasterScanned = MasterScanned;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], MasterScanned.prototype, "axis", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], MasterScanned.prototype, "rows", void 0);
+exports.MasterScanned = MasterScanned = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'How many rows were scanned per axis' })
+], MasterScanned);
+let MasterConformance = class MasterConformance {
+};
+exports.MasterConformance = MasterConformance;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [MasterScanned]),
+    tslib_1.__metadata("design:type", Array)
+], MasterConformance.prototype, "scanned", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'How many findings in total' }),
+    tslib_1.__metadata("design:type", Number)
+], MasterConformance.prototype, "total", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [MasterFindingCount]),
+    tslib_1.__metadata("design:type", Array)
+], MasterConformance.prototype, "counts", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [MasterFinding]),
+    tslib_1.__metadata("design:type", Array)
+], MasterConformance.prototype, "findings", void 0);
+exports.MasterConformance = MasterConformance = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Master data conformance report' })
+], MasterConformance);
+let MasterConformanceResolver = class MasterConformanceResolver {
+    async masterConformance(context) {
+        const { domain } = context.state;
+        const snapshot = await (0, master_conformance_1.readMasterSnapshot)(domain, (entity) => entity === recipe_definition_1.RecipeDefinition
+            ? { find: async () => (await (0, recipe_effective_list_1.listEffectiveRecipes)((0, shell_1.getRepository)(recipe_definition_1.RecipeDefinition).manager, domain, {
+                    filters: [{ name: 'materialDefinitionName', operator: 'is_not_null', value: true }]
+                })).items }
+            : entity === material_definition_1.MaterialDefinition
+                ? { find: async () => (await (0, material_effective_list_1.listEffectiveMaterialDefinitions)((0, shell_1.getRepository)(material_definition_1.MaterialDefinition).manager, domain, {
+                        filters: [{ name: 'revisionNumber', operator: 'is_not_null', value: true }]
+                    })).items }
+                : (0, shell_1.getRepository)(entity), {
+            Person: person_1.Person,
+            PersonnelClass: personnel_class_1.PersonnelClass,
+            Equipment: equipment_1.Equipment,
+            EquipmentClass: equipment_class_1.EquipmentClass,
+            PhysicalAsset: physical_asset_1.PhysicalAsset,
+            PhysicalAssetClass: physical_asset_class_1.PhysicalAssetClass,
+            MaterialDefinition: material_definition_1.MaterialDefinition,
+            MaterialClass: material_class_1.MaterialClass,
+            OperationDefinition: operation_definition_1.OperationDefinition,
+            RouteDefinition: route_definition_1.RouteDefinition,
+            RecipeDefinition: recipe_definition_1.RecipeDefinition,
+            OperationalLocation: operational_location_1.OperationalLocation,
+            StopReason: stop_reason_1.StopReason,
+            TestSpecification: test_specification_1.TestSpecification
+        });
+        const findings = (0, master_conformance_1.checkMaster)(snapshot);
+        return { scanned: (0, master_conformance_1.scannedCounts)(snapshot), total: findings.length, counts: (0, master_conformance_1.summarize)(findings), findings };
+    }
+};
+exports.MasterConformanceResolver = MasterConformanceResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => MasterConformance, { description: 'Check master data for missing fields and dangling references' }),
+    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)
+], MasterConformanceResolver.prototype, "masterConformance", null);
+exports.MasterConformanceResolver = MasterConformanceResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)()
+], MasterConformanceResolver);
+//# sourceMappingURL=master-conformance-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"master-conformance-resolver.js","sourceRoot":"","sources":["../../server/service/master-conformance-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { Ctx, Directive, Field, Int, ObjectType, Query, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { PhysicalAsset } from './asset/physical-asset'\nimport { PhysicalAssetClass } from './asset/physical-asset-class'\nimport { Equipment } from './equipment/equipment'\nimport { EquipmentClass } from './equipment/equipment-class'\nimport { StopReason } from './equipment/stop-reason'\nimport { OperationalLocation } from './location/operational-location'\nimport { MaterialClass } from './material/material-class'\nimport { MaterialDefinition } from './material/material-definition'\nimport { OperationDefinition } from './operation/operation-definition'\nimport { Person } from './personnel/person'\nimport { PersonnelClass } from './personnel/personnel-class'\nimport { RecipeDefinition } from './recipe/recipe-definition'\nimport { RouteDefinition } from './recipe/route-definition'\nimport { TestSpecification } from './test-spec/test-specification'\nimport { checkMaster, readMasterSnapshot, scannedCounts, summarize } from './master-conformance'\nimport { listEffectiveRecipes } from './recipe/recipe-effective-list'\nimport { listEffectiveMaterialDefinitions } from './material/material-effective-list'\n\n/**\n * 마스터 정합성 — **사람이 눌러서 도는 검사.**\n *\n * 목록 화면이 매번 부르는 것이 아니다. 표를 통째로 읽어야 답이 나오고, 상한을 두면 「어긋남 0건」이\n * 거짓이 되기 때문이다. 정합성은 「전부 봤나」가 곧 답이다.\n */\n\n@ObjectType({ description: 'One master data conformance finding' })\nexport class MasterFinding {\n  @Field()\n  axis: string\n\n  @Field({ nullable: true })\n  subject?: string\n\n  @Field()\n  kind: string\n\n  @Field()\n  field: string\n\n  @Field({ nullable: true })\n  value?: string\n}\n\n@ObjectType({ description: 'How many findings per axis and kind' })\nexport class MasterFindingCount {\n  @Field()\n  axis: string\n\n  @Field()\n  kind: string\n\n  @Field(type => Int)\n  count: number\n}\n\n@ObjectType({ description: 'How many rows were scanned per axis' })\nexport class MasterScanned {\n  @Field()\n  axis: string\n\n  @Field(type => Int)\n  rows: number\n}\n\n@ObjectType({ description: 'Master data conformance report' })\nexport class MasterConformance {\n  /**\n   * 무엇을 몇 개 봤나. **어긋남 0건이 「멀쩡하다」인지 「안 돌았다」인지는 이것으로만 갈린다.**\n   */\n  @Field(type => [MasterScanned])\n  scanned: MasterScanned[]\n\n  @Field(type => Int, { description: 'How many findings in total' })\n  total: number\n\n  @Field(type => [MasterFindingCount])\n  counts: MasterFindingCount[]\n\n  @Field(type => [MasterFinding])\n  findings: MasterFinding[]\n}\n\n@Resolver()\nexport class MasterConformanceResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => MasterConformance, { description: 'Check master data for missing fields and dangling references' })\n  async masterConformance(@Ctx() context: ResolverContext): Promise<MasterConformance> {\n    const { domain } = context.state\n\n    const snapshot = await readMasterSnapshot(domain, (entity: any) => entity === RecipeDefinition\n      ? { find: async () => (await listEffectiveRecipes(getRepository(RecipeDefinition).manager, domain, {\n          filters: [{ name: 'materialDefinitionName', operator: 'is_not_null', value: true }]\n        } as any)).items }\n      : entity === MaterialDefinition\n        ? { find: async () => (await listEffectiveMaterialDefinitions(getRepository(MaterialDefinition).manager, domain, {\n            filters: [{ name: 'revisionNumber', operator: 'is_not_null', value: true }]\n          } as any)).items }\n        : getRepository(entity), {\n      Person,\n      PersonnelClass,\n      Equipment,\n      EquipmentClass,\n      PhysicalAsset,\n      PhysicalAssetClass,\n      MaterialDefinition,\n      MaterialClass,\n      OperationDefinition,\n      RouteDefinition,\n      RecipeDefinition,\n      OperationalLocation,\n      StopReason,\n      TestSpecification\n    })\n\n    const findings = checkMaster(snapshot)\n\n    return { scanned: scannedCounts(snapshot), total: findings.length, counts: summarize(findings), findings }\n  }\n}\n"]}

package/dist-server/service/master-conformance.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 마스터가 **말이 되나** — 축을 가로질러 한 번에 본다.
+ *
+ * ── 왜 필요한가 ────────────────────────────────────────────────────────────
+ * 축마다 화면이 있고 축마다 값이 차 있는데, 그 사이가 이어지는지는 아무도 안 봤다. 설비 등급 다섯이
+ * 서 있고 설비 스물둘이 어느 등급에도 안 들어 있던 일이 그랬다 — 두 화면 다 멀쩡해 보였다.
+ * 카메라 자산 다섯이 ECU 등급에 들어 있던 것도, 정지 사유 고르기가 빈 목록으로 보이던 것도 같다.
+ *
+ * 사람이 열두 화면을 오가며 맞춰 보는 것으로는 안 된다. 맞춰 보지 않으면 아무도 모르고, 맞춰 봤는지
+ * 아닌지도 남지 않는다.
+ *
+ * ── 두 가지만 본다 ─────────────────────────────────────────────────────────
+ * **비어 있으면 안 되는 칸**과 **가리키는데 없는 것**이다. 둘 다 사실 판정이라 다툼이 없다.
+ * 「이 값이 옳은가」는 여기서 안 본다 — 그것은 현장이 정한다.
+ *
+ * ── 없는 것을 없다고 말한다 ────────────────────────────────────────────────
+ * 표가 통째로 비었으면 그것도 낸다. 「빠진 것 0건」과 「아직 아무것도 안 세웠다」는 다르고, 세지
+ * 않으면 둘이 같아 보인다.
+ */
+/** 한 건의 어긋남. 사실만 담는다 — 무엇을, 어디서, 무엇이. */
+export interface Finding {
+    /** 어느 축인가. `person` · `equipment` · `recipeDefinition` … */
+    axis: string;
+    /** 어느 줄인가. 표가 통째로 빈 경우에는 없다. */
+    subject?: string;
+    /** `missing` = 비어 있으면 안 되는 칸이 비었다 · `dangling` = 가리키는데 그런 것이 없다 · `empty` = 표가 비었다 · `unused` = 아무도 안 가리킨다 */
+    kind: 'missing' | 'dangling' | 'empty' | 'unused';
+    /** 어느 칸인가(`missing`·`dangling`), 또는 무엇이 비었나(`empty`·`unused`). */
+    field: string;
+    /** 가리키던 값. `dangling` 일 때만. */
+    value?: string;
+}
+/** 한 축이 내놓는 줄들. 이름과 칸 몇 개만 본다. */
+export type Row = Record<string, any>;
+export interface MasterSnapshot {
+    persons: Row[];
+    equipment: Row[];
+    physicalAssets: Row[];
+    materialDefinitions: Row[];
+    operationDefinitions: Row[];
+    routeDefinitions: Row[];
+    recipeDefinitions: Row[];
+    operationalLocations: Row[];
+    stopReasons: Row[];
+    testSpecifications: Row[];
+    personnelClasses: Row[];
+    equipmentClasses: Row[];
+    physicalAssetClasses: Row[];
+    materialClasses: Row[];
+}
+/**
+ * 마스터 전체를 잰다.
+ *
+ * **순서에 뜻이 없다.** 어느 축부터 보든 같은 답이 나와야 하고, 그래야 이 결과를 두 번 재서
+ * 견줄 수 있다.
+ */
+export declare function checkMaster(snapshot: MasterSnapshot): Finding[];
+/**
+ * **무엇을 몇 개 봤나.**
+ *
+ * 어긋남 0건이 「멀쩡하다」인지 「안 돌았다」인지는 이것으로만 갈린다. 본 수를 안 내면 두 답이
+ * 같은 글자로 나온다 — 검사기가 스스로를 못 믿게 만드는 가장 흔한 방식이다.
+ */
+export declare function scannedCounts(snapshot: MasterSnapshot): {
+    axis: string;
+    rows: number;
+}[];
+/** 축·종류별로 몇 건인지. 사람이 먼저 볼 것을 고르는 데 쓴다. */
+export declare function summarize(findings: Finding[]): {
+    axis: string;
+    kind: string;
+    count: number;
+}[];
+/**
+ * 한 도메인의 마스터를 통째로 읽어 잰다.
+ *
+ * **상한을 두지 않는다.** 정합성은 「전부 봤나」가 곧 답이라, 일부만 보고 「어긋남 0건」이라고 하면
+ * 그 답이 거짓이 된다. 그래서 이것은 목록 화면이 부르는 것이 아니라 **사람이 눌러서 도는 검사**다.
+ */
+export declare function readMasterSnapshot(domain: any, getRepository: any, entities: Record<string, any>): Promise<MasterSnapshot>;