@things-factory/worklist 10.0.18 → 10.1.0

package/dist-client/when.d.ts

@@ -0,0 +1,4 @@
+/** 날짜와 시각 — 이력처럼 날이 넘어갈 수 있는 자리. */
+export declare function whenText(value?: Date | string | number): string;
+/** 목록의 곁줄에 붙는 짧은 시각 — 「9. 2. 오후 12:48」. */
+export declare function whenShortText(value?: Date | string | number): string;

package/dist-client/when.js

@@ -0,0 +1,72 @@
+import { i18next } from '@operato/i18n';
+/**
+ * 시각을 화면의 말로 — **worklist 화면의 모든 시각이 여기를 지난다.**
+ *
+ * ── 무엇이 잘못되고 있었나 (2026-09-06) ────────────────────────────────────
+ * 같은 화면 안에서 시각 표기가 두 벌이었다.
+ *
+ * ```
+ * 목록(activity-cells.ts)   9. 2. 오후 12:48          toLocaleString(i18next.language, {...})
+ * 상세의 타임라인            Tuesday, September 1, 2026 at 11:51 AM
+ * ```
+ *
+ * 타임라인은 `Intl.DateTimeFormat(navigator.language, { dateStyle: 'full' })` 이었다. 두 가지가
+ * 어긋난다 — 언어를 **화면이 아니라 브라우저 설정**에서 가져오고, `full` 은 요일까지 적는다.
+ * 한국어로 쓰는 사용자가 목록에서 건을 고르고 상세로 들어가면 같은 종류의 값이 다른 말로 나온다.
+ *
+ * operato-plant 가 `client/when.ts` 로 같은 문제를 정리했다. worklist 는 framework 패키지라
+ * 앱을 참조할 수 없으므로(역방향 의존) 같은 규칙을 여기에 둔다.
+ *
+ * ── 시간대는 다루지 않는다 ─────────────────────────────────────────────────
+ * 도메인 시간대를 읽고 표시마다 고르게 하는 것은 공용 모듈이 할 일이고 operato-twin 의
+ * `when-core.ts` 가 이미 갖고 있다. 여기서 흉내 내면 같은 사실을 화면마다 다른 시각으로 말하게
+ * 된다. 그때까지 언어만 맞춘다.
+ */
+/**
+ * 시 · 분까지만.
+ *
+ * 기본값은 초까지 낸다. 결재 이력의 시각은 「언제쯤이었나」를 말하는 값이라 초가 뜻을 더하지 않고,
+ * 자릿수만 늘려 옆 칸을 밀어낸다.
+ */
+const CLOCK = { hour: 'numeric', minute: '2-digit' };
+/**
+ * 날짜와 시 · 분.
+ *
+ * `Intl` 은 **지정한 성분만** 낸다. 시 · 분만 주면 날짜가 사라지므로 날짜 성분을 함께 적는다 —
+ * 결재 이력은 날을 넘기는 값이라 날짜가 빠지면 어제 것과 구별되지 않는다.
+ */
+const DAY_AND_CLOCK = {
+    year: 'numeric',
+    month: 'numeric',
+    day: 'numeric',
+    ...CLOCK
+};
+/** 목록의 좁은 칸 — 해를 적지 않는다. 대부분의 줄이 올해다. */
+const SHORT_DAY_AND_CLOCK = {
+    month: 'numeric',
+    day: 'numeric',
+    ...CLOCK
+};
+/** 날짜와 시각 — 이력처럼 날이 넘어갈 수 있는 자리. */
+export function whenText(value) {
+    const date = toDate(value);
+    return date ? date.toLocaleString(lang(), DAY_AND_CLOCK) : '';
+}
+/** 목록의 곁줄에 붙는 짧은 시각 — 「9. 2. 오후 12:48」. */
+export function whenShortText(value) {
+    const date = toDate(value);
+    return date ? date.toLocaleString(lang(), SHORT_DAY_AND_CLOCK) : '';
+}
+/** 없는 값은 빈 글자다. `Invalid Date` 를 화면에 내보내지 않는다. */
+function toDate(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(date.getTime()) ? undefined : date;
+}
+/** `undefined` 면 브라우저 설정을 따른다 — i18next 가 아직 뜨지 않았을 때뿐이다. */
+function lang() {
+    return i18next.language || undefined;
+}
+//# sourceMappingURL=when.js.map

package/dist-client/when.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"when.js","sourceRoot":"","sources":["../client/when.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;GAKG;AACH,MAAM,KAAK,GAA+B,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AAEhF;;;;;GAKG;AACH,MAAM,aAAa,GAA+B;IAChD,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;IACd,GAAG,KAAK;CACT,CAAA;AAED,yCAAyC;AACzC,MAAM,mBAAmB,GAA+B;IACtD,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;IACd,GAAG,KAAK;CACT,CAAA;AAED,oCAAoC;AACpC,MAAM,UAAU,QAAQ,CAAC,KAA8B;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAE1B,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/D,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAE1B,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACrE,CAAC;AAED,kDAAkD;AAClD,SAAS,MAAM,CAAC,KAA8B;IAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IAE5D,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;AACxD,CAAC;AAED,6DAA6D;AAC7D,SAAS,IAAI;IACX,OAAO,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAA;AACtC,CAAC","sourcesContent":["import { i18next } from '@operato/i18n'\n\n/**\n * 시각을 화면의 말로 — **worklist 화면의 모든 시각이 여기를 지난다.**\n *\n * ── 무엇이 잘못되고 있었나 (2026-09-06) ────────────────────────────────────\n * 같은 화면 안에서 시각 표기가 두 벌이었다.\n *\n * ```\n * 목록(activity-cells.ts)   9. 2. 오후 12:48          toLocaleString(i18next.language, {...})\n * 상세의 타임라인            Tuesday, September 1, 2026 at 11:51 AM\n * ```\n *\n * 타임라인은 `Intl.DateTimeFormat(navigator.language, { dateStyle: 'full' })` 이었다. 두 가지가\n * 어긋난다 — 언어를 **화면이 아니라 브라우저 설정**에서 가져오고, `full` 은 요일까지 적는다.\n * 한국어로 쓰는 사용자가 목록에서 건을 고르고 상세로 들어가면 같은 종류의 값이 다른 말로 나온다.\n *\n * operato-plant 가 `client/when.ts` 로 같은 문제를 정리했다. worklist 는 framework 패키지라\n * 앱을 참조할 수 없으므로(역방향 의존) 같은 규칙을 여기에 둔다.\n *\n * ── 시간대는 다루지 않는다 ─────────────────────────────────────────────────\n * 도메인 시간대를 읽고 표시마다 고르게 하는 것은 공용 모듈이 할 일이고 operato-twin 의\n * `when-core.ts` 가 이미 갖고 있다. 여기서 흉내 내면 같은 사실을 화면마다 다른 시각으로 말하게\n * 된다. 그때까지 언어만 맞춘다.\n */\n\n/**\n * 시 · 분까지만.\n *\n * 기본값은 초까지 낸다. 결재 이력의 시각은 「언제쯤이었나」를 말하는 값이라 초가 뜻을 더하지 않고,\n * 자릿수만 늘려 옆 칸을 밀어낸다.\n */\nconst CLOCK: Intl.DateTimeFormatOptions = { hour: 'numeric', minute: '2-digit' }\n\n/**\n * 날짜와 시 · 분.\n *\n * `Intl` 은 **지정한 성분만** 낸다. 시 · 분만 주면 날짜가 사라지므로 날짜 성분을 함께 적는다 —\n * 결재 이력은 날을 넘기는 값이라 날짜가 빠지면 어제 것과 구별되지 않는다.\n */\nconst DAY_AND_CLOCK: Intl.DateTimeFormatOptions = {\n  year: 'numeric',\n  month: 'numeric',\n  day: 'numeric',\n  ...CLOCK\n}\n\n/** 목록의 좁은 칸 — 해를 적지 않는다. 대부분의 줄이 올해다. */\nconst SHORT_DAY_AND_CLOCK: Intl.DateTimeFormatOptions = {\n  month: 'numeric',\n  day: 'numeric',\n  ...CLOCK\n}\n\n/** 날짜와 시각 — 이력처럼 날이 넘어갈 수 있는 자리. */\nexport function whenText(value?: Date | string | number): string {\n  const date = toDate(value)\n\n  return date ? date.toLocaleString(lang(), DAY_AND_CLOCK) : ''\n}\n\n/** 목록의 곁줄에 붙는 짧은 시각 — 「9. 2. 오후 12:48」. */\nexport function whenShortText(value?: Date | string | number): string {\n  const date = toDate(value)\n\n  return date ? date.toLocaleString(lang(), SHORT_DAY_AND_CLOCK) : ''\n}\n\n/** 없는 값은 빈 글자다. `Invalid Date` 를 화면에 내보내지 않는다. */\nfunction toDate(value?: Date | string | number): Date | undefined {\n  if (value === undefined || value === null || value === '') {\n    return undefined\n  }\n\n  const date = value instanceof Date ? value : new Date(value)\n\n  return Number.isNaN(date.getTime()) ? undefined : date\n}\n\n/** `undefined` 면 브라우저 설정을 따른다 — i18next 가 아직 뜨지 않았을 때뿐이다. */\nfunction lang(): string | undefined {\n  return i18next.language || undefined\n}\n"]}

package/dist-server/controllers/activity-approval/_abort.js

@@ -2,13 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._abort = _abort;
 const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
+const opinion_js_1 = require("./opinion.js");
 const activity_approval_js_1 = require("../../service/activity-approval/activity-approval.js");
 async function _abort({ activityApproval, comment }, context) {
     const { user, tx } = context.state;
     var result = await tx.getRepository(activity_approval_js_1.ActivityApproval).save({
         ...activityApproval,
         judgment: activity_approval_js_1.ActivityApprovalJudgment.Aborted,
-        comment,
+        ...(0, opinion_js_1.stampedComment)(comment),
         transaction: 'abort',
         updater: user,
         terminatedAt: new Date(),

package/dist-server/controllers/activity-approval/_abort.js.map

@@ -1 +1 @@
-{"version":3,"file":"_abort.js","sourceRoot":"","sources":["../../../server/controllers/activity-approval/_abort.ts"],"names":[],"mappings":";;AAGA,wBA2BC;AA9BD,yFAAuG;AACvG,+FAAiH;AAE1G,KAAK,UAAU,MAAM,CAC1B,EAAE,gBAAgB,EAAE,OAAO,EAA2D,EACtF,OAAwB;IAExB,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAElC,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,uCAAgB,CAAC,CAAC,IAAI,CAAC;QACzD,GAAG,gBAAgB;QACnB,QAAQ,EAAE,+CAAwB,CAAC,OAAO;QAC1C,OAAO;QACP,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI,IAAI,EAAE;QACxB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAA;IAEF,MAAM,EAAE,CAAC,aAAa,CAAC,mCAAc,CAAC,CAAC,IAAI,CAAC;QAC1C,GAAG,gBAAgB,CAAC,cAAc;QAClC,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,yCAAoB,CAAC,OAAO;QACnC,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI,IAAI,EAAE;QACxB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { ActivityApproval, ActivityApprovalJudgment } from '../../service/activity-approval/activity-approval.js'\n\nexport async function _abort(\n  { activityApproval, comment }: { activityApproval: ActivityApproval; comment: string },\n  context: ResolverContext\n): Promise<ActivityApproval> {\n  const { user, tx } = context.state\n\n  var result = await tx.getRepository(ActivityApproval).save({\n    ...activityApproval,\n    judgment: ActivityApprovalJudgment.Aborted,\n    comment,\n    transaction: 'abort',\n    updater: user,\n    terminatedAt: new Date(),\n    terminator: user\n  })\n\n  await tx.getRepository(ActivityThread).save({\n    ...activityApproval.activityThread,\n    transaction: 'abort',\n    reason: comment,\n    state: ActivityThreadStatus.Aborted,\n    updater: user,\n    terminatedAt: new Date(),\n    terminator: user\n  })\n\n  return result\n}\n"]}
+{"version":3,"file":"_abort.js","sourceRoot":"","sources":["../../../server/controllers/activity-approval/_abort.ts"],"names":[],"mappings":";;AAIA,wBA2BC;AA/BD,yFAAuG;AACvG,6CAA6C;AAC7C,+FAAiH;AAE1G,KAAK,UAAU,MAAM,CAC1B,EAAE,gBAAgB,EAAE,OAAO,EAA2D,EACtF,OAAwB;IAExB,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAElC,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,uCAAgB,CAAC,CAAC,IAAI,CAAC;QACzD,GAAG,gBAAgB;QACnB,QAAQ,EAAE,+CAAwB,CAAC,OAAO;QAC1C,GAAG,IAAA,2BAAc,EAAC,OAAO,CAAC;QAC1B,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI,IAAI,EAAE;QACxB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAA;IAEF,MAAM,EAAE,CAAC,aAAa,CAAC,mCAAc,CAAC,CAAC,IAAI,CAAC;QAC1C,GAAG,gBAAgB,CAAC,cAAc;QAClC,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,yCAAoB,CAAC,OAAO;QACnC,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI,IAAI,EAAE;QACxB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { stampedComment } from './opinion.js'\nimport { ActivityApproval, ActivityApprovalJudgment } from '../../service/activity-approval/activity-approval.js'\n\nexport async function _abort(\n  { activityApproval, comment }: { activityApproval: ActivityApproval; comment: string },\n  context: ResolverContext\n): Promise<ActivityApproval> {\n  const { user, tx } = context.state\n\n  var result = await tx.getRepository(ActivityApproval).save({\n    ...activityApproval,\n    judgment: ActivityApprovalJudgment.Aborted,\n    ...stampedComment(comment),\n    transaction: 'abort',\n    updater: user,\n    terminatedAt: new Date(),\n    terminator: user\n  })\n\n  await tx.getRepository(ActivityThread).save({\n    ...activityApproval.activityThread,\n    transaction: 'abort',\n    reason: comment,\n    state: ActivityThreadStatus.Aborted,\n    updater: user,\n    terminatedAt: new Date(),\n    terminator: user\n  })\n\n  return result\n}\n"]}

package/dist-server/controllers/activity-approval/approval-line.d.ts

@@ -0,0 +1,106 @@
+import type { ApprovalLineItem } from '@things-factory/organization';
+/**
+ * 결재선에서 다음 결재자를 찾는다.
+ *
+ * ── 왜 따로 뺐나 ───────────────────────────────────────────────────────────
+ * 같은 규칙이 두 파일에 나뉘어 있었다.
+ *
+ *   submit.ts    첫 결재를 `order: 1` 로 만들고 `approvalLine[0]` 을 넣는다
+ *   approve.ts   `order` 를 승인하면 `approvalLine[order]` 를 다음 결재자로 삼는다
+ *
+ * `order` 와 배열 자리가 1만큼 다르다. 지금은 맞게 짝이 맞는데, 한쪽만 고치면 결재자가 한 명 빠지거나
+ * 같은 사람이 두 번 들어간다. 그리고 **오류가 안 난다** — 결재가 다 끝나고 나서야 안다.
+ *
+ * 그래서 한 자리에 적고 양쪽이 이것을 부른다.
+ *
+ * `order` 는 사람이 세는 수다 — 1차 결재, 2차 결재. 배열은 0부터이므로 그 차이를 여기서만 다룬다.
+ */
+/**
+ * 이 항목이 **결재**인가 — 비어 있으면 결재다.
+ *
+ * 지금 도는 결재선에는 이 칸이 없다(gangsters·dataset·quotation·accounting). 그 항목들이 전부 결재자로
+ * 읽혀야 거동이 안 바뀐다. 그래서 「참조라고 적힌 것만 참조」다.
+ */
+export declare function isApprovalStep(item: ApprovalLineItem | undefined): boolean;
+/** 이 항목이 참조인가 — 의견만 내고 결재를 막지 않는다. */
+export declare function isReferenceStep(item: ApprovalLineItem | undefined): boolean;
+/**
+ * 이 차례의 결재자는 결재선의 어느 줄인가. `order` 는 1부터.
+ *
+ * **참조 항목도 자리를 차지한다.** `order` 는 배열 자리 그대로다 — 다시 매기면 이미 쌓인 행의 뜻이
+ * 바뀐다. 그래서 결재자의 차례가 1·3·4 처럼 띄엄띄엄해질 수 있고, 그것이 맞다.
+ *
+ * 이 함수는 그 자리에 무엇이 있든 돌려준다. 결재인지 아닌지는 부르는 쪽이 본다(§`nextApproval`).
+ */
+export declare function lineItemFor(approvalLine: ApprovalLineItem[] | undefined, order: number): ApprovalLineItem | undefined;
+/**
+ * 첫 **결재자**는 몇 번째 자리인가 — 앞에 참조가 있으면 건너뛴다.
+ *
+ * 결재선이 참조로만 이루어져 있으면 `undefined` 다. 그때는 결재 없이 끝난다(§`needsApproval`).
+ */
+export declare function firstApprovalOrder(approvalLine: ApprovalLineItem[] | undefined): number | undefined;
+/**
+ * 이 결재선의 참조들 — **언제 알릴지와 함께.**
+ *
+ * `notifyAfter` 가 없으면 `0` 으로 답한다. 0 은 「상신 즉시」다 — 아직 아무 결재도 끝나지 않은 시점.
+ */
+export declare function referenceSteps(approvalLine: ApprovalLineItem[] | undefined): {
+    item: ApprovalLineItem;
+    order: number;
+    notifyAfter: number;
+}[];
+/** 이번에 알려야 할 참조들 — `afterOrder` 번째 결재가 막 끝났을 때. 상신 직후는 `0`. */
+export declare function referencesToNotify(approvalLine: ApprovalLineItem[] | undefined, afterOrder: number): {
+    item: ApprovalLineItem;
+    order: number;
+}[];
+/** 첫 결재의 차례. */
+export declare const FIRST_ORDER = 1;
+/**
+ * 이 차례를 승인하면 다음 결재자가 있나. 없으면 이것이 마지막이다.
+ *
+ * **참조는 건너뛴다.** 참조자가 아직 안 읽었어도 결재는 다음 결재자로 넘어간다 — 막게 만들면 그 사람이
+ * 휴가일 때 결재가 선다. 막아야 하는 자격은 합의이고, 그것은 아직 없다.
+ */
+export declare function nextApproval(approvalLine: ApprovalLineItem[] | undefined, order: number): {
+    item: ApprovalLineItem;
+    order: number;
+} | undefined;
+/** 이 차례가 마지막인가. */
+export declare function isLastApproval(approvalLine: ApprovalLineItem[] | undefined, order: number): boolean;
+/**
+ * 결재가 필요한가 — **결재자가 하나라도 있어야 한다.**
+ *
+ * 비어 있으면 결재 없이 끝난다. 그리고 **참조만 있는 결재선도 결재 없이 끝난다** — 참조는 막지 않으므로
+ * 기다릴 것이 없다. 참조가 있다고 결재를 기다리게 하면, 그 사람이 승인 권한도 없이 결재를 세운다.
+ */
+export declare function needsApproval(approvalLine: ApprovalLineItem[] | undefined): boolean;
+/**
+ * 이 판정이 「승인했다」인가.
+ *
+ * ── 옛 표기를 여기서 흡수한다 ──────────────────────────────────────────────
+ * 2026-08-31 전에는 다음 결재자가 있으면 승인을 `escalated` 로 적었다. **그 행은 고치지 않는다** —
+ * 승인 기록을 뒤에서 고쳐 쓰는 것은 규제 산업이 금지하는 바로 그 행위다.
+ *
+ * 대신 읽는 자리 하나에서 옛 표기를 새 뜻으로 읽는다. 이 규율이 두 곳으로 늘어나면 한쪽만 고쳐지는
+ * 날이 온다. 「승인했나」를 묻는 코드는 전부 이것을 부른다.
+ */
+export declare function isApproved(judgment: string | undefined): boolean;
+/**
+ * 더 기다릴 것이 없는 판정들 — **목록 질의와 이 파일이 같은 값을 본다.**
+ *
+ * 목록 질의가 이 배열을 그대로 쓴다. 두 벌로 두면 값이 늘 때 한쪽만 늘고, 그 판정을 받은 행이 대기
+ * 목록에 영원히 남는다 — 실제로 그렇게 됐다(아래).
+ */
+export declare const TERMINATED_JUDGMENTS: readonly ["approved", "escalated", "delegated", "rejected", "aborted", "closed"];
+/**
+ * 이 판정이 끝난 것인가 — 더 기다릴 것이 없나.
+ *
+ * ── `aborted` 가 빠져 있었다 (2026-09-01) ─────────────────────────────────
+ * 스레드를 중단하면 그 스레드의 대기 결재가 `aborted` 로 닫힌다(§`activity-thread/_abort.ts`).
+ * 그런데 **목록 질의도 이 함수도 그 값을 「끝난 것」으로 세지 않았다.**
+ *
+ * 그래서 중단된 건의 결재가 그 사람의 **승인 대기 목록에 영원히 남았다.** 눌러 봐야 이미 끝난 건이고,
+ * 목록에서 사라지지도 않는다. 닫는 쪽은 제대로 닫았는데 읽는 쪽이 그것을 못 읽었다.
+ */
+export declare function isTerminated(judgment: string | undefined): boolean;

package/dist-server/controllers/activity-approval/approval-line.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TERMINATED_JUDGMENTS = exports.FIRST_ORDER = void 0;
+exports.isApprovalStep = isApprovalStep;
+exports.isReferenceStep = isReferenceStep;
+exports.lineItemFor = lineItemFor;
+exports.firstApprovalOrder = firstApprovalOrder;
+exports.referenceSteps = referenceSteps;
+exports.referencesToNotify = referencesToNotify;
+exports.nextApproval = nextApproval;
+exports.isLastApproval = isLastApproval;
+exports.needsApproval = needsApproval;
+exports.isApproved = isApproved;
+exports.isTerminated = isTerminated;
+/**
+ * 결재선에서 다음 결재자를 찾는다.
+ *
+ * ── 왜 따로 뺐나 ───────────────────────────────────────────────────────────
+ * 같은 규칙이 두 파일에 나뉘어 있었다.
+ *
+ *   submit.ts    첫 결재를 `order: 1` 로 만들고 `approvalLine[0]` 을 넣는다
+ *   approve.ts   `order` 를 승인하면 `approvalLine[order]` 를 다음 결재자로 삼는다
+ *
+ * `order` 와 배열 자리가 1만큼 다르다. 지금은 맞게 짝이 맞는데, 한쪽만 고치면 결재자가 한 명 빠지거나
+ * 같은 사람이 두 번 들어간다. 그리고 **오류가 안 난다** — 결재가 다 끝나고 나서야 안다.
+ *
+ * 그래서 한 자리에 적고 양쪽이 이것을 부른다.
+ *
+ * `order` 는 사람이 세는 수다 — 1차 결재, 2차 결재. 배열은 0부터이므로 그 차이를 여기서만 다룬다.
+ */
+/**
+ * 이 항목이 **결재**인가 — 비어 있으면 결재다.
+ *
+ * 지금 도는 결재선에는 이 칸이 없다(gangsters·dataset·quotation·accounting). 그 항목들이 전부 결재자로
+ * 읽혀야 거동이 안 바뀐다. 그래서 「참조라고 적힌 것만 참조」다.
+ */
+function isApprovalStep(item) {
+    return !!item && item.participation !== 'reference';
+}
+/** 이 항목이 참조인가 — 의견만 내고 결재를 막지 않는다. */
+function isReferenceStep(item) {
+    return !!item && item.participation === 'reference';
+}
+/**
+ * 이 차례의 결재자는 결재선의 어느 줄인가. `order` 는 1부터.
+ *
+ * **참조 항목도 자리를 차지한다.** `order` 는 배열 자리 그대로다 — 다시 매기면 이미 쌓인 행의 뜻이
+ * 바뀐다. 그래서 결재자의 차례가 1·3·4 처럼 띄엄띄엄해질 수 있고, 그것이 맞다.
+ *
+ * 이 함수는 그 자리에 무엇이 있든 돌려준다. 결재인지 아닌지는 부르는 쪽이 본다(§`nextApproval`).
+ */
+function lineItemFor(approvalLine, order) {
+    if (!approvalLine?.length || order < 1) {
+        return undefined;
+    }
+    return approvalLine[order - 1];
+}
+/**
+ * 첫 **결재자**는 몇 번째 자리인가 — 앞에 참조가 있으면 건너뛴다.
+ *
+ * 결재선이 참조로만 이루어져 있으면 `undefined` 다. 그때는 결재 없이 끝난다(§`needsApproval`).
+ */
+function firstApprovalOrder(approvalLine) {
+    if (!approvalLine?.length)
+        return undefined;
+    const index = approvalLine.findIndex(isApprovalStep);
+    return index < 0 ? undefined : index + 1;
+}
+/**
+ * 이 결재선의 참조들 — **언제 알릴지와 함께.**
+ *
+ * `notifyAfter` 가 없으면 `0` 으로 답한다. 0 은 「상신 즉시」다 — 아직 아무 결재도 끝나지 않은 시점.
+ */
+function referenceSteps(approvalLine) {
+    if (!approvalLine?.length)
+        return [];
+    return approvalLine
+        .map((item, index) => ({ item, order: index + 1, notifyAfter: Number(item.notifyAfter ?? 0) || 0 }))
+        .filter(x => isReferenceStep(x.item));
+}
+/** 이번에 알려야 할 참조들 — `afterOrder` 번째 결재가 막 끝났을 때. 상신 직후는 `0`. */
+function referencesToNotify(approvalLine, afterOrder) {
+    return referenceSteps(approvalLine)
+        .filter(x => x.notifyAfter === afterOrder)
+        .map(({ item, order }) => ({ item, order }));
+}
+/** 첫 결재의 차례. */
+exports.FIRST_ORDER = 1;
+/**
+ * 이 차례를 승인하면 다음 결재자가 있나. 없으면 이것이 마지막이다.
+ *
+ * **참조는 건너뛴다.** 참조자가 아직 안 읽었어도 결재는 다음 결재자로 넘어간다 — 막게 만들면 그 사람이
+ * 휴가일 때 결재가 선다. 막아야 하는 자격은 합의이고, 그것은 아직 없다.
+ */
+function nextApproval(approvalLine, order) {
+    if (!approvalLine?.length)
+        return undefined;
+    for (let next = order + 1; next <= approvalLine.length; next++) {
+        const item = lineItemFor(approvalLine, next);
+        if (isApprovalStep(item))
+            return { item: item, order: next };
+    }
+    return undefined;
+}
+/** 이 차례가 마지막인가. */
+function isLastApproval(approvalLine, order) {
+    return !nextApproval(approvalLine, order);
+}
+/**
+ * 결재가 필요한가 — **결재자가 하나라도 있어야 한다.**
+ *
+ * 비어 있으면 결재 없이 끝난다. 그리고 **참조만 있는 결재선도 결재 없이 끝난다** — 참조는 막지 않으므로
+ * 기다릴 것이 없다. 참조가 있다고 결재를 기다리게 하면, 그 사람이 승인 권한도 없이 결재를 세운다.
+ */
+function needsApproval(approvalLine) {
+    return firstApprovalOrder(approvalLine) !== undefined;
+}
+/**
+ * 이 판정이 「승인했다」인가.
+ *
+ * ── 옛 표기를 여기서 흡수한다 ──────────────────────────────────────────────
+ * 2026-08-31 전에는 다음 결재자가 있으면 승인을 `escalated` 로 적었다. **그 행은 고치지 않는다** —
+ * 승인 기록을 뒤에서 고쳐 쓰는 것은 규제 산업이 금지하는 바로 그 행위다.
+ *
+ * 대신 읽는 자리 하나에서 옛 표기를 새 뜻으로 읽는다. 이 규율이 두 곳으로 늘어나면 한쪽만 고쳐지는
+ * 날이 온다. 「승인했나」를 묻는 코드는 전부 이것을 부른다.
+ */
+function isApproved(judgment) {
+    return judgment === 'approved' || judgment === 'escalated';
+}
+/**
+ * 더 기다릴 것이 없는 판정들 — **목록 질의와 이 파일이 같은 값을 본다.**
+ *
+ * 목록 질의가 이 배열을 그대로 쓴다. 두 벌로 두면 값이 늘 때 한쪽만 늘고, 그 판정을 받은 행이 대기
+ * 목록에 영원히 남는다 — 실제로 그렇게 됐다(아래).
+ */
+exports.TERMINATED_JUDGMENTS = ['approved', 'escalated', 'delegated', 'rejected', 'aborted', 'closed'];
+/**
+ * 이 판정이 끝난 것인가 — 더 기다릴 것이 없나.
+ *
+ * ── `aborted` 가 빠져 있었다 (2026-09-01) ─────────────────────────────────
+ * 스레드를 중단하면 그 스레드의 대기 결재가 `aborted` 로 닫힌다(§`activity-thread/_abort.ts`).
+ * 그런데 **목록 질의도 이 함수도 그 값을 「끝난 것」으로 세지 않았다.**
+ *
+ * 그래서 중단된 건의 결재가 그 사람의 **승인 대기 목록에 영원히 남았다.** 눌러 봐야 이미 끝난 건이고,
+ * 목록에서 사라지지도 않는다. 닫는 쪽은 제대로 닫았는데 읽는 쪽이 그것을 못 읽었다.
+ */
+function isTerminated(judgment) {
+    return exports.TERMINATED_JUDGMENTS.includes(judgment ?? '');
+}
+//# sourceMappingURL=approval-line.js.map

package/dist-server/controllers/activity-approval/approval-line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-line.js","sourceRoot":"","sources":["../../../server/controllers/activity-approval/approval-line.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * **타입만 가져온다.** 값으로 가져오면 `@things-factory/organization` 이 실려 오고, 그것이 auth-base 의\n * 라우터까지 끌고 온다. 순수 규칙 하나를 시험하려는데 서버가 통째로 뜬다.\n */\nimport type { ApprovalLineItem } from '@things-factory/organization'\n\n/**\n * 결재선에서 다음 결재자를 찾는다.\n *\n * ── 왜 따로 뺐나 ───────────────────────────────────────────────────────────\n * 같은 규칙이 두 파일에 나뉘어 있었다.\n *\n *   submit.ts    첫 결재를 `order: 1` 로 만들고 `approvalLine[0]` 을 넣는다\n *   approve.ts   `order` 를 승인하면 `approvalLine[order]` 를 다음 결재자로 삼는다\n *\n * `order` 와 배열 자리가 1만큼 다르다. 지금은 맞게 짝이 맞는데, 한쪽만 고치면 결재자가 한 명 빠지거나\n * 같은 사람이 두 번 들어간다. 그리고 **오류가 안 난다** — 결재가 다 끝나고 나서야 안다.\n *\n * 그래서 한 자리에 적고 양쪽이 이것을 부른다.\n *\n * `order` 는 사람이 세는 수다 — 1차 결재, 2차 결재. 배열은 0부터이므로 그 차이를 여기서만 다룬다.\n */\n\n/**\n * 이 항목이 **결재**인가 — 비어 있으면 결재다.\n *\n * 지금 도는 결재선에는 이 칸이 없다(gangsters·dataset·quotation·accounting). 그 항목들이 전부 결재자로\n * 읽혀야 거동이 안 바뀐다. 그래서 「참조라고 적힌 것만 참조」다.\n */\nexport function isApprovalStep(item: ApprovalLineItem | undefined): boolean {\n  return !!item && (item as any).participation !== 'reference'\n}\n\n/** 이 항목이 참조인가 — 의견만 내고 결재를 막지 않는다. */\nexport function isReferenceStep(item: ApprovalLineItem | undefined): boolean {\n  return !!item && (item as any).participation === 'reference'\n}\n\n/**\n * 이 차례의 결재자는 결재선의 어느 줄인가. `order` 는 1부터.\n *\n * **참조 항목도 자리를 차지한다.** `order` 는 배열 자리 그대로다 — 다시 매기면 이미 쌓인 행의 뜻이\n * 바뀐다. 그래서 결재자의 차례가 1·3·4 처럼 띄엄띄엄해질 수 있고, 그것이 맞다.\n *\n * 이 함수는 그 자리에 무엇이 있든 돌려준다. 결재인지 아닌지는 부르는 쪽이 본다(§`nextApproval`).\n */\nexport function lineItemFor(approvalLine: ApprovalLineItem[] | undefined, order: number): ApprovalLineItem | undefined {\n  if (!approvalLine?.length || order < 1) {\n    return undefined\n  }\n\n  return approvalLine[order - 1]\n}\n\n/**\n * 첫 **결재자**는 몇 번째 자리인가 — 앞에 참조가 있으면 건너뛴다.\n *\n * 결재선이 참조로만 이루어져 있으면 `undefined` 다. 그때는 결재 없이 끝난다(§`needsApproval`).\n */\nexport function firstApprovalOrder(approvalLine: ApprovalLineItem[] | undefined): number | undefined {\n  if (!approvalLine?.length) return undefined\n\n  const index = approvalLine.findIndex(isApprovalStep)\n  return index < 0 ? undefined : index + 1\n}\n\n/**\n * 이 결재선의 참조들 — **언제 알릴지와 함께.**\n *\n * `notifyAfter` 가 없으면 `0` 으로 답한다. 0 은 「상신 즉시」다 — 아직 아무 결재도 끝나지 않은 시점.\n */\nexport function referenceSteps(\n  approvalLine: ApprovalLineItem[] | undefined\n): { item: ApprovalLineItem; order: number; notifyAfter: number }[] {\n  if (!approvalLine?.length) return []\n\n  return approvalLine\n    .map((item, index) => ({ item, order: index + 1, notifyAfter: Number((item as any).notifyAfter ?? 0) || 0 }))\n    .filter(x => isReferenceStep(x.item))\n}\n\n/** 이번에 알려야 할 참조들 — `afterOrder` 번째 결재가 막 끝났을 때. 상신 직후는 `0`. */\nexport function referencesToNotify(\n  approvalLine: ApprovalLineItem[] | undefined,\n  afterOrder: number\n): { item: ApprovalLineItem; order: number }[] {\n  return referenceSteps(approvalLine)\n    .filter(x => x.notifyAfter === afterOrder)\n    .map(({ item, order }) => ({ item, order }))\n}\n\n/** 첫 결재의 차례. */\nexport const FIRST_ORDER = 1\n\n/**\n * 이 차례를 승인하면 다음 결재자가 있나. 없으면 이것이 마지막이다.\n *\n * **참조는 건너뛴다.** 참조자가 아직 안 읽었어도 결재는 다음 결재자로 넘어간다 — 막게 만들면 그 사람이\n * 휴가일 때 결재가 선다. 막아야 하는 자격은 합의이고, 그것은 아직 없다.\n */\nexport function nextApproval(\n  approvalLine: ApprovalLineItem[] | undefined,\n  order: number\n): { item: ApprovalLineItem; order: number } | undefined {\n  if (!approvalLine?.length) return undefined\n\n  for (let next = order + 1; next <= approvalLine.length; next++) {\n    const item = lineItemFor(approvalLine, next)\n    if (isApprovalStep(item)) return { item: item!, order: next }\n  }\n\n  return undefined\n}\n\n/** 이 차례가 마지막인가. */\nexport function isLastApproval(approvalLine: ApprovalLineItem[] | undefined, order: number): boolean {\n  return !nextApproval(approvalLine, order)\n}\n\n/**\n * 결재가 필요한가 — **결재자가 하나라도 있어야 한다.**\n *\n * 비어 있으면 결재 없이 끝난다. 그리고 **참조만 있는 결재선도 결재 없이 끝난다** — 참조는 막지 않으므로\n * 기다릴 것이 없다. 참조가 있다고 결재를 기다리게 하면, 그 사람이 승인 권한도 없이 결재를 세운다.\n */\nexport function needsApproval(approvalLine: ApprovalLineItem[] | undefined): boolean {\n  return firstApprovalOrder(approvalLine) !== undefined\n}\n\n/**\n * 이 판정이 「승인했다」인가.\n *\n * ── 옛 표기를 여기서 흡수한다 ──────────────────────────────────────────────\n * 2026-08-31 전에는 다음 결재자가 있으면 승인을 `escalated` 로 적었다. **그 행은 고치지 않는다** —\n * 승인 기록을 뒤에서 고쳐 쓰는 것은 규제 산업이 금지하는 바로 그 행위다.\n *\n * 대신 읽는 자리 하나에서 옛 표기를 새 뜻으로 읽는다. 이 규율이 두 곳으로 늘어나면 한쪽만 고쳐지는\n * 날이 온다. 「승인했나」를 묻는 코드는 전부 이것을 부른다.\n */\nexport function isApproved(judgment: string | undefined): boolean {\n  return judgment === 'approved' || judgment === 'escalated'\n}\n\n/**\n * 더 기다릴 것이 없는 판정들 — **목록 질의와 이 파일이 같은 값을 본다.**\n *\n * 목록 질의가 이 배열을 그대로 쓴다. 두 벌로 두면 값이 늘 때 한쪽만 늘고, 그 판정을 받은 행이 대기\n * 목록에 영원히 남는다 — 실제로 그렇게 됐다(아래).\n */\nexport const TERMINATED_JUDGMENTS = ['approved', 'escalated', 'delegated', 'rejected', 'aborted', 'closed'] as const\n\n/**\n * 이 판정이 끝난 것인가 — 더 기다릴 것이 없나.\n *\n * ── `aborted` 가 빠져 있었다 (2026-09-01) ─────────────────────────────────\n * 스레드를 중단하면 그 스레드의 대기 결재가 `aborted` 로 닫힌다(§`activity-thread/_abort.ts`).\n * 그런데 **목록 질의도 이 함수도 그 값을 「끝난 것」으로 세지 않았다.**\n *\n * 그래서 중단된 건의 결재가 그 사람의 **승인 대기 목록에 영원히 남았다.** 눌러 봐야 이미 끝난 건이고,\n * 목록에서 사라지지도 않는다. 닫는 쪽은 제대로 닫았는데 읽는 쪽이 그것을 못 읽었다.\n */\nexport function isTerminated(judgment: string | undefined): boolean {\n  return (TERMINATED_JUDGMENTS as readonly string[]).includes(judgment ?? '')\n}\n"]}

package/dist-server/controllers/activity-approval/approve.js

@@ -1,13 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.approve = approve;
-const organization_1 = require("@things-factory/organization");
-const auth_base_1 = require("@things-factory/auth-base");
-const common_js_1 = require("../../controllers/common.js");
+const opinion_js_1 = require("./opinion.js");
 const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
 const activity_approval_js_1 = require("../../service/activity-approval/activity-approval.js");
-const common_js_2 = require("../common.js");
+const common_js_1 = require("../common.js");
 const check_authority_js_1 = require("./check-authority.js");
+const approval_line_js_1 = require("./approval-line.js");
+const create_approval_js_1 = require("./create-approval.js");
+const claim_js_1 = require("./claim.js");
 async function approve({ id, comment }, context) {
     const { domain, user, tx } = context.state;
     var repository = tx.getRepository(activity_approval_js_1.ActivityApproval);
@@ -34,63 +35,72 @@ async function approve({ id, comment }, context) {
         where: { domain: { id: domain.id }, id: activityApproval.activityThreadId },
         relations: ['activityInstance']
     });
+    /*
+     * 여기까지 오면 스레드가 있어야 한다. 없는 채로 아래를 읽으면 `TypeError` 가 나고, 그 오류로는
+     * 무엇이 없는지 알 수 없다.
+     */
+    if (!activityThread) {
+        throw new Error(context.t('error.activity-thread not found', { activityThread: activityApproval.activityThreadId }));
+    }
+    if (!activityThread.activityInstance) {
+        throw new Error(context.t('error.activity-instance not found', { activityThread: activityThread.id }));
+    }
     const approvalLine = activityThread.activityInstance.approvalLine;
     const order = activityApproval.order;
+    /* 다음 결재자가 누구인지는 한 자리가 정한다 — `approval-line.ts`. */
+    const next = (0, approval_line_js_1.nextApproval)(approvalLine, order);
+    /*
+     * **여기서 잡는다.** 위의 검사는 읽은 시점의 것이라 그 사이에 남이 처리할 수 있다. 잡기가 첫 쓰기여야
+     * 진 쪽이 다음 결재자를 만들기 전에 물러난다.
+     */
+    if (!(await (0, claim_js_1.claimPendingApproval)(tx, activityApproval, activity_approval_js_1.ActivityApprovalJudgment.Approved))) {
+        /* 「이미 끝났다」보다 **그 사람이 할 일**을 말한다 — 목록을 새로 읽으면 지금 상태가 보인다. */
+        throw new Error(context.t('error.activity-approval taken by someone else', { activityApproval: id }));
+    }
+    /*
+     * **승인한 사람은 승인한 것이다** (2026-08-31, 아키텍트 확인).
+     *
+     * 앞서는 다음 결재자가 있으면 `Escalated` 로 적었다. 그러면 「누가 승인했나」를 물을 때 중간 결재자가
+     * 전부 「상신함」으로 나오고, **승인한 것과 그냥 넘긴 것이 구별되지 않는다.** 규제 산업에서는 결재
+     * 이력이 곧 근거라 이것이 결함이다.
+     *
+     * 다음으로 넘어간 사실은 `transaction` 이 그대로 들고 있으므로 잃는 것이 없다.
+     */
     const result = await tx.getRepository(activity_approval_js_1.ActivityApproval).save({
         ...activityApproval,
-        judgment: approvalLine[order] ? activity_approval_js_1.ActivityApprovalJudgment.Escalated : activity_approval_js_1.ActivityApprovalJudgment.Approved,
-        comment,
-        transaction: approvalLine[order] ? 'escalate' : 'approve',
+        judgment: activity_approval_js_1.ActivityApprovalJudgment.Approved,
+        ...(0, opinion_js_1.stampedComment)(comment),
+        transaction: next ? 'escalate' : 'approve',
+        /*
+         * **누가 처리했는지 남긴다.**
+         *
+         * 역할로 걸린 결재는 `approver` 가 비어 있고 `approverRole` 만 있다. 처리해도 그 자리가 비어 있으면
+         * 두 가지가 함께 무너진다 — 그 역할을 가진 사람들의 **대기 목록에 영원히 남고**(`approver IS NULL`
+         * 로 걸리므로), 정작 처리한 사람의 **완료 목록에는 안 나온다**(`approver = 나` 로 거르므로).
+         *
+         * 그리고 결재 이력에서 「누가 승인했나」는 역할이 아니라 사람이어야 한다.
+         */
+        approver: activityApproval.approver ?? user,
         updater: user,
         terminatedAt: new Date(),
         terminator: user
     });
-    if (approvalLine && approvalLine.length > order) {
-        // approvalLine에서 후속 승인자에게 escalating.
-        if (approvalLine[order].type == organization_1.OrgMemberTargetType.Role) {
-            const approverRoleId = approvalLine[order].value || approvalLine[order].approver?.id;
-            if (!approverRoleId) {
-                throw 'Cannot specify the approver role for this approval line';
-            }
-            const approverRole = await tx.getRepository(auth_base_1.Role).findOneBy({
-                id: approverRoleId
-            });
-            if (!approverRole) {
-                throw 'Cannot find the approver role for this approval line';
-            }
-            await tx.getRepository(activity_approval_js_1.ActivityApproval).save({
-                domain,
-                activityThread,
-                round: activityThread.round,
-                order: order + 1,
-                judgment: activity_approval_js_1.ActivityApprovalJudgment.Pending,
-                transaction: 'escalate',
-                approverRole: approverRole,
-                creator: user,
-                updater: user
-            });
-        }
-        else {
-            var approverUser = await (0, common_js_1.getSystemUserFromOrgMemberItem)(approvalLine[order], context);
-            if (!approverUser) {
-                throw 'Cannot specify the approval user for this approval line';
-            }
-            await tx.getRepository(activity_approval_js_1.ActivityApproval).save({
-                domain,
-                activityThread,
-                round: activityThread.round,
-                order: order + 1,
-                judgment: activity_approval_js_1.ActivityApprovalJudgment.Pending,
-                transaction: 'escalate',
-                approver: approverUser,
-                creator: user,
-                updater: user
-            });
-        }
+    /*
+     * **이번 결재가 끝나서 알릴 참조들.** `notifyAfter` 가 이 차례를 가리키는 참조가 여기 온다.
+     *
+     * 다음 결재자를 세우는 것과 **무관하게** 만든다 — 참조는 막지 않으므로, 이것이 실패해도 결재는 간다.
+     */
+    const refs = await (0, create_approval_js_1.createReferences)({ references: (0, approval_line_js_1.referencesToNotify)(approvalLine, order), activityThread }, context);
+    for (const f of refs.failed) {
+        console.warn(`[worklist] 참조자를 세우지 못했다 (결재선 ${f.order}번째) — ${f.reason}`);
+    }
+    if (next) {
+        /* 다음 결재자에게 넘긴다 — 행을 만드는 자리는 한 곳이다(§`create-approval.ts`). */
+        await (0, create_approval_js_1.createApproval)({ item: next.item, order: next.order, participation: 'approval', activityThread, transaction: 'escalate' }, context);
         activityThread = await tx.getRepository(activity_thread_js_1.ActivityThread).save({
             ...activityThread,
             transaction: 'escalate',
-            reaseon: comment,
+            reason: comment,
             state: activity_thread_js_1.ActivityThreadStatus.Escalated,
             updater: user
         });
@@ -106,7 +116,7 @@ async function approve({ id, comment }, context) {
             updater: user
         });
     }
-    await (0, common_js_2.updateActivityInstanceState)(activityThread.activityInstanceId, { causedBy: [activityThread] }, context);
+    await (0, common_js_1.updateActivityInstanceState)(activityThread.activityInstanceId, { causedBy: [activityThread] }, context);
     return result;
 }
 //# sourceMappingURL=approve.js.map

package/dist-server/controllers/activity-approval/approve.js.map

@@ -1 +1 @@
-{"version":3,"file":"approve.js","sourceRoot":"","sources":["../../../server/controllers/activity-approval/approve.ts"],"names":[],"mappings":"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","sourcesContent":["import { ApprovalLineItem, OrgMemberTargetType } from '@things-factory/organization'\nimport { Role } from '@things-factory/auth-base'\nimport { getSystemUserFromOrgMemberItem } from '../../controllers/common.js'\nimport { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { ActivityApproval, ActivityApprovalJudgment } from '../../service/activity-approval/activity-approval.js'\nimport { updateActivityInstanceState } from '../common.js'\nimport { checkAuthority } from './check-authority.js'\n\nexport async function approve(\n  { id, comment }: { id: string; comment: string },\n  context: ResolverContext\n): Promise<ActivityApproval> {\n  const { domain, user, tx } = context.state\n\n  var repository = tx.getRepository(ActivityApproval)\n\n  var activityApproval = await repository.findOne({\n    where: { domain: { id: domain.id }, id }\n  })\n\n  if (!activityApproval) {\n    throw new Error(\n      context.t('error.activity-approval not found', {\n        activityApproval: id\n      })\n    )\n  }\n\n  await checkAuthority(activityApproval, context)\n\n  /* \n    Prerequisite of Approval\n    - Previous judgment should be 'pending'\n  */\n  if (activityApproval.judgment !== ActivityApprovalJudgment.Pending) {\n    throw new Error(\n      context.t(`error.activity-approval is already terminated`, {\n        activityApproval: id,\n        actual: activityApproval.judgment\n      })\n    )\n  }\n\n  var activityThread = await tx.getRepository(ActivityThread).findOne({\n    where: { domain: { id: domain.id }, id: activityApproval.activityThreadId },\n    relations: ['activityInstance']\n  })\n\n  const approvalLine: ApprovalLineItem[] = activityThread.activityInstance.approvalLine\n  const order = activityApproval.order\n\n  const result = await tx.getRepository(ActivityApproval).save({\n    ...activityApproval,\n    judgment: approvalLine[order] ? ActivityApprovalJudgment.Escalated : ActivityApprovalJudgment.Approved,\n    comment,\n    transaction: approvalLine[order] ? 'escalate' : 'approve',\n    updater: user,\n    terminatedAt: new Date(),\n    terminator: user\n  })\n\n  if (approvalLine && approvalLine.length > order) {\n    // approvalLine에서 후속 승인자에게 escalating.\n\n    if (approvalLine[order].type == OrgMemberTargetType.Role) {\n      const approverRoleId = approvalLine[order].value || approvalLine[order].approver?.id\n\n      if (!approverRoleId) {\n        throw 'Cannot specify the approver role for this approval line'\n      }\n\n      const approverRole = await tx.getRepository(Role).findOneBy({\n        id: approverRoleId\n      })\n\n      if (!approverRole) {\n        throw 'Cannot find the approver role for this approval line'\n      }\n\n      await tx.getRepository(ActivityApproval).save({\n        domain,\n        activityThread,\n        round: activityThread.round,\n        order: order + 1,\n        judgment: ActivityApprovalJudgment.Pending,\n        transaction: 'escalate',\n        approverRole: approverRole,\n        creator: user,\n        updater: user\n      })\n    } else {\n      var approverUser = await getSystemUserFromOrgMemberItem(approvalLine[order], context)\n\n      if (!approverUser) {\n        throw 'Cannot specify the approval user for this approval line'\n      }\n\n      await tx.getRepository(ActivityApproval).save({\n        domain,\n        activityThread,\n        round: activityThread.round,\n        order: order + 1,\n        judgment: ActivityApprovalJudgment.Pending,\n        transaction: 'escalate',\n        approver: approverUser,\n        creator: user,\n        updater: user\n      })\n    }\n\n    activityThread = await tx.getRepository(ActivityThread).save({\n      ...activityThread,\n      transaction: 'escalate',\n      reaseon: comment,\n      state: ActivityThreadStatus.Escalated,\n      updater: user\n    })\n  } else {\n    activityThread = await tx.getRepository(ActivityThread).save({\n      ...activityThread,\n      transaction: 'approve',\n      reason: comment,\n      state: ActivityThreadStatus.Ended,\n      terminatedAt: new Date(),\n      terminator: user,\n      updater: user\n    })\n  }\n\n  await updateActivityInstanceState(activityThread.activityInstanceId, { causedBy: [activityThread] }, context)\n\n  return result\n}\n"]}
+{"version":3,"file":"approve.js","sourceRoot":"","sources":["../../../server/controllers/activity-approval/approve.ts"],"names":[],"mappings":"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","sourcesContent":["import { ApprovalLineItem } from '@things-factory/organization'\nimport { stampedComment } from './opinion.js'\nimport { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { ActivityApproval, ActivityApprovalJudgment } from '../../service/activity-approval/activity-approval.js'\nimport { updateActivityInstanceState } from '../common.js'\nimport { checkAuthority } from './check-authority.js'\nimport { nextApproval, referencesToNotify } from './approval-line.js'\nimport { createApproval, createReferences } from './create-approval.js'\nimport { claimPendingApproval } from './claim.js'\n\nexport async function approve(\n  { id, comment }: { id: string; comment: string },\n  context: ResolverContext\n): Promise<ActivityApproval> {\n  const { domain, user, tx } = context.state\n\n  var repository = tx.getRepository(ActivityApproval)\n\n  var activityApproval = await repository.findOne({\n    where: { domain: { id: domain.id }, id }\n  })\n\n  if (!activityApproval) {\n    throw new Error(\n      context.t('error.activity-approval not found', {\n        activityApproval: id\n      })\n    )\n  }\n\n  await checkAuthority(activityApproval, context)\n\n  /* \n    Prerequisite of Approval\n    - Previous judgment should be 'pending'\n  */\n  if (activityApproval.judgment !== ActivityApprovalJudgment.Pending) {\n    throw new Error(\n      context.t(`error.activity-approval is already terminated`, {\n        activityApproval: id,\n        actual: activityApproval.judgment\n      })\n    )\n  }\n\n  var activityThread = await tx.getRepository(ActivityThread).findOne({\n    where: { domain: { id: domain.id }, id: activityApproval.activityThreadId },\n    relations: ['activityInstance']\n  })\n\n  /*\n   * 여기까지 오면 스레드가 있어야 한다. 없는 채로 아래를 읽으면 `TypeError` 가 나고, 그 오류로는\n   * 무엇이 없는지 알 수 없다.\n   */\n  if (!activityThread) {\n    throw new Error(context.t('error.activity-thread not found', { activityThread: activityApproval.activityThreadId }))\n  }\n\n  if (!activityThread.activityInstance) {\n    throw new Error(context.t('error.activity-instance not found', { activityThread: activityThread.id }))\n  }\n\n  const approvalLine: ApprovalLineItem[] = activityThread.activityInstance.approvalLine\n  const order = activityApproval.order\n\n  /* 다음 결재자가 누구인지는 한 자리가 정한다 — `approval-line.ts`. */\n  const next = nextApproval(approvalLine, order)\n\n  /*\n   * **여기서 잡는다.** 위의 검사는 읽은 시점의 것이라 그 사이에 남이 처리할 수 있다. 잡기가 첫 쓰기여야\n   * 진 쪽이 다음 결재자를 만들기 전에 물러난다.\n   */\n  if (!(await claimPendingApproval(tx, activityApproval, ActivityApprovalJudgment.Approved))) {\n    /* 「이미 끝났다」보다 **그 사람이 할 일**을 말한다 — 목록을 새로 읽으면 지금 상태가 보인다. */\n    throw new Error(context.t('error.activity-approval taken by someone else', { activityApproval: id }))\n  }\n\n  /*\n   * **승인한 사람은 승인한 것이다** (2026-08-31, 아키텍트 확인).\n   *\n   * 앞서는 다음 결재자가 있으면 `Escalated` 로 적었다. 그러면 「누가 승인했나」를 물을 때 중간 결재자가\n   * 전부 「상신함」으로 나오고, **승인한 것과 그냥 넘긴 것이 구별되지 않는다.** 규제 산업에서는 결재\n   * 이력이 곧 근거라 이것이 결함이다.\n   *\n   * 다음으로 넘어간 사실은 `transaction` 이 그대로 들고 있으므로 잃는 것이 없다.\n   */\n  const result = await tx.getRepository(ActivityApproval).save({\n    ...activityApproval,\n    judgment: ActivityApprovalJudgment.Approved,\n    ...stampedComment(comment),\n    transaction: next ? 'escalate' : 'approve',\n    /*\n     * **누가 처리했는지 남긴다.**\n     *\n     * 역할로 걸린 결재는 `approver` 가 비어 있고 `approverRole` 만 있다. 처리해도 그 자리가 비어 있으면\n     * 두 가지가 함께 무너진다 — 그 역할을 가진 사람들의 **대기 목록에 영원히 남고**(`approver IS NULL`\n     * 로 걸리므로), 정작 처리한 사람의 **완료 목록에는 안 나온다**(`approver = 나` 로 거르므로).\n     *\n     * 그리고 결재 이력에서 「누가 승인했나」는 역할이 아니라 사람이어야 한다.\n     */\n    approver: activityApproval.approver ?? user,\n    updater: user,\n    terminatedAt: new Date(),\n    terminator: user\n  })\n\n  /*\n   * **이번 결재가 끝나서 알릴 참조들.** `notifyAfter` 가 이 차례를 가리키는 참조가 여기 온다.\n   *\n   * 다음 결재자를 세우는 것과 **무관하게** 만든다 — 참조는 막지 않으므로, 이것이 실패해도 결재는 간다.\n   */\n  const refs = await createReferences(\n    { references: referencesToNotify(approvalLine, order), activityThread },\n    context\n  )\n  for (const f of refs.failed) {\n    console.warn(`[worklist] 참조자를 세우지 못했다 (결재선 ${f.order}번째) — ${f.reason}`)\n  }\n\n  if (next) {\n    /* 다음 결재자에게 넘긴다 — 행을 만드는 자리는 한 곳이다(§`create-approval.ts`). */\n    await createApproval(\n      { item: next.item, order: next.order, participation: 'approval', activityThread, transaction: 'escalate' },\n      context\n    )\n\n    activityThread = await tx.getRepository(ActivityThread).save({\n      ...activityThread,\n      transaction: 'escalate',\n      reason: comment,\n      state: ActivityThreadStatus.Escalated,\n      updater: user\n    })\n  } else {\n    activityThread = await tx.getRepository(ActivityThread).save({\n      ...activityThread,\n      transaction: 'approve',\n      reason: comment,\n      state: ActivityThreadStatus.Ended,\n      terminatedAt: new Date(),\n      terminator: user,\n      updater: user\n    })\n  }\n\n  await updateActivityInstanceState(activityThread.activityInstanceId, { causedBy: [activityThread] }, context)\n\n  return result\n}\n"]}