@things-factory/worklist 10.1.248 → 10.1.249

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

@@ -0,0 +1,187 @@
+/**
+ * 이 공장에서 **어느 결재 문이 서 있나** — 순수 판단, DB 를 모른다.
+ *
+ * 결재선이 찼나를 세는 규칙은 상신하는 쪽과 **같은 함수**를 쓴다(§`approval-line-standing`). 여기서
+ * 따로 세면 화면이 「섰다」로 그리고 상신이 거절하는 날이 온다 — 그 자리가 실제로 있었다.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 왜 이것을 볼 자리가 필요한가 ───────────────────────────────────────────
+ * 양식은 제품이 기동할 때 세우고 **결재선은 그 공장이 채운다.** 채운 것이 「우리는 이 단계를 쓴다」는
+ * 선언이다. 그래서 결재선이 비어 있는 것은 결함이 아니다 — 그 공장의 선택이다.
+ *
+ * 문제는 **그 선택이 어디에도 안 보인다**는 것이다. 업무 카탈로그는 「제품이 이 문을 만들었나」를
+ * 보여 주지만 「이 공장에서 이 문이 서 있나」는 말하지 않는다. 두 질문이 다른데 하나만 보인다.
+ *
+ * 실측(2026-09-11): 미라텍 도메인에 양식 11개가 다 설치돼 있고 **11개 전부 결재선이 비어 있다.**
+ * 그 공장에서는 실적 정정도 폐기도 승인 없이 바로 반영되는데, 화면에는 문이 있는 것처럼 보인다.
+ *
+ * ── 비어 있으면 그냥 통과가 아니다 ─────────────────────────────────────────
+ * 빈 결재선에서 무엇이 일어나는지는 **문마다 선언한다**(ADR-0077 결정 1, `WhenNoLine`). `run` 문은 상신이
+ * 곧 완료가 되어 올린 사람이 자기 건을 승인한 것이 되고, `refuse` 문은 올리는 것 자체가 거절된다.
+ * 「승인을 안 받는다」 한 벌로 말하면 둘 다 틀린다 — 판단은 그 선언을 그대로 싣는다.
+ *
+ * ── 기동 로그는 사실의 집이 아니다 ─────────────────────────────────────────
+ * `install-boot.ts` 가 기동할 때 한 줄 찍는다. 그 줄은 한 번 지나가고, 그 뒤로 어느 화면도 이것을
+ * 말하지 않는다. 사람이 조치해야 하는 사실은 물어볼 수 있는 자리에 있어야 한다.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * 문이 두 종류다 — **축이 다르고, 비었을 때 결과도 다르다.**
+ *
+ * ```
+ * approval    누가 승인하나   결재선이 비면  문의 선언대로 — 통과해 버리거나(run) 올릴 수 없다(refuse)
+ * assignment  누가 받나       역할이 안 묶이면  배정 업무가 아무에게도 안 간다 → 아무도 안 받는다
+ * ```
+ *
+ * 같은 `off` 인데 결과가 반대다. 한 벌 문장으로 뭉개면 관리자가 무엇을 해야 하는지 알 수 없다.
+ */
+import type { ApprovalLineStanding } from './approval-line-standing.js';
+import type { WhenNoLine, WhenNoLineBecause } from './work-door-declaration.js';
+export type DoorKind = 'approval' | 'assignment';
+/** 문 하나가 어떤 상태인가. */
+export type DoorStanding = 
+/** 채워졌다 — 이 공장은 이 문을 쓴다. */
+'on'
+/** 양식은 섰는데 비었다. **조치 대상.** */
+ | 'off'
+/** 양식이 아예 안 섰다 — 기동이 못 세웠다. 공장의 선택이 아니라 결함이다. **조치 대상.** */
+ | 'missing'
+/**
+ * **이 공장은 이 문을 안 쓴다** — 공장이 그렇게 말했다.
+ *
+ * 조치 대상이 아니다. 이것이 없으면 이 조사는 영원히 잔소리하는 화면이 되고, 그러면 사람들이
+ * 안 본다 — 그때 진짜 빈 문 하나가 그 잔소리에 섞여 묻힌다(아키텍트 판정 2026-09-11).
+ *
+ * **자동으로 추론하지 않는다.** 「석 달 안 썼으니 안 쓰는 것」은 조용한 한 철에 참이 된다.
+ */
+ | 'not-used';
+/**
+ * **왜 그 상태인가** — 상태 하나에 까닭이 여럿이고, 까닭마다 관리자가 할 일이 다르다.
+ *
+ * ```
+ * not-used        공장이 안 쓴다고 말했다
+ * missing         양식이 기동 때 안 섰다 — 기동 기록을 볼 일
+ * line-empty      결재선이 비었다 — 결재선을 채울 일
+ * role-empty      결재선이 지목한 역할에 사람이 없다 — 그 역할에 사람을 넣을 일
+ * person-absent   결재선이 지목한 사람이 이 공장에 없다 — 다른 사람을 지목할 일
+ * no-assignee     배정 문에 받을 역할이 안 묶였다
+ * line-filled     결재자가 있다
+ * assignee-bound  받을 역할이 묶였다
+ * ```
+ *
+ * 문장이 아니라 값이다. 서버가 한국어 문장을 만들어 보내면 다른 언어 사용자가 한국어를 읽고, 화면이
+ * 그 문장을 다시 뜯어 읽게 된다 — 문장은 화면이 이 값과 번역으로 짓는다(`door-sentence.ts`).
+ */
+export type DoorReason = 'not-used' | 'missing' | 'line-empty' | 'role-empty' | 'person-absent' | 'no-assignee' | 'line-filled' | 'assignee-bound';
+/** 이 문 하나에 대해 아는 것 — 사실만. 문장은 화면이 짓는다. */
+export interface WorkDoor {
+    /** 양식 이름. 콜백을 찾는 키다. */
+    name: string;
+    /**
+     * 화면에 낼 이름의 번역 키 — **이름에서 센다**(`activityTKey`). 선언이 고르지 않는다.
+     *
+     * 선언한 키를 읽던 때 plant 가 `activity.${PascalCase}.label` 로 지어 보냈고 번역은 kebab 이라, 화면에
+     * 키 글자가 그대로 떴다(:4000, 2026-09-24). 아무도 고르지 않는 키는 아무도 틀리게 못 고른다.
+     */
+    labelKey: string;
+    kind: DoorKind;
+    standing: DoorStanding;
+    reason: DoorReason;
+    /** 결재자 수. 안 섰거나 비었으면 0. */
+    approvers: number;
+    /**
+     * **결재선이 비면 이 문이 어떻게 하나** — 선언 그대로(ADR-0077 결정 1). 결재 문에만 있다.
+     *
+     * 빈 결재선의 결과가 문마다 다르다. `run` 은 올린 사람이 자기 건을 승인한 것이 되고, `refuse` 는
+     * 올리는 것 자체가 거절된다. 한 벌 문장으로 뭉개면 거절하는 문에 「자기 건을 승인한다」가 적힌다 —
+     * 실제로 그랬다(:4000, 개정 결재 넷, 2026-09-24).
+     */
+    whenNoLine?: WhenNoLine;
+    /** `refuse` · `as-established` 문이 결재를 요구하는 까닭. */
+    whenNoLineBecause?: WhenNoLineBecause;
+    /** 다른 문의 결재선을 따르면 그 문의 이름 번역 키. 결재선은 그 문에서 정한다. */
+    followsLabelKey?: string;
+    /** 배정 문에 묶인 역할 이름. */
+    assigneeRoles?: string[];
+    /** 공장이 「안 쓴다」고 적은 사유 — 사람이 쓴 글이라 번역하지 않고 그대로 보인다. */
+    notUsedBecause?: string;
+    /**
+     * **남의 도메인에서 빌려 온 양식일 때만** 그 도메인의 이름.
+     *
+     * 본사에서 정하고 공장이 쓰는 것이 정상이라, 자기 것이 없으면 부모 것을 쓴다
+     * (`activityNamedIn`). 그 사실을 안 말하면 「우리가 정한 적 없는데 왜 서 있나」가 된다.
+     *
+     * ⚠ 자기 도메인이면 **없다.** 자기 이름을 채우면 화면이 모든 줄에 「miratek 에서 정했습니다」를
+     * 달고, 그 말은 아무것도 알려 주지 않는다 — 실제로 그랬다(2026-09-12, 화면으로 보고 알았다).
+     */
+    from?: string;
+}
+/** 한 문에 대해 읽은 것. 엔티티를 통째로 받지 않는다 — 그러면 이 판단이 DB 를 끌고 온다. */
+export interface DoorReading {
+    name: string;
+    kind: DoorKind;
+    /** 결재 문의 선언 — 빈 결재선에서 어떻게 하나와 그 까닭. */
+    whenNoLine?: WhenNoLine;
+    whenNoLineBecause?: WhenNoLineBecause;
+    /**
+     * 그 도메인(또는 부모)에 선 양식. 못 찾았으면 없다.
+     *
+     * 채워졌나를 보는 칸이 종류마다 다르다 — 결재는 `approvalLine`, 배정은 `assigneeRoles`(역할 이름들)이다.
+     * `borrowedFrom` 은 **다른 도메인의 양식일 때만** 채운다. 자기 것이면 비운다 — 읽는 쪽이
+     * 「빌려 왔나」를 이 칸 하나로 판단한다.
+     */
+    installed?: {
+        approvalLine?: unknown[];
+        assigneeRoles?: 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;
+/**
+ * 상태별 수 — **문장은 화면이 짓는다.**
+ *
+ * 목록만 내면 읽는 사람이 열두 줄을 세어야 해서 한 문장으로 요약한다. 그 문장을 서버가 한국어로
+ * 지어 보내면 다른 언어 사용자가 한국어를 읽는다 — 그래서 수만 보낸다.
+ */
+export declare function countDoors(doors: readonly WorkDoor[]): {
+    on: number;
+    off: number;
+    missing: number;
+    notUsed: number;
+};
+/** 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,119 @@
+"use strict";
+/**
+ * 이 공장에서 **어느 결재 문이 서 있나** — 순수 판단, DB 를 모른다.
+ *
+ * 결재선이 찼나를 세는 규칙은 상신하는 쪽과 **같은 함수**를 쓴다(§`approval-line-standing`). 여기서
+ * 따로 세면 화면이 「섰다」로 그리고 상신이 거절하는 날이 온다 — 그 자리가 실제로 있었다.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ── 왜 이것을 볼 자리가 필요한가 ───────────────────────────────────────────
+ * 양식은 제품이 기동할 때 세우고 **결재선은 그 공장이 채운다.** 채운 것이 「우리는 이 단계를 쓴다」는
+ * 선언이다. 그래서 결재선이 비어 있는 것은 결함이 아니다 — 그 공장의 선택이다.
+ *
+ * 문제는 **그 선택이 어디에도 안 보인다**는 것이다. 업무 카탈로그는 「제품이 이 문을 만들었나」를
+ * 보여 주지만 「이 공장에서 이 문이 서 있나」는 말하지 않는다. 두 질문이 다른데 하나만 보인다.
+ *
+ * 실측(2026-09-11): 미라텍 도메인에 양식 11개가 다 설치돼 있고 **11개 전부 결재선이 비어 있다.**
+ * 그 공장에서는 실적 정정도 폐기도 승인 없이 바로 반영되는데, 화면에는 문이 있는 것처럼 보인다.
+ *
+ * ── 비어 있으면 그냥 통과가 아니다 ─────────────────────────────────────────
+ * 빈 결재선에서 무엇이 일어나는지는 **문마다 선언한다**(ADR-0077 결정 1, `WhenNoLine`). `run` 문은 상신이
+ * 곧 완료가 되어 올린 사람이 자기 건을 승인한 것이 되고, `refuse` 문은 올리는 것 자체가 거절된다.
+ * 「승인을 안 받는다」 한 벌로 말하면 둘 다 틀린다 — 판단은 그 선언을 그대로 싣는다.
+ *
+ * ── 기동 로그는 사실의 집이 아니다 ─────────────────────────────────────────
+ * `install-boot.ts` 가 기동할 때 한 줄 찍는다. 그 줄은 한 번 지나가고, 그 뒤로 어느 화면도 이것을
+ * 말하지 않는다. 사람이 조치해야 하는 사실은 물어볼 수 있는 자리에 있어야 한다.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORK_DOOR_NOT_USED_CONTENT = void 0;
+exports.judgeDoor = judgeDoor;
+exports.doorsToFill = doorsToFill;
+exports.countDoors = countDoors;
+exports.workDoorNotUsedBefore = workDoorNotUsedBefore;
+const decision_key_declaration_js_1 = require("../activity/decision-key-declaration.js");
+function judgeDoor(reading) {
+    const { name, kind, installed, notUsedBecause, follows } = reading;
+    const approval = kind === 'approval';
+    const known = {
+        name,
+        labelKey: (0, decision_key_declaration_js_1.activityTKey)(name, 'label'),
+        kind,
+        standing: 'off',
+        reason: 'line-empty',
+        approvers: 0,
+        ...(approval && reading.whenNoLine ? { whenNoLine: reading.whenNoLine } : {}),
+        ...(approval && reading.whenNoLineBecause ? { whenNoLineBecause: reading.whenNoLineBecause } : {}),
+        ...(follows ? { followsLabelKey: (0, decision_key_declaration_js_1.activityTKey)(follows, 'label') } : {})
+    };
+    /*
+     * **공장이 안 쓴다고 말한 것이 먼저다.** 뒤에 두면 양식이 안 선 문을 「결함」으로 먼저 그리고,
+     * 안 쓰기로 한 공장이 고치라는 말을 계속 듣는다.
+     */
+    if (notUsedBecause) {
+        return { ...known, standing: 'not-used', reason: 'not-used', notUsedBecause };
+    }
+    if (!installed) {
+        return { ...known, standing: 'missing', reason: 'missing' };
+    }
+    const from = installed.borrowedFrom ? { from: installed.borrowedFrom } : {};
+    if (!approval) {
+        return installed.assigneeRoles?.length
+            ? { ...known, ...from, standing: 'on', reason: 'assignee-bound', approvers: 1, assigneeRoles: installed.assigneeRoles }
+            : { ...known, ...from, standing: 'off', reason: 'no-assignee' };
+    }
+    /*
+     * 결재 문은 **줄 수가 아니라 그 줄에 사람이 있는지**로 센다. 역할을 지목해 놓고 그 역할이 빈
+     * 결재선은 화면에 「섰다」로 그려지고 상신하는 순간 터진다(ADR-0047 ③).
+     */
+    const line = reading.approvalStanding;
+    const filled = line && !line.refusal ? line.approvers : 0;
+    if (filled) {
+        return { ...known, ...from, standing: 'on', reason: 'line-filled', approvers: filled };
+    }
+    /*
+     * **관리자가 할 일이 다르다.** 결재선을 정하는 것과 그 역할에 사람을 넣는 것은 다른 일이고,
+     * 뒤엣것을 앞엣것으로 말하면 이미 정해 둔 결재선을 다시 들여다보게 만든다.
+     */
+    const reason = line?.refusal?.code === 'approval-role-empty'
+        ? 'role-empty'
+        : line?.refusal?.code === 'approval-person-absent'
+            ? 'person-absent'
+            : 'line-empty';
+    return { ...known, ...from, standing: 'off', reason };
+}
+/**
+ * 아직 채울 것이 몇 개인가 — **안 쓰기로 한 것은 안 센다.**
+ *
+ * 그래야 0 이 「다 됐다」를 뜻한다. 안 쓰는 것을 남은 수에 넣으면 다 채운 공장에서도 수가 안 줄고,
+ * 그 화면은 잔소리가 된다(아키텍트 판정 2026-09-11).
+ */
+function doorsToFill(doors) {
+    return doors.filter(one => one.standing === 'off' || one.standing === 'missing').length;
+}
+/**
+ * 상태별 수 — **문장은 화면이 짓는다.**
+ *
+ * 목록만 내면 읽는 사람이 열두 줄을 세어야 해서 한 문장으로 요약한다. 그 문장을 서버가 한국어로
+ * 지어 보내면 다른 언어 사용자가 한국어를 읽는다 — 그래서 수만 보낸다.
+ */
+function countDoors(doors) {
+    return {
+        on: doors.filter(one => one.standing === 'on').length,
+        off: doors.filter(one => one.standing === 'off').length,
+        missing: doors.filter(one => one.standing === 'missing').length,
+        notUsed: doors.filter(one => one.standing === 'not-used').length
+    };
+}
+/** 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 * 빈 결재선에서 무엇이 일어나는지는 **문마다 선언한다**(ADR-0077 결정 1, `WhenNoLine`). `run` 문은 상신이\n * 곧 완료가 되어 올린 사람이 자기 건을 승인한 것이 되고, `refuse` 문은 올리는 것 자체가 거절된다.\n * 「승인을 안 받는다」 한 벌로 말하면 둘 다 틀린다 — 판단은 그 선언을 그대로 싣는다.\n *\n * ── 기동 로그는 사실의 집이 아니다 ─────────────────────────────────────────\n * `install-boot.ts` 가 기동할 때 한 줄 찍는다. 그 줄은 한 번 지나가고, 그 뒤로 어느 화면도 이것을\n * 말하지 않는다. 사람이 조치해야 하는 사실은 물어볼 수 있는 자리에 있어야 한다.\n * ═══════════════════════════════════════════════════════════════════════════\n */\n\n/**\n * 문이 두 종류다 — **축이 다르고, 비었을 때 결과도 다르다.**\n *\n * ```\n * approval    누가 승인하나   결재선이 비면  문의 선언대로 — 통과해 버리거나(run) 올릴 수 없다(refuse)\n * assignment  누가 받나       역할이 안 묶이면  배정 업무가 아무에게도 안 간다 → 아무도 안 받는다\n * ```\n *\n * 같은 `off` 인데 결과가 반대다. 한 벌 문장으로 뭉개면 관리자가 무엇을 해야 하는지 알 수 없다.\n */\nimport type { ApprovalLineStanding } from './approval-line-standing.js'\nimport { activityTKey } from '../activity/decision-key-declaration.js'\nimport type { WhenNoLine, WhenNoLineBecause } from './work-door-declaration.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/**\n * **왜 그 상태인가** — 상태 하나에 까닭이 여럿이고, 까닭마다 관리자가 할 일이 다르다.\n *\n * ```\n * not-used        공장이 안 쓴다고 말했다\n * missing         양식이 기동 때 안 섰다 — 기동 기록을 볼 일\n * line-empty      결재선이 비었다 — 결재선을 채울 일\n * role-empty      결재선이 지목한 역할에 사람이 없다 — 그 역할에 사람을 넣을 일\n * person-absent   결재선이 지목한 사람이 이 공장에 없다 — 다른 사람을 지목할 일\n * no-assignee     배정 문에 받을 역할이 안 묶였다\n * line-filled     결재자가 있다\n * assignee-bound  받을 역할이 묶였다\n * ```\n *\n * 문장이 아니라 값이다. 서버가 한국어 문장을 만들어 보내면 다른 언어 사용자가 한국어를 읽고, 화면이\n * 그 문장을 다시 뜯어 읽게 된다 — 문장은 화면이 이 값과 번역으로 짓는다(`door-sentence.ts`).\n */\nexport type DoorReason =\n  | 'not-used'\n  | 'missing'\n  | 'line-empty'\n  | 'role-empty'\n  | 'person-absent'\n  | 'no-assignee'\n  | 'line-filled'\n  | 'assignee-bound'\n\n/** 이 문 하나에 대해 아는 것 — 사실만. 문장은 화면이 짓는다. */\nexport interface WorkDoor {\n  /** 양식 이름. 콜백을 찾는 키다. */\n  name: string\n  /**\n   * 화면에 낼 이름의 번역 키 — **이름에서 센다**(`activityTKey`). 선언이 고르지 않는다.\n   *\n   * 선언한 키를 읽던 때 plant 가 `activity.${PascalCase}.label` 로 지어 보냈고 번역은 kebab 이라, 화면에\n   * 키 글자가 그대로 떴다(:4000, 2026-09-24). 아무도 고르지 않는 키는 아무도 틀리게 못 고른다.\n   */\n  labelKey: string\n  kind: DoorKind\n  standing: DoorStanding\n  reason: DoorReason\n  /** 결재자 수. 안 섰거나 비었으면 0. */\n  approvers: number\n  /**\n   * **결재선이 비면 이 문이 어떻게 하나** — 선언 그대로(ADR-0077 결정 1). 결재 문에만 있다.\n   *\n   * 빈 결재선의 결과가 문마다 다르다. `run` 은 올린 사람이 자기 건을 승인한 것이 되고, `refuse` 는\n   * 올리는 것 자체가 거절된다. 한 벌 문장으로 뭉개면 거절하는 문에 「자기 건을 승인한다」가 적힌다 —\n   * 실제로 그랬다(:4000, 개정 결재 넷, 2026-09-24).\n   */\n  whenNoLine?: WhenNoLine\n  /** `refuse` · `as-established` 문이 결재를 요구하는 까닭. */\n  whenNoLineBecause?: WhenNoLineBecause\n  /** 다른 문의 결재선을 따르면 그 문의 이름 번역 키. 결재선은 그 문에서 정한다. */\n  followsLabelKey?: string\n  /** 배정 문에 묶인 역할 이름. */\n  assigneeRoles?: string[]\n  /** 공장이 「안 쓴다」고 적은 사유 — 사람이 쓴 글이라 번역하지 않고 그대로 보인다. */\n  notUsedBecause?: string\n  /**\n   * **남의 도메인에서 빌려 온 양식일 때만** 그 도메인의 이름.\n   *\n   * 본사에서 정하고 공장이 쓰는 것이 정상이라, 자기 것이 없으면 부모 것을 쓴다\n   * (`activityNamedIn`). 그 사실을 안 말하면 「우리가 정한 적 없는데 왜 서 있나」가 된다.\n   *\n   * ⚠ 자기 도메인이면 **없다.** 자기 이름을 채우면 화면이 모든 줄에 「miratek 에서 정했습니다」를\n   * 달고, 그 말은 아무것도 알려 주지 않는다 — 실제로 그랬다(2026-09-12, 화면으로 보고 알았다).\n   */\n  from?: string\n}\n\n/** 한 문에 대해 읽은 것. 엔티티를 통째로 받지 않는다 — 그러면 이 판단이 DB 를 끌고 온다. */\nexport interface DoorReading {\n  name: string\n  kind: DoorKind\n  /** 결재 문의 선언 — 빈 결재선에서 어떻게 하나와 그 까닭. */\n  whenNoLine?: WhenNoLine\n  whenNoLineBecause?: WhenNoLineBecause\n  /**\n   * 그 도메인(또는 부모)에 선 양식. 못 찾았으면 없다.\n   *\n   * 채워졌나를 보는 칸이 종류마다 다르다 — 결재는 `approvalLine`, 배정은 `assigneeRoles`(역할 이름들)이다.\n   * `borrowedFrom` 은 **다른 도메인의 양식일 때만** 채운다. 자기 것이면 비운다 — 읽는 쪽이\n   * 「빌려 왔나」를 이 칸 하나로 판단한다.\n   */\n  installed?: { approvalLine?: unknown[]; assigneeRoles?: 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, kind, installed, notUsedBecause, follows } = reading\n  const approval = kind === 'approval'\n  const known: WorkDoor = {\n    name,\n    labelKey: activityTKey(name, 'label'),\n    kind,\n    standing: 'off',\n    reason: 'line-empty',\n    approvers: 0,\n    ...(approval && reading.whenNoLine ? { whenNoLine: reading.whenNoLine } : {}),\n    ...(approval && reading.whenNoLineBecause ? { whenNoLineBecause: reading.whenNoLineBecause } : {}),\n    ...(follows ? { followsLabelKey: activityTKey(follows, 'label') } : {})\n  }\n\n  /*\n   * **공장이 안 쓴다고 말한 것이 먼저다.** 뒤에 두면 양식이 안 선 문을 「결함」으로 먼저 그리고,\n   * 안 쓰기로 한 공장이 고치라는 말을 계속 듣는다.\n   */\n  if (notUsedBecause) {\n    return { ...known, standing: 'not-used', reason: 'not-used', notUsedBecause }\n  }\n\n  if (!installed) {\n    return { ...known, standing: 'missing', reason: 'missing' }\n  }\n\n  const from = installed.borrowedFrom ? { from: installed.borrowedFrom } : {}\n\n  if (!approval) {\n    return installed.assigneeRoles?.length\n      ? { ...known, ...from, standing: 'on', reason: 'assignee-bound', approvers: 1, assigneeRoles: installed.assigneeRoles }\n      : { ...known, ...from, standing: 'off', reason: 'no-assignee' }\n  }\n\n  /*\n   * 결재 문은 **줄 수가 아니라 그 줄에 사람이 있는지**로 센다. 역할을 지목해 놓고 그 역할이 빈\n   * 결재선은 화면에 「섰다」로 그려지고 상신하는 순간 터진다(ADR-0047 ③).\n   */\n  const line = reading.approvalStanding\n  const filled = line && !line.refusal ? line.approvers : 0\n\n  if (filled) {\n    return { ...known, ...from, standing: 'on', reason: 'line-filled', approvers: filled }\n  }\n\n  /*\n   * **관리자가 할 일이 다르다.** 결재선을 정하는 것과 그 역할에 사람을 넣는 것은 다른 일이고,\n   * 뒤엣것을 앞엣것으로 말하면 이미 정해 둔 결재선을 다시 들여다보게 만든다.\n   */\n  const reason: DoorReason =\n    line?.refusal?.code === 'approval-role-empty'\n      ? 'role-empty'\n      : line?.refusal?.code === 'approval-person-absent'\n        ? 'person-absent'\n        : 'line-empty'\n\n  return { ...known, ...from, standing: 'off', reason }\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/**\n * 상태별 수 — **문장은 화면이 짓는다.**\n *\n * 목록만 내면 읽는 사람이 열두 줄을 세어야 해서 한 문장으로 요약한다. 그 문장을 서버가 한국어로\n * 지어 보내면 다른 언어 사용자가 한국어를 읽는다 — 그래서 수만 보낸다.\n */\nexport function countDoors(doors: readonly WorkDoor[]): { on: number; off: number; missing: number; notUsed: number } {\n  return {\n    on: doors.filter(one => one.standing === 'on').length,\n    off: doors.filter(one => one.standing === 'off').length,\n    missing: doors.filter(one => one.standing === 'missing').length,\n    notUsed: doors.filter(one => one.standing === 'not-used').length\n  }\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"]}