@things-factory/worklist 10.1.29 → 10.1.31

package/dist-server/service/work-door/work-door-type.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkDoorsType = exports.WorkDoorType = exports.DoorKindValue = exports.DoorStandingValue = void 0;
+exports.toDoorType = toDoorType;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+/**
+ * 「이 공장에서 어느 결재 문이 서 있나」를 화면에 낼 모양.
+ *
+ * 문자열 하나로 안 낸다 — 화면이 상태별로 다르게 그려야 하고, 그러려면 상태가 값이어야 한다.
+ * 문장만 주면 화면이 그 문장을 다시 뜯어 읽는다.
+ */
+var DoorStandingValue;
+(function (DoorStandingValue) {
+    /** 채워졌다. */
+    DoorStandingValue["On"] = "on";
+    /** 양식은 섰는데 받을 사람이 없다. 조치 대상. */
+    DoorStandingValue["Off"] = "off";
+    /** 양식이 아예 안 섰다 — 설정이 아니라 결함이다. 조치 대상. */
+    DoorStandingValue["Missing"] = "missing";
+    /** 이 공장이 안 쓰기로 했다. 조치 대상이 아니다. */
+    DoorStandingValue["NotUsed"] = "not-used";
+})(DoorStandingValue || (exports.DoorStandingValue = DoorStandingValue = {}));
+/** 결재냐 배정이냐 — 비었을 때 결과가 반대라 화면이 갈라 그려야 한다. */
+var DoorKindValue;
+(function (DoorKindValue) {
+    DoorKindValue["Approval"] = "approval";
+    DoorKindValue["Assignment"] = "assignment";
+})(DoorKindValue || (exports.DoorKindValue = DoorKindValue = {}));
+(0, type_graphql_1.registerEnumType)(DoorKindValue, {
+    name: 'DoorKind',
+    description: 'Whether the plant fills an approval line or an assignee role on this door'
+});
+(0, type_graphql_1.registerEnumType)(DoorStandingValue, {
+    name: 'DoorStanding',
+    description: 'Whether this plant has an approval step standing for that form'
+});
+let WorkDoorType = class WorkDoorType {
+};
+exports.WorkDoorType = WorkDoorType;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'the form name — the key the callback is found by' }),
+    tslib_1.__metadata("design:type", String)
+], WorkDoorType.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'what to show a person' }),
+    tslib_1.__metadata("design:type", String)
+], WorkDoorType.prototype, "label", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => DoorKindValue),
+    tslib_1.__metadata("design:type", String)
+], WorkDoorType.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => DoorStandingValue),
+    tslib_1.__metadata("design:type", String)
+], WorkDoorType.prototype, "standing", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'how many approvers — zero for an assignment door or an empty line' }),
+    tslib_1.__metadata("design:type", Number)
+], WorkDoorType.prototype, "approvers", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'which domain the approval line came from — a plant may use its parent\'s' }),
+    tslib_1.__metadata("design:type", String)
+], WorkDoorType.prototype, "from", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'what this standing means, in the words the screen shows' }),
+    tslib_1.__metadata("design:type", String)
+], WorkDoorType.prototype, "because", void 0);
+exports.WorkDoorType = WorkDoorType = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'One approval form and whether this plant has approvers on it' })
+], WorkDoorType);
+let WorkDoorsType = class WorkDoorsType {
+};
+exports.WorkDoorsType = WorkDoorsType;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [WorkDoorType]),
+    tslib_1.__metadata("design:type", Array)
+], WorkDoorsType.prototype, "doors", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'the whole plant in one sentence — a list alone makes the reader count rows' }),
+    tslib_1.__metadata("design:type", String)
+], WorkDoorsType.prototype, "summary", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'how many still need filling — not-used doors are never counted' }),
+    tslib_1.__metadata("design:type", Number)
+], WorkDoorsType.prototype, "todo", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'how many of the role seats this product offers actually exist here' }),
+    tslib_1.__metadata("design:type", Number)
+], WorkDoorsType.prototype, "seatsStanding", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'how many role seats this product offers' }),
+    tslib_1.__metadata("design:type", Number)
+], WorkDoorsType.prototype, "seatsOffered", void 0);
+exports.WorkDoorsType = WorkDoorsType = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Every approval form this product installs, and where this plant stands on each' })
+], WorkDoorsType);
+/** 판단의 모양을 화면의 모양으로. 열거형 철자는 `@Field` 가 정하므로 값으로 옮긴다. */
+function toDoorType(door) {
+    return {
+        name: door.name,
+        label: door.label,
+        kind: door.kind === 'assignment' ? DoorKindValue.Assignment : DoorKindValue.Approval,
+        standing: standingValue(door.standing),
+        approvers: door.approvers,
+        from: door.from,
+        because: door.because
+    };
+}
+function standingValue(standing) {
+    switch (standing) {
+        case 'on':
+            return DoorStandingValue.On;
+        case 'off':
+            return DoorStandingValue.Off;
+        case 'missing':
+            return DoorStandingValue.Missing;
+        default:
+            return DoorStandingValue.NotUsed;
+    }
+}
+//# sourceMappingURL=work-door-type.js.map

package/dist-server/service/work-door/work-door-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-door-type.js","sourceRoot":"","sources":["../../../server/service/work-door/work-door-type.ts"],"names":[],"mappings":"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","sourcesContent":["import { Field, Int, ObjectType, registerEnumType } from 'type-graphql'\n\nimport type { WorkDoor, DoorStanding } from './work-door.js'\n\n/**\n * 「이 공장에서 어느 결재 문이 서 있나」를 화면에 낼 모양.\n *\n * 문자열 하나로 안 낸다 — 화면이 상태별로 다르게 그려야 하고, 그러려면 상태가 값이어야 한다.\n * 문장만 주면 화면이 그 문장을 다시 뜯어 읽는다.\n */\n\nexport enum DoorStandingValue {\n  /** 채워졌다. */\n  On = 'on',\n  /** 양식은 섰는데 받을 사람이 없다. 조치 대상. */\n  Off = 'off',\n  /** 양식이 아예 안 섰다 — 설정이 아니라 결함이다. 조치 대상. */\n  Missing = 'missing',\n  /** 이 공장이 안 쓰기로 했다. 조치 대상이 아니다. */\n  NotUsed = 'not-used'\n}\n\n/** 결재냐 배정이냐 — 비었을 때 결과가 반대라 화면이 갈라 그려야 한다. */\nexport enum DoorKindValue {\n  Approval = 'approval',\n  Assignment = 'assignment'\n}\n\nregisterEnumType(DoorKindValue, {\n  name: 'DoorKind',\n  description: 'Whether the plant fills an approval line or an assignee role on this door'\n})\n\nregisterEnumType(DoorStandingValue, {\n  name: 'DoorStanding',\n  description: 'Whether this plant has an approval step standing for that form'\n})\n\n@ObjectType({ description: 'One approval form and whether this plant has approvers on it' })\nexport class WorkDoorType {\n  @Field({ description: 'the form name — the key the callback is found by' })\n  name: string\n\n  @Field({ description: 'what to show a person' })\n  label: string\n\n  @Field(type => DoorKindValue)\n  kind: DoorKindValue\n\n  @Field(type => DoorStandingValue)\n  standing: DoorStandingValue\n\n  @Field(type => Int, { description: 'how many approvers — zero for an assignment door or an empty line' })\n  approvers: number\n\n  @Field({ nullable: true, description: 'which domain the approval line came from — a plant may use its parent\\'s' })\n  from?: string\n\n  @Field({ description: 'what this standing means, in the words the screen shows' })\n  because: string\n}\n\n@ObjectType({ description: 'Every approval form this product installs, and where this plant stands on each' })\nexport class WorkDoorsType {\n  @Field(type => [WorkDoorType])\n  doors: WorkDoorType[]\n\n  @Field({ description: 'the whole plant in one sentence — a list alone makes the reader count rows' })\n  summary: string\n\n  @Field(type => Int, { description: 'how many still need filling — not-used doors are never counted' })\n  todo: number\n\n  /**\n   * 이 제품이 내놓는 역할 자리 중 **이 공장에 실제로 선 것.**\n   *\n   * ── 왜 문 목록에 자리 수가 붙나 ────────────────────────────────────────\n   * 문이 비었다는 말만 하면 사람은 양식 화면으로 간다. 그런데 **고를 역할이 없으면 그 화면의\n   * 결재선 칸이 빈 목록**이다. 헛걸음하고 돌아와서, 무엇이 잘못됐는지 모른 채 이 화면을 다시 본다.\n   *\n   * 두 수를 함께 내면 화면이 순서를 말할 수 있다 — 자리부터 세우고, 그다음에 결재선을 건다.\n   */\n  @Field(type => Int, { description: 'how many of the role seats this product offers actually exist here' })\n  seatsStanding: number\n\n  @Field(type => Int, { description: 'how many role seats this product offers' })\n  seatsOffered: number\n}\n\n/** 판단의 모양을 화면의 모양으로. 열거형 철자는 `@Field` 가 정하므로 값으로 옮긴다. */\nexport function toDoorType(door: WorkDoor): WorkDoorType {\n  return {\n    name: door.name,\n    label: door.label,\n    kind: door.kind === 'assignment' ? DoorKindValue.Assignment : DoorKindValue.Approval,\n    standing: standingValue(door.standing),\n    approvers: door.approvers,\n    from: door.from,\n    because: door.because\n  }\n}\n\nfunction standingValue(standing: DoorStanding): DoorStandingValue {\n  switch (standing) {\n    case 'on':\n      return DoorStandingValue.On\n    case 'off':\n      return DoorStandingValue.Off\n    case 'missing':\n      return DoorStandingValue.Missing\n    default:\n      return DoorStandingValue.NotUsed\n  }\n}\n"]}

package/dist-server/service/work-door/work-door.d.ts

@@ -0,0 +1,138 @@
+/**
+ * 이 공장에서 **어느 결재 문이 서 있나** — 순수 판단, DB 를 모른다.
+ *
+ * 결재선이 찼나를 세는 규칙은 상신하는 쪽과 **같은 함수**를 쓴다(§`approval-line-standing`). 여기서
+ * 따로 세면 화면이 「섰다」로 그리고 상신이 거절하는 날이 온다 — 그 자리가 실제로 있었다.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 왜 이것을 볼 자리가 필요한가 ───────────────────────────────────────────
+ * 양식은 제품이 기동할 때 세우고 **결재선은 그 공장이 채운다.** 채운 것이 「우리는 이 단계를 쓴다」는
+ * 선언이다. 그래서 결재선이 비어 있는 것은 결함이 아니다 — 그 공장의 선택이다.
+ *
+ * 문제는 **그 선택이 어디에도 안 보인다**는 것이다. 업무 카탈로그는 「제품이 이 문을 만들었나」를
+ * 보여 주지만 「이 공장에서 이 문이 서 있나」는 말하지 않는다. 두 질문이 다른데 하나만 보인다.
+ *
+ * 실측(2026-09-11): 미라텍 도메인에 양식 11개가 다 설치돼 있고 **11개 전부 결재선이 비어 있다.**
+ * 그 공장에서는 실적 정정도 폐기도 승인 없이 바로 반영되는데, 화면에는 문이 있는 것처럼 보인다.
+ *
+ * ── 비어 있으면 그냥 통과가 아니다 ─────────────────────────────────────────
+ * 워크리스트의 거동이 그렇다 — **결재선이 비면 상신이 곧 완료가 되어, 올린 사람이 자기 건을 승인한
+ * 것이 된다**(`activity-lookup.ts` § `approvalLineStanding`). 「승인을 안 받는다」가 아니라 「자기가
+ * 승인한다」다. 그 차이를 문장에 담는다.
+ *
+ * ── 기동 로그는 사실의 집이 아니다 ─────────────────────────────────────────
+ * `install-boot.ts` 가 기동할 때 한 줄 찍는다. 그 줄은 한 번 지나가고, 그 뒤로 어느 화면도 이것을
+ * 말하지 않는다. 사람이 조치해야 하는 사실은 물어볼 수 있는 자리에 있어야 한다.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * 문이 두 종류다 — **축이 다르고, 비었을 때 결과도 다르다.**
+ *
+ * ```
+ * approval    누가 승인하나   결재선이 비면  올린 사람이 곧 승인한 것이 된다 → 통과해 버린다
+ * assignment  누가 받나       역할이 안 묶이면  배정 업무가 아무에게도 안 간다 → 아무도 안 받는다
+ * ```
+ *
+ * 같은 `off` 인데 결과가 반대다. 한 벌 문장으로 뭉개면 관리자가 무엇을 해야 하는지 알 수 없다.
+ */
+import type { ApprovalLineStanding } from './approval-line-standing.js';
+export type DoorKind = 'approval' | 'assignment';
+/** 문 하나가 어떤 상태인가. */
+export type DoorStanding = 
+/** 채워졌다 — 이 공장은 이 문을 쓴다. */
+'on'
+/** 양식은 섰는데 비었다. **조치 대상.** */
+ | 'off'
+/** 양식이 아예 안 섰다 — 기동이 못 세웠다. 공장의 선택이 아니라 결함이다. **조치 대상.** */
+ | 'missing'
+/**
+ * **이 공장은 이 문을 안 쓴다** — 공장이 그렇게 말했다.
+ *
+ * 조치 대상이 아니다. 이것이 없으면 이 조사는 영원히 잔소리하는 화면이 되고, 그러면 사람들이
+ * 안 본다 — 그때 진짜 빈 문 하나가 그 잔소리에 섞여 묻힌다(아키텍트 판정 2026-09-11).
+ *
+ * **자동으로 추론하지 않는다.** 「석 달 안 썼으니 안 쓰는 것」은 조용한 한 철에 참이 된다.
+ */
+ | 'not-used';
+/** 이 문 하나에 대해 아는 것. */
+export interface WorkDoor {
+    /** 양식 이름. 콜백을 찾는 키다. */
+    name: string;
+    /** 화면에 낼 이름. */
+    label: string;
+    kind: DoorKind;
+    standing: DoorStanding;
+    /** 결재자 수. 안 섰거나 비었으면 0. */
+    approvers: number;
+    /**
+     * **남의 도메인에서 빌려 온 양식일 때만** 그 도메인의 이름.
+     *
+     * 본사에서 정하고 공장이 쓰는 것이 정상이라, 자기 것이 없으면 부모 것을 쓴다
+     * (`activityNamedIn`). 그 사실을 안 말하면 「우리가 정한 적 없는데 왜 서 있나」가 된다.
+     *
+     * ⚠ 자기 도메인이면 **없다.** 자기 이름을 채우면 화면이 모든 줄에 「miratek 에서 정했습니다」를
+     * 달고, 그 말은 아무것도 알려 주지 않는다 — 실제로 그랬다(2026-09-12, 화면으로 보고 알았다).
+     */
+    from?: string;
+    /** 이 상태가 무엇을 뜻하는지 — 화면에 그대로 나가는 문장. */
+    because: string;
+}
+/** 한 문에 대해 읽은 것. 엔티티를 통째로 받지 않는다 — 그러면 이 판단이 DB 를 끌고 온다. */
+export interface DoorReading {
+    name: string;
+    label: string;
+    kind: DoorKind;
+    /**
+     * 그 도메인(또는 부모)에 선 양식. 못 찾았으면 없다.
+     *
+     * 채워졌나를 보는 칸이 종류마다 다르다 — 결재는 `approvalLine`, 배정은 `assigneeRole` 이다.
+     */
+    /**
+     * `borrowedFrom` 은 **다른 도메인의 양식일 때만** 채운다. 자기 것이면 비운다 — 읽는 쪽이
+     * 「빌려 왔나」를 이 칸 하나로 판단한다.
+     */
+    installed?: {
+        approvalLine?: unknown[];
+        assigneeRole?: string;
+        borrowedFrom?: string;
+    };
+    /** 공장이 「안 쓴다」고 말했으면 그 사유. 말한 적 없으면 없다. */
+    notUsedBecause?: string;
+    /**
+     * **다른 문의 결재선을 따르면** 그 문의 이름(화면에 나가는 것). 그러면 `approvalStanding` 도 그 문의
+     * 것이다 — 이 문에서 결재선을 고치러 가면 안 되고 그 문으로 가야 한다는 것을 문장이 말한다.
+     */
+    follows?: string;
+    /**
+     * 결재선이 찼나 — **상신하는 쪽과 같은 함수**(`judgeApprovalLine`)가 낸 결과를 그대로 받는다.
+     *
+     * 여기서 다시 세지 않는다. 역할에 사람이 있는지는 DB 를 읽어야 알고, 이 판단은 DB 를 모른다.
+     * 없으면 「못 읽었다」로 읽는다 — 「안 읽었다」가 「다 찼다」로 새면 도로 줄 수 세기가 된다.
+     */
+    approvalStanding?: ApprovalLineStanding;
+}
+export declare function judgeDoor(reading: DoorReading): WorkDoor;
+/**
+ * 아직 채울 것이 몇 개인가 — **안 쓰기로 한 것은 안 센다.**
+ *
+ * 그래야 0 이 「다 됐다」를 뜻한다. 안 쓰는 것을 남은 수에 넣으면 다 채운 공장에서도 수가 안 줄고,
+ * 그 화면은 잔소리가 된다(아키텍트 판정 2026-09-11).
+ */
+export declare function doorsToFill(doors: readonly WorkDoor[]): number;
+/** 이 공장 전체를 한 문장으로 — 목록만 내면 읽는 사람이 11줄을 세어야 한다. */
+export declare function summarizeDoors(doors: readonly WorkDoor[]): string;
+/** The not-used declaration's content columns: which door and why. */
+export declare const WORK_DOOR_NOT_USED_CONTENT: readonly ["doorName", "because"];
+/** The declaration as it was — its content, who declared it, and when — written when it is withdrawn. */
+export declare function workDoorNotUsedBefore(declaration: {
+    doorName: string;
+    because: string;
+    declaredBy?: {
+        email?: string;
+        name?: string;
+    } | null;
+    createdAt?: Date | null;
+}): {
+    declaredBy: string;
+    declaredAt: Date;
+};

package/dist-server/service/work-door/work-door.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * 이 공장에서 **어느 결재 문이 서 있나** — 순수 판단, DB 를 모른다.
+ *
+ * 결재선이 찼나를 세는 규칙은 상신하는 쪽과 **같은 함수**를 쓴다(§`approval-line-standing`). 여기서
+ * 따로 세면 화면이 「섰다」로 그리고 상신이 거절하는 날이 온다 — 그 자리가 실제로 있었다.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 왜 이것을 볼 자리가 필요한가 ───────────────────────────────────────────
+ * 양식은 제품이 기동할 때 세우고 **결재선은 그 공장이 채운다.** 채운 것이 「우리는 이 단계를 쓴다」는
+ * 선언이다. 그래서 결재선이 비어 있는 것은 결함이 아니다 — 그 공장의 선택이다.
+ *
+ * 문제는 **그 선택이 어디에도 안 보인다**는 것이다. 업무 카탈로그는 「제품이 이 문을 만들었나」를
+ * 보여 주지만 「이 공장에서 이 문이 서 있나」는 말하지 않는다. 두 질문이 다른데 하나만 보인다.
+ *
+ * 실측(2026-09-11): 미라텍 도메인에 양식 11개가 다 설치돼 있고 **11개 전부 결재선이 비어 있다.**
+ * 그 공장에서는 실적 정정도 폐기도 승인 없이 바로 반영되는데, 화면에는 문이 있는 것처럼 보인다.
+ *
+ * ── 비어 있으면 그냥 통과가 아니다 ─────────────────────────────────────────
+ * 워크리스트의 거동이 그렇다 — **결재선이 비면 상신이 곧 완료가 되어, 올린 사람이 자기 건을 승인한
+ * 것이 된다**(`activity-lookup.ts` § `approvalLineStanding`). 「승인을 안 받는다」가 아니라 「자기가
+ * 승인한다」다. 그 차이를 문장에 담는다.
+ *
+ * ── 기동 로그는 사실의 집이 아니다 ─────────────────────────────────────────
+ * `install-boot.ts` 가 기동할 때 한 줄 찍는다. 그 줄은 한 번 지나가고, 그 뒤로 어느 화면도 이것을
+ * 말하지 않는다. 사람이 조치해야 하는 사실은 물어볼 수 있는 자리에 있어야 한다.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORK_DOOR_NOT_USED_CONTENT = void 0;
+exports.judgeDoor = judgeDoor;
+exports.doorsToFill = doorsToFill;
+exports.summarizeDoors = summarizeDoors;
+exports.workDoorNotUsedBefore = workDoorNotUsedBefore;
+function judgeDoor(reading) {
+    const { name, label, kind, installed, notUsedBecause, follows } = reading;
+    /* 따르는 문이 있으면 결재선을 고치는 자리가 그 문이다. 문장 끝에 그 사실을 붙인다. */
+    const following = follows ? ` — 「${follows}」 의 결재선을 따르므로, 결재선은 그 문에서 정합니다.` : '';
+    /*
+     * **공장이 안 쓴다고 말한 것이 먼저다.** 뒤에 두면 양식이 안 선 문을 「결함」으로 먼저 그리고,
+     * 안 쓰기로 한 공장이 고치라는 말을 계속 듣는다.
+     */
+    if (notUsedBecause) {
+        return {
+            name,
+            label,
+            kind,
+            standing: 'not-used',
+            approvers: 0,
+            because: `「${label}」 은 이 공장이 쓰지 않기로 한 업무입니다 — ${notUsedBecause}`
+        };
+    }
+    if (!installed) {
+        return {
+            name,
+            label,
+            kind,
+            standing: 'missing',
+            approvers: 0,
+            because: `「${label}」 양식이 이 공장에 서지 않았습니다. 공장이 안 쓰기로 한 것이 아니라 세우지 못한 것이므로 기동 기록을 보십시오.`
+        };
+    }
+    /*
+     * 결재 문은 **줄 수가 아니라 그 줄에 사람이 있는지**로 센다. 역할을 지목해 놓고 그 역할이 빈
+     * 결재선은 화면에 「섰다」로 그려지고 상신하는 순간 터진다(ADR-0047 ③).
+     */
+    const line = kind === 'approval' ? reading.approvalStanding : undefined;
+    const filled = kind === 'approval' ? (line && !line.refusal ? line.approvers : 0) : installed.assigneeRole ? 1 : 0;
+    const roleIsEmpty = line?.refusal?.code === 'approval-role-empty';
+    const personIsGone = line?.refusal?.code === 'approval-person-absent';
+    if (!filled) {
+        return {
+            name,
+            label,
+            kind,
+            standing: 'off',
+            approvers: 0,
+            from: installed.borrowedFrom,
+            /* 종류마다 결과가 반대다(§`DoorKind`). 그래서 문장도 다르다. */
+            because: (kind !== 'approval'
+                ? `「${label}」 을 받을 역할이 묶이지 않았습니다. 이 업무는 만들어져도 아무에게도 가지 않습니다.`
+                : roleIsEmpty
+                    ? /*
+                       * **관리자가 할 일이 다르다.** 결재선을 정하는 것과 그 역할에 사람을 넣는 것은 다른
+                       * 일이고, 뒤엣것을 앞엣것으로 말하면 이미 정해 둔 결재선을 다시 들여다보게 만든다.
+                       */
+                        `「${label}」 의 결재선이 지목한 역할에 사람이 없습니다. 결재선은 정해져 있으니 그 역할에 사람을 넣어야 이 단계가 섭니다.`
+                    : personIsGone
+                        ? `「${label}」 의 결재선이 지목한 사람이 이 공장에 없습니다. 다른 사람을 지목하거나 그 사람을 넣어야 이 단계가 섭니다.`
+                        : `「${label}」 에 결재자가 없습니다. 이 단계는 서지 않고, 올린 사람이 올리는 순간 자기 건을 승인한 것이 됩니다.`) +
+                following
+        };
+    }
+    return {
+        name,
+        label,
+        kind,
+        standing: 'on',
+        approvers: filled,
+        from: installed.borrowedFrom,
+        because: kind === 'approval'
+            ? `「${label}」 은 결재자 ${filled}명을 지납니다.${following}`
+            : `「${label}」 은 ${installed.assigneeRole} 가 받습니다.`
+    };
+}
+/**
+ * 아직 채울 것이 몇 개인가 — **안 쓰기로 한 것은 안 센다.**
+ *
+ * 그래야 0 이 「다 됐다」를 뜻한다. 안 쓰는 것을 남은 수에 넣으면 다 채운 공장에서도 수가 안 줄고,
+ * 그 화면은 잔소리가 된다(아키텍트 판정 2026-09-11).
+ */
+function doorsToFill(doors) {
+    return doors.filter(one => one.standing === 'off' || one.standing === 'missing').length;
+}
+/** 이 공장 전체를 한 문장으로 — 목록만 내면 읽는 사람이 11줄을 세어야 한다. */
+function summarizeDoors(doors) {
+    if (!doors.length) {
+        return '이 제품이 세우는 업무 양식이 없습니다.';
+    }
+    const on = doors.filter(one => one.standing === 'on').length;
+    const off = doors.filter(one => one.standing === 'off').length;
+    const missing = doors.filter(one => one.standing === 'missing').length;
+    const notUsed = doors.filter(one => one.standing === 'not-used').length;
+    /*
+     * **셀 것은 `off + missing` 뿐이다.** 그래야 0 이 「다 됐다」를 뜻한다. 안 쓰기로 한 것을 남은 수에
+     * 넣으면 다 채운 공장에서도 수가 안 줄고, 그 화면은 잔소리가 된다.
+     */
+    const todo = off + missing;
+    if (!todo) {
+        return notUsed
+            ? `채울 것이 남지 않았습니다. 업무 문 ${on}개가 서 있고 ${notUsed}개는 이 공장이 쓰지 않기로 한 것입니다.`
+            : `업무 문 ${doors.length}개가 다 서 있습니다.`;
+    }
+    const said = [`채울 것이 ${todo}개 남았습니다.`];
+    if (off) {
+        said.push(`${off}개는 양식은 섰는데 받을 사람이 없습니다 — 누가 할지 이 공장이 아직 정하지 않은 것입니다.`);
+    }
+    if (missing) {
+        said.push(`${missing}개는 양식이 아예 서지 않았습니다. 이것은 설정이 아니라 결함입니다.`);
+    }
+    if (notUsed) {
+        said.push(`${notUsed}개는 이 공장이 쓰지 않기로 한 것이라 세지 않았습니다.`);
+    }
+    return said.join(' ');
+}
+/** The not-used declaration's content columns: which door and why. */
+exports.WORK_DOOR_NOT_USED_CONTENT = ['doorName', 'because'];
+/** The declaration as it was — its content, who declared it, and when — written when it is withdrawn. */
+function workDoorNotUsedBefore(declaration) {
+    return {
+        ...Object.fromEntries(exports.WORK_DOOR_NOT_USED_CONTENT.map(column => [column, declaration[column] ?? null])),
+        declaredBy: declaration.declaredBy?.email ?? declaration.declaredBy?.name ?? null,
+        declaredAt: declaration.createdAt ?? null
+    };
+}
+//# sourceMappingURL=work-door.js.map

package/dist-server/service/work-door/work-door.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-door.js","sourceRoot":"","sources":["../../../server/service/work-door/work-door.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 이 공장에서 **어느 결재 문이 서 있나** — 순수 판단, DB 를 모른다.\n *\n * 결재선이 찼나를 세는 규칙은 상신하는 쪽과 **같은 함수**를 쓴다(§`approval-line-standing`). 여기서\n * 따로 세면 화면이 「섰다」로 그리고 상신이 거절하는 날이 온다 — 그 자리가 실제로 있었다.\n *\n * ═══════════════════════════════════════════════════════════════════════════\n * ── 왜 이것을 볼 자리가 필요한가 ───────────────────────────────────────────\n * 양식은 제품이 기동할 때 세우고 **결재선은 그 공장이 채운다.** 채운 것이 「우리는 이 단계를 쓴다」는\n * 선언이다. 그래서 결재선이 비어 있는 것은 결함이 아니다 — 그 공장의 선택이다.\n *\n * 문제는 **그 선택이 어디에도 안 보인다**는 것이다. 업무 카탈로그는 「제품이 이 문을 만들었나」를\n * 보여 주지만 「이 공장에서 이 문이 서 있나」는 말하지 않는다. 두 질문이 다른데 하나만 보인다.\n *\n * 실측(2026-09-11): 미라텍 도메인에 양식 11개가 다 설치돼 있고 **11개 전부 결재선이 비어 있다.**\n * 그 공장에서는 실적 정정도 폐기도 승인 없이 바로 반영되는데, 화면에는 문이 있는 것처럼 보인다.\n *\n * ── 비어 있으면 그냥 통과가 아니다 ─────────────────────────────────────────\n * 워크리스트의 거동이 그렇다 — **결재선이 비면 상신이 곧 완료가 되어, 올린 사람이 자기 건을 승인한\n * 것이 된다**(`activity-lookup.ts` § `approvalLineStanding`). 「승인을 안 받는다」가 아니라 「자기가\n * 승인한다」다. 그 차이를 문장에 담는다.\n *\n * ── 기동 로그는 사실의 집이 아니다 ─────────────────────────────────────────\n * `install-boot.ts` 가 기동할 때 한 줄 찍는다. 그 줄은 한 번 지나가고, 그 뒤로 어느 화면도 이것을\n * 말하지 않는다. 사람이 조치해야 하는 사실은 물어볼 수 있는 자리에 있어야 한다.\n * ═══════════════════════════════════════════════════════════════════════════\n */\n\n/**\n * 문이 두 종류다 — **축이 다르고, 비었을 때 결과도 다르다.**\n *\n * ```\n * approval    누가 승인하나   결재선이 비면  올린 사람이 곧 승인한 것이 된다 → 통과해 버린다\n * assignment  누가 받나       역할이 안 묶이면  배정 업무가 아무에게도 안 간다 → 아무도 안 받는다\n * ```\n *\n * 같은 `off` 인데 결과가 반대다. 한 벌 문장으로 뭉개면 관리자가 무엇을 해야 하는지 알 수 없다.\n */\nimport type { ApprovalLineStanding } from './approval-line-standing.js'\n\nexport type DoorKind = 'approval' | 'assignment'\n\n/** 문 하나가 어떤 상태인가. */\nexport type DoorStanding =\n  /** 채워졌다 — 이 공장은 이 문을 쓴다. */\n  | 'on'\n  /** 양식은 섰는데 비었다. **조치 대상.** */\n  | 'off'\n  /** 양식이 아예 안 섰다 — 기동이 못 세웠다. 공장의 선택이 아니라 결함이다. **조치 대상.** */\n  | 'missing'\n  /**\n   * **이 공장은 이 문을 안 쓴다** — 공장이 그렇게 말했다.\n   *\n   * 조치 대상이 아니다. 이것이 없으면 이 조사는 영원히 잔소리하는 화면이 되고, 그러면 사람들이\n   * 안 본다 — 그때 진짜 빈 문 하나가 그 잔소리에 섞여 묻힌다(아키텍트 판정 2026-09-11).\n   *\n   * **자동으로 추론하지 않는다.** 「석 달 안 썼으니 안 쓰는 것」은 조용한 한 철에 참이 된다.\n   */\n  | 'not-used'\n\n/** 이 문 하나에 대해 아는 것. */\nexport interface WorkDoor {\n  /** 양식 이름. 콜백을 찾는 키다. */\n  name: string\n  /** 화면에 낼 이름. */\n  label: string\n  kind: DoorKind\n  standing: DoorStanding\n  /** 결재자 수. 안 섰거나 비었으면 0. */\n  approvers: number\n  /**\n   * **남의 도메인에서 빌려 온 양식일 때만** 그 도메인의 이름.\n   *\n   * 본사에서 정하고 공장이 쓰는 것이 정상이라, 자기 것이 없으면 부모 것을 쓴다\n   * (`activityNamedIn`). 그 사실을 안 말하면 「우리가 정한 적 없는데 왜 서 있나」가 된다.\n   *\n   * ⚠ 자기 도메인이면 **없다.** 자기 이름을 채우면 화면이 모든 줄에 「miratek 에서 정했습니다」를\n   * 달고, 그 말은 아무것도 알려 주지 않는다 — 실제로 그랬다(2026-09-12, 화면으로 보고 알았다).\n   */\n  from?: string\n  /** 이 상태가 무엇을 뜻하는지 — 화면에 그대로 나가는 문장. */\n  because: string\n}\n\n/** 한 문에 대해 읽은 것. 엔티티를 통째로 받지 않는다 — 그러면 이 판단이 DB 를 끌고 온다. */\nexport interface DoorReading {\n  name: string\n  label: string\n  kind: DoorKind\n  /**\n   * 그 도메인(또는 부모)에 선 양식. 못 찾았으면 없다.\n   *\n   * 채워졌나를 보는 칸이 종류마다 다르다 — 결재는 `approvalLine`, 배정은 `assigneeRole` 이다.\n   */\n  /**\n   * `borrowedFrom` 은 **다른 도메인의 양식일 때만** 채운다. 자기 것이면 비운다 — 읽는 쪽이\n   * 「빌려 왔나」를 이 칸 하나로 판단한다.\n   */\n  installed?: { approvalLine?: unknown[]; assigneeRole?: string; borrowedFrom?: string }\n  /** 공장이 「안 쓴다」고 말했으면 그 사유. 말한 적 없으면 없다. */\n  notUsedBecause?: string\n  /**\n   * **다른 문의 결재선을 따르면** 그 문의 이름(화면에 나가는 것). 그러면 `approvalStanding` 도 그 문의\n   * 것이다 — 이 문에서 결재선을 고치러 가면 안 되고 그 문으로 가야 한다는 것을 문장이 말한다.\n   */\n  follows?: string\n  /**\n   * 결재선이 찼나 — **상신하는 쪽과 같은 함수**(`judgeApprovalLine`)가 낸 결과를 그대로 받는다.\n   *\n   * 여기서 다시 세지 않는다. 역할에 사람이 있는지는 DB 를 읽어야 알고, 이 판단은 DB 를 모른다.\n   * 없으면 「못 읽었다」로 읽는다 — 「안 읽었다」가 「다 찼다」로 새면 도로 줄 수 세기가 된다.\n   */\n  approvalStanding?: ApprovalLineStanding\n}\n\nexport function judgeDoor(reading: DoorReading): WorkDoor {\n  const { name, label, kind, installed, notUsedBecause, follows } = reading\n  /* 따르는 문이 있으면 결재선을 고치는 자리가 그 문이다. 문장 끝에 그 사실을 붙인다. */\n  const following = follows ? ` — 「${follows}」 의 결재선을 따르므로, 결재선은 그 문에서 정합니다.` : ''\n\n  /*\n   * **공장이 안 쓴다고 말한 것이 먼저다.** 뒤에 두면 양식이 안 선 문을 「결함」으로 먼저 그리고,\n   * 안 쓰기로 한 공장이 고치라는 말을 계속 듣는다.\n   */\n  if (notUsedBecause) {\n    return {\n      name,\n      label,\n      kind,\n      standing: 'not-used',\n      approvers: 0,\n      because: `「${label}」 은 이 공장이 쓰지 않기로 한 업무입니다 — ${notUsedBecause}`\n    }\n  }\n\n  if (!installed) {\n    return {\n      name,\n      label,\n      kind,\n      standing: 'missing',\n      approvers: 0,\n      because: `「${label}」 양식이 이 공장에 서지 않았습니다. 공장이 안 쓰기로 한 것이 아니라 세우지 못한 것이므로 기동 기록을 보십시오.`\n    }\n  }\n\n  /*\n   * 결재 문은 **줄 수가 아니라 그 줄에 사람이 있는지**로 센다. 역할을 지목해 놓고 그 역할이 빈\n   * 결재선은 화면에 「섰다」로 그려지고 상신하는 순간 터진다(ADR-0047 ③).\n   */\n  const line = kind === 'approval' ? reading.approvalStanding : undefined\n\n  const filled = kind === 'approval' ? (line && !line.refusal ? line.approvers : 0) : installed.assigneeRole ? 1 : 0\n  const roleIsEmpty = line?.refusal?.code === 'approval-role-empty'\n  const personIsGone = line?.refusal?.code === 'approval-person-absent'\n\n  if (!filled) {\n    return {\n      name,\n      label,\n      kind,\n      standing: 'off',\n      approvers: 0,\n      from: installed.borrowedFrom,\n      /* 종류마다 결과가 반대다(§`DoorKind`). 그래서 문장도 다르다. */\n      because:\n        (kind !== 'approval'\n          ? `「${label}」 을 받을 역할이 묶이지 않았습니다. 이 업무는 만들어져도 아무에게도 가지 않습니다.`\n          : roleIsEmpty\n            ? /*\n               * **관리자가 할 일이 다르다.** 결재선을 정하는 것과 그 역할에 사람을 넣는 것은 다른\n               * 일이고, 뒤엣것을 앞엣것으로 말하면 이미 정해 둔 결재선을 다시 들여다보게 만든다.\n               */\n              `「${label}」 의 결재선이 지목한 역할에 사람이 없습니다. 결재선은 정해져 있으니 그 역할에 사람을 넣어야 이 단계가 섭니다.`\n            : personIsGone\n              ? `「${label}」 의 결재선이 지목한 사람이 이 공장에 없습니다. 다른 사람을 지목하거나 그 사람을 넣어야 이 단계가 섭니다.`\n            : `「${label}」 에 결재자가 없습니다. 이 단계는 서지 않고, 올린 사람이 올리는 순간 자기 건을 승인한 것이 됩니다.`) +\n        following\n    }\n  }\n\n  return {\n    name,\n    label,\n    kind,\n    standing: 'on',\n    approvers: filled,\n    from: installed.borrowedFrom,\n    because:\n      kind === 'approval'\n        ? `「${label}」 은 결재자 ${filled}명을 지납니다.${following}`\n        : `「${label}」 은 ${installed.assigneeRole} 가 받습니다.`\n  }\n}\n\n/**\n * 아직 채울 것이 몇 개인가 — **안 쓰기로 한 것은 안 센다.**\n *\n * 그래야 0 이 「다 됐다」를 뜻한다. 안 쓰는 것을 남은 수에 넣으면 다 채운 공장에서도 수가 안 줄고,\n * 그 화면은 잔소리가 된다(아키텍트 판정 2026-09-11).\n */\nexport function doorsToFill(doors: readonly WorkDoor[]): number {\n  return doors.filter(one => one.standing === 'off' || one.standing === 'missing').length\n}\n\n/** 이 공장 전체를 한 문장으로 — 목록만 내면 읽는 사람이 11줄을 세어야 한다. */\nexport function summarizeDoors(doors: readonly WorkDoor[]): string {\n  if (!doors.length) {\n    return '이 제품이 세우는 업무 양식이 없습니다.'\n  }\n\n  const on = doors.filter(one => one.standing === 'on').length\n  const off = doors.filter(one => one.standing === 'off').length\n  const missing = doors.filter(one => one.standing === 'missing').length\n  const notUsed = doors.filter(one => one.standing === 'not-used').length\n\n  /*\n   * **셀 것은 `off + missing` 뿐이다.** 그래야 0 이 「다 됐다」를 뜻한다. 안 쓰기로 한 것을 남은 수에\n   * 넣으면 다 채운 공장에서도 수가 안 줄고, 그 화면은 잔소리가 된다.\n   */\n  const todo = off + missing\n\n  if (!todo) {\n    return notUsed\n      ? `채울 것이 남지 않았습니다. 업무 문 ${on}개가 서 있고 ${notUsed}개는 이 공장이 쓰지 않기로 한 것입니다.`\n      : `업무 문 ${doors.length}개가 다 서 있습니다.`\n  }\n\n  const said = [`채울 것이 ${todo}개 남았습니다.`]\n\n  if (off) {\n    said.push(`${off}개는 양식은 섰는데 받을 사람이 없습니다 — 누가 할지 이 공장이 아직 정하지 않은 것입니다.`)\n  }\n\n  if (missing) {\n    said.push(`${missing}개는 양식이 아예 서지 않았습니다. 이것은 설정이 아니라 결함입니다.`)\n  }\n\n  if (notUsed) {\n    said.push(`${notUsed}개는 이 공장이 쓰지 않기로 한 것이라 세지 않았습니다.`)\n  }\n\n  return said.join(' ')\n}\n\n/** The not-used declaration's content columns: which door and why. */\nexport const WORK_DOOR_NOT_USED_CONTENT = ['doorName', 'because'] as const\n\n/** The declaration as it was — its content, who declared it, and when — written when it is withdrawn. */\nexport function workDoorNotUsedBefore(declaration: {\n  doorName: string\n  because: string\n  declaredBy?: { email?: string; name?: string } | null\n  createdAt?: Date | null\n}) {\n  return {\n    ...Object.fromEntries(WORK_DOOR_NOT_USED_CONTENT.map(column => [column, declaration[column] ?? null])),\n    declaredBy: declaration.declaredBy?.email ?? declaration.declaredBy?.name ?? null,\n    declaredAt: declaration.createdAt ?? null\n  }\n}\n"]}