@things-factory/worklist 10.1.248 → 10.1.250

package/dist-server/service/approval-notice/approval-notice-rules.d.ts

@@ -0,0 +1,67 @@
+import type { NoticeWords } from '@things-factory/notification';
+import type { ApprovalLineItem } from '@things-factory/organization';
+/**
+ * What happened.
+ *
+ * - `request`   a seat's turn came - the first one on submit, the next one after an approval
+ * - `delegated` a seat was handed to someone
+ * - `reference` someone was seated to read along
+ * - `approved`  the last approval ended the case
+ * - `rejected`  an approver sent it back
+ */
+export type ApprovalNoticeKind = 'request' | 'delegated' | 'reference' | 'approved' | 'rejected';
+export declare const APPROVAL_NOTICE_KINDS: readonly ApprovalNoticeKind[];
+/** A notice for the person whose turn it is - the other kinds tell the requester of a judgment. */
+export declare function isTurnNotice(kind: ApprovalNoticeKind): boolean;
+export type NoticePerson = {
+    id: string;
+    name?: string | null;
+    email?: string | null;
+    locale?: string | null;
+};
+/**
+ * Who is told.
+ *
+ * A turn reaches the seat: its person, or - for a seat held by a role - everyone holding the role. A judgment
+ * reaches the requester. Whoever did the thing is not told of it, and nobody is told twice.
+ */
+export declare function noticeReceivers({ kind, approver, roleHolders, requester, actorId }: {
+    kind: ApprovalNoticeKind;
+    approver?: NoticePerson | null;
+    roleHolders?: NoticePerson[] | null;
+    requester?: NoticePerson | null;
+    actorId?: string | null;
+}): NoticePerson[];
+/**
+ * The page the notice opens, relative to the domain - the same pages the worklist lists open.
+ *
+ * A turn opens the approval. An approved case opens the thread's read-only view; a rejected one opens the thread
+ * itself, where the requester revises and raises it again.
+ */
+export declare function noticeAddress(kind: ApprovalNoticeKind, { approvalId, threadId }: {
+    approvalId: string;
+    threadId: string;
+}): string;
+/** Which approval of the line this seat is - references take a place in the line but are not counted. */
+export declare function approvalStep(line: ApprovalLineItem[] | null | undefined, order: number): {
+    step: number;
+    steps: number;
+} | undefined;
+export type NoticeFacts = {
+    kind: ApprovalNoticeKind;
+    /** The case as the worklist names it. */
+    name: string;
+    requester?: string | null;
+    /** Who did the thing - the approver who judged, the person who handed a seat on. */
+    actor?: string | null;
+    step?: number;
+    steps?: number;
+};
+export type Translate = (key: string, options?: {
+    [name: string]: unknown;
+}) => string;
+/**
+ * The sentences, from the worklist translations (`approval-notice.<kind>.*`). Nothing of the request's content goes
+ * in: no input, no amount, no comment. The page behind the link shows those to whoever may see them.
+ */
+export declare function noticeWords(t: Translate, facts: NoticeFacts): NoticeWords;

package/dist-server/service/approval-notice/approval-notice-rules.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APPROVAL_NOTICE_KINDS = void 0;
+exports.isTurnNotice = isTurnNotice;
+exports.noticeReceivers = noticeReceivers;
+exports.noticeAddress = noticeAddress;
+exports.approvalStep = approvalStep;
+exports.noticeWords = noticeWords;
+const approval_line_js_1 = require("../../controllers/activity-approval/approval-line.js");
+exports.APPROVAL_NOTICE_KINDS = ['request', 'delegated', 'reference', 'approved', 'rejected'];
+/** A notice for the person whose turn it is - the other kinds tell the requester of a judgment. */
+function isTurnNotice(kind) {
+    return kind === 'request' || kind === 'delegated' || kind === 'reference';
+}
+/**
+ * Who is told.
+ *
+ * A turn reaches the seat: its person, or - for a seat held by a role - everyone holding the role. A judgment
+ * reaches the requester. Whoever did the thing is not told of it, and nobody is told twice.
+ */
+function noticeReceivers({ kind, approver, roleHolders, requester, actorId }) {
+    const candidates = isTurnNotice(kind) ? (approver ? [approver] : roleHolders || []) : requester ? [requester] : [];
+    const seen = new Set();
+    return candidates.filter(person => {
+        if (!person?.id || person.id === actorId || seen.has(person.id))
+            return false;
+        seen.add(person.id);
+        return true;
+    });
+}
+/**
+ * The page the notice opens, relative to the domain - the same pages the worklist lists open.
+ *
+ * A turn opens the approval. An approved case opens the thread's read-only view; a rejected one opens the thread
+ * itself, where the requester revises and raises it again.
+ */
+function noticeAddress(kind, { approvalId, threadId }) {
+    if (isTurnNotice(kind))
+        return `activity-approval/${approvalId}`;
+    return kind === 'approved' ? `activity-thread-view/${threadId}` : `activity-thread/${threadId}`;
+}
+/** Which approval of the line this seat is - references take a place in the line but are not counted. */
+function approvalStep(line, order) {
+    const orders = (line || []).map((item, index) => ((0, approval_line_js_1.isApprovalStep)(item) ? index + 1 : 0)).filter(Boolean);
+    const step = orders.indexOf(order) + 1;
+    return step ? { step, steps: orders.length } : undefined;
+}
+/**
+ * The sentences, from the worklist translations (`approval-notice.<kind>.*`). Nothing of the request's content goes
+ * in: no input, no amount, no comment. The page behind the link shows those to whoever may see them.
+ */
+function noticeWords(t, facts) {
+    const values = {
+        name: facts.name,
+        requester: facts.requester || '-',
+        actor: facts.actor || '-',
+        step: facts.step ?? '-',
+        steps: facts.steps ?? '-'
+    };
+    return {
+        subject: t(`approval-notice.${facts.kind}.subject`, values),
+        body: t(`approval-notice.${facts.kind}.body`, values),
+        action: t(isTurnNotice(facts.kind) ? 'approval-notice.open-approval' : 'approval-notice.open-request', values),
+        note: t(isTurnNotice(facts.kind) ? 'approval-notice.see-approval-box' : 'approval-notice.see-request-box', values)
+    };
+}
+//# sourceMappingURL=approval-notice-rules.js.map

package/dist-server/service/approval-notice/approval-notice-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-notice-rules.js","sourceRoot":"","sources":["../../../server/service/approval-notice/approval-notice-rules.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The rules of the approval notice (ADR-0164) - who is told and what they read. How it is sent is notification's.\n * Plain functions over plain values: no entity, no request, so a test holds every rule without a database.\n */\nimport type { NoticeWords } from '@things-factory/notification'\nimport type { ApprovalLineItem } from '@things-factory/organization'\n\nimport { isApprovalStep } from '../../controllers/activity-approval/approval-line.js'\n\n/**\n * What happened.\n *\n * - `request`   a seat's turn came - the first one on submit, the next one after an approval\n * - `delegated` a seat was handed to someone\n * - `reference` someone was seated to read along\n * - `approved`  the last approval ended the case\n * - `rejected`  an approver sent it back\n */\nexport type ApprovalNoticeKind = 'request' | 'delegated' | 'reference' | 'approved' | 'rejected'\n\nexport const APPROVAL_NOTICE_KINDS: readonly ApprovalNoticeKind[] = ['request', 'delegated', 'reference', 'approved', 'rejected']\n\n/** A notice for the person whose turn it is - the other kinds tell the requester of a judgment. */\nexport function isTurnNotice(kind: ApprovalNoticeKind): boolean {\n  return kind === 'request' || kind === 'delegated' || kind === 'reference'\n}\n\nexport type NoticePerson = { id: string; name?: string | null; email?: string | null; locale?: string | null }\n\n/**\n * Who is told.\n *\n * A turn reaches the seat: its person, or - for a seat held by a role - everyone holding the role. A judgment\n * reaches the requester. Whoever did the thing is not told of it, and nobody is told twice.\n */\nexport function noticeReceivers({\n  kind,\n  approver,\n  roleHolders,\n  requester,\n  actorId\n}: {\n  kind: ApprovalNoticeKind\n  approver?: NoticePerson | null\n  roleHolders?: NoticePerson[] | null\n  requester?: NoticePerson | null\n  actorId?: string | null\n}): NoticePerson[] {\n  const candidates = isTurnNotice(kind) ? (approver ? [approver] : roleHolders || []) : requester ? [requester] : []\n  const seen = new Set<string>()\n\n  return candidates.filter(person => {\n    if (!person?.id || person.id === actorId || seen.has(person.id)) return false\n    seen.add(person.id)\n    return true\n  })\n}\n\n/**\n * The page the notice opens, relative to the domain - the same pages the worklist lists open.\n *\n * A turn opens the approval. An approved case opens the thread's read-only view; a rejected one opens the thread\n * itself, where the requester revises and raises it again.\n */\nexport function noticeAddress(kind: ApprovalNoticeKind, { approvalId, threadId }: { approvalId: string; threadId: string }): string {\n  if (isTurnNotice(kind)) return `activity-approval/${approvalId}`\n  return kind === 'approved' ? `activity-thread-view/${threadId}` : `activity-thread/${threadId}`\n}\n\n/** Which approval of the line this seat is - references take a place in the line but are not counted. */\nexport function approvalStep(line: ApprovalLineItem[] | null | undefined, order: number): { step: number; steps: number } | undefined {\n  const orders = (line || []).map((item, index) => (isApprovalStep(item) ? index + 1 : 0)).filter(Boolean)\n  const step = orders.indexOf(order) + 1\n  return step ? { step, steps: orders.length } : undefined\n}\n\n\nexport type NoticeFacts = {\n  kind: ApprovalNoticeKind\n  /** The case as the worklist names it. */\n  name: string\n  requester?: string | null\n  /** Who did the thing - the approver who judged, the person who handed a seat on. */\n  actor?: string | null\n  step?: number\n  steps?: number\n}\n\nexport type Translate = (key: string, options?: { [name: string]: unknown }) => string\n\n/**\n * The sentences, from the worklist translations (`approval-notice.<kind>.*`). Nothing of the request's content goes\n * in: no input, no amount, no comment. The page behind the link shows those to whoever may see them.\n */\nexport function noticeWords(t: Translate, facts: NoticeFacts): NoticeWords {\n  const values = {\n    name: facts.name,\n    requester: facts.requester || '-',\n    actor: facts.actor || '-',\n    step: facts.step ?? '-',\n    steps: facts.steps ?? '-'\n  }\n\n  return {\n    subject: t(`approval-notice.${facts.kind}.subject`, values),\n    body: t(`approval-notice.${facts.kind}.body`, values),\n    action: t(isTurnNotice(facts.kind) ? 'approval-notice.open-approval' : 'approval-notice.open-request', values),\n    note: t(isTurnNotice(facts.kind) ? 'approval-notice.see-approval-box' : 'approval-notice.see-request-box', values)\n  }\n}\n"]}

package/dist-server/service/approval-notice/approval-notice.d.ts

@@ -0,0 +1,11 @@
+import { type ApprovalNoticeKind } from './approval-notice-rules.js';
+/**
+ * Tells of what just happened to approval `approvalId`, once the transaction has committed.
+ *
+ * Who and what are settled here, inside the transaction, from rows it can see. Nothing here throws: a notice that
+ * cannot be made is reported and the approval stands.
+ */
+export declare function noticeApproval(context: ResolverContext, { kind, approvalId }: {
+    kind: ApprovalNoticeKind;
+    approvalId: string;
+}): Promise<void>;

package/dist-server/service/approval-notice/approval-notice.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noticeApproval = noticeApproval;
+/*
+ * The approval notice (ADR-0164) - the one place the worklist tells people of an approval's turn and judgment.
+ *
+ * The four places an approval moves call `noticeApproval`: createApproval (a turn or a reference), delegate (a
+ * handed seat), approve with no one after (approved) and reject (rejected). Applications call nothing; a case that
+ * goes through the approval line is told of. Sending is notification's (`sendNoticeWhenCommitted`).
+ */
+const auth_base_1 = require("@things-factory/auth-base");
+const env_1 = require("@things-factory/env");
+const translator_1 = require("@things-factory/i18n-base/translator");
+const notification_1 = require("@things-factory/notification");
+const activity_approval_js_1 = require("../activity-approval/activity-approval.js");
+const assignee_pool_js_1 = require("../activity-instance/assignee-pool.js");
+const approval_notice_rules_js_1 = require("./approval-notice-rules.js");
+/**
+ * Tells of what just happened to approval `approvalId`, once the transaction has committed.
+ *
+ * Who and what are settled here, inside the transaction, from rows it can see. Nothing here throws: a notice that
+ * cannot be made is reported and the approval stands.
+ */
+async function noticeApproval(context, { kind, approvalId }) {
+    try {
+        const { user, tx } = context.state;
+        const approval = await tx.getRepository(activity_approval_js_1.ActivityApproval).findOne({
+            where: { id: approvalId },
+            relations: ['approver', 'approverRole', 'approverRole.users', 'activityThread', 'activityThread.assignee', 'activityThread.activityInstance']
+        });
+        const thread = approval?.activityThread;
+        const instance = thread?.activityInstance;
+        if (!approval || !thread || !instance)
+            return;
+        const receivers = (0, approval_notice_rules_js_1.noticeReceivers)({
+            kind,
+            approver: active(approval.approver),
+            roleHolders: (0, assignee_pool_js_1.poolMembers)(approval.approverRole ? [approval.approverRole] : []).map(active).filter(Boolean),
+            requester: active(thread.assignee),
+            actorId: user?.id
+        });
+        if (!receivers.length)
+            return;
+        const facts = {
+            kind,
+            name: instance.name || '',
+            requester: thread.assignee?.name,
+            actor: user?.name,
+            ...((0, approval_notice_rules_js_1.isTurnNotice)(kind) ? (0, approval_notice_rules_js_1.approvalStep)(instance.approvalLine, approval.order) : {})
+        };
+        const address = (0, approval_notice_rules_js_1.noticeAddress)(kind, { approvalId: approval.id, threadId: thread.id });
+        (0, notification_1.sendNoticeWhenCommitted)(context, {
+            type: 'approval',
+            level: kind === 'rejected' ? 'warn' : 'info',
+            receivers,
+            words: lng => (0, approval_notice_rules_js_1.noticeWords)(translatorOf(lng), facts),
+            address,
+            link: (0, notification_1.noticeLinkOf)(context, address),
+            label: `approval notice ${kind} of ${approval.id}`
+        });
+    }
+    catch (error) {
+        env_1.logger.error(`[worklist] approval notice ${kind} of ${approvalId} could not be made`, error);
+    }
+}
+/** Only a person who can sign in is told. */
+function active(person) {
+    return person && person.status === auth_base_1.UserStatus.ACTIVATED ? { id: person.id, name: person.name, email: person.email, locale: person.locale } : null;
+}
+/** A sentence missing in the person's language is said in English, never as its key. */
+function translatorOf(lng) {
+    const own = (0, translator_1.translatorFor)(lng);
+    const english = (0, translator_1.translatorFor)('en');
+    return (key, options = {}) => own(key, { ...options, defaultValue: english(key, options) });
+}
+//# sourceMappingURL=approval-notice.js.map

package/dist-server/service/approval-notice/approval-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-notice.js","sourceRoot":"","sources":["../../../server/service/approval-notice/approval-notice.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The approval notice (ADR-0164) - the one place the worklist tells people of an approval's turn and judgment.\n *\n * The four places an approval moves call `noticeApproval`: createApproval (a turn or a reference), delegate (a\n * handed seat), approve with no one after (approved) and reject (rejected). Applications call nothing; a case that\n * goes through the approval line is told of. Sending is notification's (`sendNoticeWhenCommitted`).\n */\nimport { User, UserStatus } from '@things-factory/auth-base'\nimport { logger } from '@things-factory/env'\nimport { translatorFor } from '@things-factory/i18n-base/translator'\nimport { noticeLinkOf, sendNoticeWhenCommitted } from '@things-factory/notification'\n\nimport { ActivityApproval } from '../activity-approval/activity-approval.js'\nimport { poolMembers } from '../activity-instance/assignee-pool.js'\nimport {\n  approvalStep,\n  isTurnNotice,\n  noticeAddress,\n  noticeReceivers,\n  noticeWords,\n  type ApprovalNoticeKind,\n  type NoticeFacts,\n  type NoticePerson,\n  type Translate\n} from './approval-notice-rules.js'\n\n/**\n * Tells of what just happened to approval `approvalId`, once the transaction has committed.\n *\n * Who and what are settled here, inside the transaction, from rows it can see. Nothing here throws: a notice that\n * cannot be made is reported and the approval stands.\n */\nexport async function noticeApproval(context: ResolverContext, { kind, approvalId }: { kind: ApprovalNoticeKind; approvalId: string }): Promise<void> {\n  try {\n    const { user, tx } = context.state\n\n    const approval = await tx.getRepository(ActivityApproval).findOne({\n      where: { id: approvalId },\n      relations: ['approver', 'approverRole', 'approverRole.users', 'activityThread', 'activityThread.assignee', 'activityThread.activityInstance']\n    })\n    const thread = approval?.activityThread\n    const instance = thread?.activityInstance\n    if (!approval || !thread || !instance) return\n\n    const receivers = noticeReceivers({\n      kind,\n      approver: active(approval.approver),\n      roleHolders: poolMembers(approval.approverRole ? [approval.approverRole] : []).map(active).filter(Boolean),\n      requester: active(thread.assignee),\n      actorId: user?.id\n    })\n    if (!receivers.length) return\n\n    const facts: NoticeFacts = {\n      kind,\n      name: instance.name || '',\n      requester: thread.assignee?.name,\n      actor: user?.name,\n      ...(isTurnNotice(kind) ? approvalStep(instance.approvalLine, approval.order) : {})\n    }\n    const address = noticeAddress(kind, { approvalId: approval.id, threadId: thread.id })\n\n    sendNoticeWhenCommitted(context, {\n      type: 'approval',\n      level: kind === 'rejected' ? 'warn' : 'info',\n      receivers,\n      words: lng => noticeWords(translatorOf(lng), facts),\n      address,\n      link: noticeLinkOf(context, address),\n      label: `approval notice ${kind} of ${approval.id}`\n    })\n  } catch (error) {\n    logger.error(`[worklist] approval notice ${kind} of ${approvalId} could not be made`, error)\n  }\n}\n\n/** Only a person who can sign in is told. */\nfunction active(person?: User | null): NoticePerson | null {\n  return person && person.status === UserStatus.ACTIVATED ? { id: person.id, name: person.name, email: person.email, locale: person.locale } : null\n}\n\n/** A sentence missing in the person's language is said in English, never as its key. */\nfunction translatorOf(lng: string): Translate {\n  const own = translatorFor(lng)\n  const english = translatorFor('en')\n  return (key, options = {}) => own(key, { ...options, defaultValue: english(key, options) })\n}\n"]}

package/dist-server/service/approval-progress/approval-progress-query.d.ts

@@ -0,0 +1,14 @@
+import { Pagination } from '@things-factory/shell';
+import { ApprovalProgressFilter, ApprovalProgressList } from './approval-progress-type.js';
+/**
+ * 결재 현황 — the domain's every approval case and where it stands, whatever its kind (ADR-0183).
+ *
+ * Read by whoever reads every case (`activity-instance` query, the rule `assert-may-read.ts` names): a line shows
+ * the headline and the requester of a case the reader may already open.
+ *
+ * A case is one activity instance with a deciding approval row. Its state, step and waiting are read from the rows
+ * by `progressOf`; the filter and the counts run on those lines, so a count says what the list would show.
+ */
+export declare class ApprovalProgressQuery {
+    approvalProgress(filter: ApprovalProgressFilter, pagination: Pagination, context: ResolverContext): Promise<ApprovalProgressList>;
+}

package/dist-server/service/approval-progress/approval-progress-query.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApprovalProgressQuery = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const auth_base_1 = require("@things-factory/auth-base");
+const organization_1 = require("@things-factory/organization");
+const shell_1 = require("@things-factory/shell");
+const activity_approval_js_1 = require("../activity-approval/activity-approval.js");
+const decision_key_declaration_js_1 = require("../activity/decision-key-declaration.js");
+const approval_progress_rule_js_1 = require("./approval-progress-rule.js");
+const approval_progress_type_js_1 = require("./approval-progress-type.js");
+const waiting_on_js_1 = require("./waiting-on.js");
+/**
+ * 결재 현황 — the domain's every approval case and where it stands, whatever its kind (ADR-0183).
+ *
+ * Read by whoever reads every case (`activity-instance` query, the rule `assert-may-read.ts` names): a line shows
+ * the headline and the requester of a case the reader may already open.
+ *
+ * A case is one activity instance with a deciding approval row. Its state, step and waiting are read from the rows
+ * by `progressOf`; the filter and the counts run on those lines, so a count says what the list would show.
+ */
+let ApprovalProgressQuery = class ApprovalProgressQuery {
+    async approvalProgress(filter, pagination, context) {
+        const { domain } = context.state;
+        filter = filter || {};
+        const rows = await (0, shell_1.getRepository)(activity_approval_js_1.ActivityApproval)
+            .createQueryBuilder('ap')
+            .innerJoinAndSelect('ap.activityThread', 'at')
+            .innerJoinAndSelect('at.activityInstance', 'ai')
+            .leftJoinAndSelect('ai.activity', 'act')
+            .where('ap.domain = :domainId', { domainId: domain.id })
+            .getMany();
+        const cases = new Map();
+        for (const row of rows) {
+            const id = row.activityThread.activityInstance.id;
+            cases.set(id, [...(cases.get(id) || []), row]);
+        }
+        const requesterOf = (approvals) => {
+            const thread = approvals[0].activityThread;
+            return thread.assigneeId || thread.activityInstance.creatorId;
+        };
+        const requesterIds = [...new Set([...cases.values()].map(requesterOf).filter(Boolean))];
+        const employees = requesterIds.length
+            ? await (0, shell_1.getRepository)(organization_1.Employee)
+                .createQueryBuilder('e')
+                .leftJoinAndSelect('e.user', 'u')
+                .leftJoinAndSelect('e.department', 'd')
+                .where('e.domain = :domainId', { domainId: domain.id })
+                .andWhere('u.id IN (:...requesterIds)', { requesterIds })
+                .getMany()
+            : [];
+        const employeeOf = new Map(employees.map(one => [one.user?.id, one]));
+        const users = requesterIds.length
+            ? await (0, shell_1.getRepository)(auth_base_1.User).createQueryBuilder('u').where('u.id IN (:...requesterIds)', { requesterIds }).getMany()
+            : [];
+        const userName = new Map(users.map(one => [one.id, one.name]));
+        const lines = [];
+        for (const [id, approvals] of cases) {
+            /* A case seated only for references is not an approval. */
+            if (!approvals.some(row => row.participation !== 'reference'))
+                continue;
+            const instance = approvals[0].activityThread.activityInstance;
+            const requesterId = requesterOf(approvals);
+            const employee = employeeOf.get(requesterId);
+            lines.push({
+                id,
+                approvals,
+                activityName: instance.activity?.name ?? '',
+                headline: instance.name ?? '',
+                requesterName: employee?.name || userName.get(requesterId),
+                departmentId: employee?.department?.id,
+                progress: (0, approval_progress_rule_js_1.progressOf)({
+                    instanceState: instance.state,
+                    dueAt: instance.dueAt,
+                    approvalLine: instance.approvalLine,
+                    approvals
+                })
+            });
+        }
+        const passing = lines.filter(line => (0, approval_progress_rule_js_1.passes)(line, filter)).sort(approval_progress_rule_js_1.inProgressOrder);
+        const { states, overdue } = (0, approval_progress_rule_js_1.countsOf)(lines, filter);
+        const limit = pagination?.limit || 50;
+        const page = pagination?.page || 1;
+        const pageLines = passing.slice((page - 1) * limit, page * limit);
+        const items = [];
+        for (const line of pageLines) {
+            const instance = line.approvals[0].activityThread.activityInstance;
+            const { names, roleName } = await (0, waiting_on_js_1.namesWaitedOn)((0, shell_1.getRepository)(activity_approval_js_1.ActivityApproval).manager, line.progress.waiting);
+            const employee = employeeOf.get(requesterOf(line.approvals));
+            items.push({
+                id: line.id,
+                activityName: line.activityName,
+                activityLabel: instance.activity?.label || line.activityName,
+                activityLabelTKey: line.activityName ? (0, decision_key_declaration_js_1.activityTKey)(line.activityName, 'label') : undefined,
+                headline: line.headline,
+                requesterName: line.requesterName,
+                departmentName: employee?.department?.name,
+                state: line.progress.state,
+                step: line.progress.step,
+                steps: line.progress.steps,
+                waitingOn: names,
+                waitingRole: roleName,
+                waitingSince: line.progress.waitingSince,
+                dueAt: instance.dueAt,
+                overdue: line.progress.overdue,
+                raisedAt: line.progress.raisedAt,
+                endedAt: line.progress.endedAt
+            });
+        }
+        /* The kinds that have a case here - what the kind filter offers. */
+        const kinds = new Map();
+        for (const line of lines) {
+            const activity = line.approvals[0].activityThread.activityInstance.activity;
+            if (line.activityName && !kinds.has(line.activityName))
+                kinds.set(line.activityName, { name: line.activityName, label: activity?.label || line.activityName, labelTKey: (0, decision_key_declaration_js_1.activityTKey)(line.activityName, 'label') });
+        }
+        return {
+            items,
+            kinds: [...kinds.values()].sort((a, b) => a.label.localeCompare(b.label)),
+            total: passing.length,
+            counts: approval_progress_rule_js_1.APPROVAL_PROGRESS_STATES.map(state => ({ state, count: states[state] })),
+            overdue
+        };
+    }
+};
+exports.ApprovalProgressQuery = ApprovalProgressQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "activity-instance", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => approval_progress_type_js_1.ApprovalProgressList, { description: 'The approvals of this domain, every kind, and where each stands.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('filter', type => approval_progress_type_js_1.ApprovalProgressFilter, { nullable: true })),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('pagination', type => shell_1.Pagination, { nullable: true })),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [approval_progress_type_js_1.ApprovalProgressFilter,
+        shell_1.Pagination, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ApprovalProgressQuery.prototype, "approvalProgress", null);
+exports.ApprovalProgressQuery = ApprovalProgressQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)()
+], ApprovalProgressQuery);
+//# sourceMappingURL=approval-progress-query.js.map

package/dist-server/service/approval-progress/approval-progress-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-progress-query.js","sourceRoot":"","sources":["../../../server/service/approval-progress/approval-progress-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Directive, Query, Resolver } from 'type-graphql'\n\nimport { User } from '@things-factory/auth-base'\nimport { Employee } from '@things-factory/organization'\nimport { getRepository, Pagination } from '@things-factory/shell'\n\nimport { ActivityApproval } from '../activity-approval/activity-approval.js'\nimport { activityTKey } from '../activity/decision-key-declaration.js'\nimport {\n  APPROVAL_PROGRESS_STATES,\n  countsOf,\n  inProgressOrder,\n  passes,\n  progressOf,\n  ProgressLine\n} from './approval-progress-rule.js'\nimport { ApprovalProgress, ApprovalProgressFilter, ApprovalProgressList } from './approval-progress-type.js'\nimport { namesWaitedOn } from './waiting-on.js'\n\n/**\n * 결재 현황 — the domain's every approval case and where it stands, whatever its kind (ADR-0183).\n *\n * Read by whoever reads every case (`activity-instance` query, the rule `assert-may-read.ts` names): a line shows\n * the headline and the requester of a case the reader may already open.\n *\n * A case is one activity instance with a deciding approval row. Its state, step and waiting are read from the rows\n * by `progressOf`; the filter and the counts run on those lines, so a count says what the list would show.\n */\n@Resolver()\nexport class ApprovalProgressQuery {\n  @Directive('@privilege(category: \"activity-instance\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => ApprovalProgressList, { description: 'The approvals of this domain, every kind, and where each stands.' })\n  async approvalProgress(\n    @Arg('filter', type => ApprovalProgressFilter, { nullable: true }) filter: ApprovalProgressFilter,\n    @Arg('pagination', type => Pagination, { nullable: true }) pagination: Pagination,\n    @Ctx() context: ResolverContext\n  ): Promise<ApprovalProgressList> {\n    const { domain } = context.state\n    filter = filter || {}\n\n    const rows = await getRepository(ActivityApproval)\n      .createQueryBuilder('ap')\n      .innerJoinAndSelect('ap.activityThread', 'at')\n      .innerJoinAndSelect('at.activityInstance', 'ai')\n      .leftJoinAndSelect('ai.activity', 'act')\n      .where('ap.domain = :domainId', { domainId: domain.id })\n      .getMany()\n\n    const cases = new Map<string, ActivityApproval[]>()\n    for (const row of rows) {\n      const id = row.activityThread.activityInstance.id\n      cases.set(id, [...(cases.get(id) || []), row])\n    }\n\n    const requesterOf = (approvals: ActivityApproval[]) => {\n      const thread = approvals[0].activityThread\n      return thread.assigneeId || thread.activityInstance.creatorId\n    }\n\n    const requesterIds = [...new Set([...cases.values()].map(requesterOf).filter(Boolean))]\n    const employees = requesterIds.length\n      ? await getRepository(Employee)\n          .createQueryBuilder('e')\n          .leftJoinAndSelect('e.user', 'u')\n          .leftJoinAndSelect('e.department', 'd')\n          .where('e.domain = :domainId', { domainId: domain.id })\n          .andWhere('u.id IN (:...requesterIds)', { requesterIds })\n          .getMany()\n      : []\n    const employeeOf = new Map(employees.map(one => [one.user?.id, one]))\n    const users = requesterIds.length\n      ? await getRepository(User).createQueryBuilder('u').where('u.id IN (:...requesterIds)', { requesterIds }).getMany()\n      : []\n    const userName = new Map(users.map(one => [one.id, one.name]))\n\n    const lines: (ProgressLine & { id: string; approvals: ActivityApproval[] })[] = []\n    for (const [id, approvals] of cases) {\n      /* A case seated only for references is not an approval. */\n      if (!approvals.some(row => row.participation !== 'reference')) continue\n\n      const instance = approvals[0].activityThread.activityInstance\n      const requesterId = requesterOf(approvals)\n      const employee = employeeOf.get(requesterId)\n\n      lines.push({\n        id,\n        approvals,\n        activityName: instance.activity?.name ?? '',\n        headline: instance.name ?? '',\n        requesterName: employee?.name || userName.get(requesterId),\n        departmentId: employee?.department?.id,\n        progress: progressOf({\n          instanceState: instance.state,\n          dueAt: instance.dueAt,\n          approvalLine: instance.approvalLine as any,\n          approvals\n        })\n      })\n    }\n\n    const passing = lines.filter(line => passes(line, filter)).sort(inProgressOrder)\n    const { states, overdue } = countsOf(lines, filter)\n\n    const limit = pagination?.limit || 50\n    const page = pagination?.page || 1\n    const pageLines = passing.slice((page - 1) * limit, page * limit)\n\n    const items: ApprovalProgress[] = []\n    for (const line of pageLines) {\n      const instance = line.approvals[0].activityThread.activityInstance\n      const { names, roleName } = await namesWaitedOn(getRepository(ActivityApproval).manager, line.progress.waiting)\n      const employee = employeeOf.get(requesterOf(line.approvals))\n\n      items.push({\n        id: line.id,\n        activityName: line.activityName,\n        activityLabel: instance.activity?.label || line.activityName,\n        activityLabelTKey: line.activityName ? activityTKey(line.activityName, 'label') : undefined,\n        headline: line.headline,\n        requesterName: line.requesterName,\n        departmentName: employee?.department?.name,\n        state: line.progress.state,\n        step: line.progress.step,\n        steps: line.progress.steps,\n        waitingOn: names,\n        waitingRole: roleName,\n        waitingSince: line.progress.waitingSince,\n        dueAt: instance.dueAt,\n        overdue: line.progress.overdue,\n        raisedAt: line.progress.raisedAt,\n        endedAt: line.progress.endedAt\n      })\n    }\n\n    /* The kinds that have a case here - what the kind filter offers. */\n    const kinds = new Map<string, { name: string; label: string; labelTKey: string }>()\n    for (const line of lines) {\n      const activity = line.approvals[0].activityThread.activityInstance.activity\n      if (line.activityName && !kinds.has(line.activityName))\n        kinds.set(line.activityName, { name: line.activityName, label: activity?.label || line.activityName, labelTKey: activityTKey(line.activityName, 'label') })\n    }\n\n    return {\n      items,\n      kinds: [...kinds.values()].sort((a, b) => a.label.localeCompare(b.label)),\n      total: passing.length,\n      counts: APPROVAL_PROGRESS_STATES.map(state => ({ state, count: states[state] })),\n      overdue\n    }\n  }\n}\n"]}

package/dist-server/service/approval-progress/approval-progress-rule.d.ts

@@ -0,0 +1,67 @@
+export type ApprovalProgressState = 'PENDING' | 'APPROVED' | 'REJECTED' | 'ABORTED';
+export declare const APPROVAL_PROGRESS_STATES: readonly ApprovalProgressState[];
+export interface ProgressApprovalRow {
+    round?: number | null;
+    order?: number | null;
+    judgment?: string | null;
+    participation?: string | null;
+    createdAt?: Date | null;
+    terminatedAt?: Date | null;
+    approverId?: string | null;
+    approverRoleId?: string | null;
+}
+export interface ProgressFacts {
+    instanceState?: string | null;
+    dueAt?: Date | null;
+    approvalLine?: {
+        participation?: string;
+    }[] | null;
+    approvals: ProgressApprovalRow[];
+}
+export interface Progress {
+    state: ApprovalProgressState;
+    /** The step waited on now, counted among the deciding steps (references skipped) — 1 for the first approver. */
+    step?: number;
+    /** How many deciding steps the line has. */
+    steps: number;
+    /** The rows of the step waited on now — whom it waits on. */
+    waiting: ProgressApprovalRow[];
+    /** Since when the step waited on now has waited — its row is made when the step before it is approved. */
+    waitingSince?: Date;
+    /** When it was first put up for approval. */
+    raisedAt?: Date;
+    /** When it ended, for what is no longer waiting. */
+    endedAt?: Date;
+    overdue: boolean;
+}
+export declare function progressOf(facts: ProgressFacts, now?: Date): Progress;
+export interface ProgressFilter {
+    activityNames?: string[] | null;
+    states?: string[] | null;
+    departmentIds?: string[] | null;
+    /** The first day raised, inclusive. */
+    from?: Date | null;
+    /** The last moment raised, exclusive. */
+    to?: Date | null;
+    overdueOnly?: boolean | null;
+    search?: string | null;
+}
+export interface ProgressLine {
+    activityName: string;
+    headline: string;
+    requesterName?: string;
+    departmentId?: string;
+    progress: Progress;
+}
+/** Whether a line passes the filter. `ignore` leaves out the conditions a count is taken across. */
+export declare function passes(line: ProgressLine, filter: ProgressFilter, ignore?: {
+    state?: boolean;
+    overdue?: boolean;
+}): boolean;
+/** What waits stands first, the longest waiting at the top; what ended follows, the latest first. */
+export declare function inProgressOrder(a: ProgressLine, b: ProgressLine): number;
+/** How many lines stand in each state, and how many are overdue — under the filter's other conditions. */
+export declare function countsOf(lines: ProgressLine[], filter: ProgressFilter): {
+    states: Record<ApprovalProgressState, number>;
+    overdue: number;
+};

package/dist-server/service/approval-progress/approval-progress-rule.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APPROVAL_PROGRESS_STATES = void 0;
+exports.progressOf = progressOf;
+exports.passes = passes;
+exports.inProgressOrder = inProgressOrder;
+exports.countsOf = countsOf;
+const approval_step_js_1 = require("../../../shared/approval-step.js");
+exports.APPROVAL_PROGRESS_STATES = ['PENDING', 'APPROVED', 'REJECTED', 'ABORTED'];
+const deciding = (row) => row.participation !== 'reference';
+const timeOf = (value) => (value ? new Date(value).getTime() : undefined);
+const earliest = (values) => {
+    const times = values.map(timeOf).filter((one) => one !== undefined);
+    return times.length ? new Date(Math.min(...times)) : undefined;
+};
+const latest = (values) => {
+    const times = values.map(timeOf).filter((one) => one !== undefined);
+    return times.length ? new Date(Math.max(...times)) : undefined;
+};
+/** The orders of the deciding steps of the line — a reference takes a place in the line and is not a step. */
+function decidingOrders(facts) {
+    const line = facts.approvalLine || [];
+    if (line.length) {
+        return line.map((item, index) => (item?.participation === 'reference' ? 0 : index + 1)).filter(Boolean);
+    }
+    /* A case with no line kept on it: the orders its deciding rows carry. */
+    return [...new Set(facts.approvals.filter(deciding).map(row => Number(row.order) || 0))].sort((a, b) => a - b);
+}
+function progressOf(facts, now = new Date()) {
+    const approvals = facts.approvals || [];
+    const round = (0, approval_step_js_1.latestRound)(approvals);
+    const thisRound = approvals.filter(row => (Number(row.round) || 0) === round && deciding(row));
+    const orders = decidingOrders(facts);
+    /*
+     * 반려가 중단보다 먼저다. Office 의 문은 반려되면 업무를 닫는다(`rejectionIsFinal`) — 그 건은 aborted 이고
+     * 그 차수에 rejected 가 남는다. 중단을 먼저 읽으면 반려된 결재가 「중단」으로 보인다.
+     */
+    const state = thisRound.some(row => row.judgment === 'rejected')
+        ? 'REJECTED'
+        : facts.instanceState === 'aborted'
+            ? 'ABORTED'
+            : (0, approval_step_js_1.currentStepOf)(approvals)
+                ? 'PENDING'
+                : 'APPROVED';
+    const step = state === 'PENDING' ? (0, approval_step_js_1.currentStepOf)(approvals) : undefined;
+    const waiting = state === 'PENDING' ? (0, approval_step_js_1.currentStepRows)(approvals) : [];
+    const dueAt = timeOf(facts.dueAt);
+    return {
+        state,
+        step: step ? (orders.indexOf(step.order) + 1 || step.order) : undefined,
+        steps: orders.length,
+        waiting,
+        waitingSince: earliest(waiting.map(row => row.createdAt)),
+        raisedAt: earliest(approvals.filter(deciding).map(row => row.createdAt)),
+        endedAt: state === 'PENDING' ? undefined : latest(thisRound.map(row => row.terminatedAt)),
+        overdue: state === 'PENDING' && dueAt !== undefined && dueAt < now.getTime()
+    };
+}
+/** Whether a line passes the filter. `ignore` leaves out the conditions a count is taken across. */
+function passes(line, filter, ignore = {}) {
+    const { progress } = line;
+    if (filter.activityNames?.length && !filter.activityNames.includes(line.activityName))
+        return false;
+    if (!ignore.state && filter.states?.length && !filter.states.includes(progress.state))
+        return false;
+    if (filter.departmentIds?.length && !filter.departmentIds.includes(line.departmentId ?? ''))
+        return false;
+    const raised = timeOf(progress.raisedAt);
+    if (filter.from && (raised === undefined || raised < new Date(filter.from).getTime()))
+        return false;
+    if (filter.to && (raised === undefined || raised >= new Date(filter.to).getTime()))
+        return false;
+    if (!ignore.overdue && filter.overdueOnly && !progress.overdue)
+        return false;
+    const search = filter.search?.trim().toLowerCase();
+    if (search && ![line.headline, line.requesterName ?? ''].some(text => text.toLowerCase().includes(search)))
+        return false;
+    return true;
+}
+/** What waits stands first, the longest waiting at the top; what ended follows, the latest first. */
+function inProgressOrder(a, b) {
+    const pendingA = a.progress.state === 'PENDING';
+    const pendingB = b.progress.state === 'PENDING';
+    if (pendingA !== pendingB)
+        return pendingA ? -1 : 1;
+    if (pendingA)
+        return (timeOf(a.progress.waitingSince) ?? 0) - (timeOf(b.progress.waitingSince) ?? 0);
+    return (timeOf(b.progress.endedAt ?? b.progress.raisedAt) ?? 0) - (timeOf(a.progress.endedAt ?? a.progress.raisedAt) ?? 0);
+}
+/** How many lines stand in each state, and how many are overdue — under the filter's other conditions. */
+function countsOf(lines, filter) {
+    const states = Object.fromEntries(exports.APPROVAL_PROGRESS_STATES.map(state => [state, 0]));
+    let overdue = 0;
+    for (const line of lines) {
+        if (passes(line, filter, { state: true, overdue: true }))
+            states[line.progress.state]++;
+        if (passes(line, filter, { overdue: true }) && line.progress.overdue)
+            overdue++;
+    }
+    return { states, overdue };
+}
+//# sourceMappingURL=approval-progress-rule.js.map