@things-factory/worklist 10.1.248 → 10.1.250

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

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkDoorResolver = void 0;
+exports.notUsedCannotBeDeclared = notUsedCannotBeDeclared;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const activity_js_1 = require("../activity/activity.js");
+const approval_line_seats_js_1 = require("../activity/approval-line-seats.js");
+const shell_2 = require("@things-factory/shell");
+const work_door_js_1 = require("./work-door.js");
+const work_door_service_js_1 = require("./work-door-service.js");
+const work_door_declaration_js_1 = require("./work-door-declaration.js");
+const work_door_not_used_js_1 = require("./work-door-not-used.js");
+const work_door_type_js_1 = require("./work-door-type.js");
+const work_door_journal_js_1 = require("./work-door-journal.js");
+const work_door_journal_service_js_1 = require("./work-door-journal-service.js");
+/**
+ * 이 공장의 결재 문 현황을 묻는 자리.
+ *
+ * ── 왜 질의인가 ────────────────────────────────────────────────────────────
+ * 기동할 때 로그로 한 번 지나가는 사실이었다(`install-boot.ts`). 사람이 조치해야 하는 사실은
+ * **물어볼 수 있어야** 한다 — 지나간 로그를 찾아 올라가게 하면 아무도 안 본다.
+ *
+ * ── 부모까지 보는 것은 `activityNamedIn` 의 규칙을 그대로 쓴다 ─────────────
+ * 상신하는 쪽이 그 규칙으로 양식을 찾으므로, 보는 쪽이 다른 규칙으로 찾으면 **화면이 「없다」고 하는데
+ * 실제로는 서는** 상태가 생긴다. 같은 함수를 부른다.
+ */
+let WorkDoorResolver = class WorkDoorResolver {
+    async workDoors(context) {
+        const manager = (0, shell_1.getRepository)(activity_js_1.Activity).manager;
+        const { domain, user } = context.state;
+        const doors = await (0, work_door_service_js_1.workDoorsFor)(manager, domain);
+        return {
+            /* Seats are read in the domain the line was set in - a borrowed line names the parent's roles. */
+            doors: await Promise.all(doors.map(async (door) => ({
+                ...(0, work_door_type_js_1.toDoorType)(door),
+                approvalLine: door.line ? await (0, approval_line_seats_js_1.approvalLineSeats)(door.line.seats, { id: door.line.domainId }, user) : undefined
+            }))),
+            todo: (0, work_door_js_1.doorsToFill)(doors),
+            ...(0, work_door_js_1.countDoors)(doors),
+            seatsStanding: await (0, work_door_service_js_1.seatsStanding)(manager, domain),
+            seatsOffered: (0, work_door_service_js_1.seatsOffered)()
+        };
+    }
+    /**
+     * **이 공장은 이 문을 안 쓴다**고 선언한다.
+     *
+     * ── 왜 사유를 받나 ──────────────────────────────────────────────────────
+     * 이 선언은 승인 단계를 끄는 것이다. 반년 뒤 「왜 폐기 승인이 없나」를 묻는 사람이 나오고, 그때
+     * 사유가 없으면 누가 왜 껐는지 알 수 없다. 사람과 시각은 표가 들고 이유는 사람이 적는다.
+     *
+     * ── 모르는 이름은 받지 않는다 ───────────────────────────────────────────
+     * 오타로 선언하면 그 줄은 아무 문에도 안 걸리고, 정작 끄려던 문은 계속 조치 대상으로 남는다.
+     * 끈 줄 알고 있는데 화면은 그대로다 — 화면이 그 오타를 말해 주지 않는다.
+     */
+    async declareWorkDoorNotUsed(doorName, because, context) {
+        const { domain, user, tx } = context.state;
+        const door = (0, work_door_declaration_js_1.declaredDoor)(doorName);
+        if (!door) {
+            throw new shell_2.Refusal('work-door-unknown', { name: doorName }, 'unknown task "{name}". use a task name from the status screen.');
+        }
+        /*
+         * **결재선 없이는 설 수 없는 문은 끌 수 없다**(ADR-0077 결정 3). 받아 두면 이 화면은 「꺼짐」이라
+         * 말하는데 제품은 계속 결재를 요구하고, 제품이 이 선언을 따르면 되돌릴 수 없는 일이 결재 없이 돈다.
+         * 까닭마다 문장이 다르다 — 관리자가 읽고 「결재선을 세우면 된다」까지 알아야 한다.
+         */
+        const cannot = (0, work_door_declaration_js_1.whyNotUsedCannotBeDeclared)(door);
+        if (cannot) {
+            throw notUsedCannotBeDeclared(doorName, cannot);
+        }
+        if (!because?.trim()) {
+            throw new shell_2.Refusal('work-door-not-used-reason-missing', {}, 'enter why this task is not used.');
+        }
+        const repository = tx.getRepository(work_door_not_used_js_1.WorkDoorNotUsed);
+        const existing = await repository.findOne({ where: { domain: { id: domain.id }, doorName } });
+        await repository.save({
+            ...(existing ?? {}),
+            domain,
+            doorName,
+            because: because.trim(),
+            declaredBy: user
+        });
+        return await this.workDoors(context);
+    }
+    /** 다시 쓰기로 했다. 선언을 지운다 — 지우면 그 문은 다시 조치 대상으로 돌아온다. */
+    async useWorkDoorAgain(doorName, context) {
+        const { domain, user, tx } = context.state;
+        const repository = tx.getRepository(work_door_not_used_js_1.WorkDoorNotUsed);
+        const existing = await repository.findOne({ where: { domain: { id: domain.id }, doorName }, relations: ['declaredBy'] });
+        /* 없는 것을 지우라는 것은 이미 쓰고 있다는 뜻이다. 오류로 막지 않고 지금 현황을 낸다. */
+        if (existing) {
+            /*
+             * **지우는 선언을 이력에 남긴다.** 왜 안 쓰기로 했고 누가 정했는지가 지우면 어디에도 없어진다
+             * (ADR-0064 ③, 2026-09-17). 다시 선언할 때 그 내용을 여기서 읽는다.
+             */
+            await (0, work_door_journal_service_js_1.noteWorkDoor)(tx, domain, {
+                kind: work_door_journal_js_1.WorkDoorEvent.NotUsedWithdrawn,
+                door: existing.doorName,
+                detail: (0, work_door_js_1.workDoorNotUsedBefore)(existing)
+            }, user);
+            await repository.remove(existing);
+        }
+        return await this.workDoors(context);
+    }
+};
+exports.WorkDoorResolver = WorkDoorResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "activity", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => work_door_type_js_1.WorkDoorsType, {
+        description: 'To see which approval steps this plant actually has standing, and which pass with nobody on them'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], WorkDoorResolver.prototype, "workDoors", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "activity", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => work_door_type_js_1.WorkDoorsType, { description: 'To declare that this plant does not use one work door' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('doorName')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('because', { description: 'why — somebody will ask in six months' })),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], WorkDoorResolver.prototype, "declareWorkDoorNotUsed", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "activity", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => work_door_type_js_1.WorkDoorsType, { description: 'To withdraw the declaration and use that door again' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('doorName')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], WorkDoorResolver.prototype, "useWorkDoorAgain", null);
+exports.WorkDoorResolver = WorkDoorResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(),
+    (0, type_graphql_1.UseMiddleware)(shell_2.SpeakRefusals)
+], WorkDoorResolver);
+/** The refusal for each reason. One code per reason, so each language has its own whole sentence. */
+const NOT_USED_REFUSALS = {
+    irreversible: '"{name}" cannot be turned off. what it does cannot be undone, so it only runs through approval. set its approval line instead.',
+    'approval-is-the-act': '"{name}" cannot be turned off. its approval is the work itself. set its approval line instead.',
+    'lowers-a-control': '"{name}" cannot be turned off. it lowers a control that stands, so it only runs through approval. set its approval line instead.'
+};
+function notUsedCannotBeDeclared(name, because) {
+    return new shell_2.Refusal(`work-door-not-used-refused-${because}`, { name }, NOT_USED_REFUSALS[because]);
+}
+//# sourceMappingURL=work-door-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"work-door-resolver.js","sourceRoot":"","sources":["../../../server/service/work-door/work-door-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager } from 'typeorm'\n\nimport { Arg, Ctx, Directive, Mutation, Query, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { Role } from '@things-factory/auth-base'\nimport { Domain, getRepository } from '@things-factory/shell'\nimport { Activity } from '../activity/activity.js'\nimport { approvalLineSeats } from '../activity/approval-line-seats.js'\n\nimport { Refusal, SpeakRefusals } from '@things-factory/shell'\n\nimport { activityNamedIn } from './activity-lookup.js'\nimport { countDoors, doorsToFill, workDoorNotUsedBefore } from './work-door.js'\nimport { seatsOffered, seatsStanding, workDoorsFor } from './work-door-service.js'\nimport { declaredDoor, whyNotUsedCannotBeDeclared, type WhenNoLineBecause } from './work-door-declaration.js'\nimport { WorkDoorNotUsed } from './work-door-not-used.js'\nimport { WorkDoorsType, toDoorType } from './work-door-type.js'\nimport { WorkDoorEvent } from './work-door-journal.js'\nimport { noteWorkDoor } from './work-door-journal-service.js'\n\n/**\n * 이 공장의 결재 문 현황을 묻는 자리.\n *\n * ── 왜 질의인가 ────────────────────────────────────────────────────────────\n * 기동할 때 로그로 한 번 지나가는 사실이었다(`install-boot.ts`). 사람이 조치해야 하는 사실은\n * **물어볼 수 있어야** 한다 — 지나간 로그를 찾아 올라가게 하면 아무도 안 본다.\n *\n * ── 부모까지 보는 것은 `activityNamedIn` 의 규칙을 그대로 쓴다 ─────────────\n * 상신하는 쪽이 그 규칙으로 양식을 찾으므로, 보는 쪽이 다른 규칙으로 찾으면 **화면이 「없다」고 하는데\n * 실제로는 서는** 상태가 생긴다. 같은 함수를 부른다.\n */\n@Resolver()\n@UseMiddleware(SpeakRefusals)\nexport class WorkDoorResolver {\n  @Directive('@privilege(category: \"activity\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => WorkDoorsType, {\n    description: 'To see which approval steps this plant actually has standing, and which pass with nobody on them'\n  })\n  async workDoors(@Ctx() context: ResolverContext): Promise<WorkDoorsType> {\n    const manager = getRepository(Activity).manager\n    const { domain, user } = context.state\n    const doors = await workDoorsFor(manager, domain)\n\n    return {\n      /* Seats are read in the domain the line was set in - a borrowed line names the parent's roles. */\n      doors: await Promise.all(\n        doors.map(async door => ({\n          ...toDoorType(door),\n          approvalLine: door.line ? await approvalLineSeats(door.line.seats, { id: door.line.domainId } as Domain, user) : undefined\n        }))\n      ),\n      todo: doorsToFill(doors),\n      ...countDoors(doors),\n      seatsStanding: await seatsStanding(manager, domain),\n      seatsOffered: seatsOffered()\n    }\n  }\n\n  /**\n   * **이 공장은 이 문을 안 쓴다**고 선언한다.\n   *\n   * ── 왜 사유를 받나 ──────────────────────────────────────────────────────\n   * 이 선언은 승인 단계를 끄는 것이다. 반년 뒤 「왜 폐기 승인이 없나」를 묻는 사람이 나오고, 그때\n   * 사유가 없으면 누가 왜 껐는지 알 수 없다. 사람과 시각은 표가 들고 이유는 사람이 적는다.\n   *\n   * ── 모르는 이름은 받지 않는다 ───────────────────────────────────────────\n   * 오타로 선언하면 그 줄은 아무 문에도 안 걸리고, 정작 끄려던 문은 계속 조치 대상으로 남는다.\n   * 끈 줄 알고 있는데 화면은 그대로다 — 화면이 그 오타를 말해 주지 않는다.\n   */\n  @Directive('@privilege(category: \"activity\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => WorkDoorsType, { description: 'To declare that this plant does not use one work door' })\n  async declareWorkDoorNotUsed(\n    @Arg('doorName') doorName: string,\n    @Arg('because', { description: 'why — somebody will ask in six months' }) because: string,\n    @Ctx() context: ResolverContext\n  ): Promise<WorkDoorsType> {\n    const { domain, user, tx } = context.state\n\n    const door = declaredDoor(doorName)\n\n    if (!door) {\n      throw new Refusal(\n        'work-door-unknown',\n        { name: doorName },\n        'unknown task \"{name}\". use a task name from the status screen.'\n      )\n    }\n\n    /*\n     * **결재선 없이는 설 수 없는 문은 끌 수 없다**(ADR-0077 결정 3). 받아 두면 이 화면은 「꺼짐」이라\n     * 말하는데 제품은 계속 결재를 요구하고, 제품이 이 선언을 따르면 되돌릴 수 없는 일이 결재 없이 돈다.\n     * 까닭마다 문장이 다르다 — 관리자가 읽고 「결재선을 세우면 된다」까지 알아야 한다.\n     */\n    const cannot = whyNotUsedCannotBeDeclared(door)\n\n    if (cannot) {\n      throw notUsedCannotBeDeclared(doorName, cannot)\n    }\n\n    if (!because?.trim()) {\n      throw new Refusal('work-door-not-used-reason-missing', {}, 'enter why this task is not used.')\n    }\n\n    const repository = tx.getRepository(WorkDoorNotUsed)\n    const existing = await repository.findOne({ where: { domain: { id: domain.id }, doorName } })\n\n    await repository.save({\n      ...(existing ?? {}),\n      domain,\n      doorName,\n      because: because.trim(),\n      declaredBy: user\n    } as any)\n\n    return await this.workDoors(context)\n  }\n\n  /** 다시 쓰기로 했다. 선언을 지운다 — 지우면 그 문은 다시 조치 대상으로 돌아온다. */\n  @Directive('@privilege(category: \"activity\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => WorkDoorsType, { description: 'To withdraw the declaration and use that door again' })\n  async useWorkDoorAgain(@Arg('doorName') doorName: string, @Ctx() context: ResolverContext): Promise<WorkDoorsType> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(WorkDoorNotUsed)\n    const existing = await repository.findOne({ where: { domain: { id: domain.id }, doorName }, relations: ['declaredBy'] })\n\n    /* 없는 것을 지우라는 것은 이미 쓰고 있다는 뜻이다. 오류로 막지 않고 지금 현황을 낸다. */\n    if (existing) {\n      /*\n       * **지우는 선언을 이력에 남긴다.** 왜 안 쓰기로 했고 누가 정했는지가 지우면 어디에도 없어진다\n       * (ADR-0064 ③, 2026-09-17). 다시 선언할 때 그 내용을 여기서 읽는다.\n       */\n      await noteWorkDoor(\n        tx,\n        domain,\n        {\n          kind: WorkDoorEvent.NotUsedWithdrawn,\n          door: existing.doorName,\n          detail: workDoorNotUsedBefore(existing)\n        },\n        user\n      )\n\n      await repository.remove(existing)\n    }\n\n    return await this.workDoors(context)\n  }\n}\n\n/** The refusal for each reason. One code per reason, so each language has its own whole sentence. */\nconst NOT_USED_REFUSALS: Record<WhenNoLineBecause, string> = {\n  irreversible:\n    '\"{name}\" cannot be turned off. what it does cannot be undone, so it only runs through approval. set its approval line instead.',\n  'approval-is-the-act': '\"{name}\" cannot be turned off. its approval is the work itself. set its approval line instead.',\n  'lowers-a-control':\n    '\"{name}\" cannot be turned off. it lowers a control that stands, so it only runs through approval. set its approval line instead.'\n}\n\nexport function notUsedCannotBeDeclared(name: string, because: WhenNoLineBecause): Refusal {\n  return new Refusal(`work-door-not-used-refused-${because}`, { name }, NOT_USED_REFUSALS[because])\n}\n"]}

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

@@ -0,0 +1,36 @@
+import { EntityManager } from 'typeorm';
+import { Domain } from '@things-factory/shell';
+import { WorkDoor } from './work-door';
+/** A judged door and the approval line that applies to it, as stored, for the status screen to name. */
+export type WorkDoorRead = WorkDoor & {
+    line?: {
+        seats: unknown[];
+        domainId: string;
+    };
+};
+/**
+ * 이 공장의 문 열둘을 읽어 판정한다 — **한 벌.**
+ *
+ * ── 왜 resolver 밖에 두나 ──────────────────────────────────────────────────
+ * 이 판정을 묻는 자리가 둘이 됐다. 화면(`workDoors`)과 성숙도 표다. 각자 읽으면 둘이 다른 수를
+ * 말하게 되고, **어느 쪽이 맞는지 보는 사람이 알 길이 없다.** 성숙도 표는 이 제품이 스스로에 대해
+ * 하는 말이라 화면과 어긋나면 그 표 전체를 못 믿는다.
+ *
+ * ── 부모까지 보는 규칙은 상신하는 쪽의 것을 그대로 쓴다 ────────────────────
+ * 상신이 `activityNamedIn` 으로 양식을 찾으므로, 보는 쪽이 다른 규칙으로 찾으면 **「없다」고
+ * 말하는데 실제로는 서는** 상태가 생긴다.
+ */
+export declare function workDoorsFor(manager: EntityManager, domain: Domain): Promise<WorkDoorRead[]>;
+/**
+ * 이 제품이 내놓는 역할 자리 중 이 공장에 선 것이 몇인가.
+ *
+ * 결재선은 **역할을 가리킨다**(`[{type:'Role', value:<역할 id>}]`). 그러니 역할이 없는 공장에서는
+ * 결재선을 만들 수 없다 — 양식 화면까지 가서야 그걸 알게 된다. 문 현황과 함께 내서 화면이 순서를
+ * 말하게 한다.
+ *
+ * 공장이 스스로 만든 다른 역할은 안 센다. 이 수가 말하는 것은 「이 제품이 내놓은 자리」이고,
+ * 그 밖의 역할로 결재선을 짜는 것도 물론 된다.
+ */
+export declare function seatsStanding(manager: EntityManager, domain: Domain): Promise<number>;
+/** 이 설치본의 앱들이 내놓는 자리의 수 — 화면이 목록을 따로 들지 않게 여기서 센다. */
+export declare function seatsOffered(): number;

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

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workDoorsFor = workDoorsFor;
+exports.seatsStanding = seatsStanding;
+exports.seatsOffered = seatsOffered;
+const typeorm_1 = require("typeorm");
+const auth_base_1 = require("@things-factory/auth-base");
+const shell_1 = require("@things-factory/shell");
+const activity_lookup_js_1 = require("./activity-lookup.js");
+const approval_line_standing_js_1 = require("./approval-line-standing.js");
+const work_door_declaration_js_1 = require("./work-door-declaration.js");
+const work_door_1 = require("./work-door");
+const assignee_pool_js_1 = require("../activity-instance/assignee-pool.js");
+const work_door_not_used_1 = require("./work-door-not-used");
+/**
+ * 이 공장의 문 열둘을 읽어 판정한다 — **한 벌.**
+ *
+ * ── 왜 resolver 밖에 두나 ──────────────────────────────────────────────────
+ * 이 판정을 묻는 자리가 둘이 됐다. 화면(`workDoors`)과 성숙도 표다. 각자 읽으면 둘이 다른 수를
+ * 말하게 되고, **어느 쪽이 맞는지 보는 사람이 알 길이 없다.** 성숙도 표는 이 제품이 스스로에 대해
+ * 하는 말이라 화면과 어긋나면 그 표 전체를 못 믿는다.
+ *
+ * ── 부모까지 보는 규칙은 상신하는 쪽의 것을 그대로 쓴다 ────────────────────
+ * 상신이 `activityNamedIn` 으로 양식을 찾으므로, 보는 쪽이 다른 규칙으로 찾으면 **「없다」고
+ * 말하는데 실제로는 서는** 상태가 생긴다.
+ */
+async function workDoorsFor(manager, domain) {
+    /* 공장이 「안 쓴다」고 말한 것을 한 번에 읽는다. 문마다 읽으면 열두 번 묻는다. */
+    const declared = new Map((await manager.find(work_door_not_used_1.WorkDoorNotUsed, { where: { domain: { id: domain.id } } })).map(one => [
+        one.doorName,
+        one.because
+    ]));
+    const doors = [];
+    /*
+     * **포트 하나를 문 열일곱이 함께 쓴다.** 포트가 읽은 역할을 기억하므로 같은 역할을 여러 번 묻지
+     * 않는다 — 결재선 대부분이 공장장으로 끝난다. 이 판정 동안만 산다.
+     */
+    const reader = (0, activity_lookup_js_1.seatReader)(manager);
+    for (const door of (0, work_door_declaration_js_1.declaredDoors)()) {
+        const name = door.name;
+        const activity = await (0, activity_lookup_js_1.activityNamedIn)(manager, domain, name);
+        /*
+         * **결재선을 빌려 쓰는 문**은 따르는 문의 결재선으로 센다(§`LINE_FOLLOWS`). 자기 칸을 세면, 올리는
+         * 쪽은 발행 승인의 결재선으로 서는데 현황은 「결재자 없음」이라고 말한다.
+         */
+        const follows = door.lineFollows;
+        const lineOwner = follows ? await (0, activity_lookup_js_1.activityNamedIn)(manager, domain, follows) : activity;
+        const judged = (0, work_door_1.judgeDoor)({
+            name,
+            kind: door.kind,
+            whenNoLine: door.whenNoLine,
+            whenNoLineBecause: door.because,
+            notUsedBecause: declared.get(name),
+            follows,
+            /* 상신하는 쪽과 **같은 함수**로 센다. 여기서 따로 세면 화면과 관문이 갈린다. */
+            approvalStanding: activity
+                ? await (0, approval_line_standing_js_1.judgeApprovalLine)(lineOwner?.approvalLine, reader)
+                : undefined,
+            installed: activity
+                ? {
+                    approvalLine: lineOwner?.approvalLine,
+                    assigneeRoles: await roleNamesOf(manager, (0, assignee_pool_js_1.poolIdsOf)(activity)),
+                    /*
+                     * **빌려 온 것일 때만** 채운다. `Activity` 는 `domainId` 만 들고 있어 이름은 따로
+                     * 읽는데, 자기 도메인이면 읽지도 않고 비운다 — 자기 이름을 채우면 화면이 모든 줄에
+                     * 「우리 공장에서 정했습니다」를 달고, 「결재자 없음」 옆에서 그 말이 거짓이 된다.
+                     */
+                    borrowedFrom: activity.domainId === domain.id ? undefined : await subdomainOf(manager, activity.domainId)
+                }
+                : undefined
+        });
+        /*
+         * The line that applies, as stored, with the domain it was set in - the status screen names its
+         * seats. It is the followed door's line when this one follows, so the names match what raising
+         * this door actually goes through. Only for a door that stands: a missing or unused door goes
+         * through no line.
+         */
+        const line = lineOwner?.approvalLine;
+        const lineStands = door.kind === 'approval' && (judged.standing === 'on' || judged.standing === 'off');
+        doors.push(lineStands && line?.length ? { ...judged, line: { seats: line, domainId: lineOwner.domainId } } : judged);
+    }
+    return doors;
+}
+/**
+ * 그 역할의 이름. 없으면 없다 — 지어내지 않는다.
+ *
+ * 문마다 부르지 않고 배정 문에서만 부른다. 배정 문이 하나도 없는 지금은 한 번도 안 돈다.
+ */
+/** The pool's role names, in the order the activity lists them. */
+async function roleNamesOf(manager, roleIds) {
+    if (!roleIds.length) {
+        return [];
+    }
+    const found = await manager.find(auth_base_1.Role, { where: { id: (0, typeorm_1.In)(roleIds) } });
+    return roleIds.map(id => found.find(role => role.id === id)?.name).filter(Boolean);
+}
+/**
+ * 부모 도메인의 이름. 못 읽으면 지어내지 않고 비운다 — 「본사」라고 적으면 없는 이름이 화면에 남는다.
+ *
+ * 원문 SQL 로 안 읽는다. 자리표시자 철자가 드라이버마다 달라(`?` · `$1`) sqlite 에서는 통과하고
+ * postgres 에서만 죽는다 — 그 부류는 여기서 절대 못 잡는다.
+ */
+async function subdomainOf(manager, domainId) {
+    const found = await manager.findOne(shell_1.Domain, { where: { id: domainId } });
+    return found?.subdomain;
+}
+/**
+ * 이 제품이 내놓는 역할 자리 중 이 공장에 선 것이 몇인가.
+ *
+ * 결재선은 **역할을 가리킨다**(`[{type:'Role', value:<역할 id>}]`). 그러니 역할이 없는 공장에서는
+ * 결재선을 만들 수 없다 — 양식 화면까지 가서야 그걸 알게 된다. 문 현황과 함께 내서 화면이 순서를
+ * 말하게 한다.
+ *
+ * 공장이 스스로 만든 다른 역할은 안 센다. 이 수가 말하는 것은 「이 제품이 내놓은 자리」이고,
+ * 그 밖의 역할로 결재선을 짜는 것도 물론 된다.
+ */
+async function seatsStanding(manager, domain) {
+    const offered = (0, work_door_declaration_js_1.offeredSeatNames)();
+    const here = await manager.find(auth_base_1.Role, { where: { domain: { id: domain.id } } });
+    const names = new Set(here.map(one => one.name));
+    return offered.filter(one => names.has(one)).length;
+}
+/** 이 설치본의 앱들이 내놓는 자리의 수 — 화면이 목록을 따로 들지 않게 여기서 센다. */
+function seatsOffered() {
+    return (0, work_door_declaration_js_1.offeredSeatNames)().length;
+}
+//# sourceMappingURL=work-door-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"work-door-service.js","sourceRoot":"","sources":["../../../server/service/work-door/work-door-service.ts"],"names":[],"mappings":";;AA2BA,oCAkEC;AAwCD,sCAMC;AAGD,oCAEC;AAhJD,qCAA2C;AAE3C,yDAAgD;AAChD,iDAA8C;AAE9C,6DAAkE;AAClE,2EAA+D;AAC/D,yEAA4E;AAC5E,2CAAiD;AACjD,4EAAiE;AACjE,6DAAsD;AAKtD;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,YAAY,CAAC,OAAsB,EAAE,MAAc;IACvE,mDAAmD;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,oCAAe,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACzF,GAAG,CAAC,QAAQ;QACZ,GAAG,CAAC,OAAO;KACZ,CAAC,CACH,CAAA;IAED,MAAM,KAAK,GAAmB,EAAE,CAAA;IAEhC;;;OAGG;IACH,MAAM,MAAM,GAAG,IAAA,+BAAU,EAAC,OAAO,CAAC,CAAA;IAElC,KAAK,MAAM,IAAI,IAAI,IAAA,wCAAa,GAAE,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAA,oCAAe,EAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;QAC7D;;;WAGG;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAA;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,IAAA,oCAAe,EAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QAEtF,MAAM,MAAM,GAAG,IAAA,qBAAS,EAAC;YACrB,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,iBAAiB,EAAE,IAAI,CAAC,OAAO;YAC/B,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAClC,OAAO;YACP,mDAAmD;YACnD,gBAAgB,EAAE,QAAQ;gBACxB,CAAC,CAAC,MAAM,IAAA,6CAAiB,EAAC,SAAS,EAAE,YAAuD,EAAE,MAAM,CAAC;gBACrG,CAAC,CAAC,SAAS;YACb,SAAS,EAAE,QAAQ;gBACjB,CAAC,CAAC;oBACE,YAAY,EAAE,SAAS,EAAE,YAAqC;oBAC9D,aAAa,EAAE,MAAM,WAAW,CAAC,OAAO,EAAE,IAAA,4BAAS,EAAC,QAAQ,CAAC,CAAC;oBAC9D;;;;uBAIG;oBACH,YAAY,EACV,QAAQ,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC;iBAC9F;gBACH,CAAC,CAAC,SAAS;SAChB,CAAC,CAAA;QAEF;;;;;WAKG;QACH,MAAM,IAAI,GAAG,SAAS,EAAE,YAAqC,CAAA;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAA;QAEtG,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IACvH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,mEAAmE;AACnE,KAAK,UAAU,WAAW,CAAC,OAAsB,EAAE,OAAiB;IAClE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;IAEtE,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AACpF,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,WAAW,CAAC,OAAsB,EAAE,QAAgB;IACjE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,cAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAA;IAExE,OAAO,KAAK,EAAE,SAAS,CAAA;AACzB,CAAC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,aAAa,CAAC,OAAsB,EAAE,MAAc;IACxE,MAAM,OAAO,GAAG,IAAA,2CAAgB,GAAE,CAAA;IAClC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAI,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IAC/E,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IAEhD,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;AACrD,CAAC;AAED,sDAAsD;AACtD,SAAgB,YAAY;IAC1B,OAAO,IAAA,2CAAgB,GAAE,CAAC,MAAM,CAAA;AAClC,CAAC","sourcesContent":["import { EntityManager, In } from 'typeorm'\n\nimport { Role } from '@things-factory/auth-base'\nimport { Domain } from '@things-factory/shell'\n\nimport { activityNamedIn, seatReader } from './activity-lookup.js'\nimport { judgeApprovalLine } from './approval-line-standing.js'\nimport { declaredDoors, offeredSeatNames } from './work-door-declaration.js'\nimport { WorkDoor, judgeDoor } from './work-door'\nimport { poolIdsOf } from '../activity-instance/assignee-pool.js'\nimport { WorkDoorNotUsed } from './work-door-not-used'\n\n/** A judged door and the approval line that applies to it, as stored, for the status screen to name. */\nexport type WorkDoorRead = WorkDoor & { line?: { seats: unknown[]; domainId: string } }\n\n/**\n * 이 공장의 문 열둘을 읽어 판정한다 — **한 벌.**\n *\n * ── 왜 resolver 밖에 두나 ──────────────────────────────────────────────────\n * 이 판정을 묻는 자리가 둘이 됐다. 화면(`workDoors`)과 성숙도 표다. 각자 읽으면 둘이 다른 수를\n * 말하게 되고, **어느 쪽이 맞는지 보는 사람이 알 길이 없다.** 성숙도 표는 이 제품이 스스로에 대해\n * 하는 말이라 화면과 어긋나면 그 표 전체를 못 믿는다.\n *\n * ── 부모까지 보는 규칙은 상신하는 쪽의 것을 그대로 쓴다 ────────────────────\n * 상신이 `activityNamedIn` 으로 양식을 찾으므로, 보는 쪽이 다른 규칙으로 찾으면 **「없다」고\n * 말하는데 실제로는 서는** 상태가 생긴다.\n */\nexport async function workDoorsFor(manager: EntityManager, domain: Domain): Promise<WorkDoorRead[]> {\n  /* 공장이 「안 쓴다」고 말한 것을 한 번에 읽는다. 문마다 읽으면 열두 번 묻는다. */\n  const declared = new Map(\n    (await manager.find(WorkDoorNotUsed, { where: { domain: { id: domain.id } } })).map(one => [\n      one.doorName,\n      one.because\n    ])\n  )\n\n  const doors: WorkDoorRead[] = []\n\n  /*\n   * **포트 하나를 문 열일곱이 함께 쓴다.** 포트가 읽은 역할을 기억하므로 같은 역할을 여러 번 묻지\n   * 않는다 — 결재선 대부분이 공장장으로 끝난다. 이 판정 동안만 산다.\n   */\n  const reader = seatReader(manager)\n\n  for (const door of declaredDoors()) {\n    const name = door.name\n    const activity = await activityNamedIn(manager, domain, name)\n    /*\n     * **결재선을 빌려 쓰는 문**은 따르는 문의 결재선으로 센다(§`LINE_FOLLOWS`). 자기 칸을 세면, 올리는\n     * 쪽은 발행 승인의 결재선으로 서는데 현황은 「결재자 없음」이라고 말한다.\n     */\n    const follows = door.lineFollows\n    const lineOwner = follows ? await activityNamedIn(manager, domain, follows) : activity\n\n    const judged = judgeDoor({\n        name,\n        kind: door.kind,\n        whenNoLine: door.whenNoLine,\n        whenNoLineBecause: door.because,\n        notUsedBecause: declared.get(name),\n        follows,\n        /* 상신하는 쪽과 **같은 함수**로 센다. 여기서 따로 세면 화면과 관문이 갈린다. */\n        approvalStanding: activity\n          ? await judgeApprovalLine(lineOwner?.approvalLine as Parameters<typeof judgeApprovalLine>[0], reader)\n          : undefined,\n        installed: activity\n          ? {\n              approvalLine: lineOwner?.approvalLine as unknown[] | undefined,\n              assigneeRoles: await roleNamesOf(manager, poolIdsOf(activity)),\n              /*\n               * **빌려 온 것일 때만** 채운다. `Activity` 는 `domainId` 만 들고 있어 이름은 따로\n               * 읽는데, 자기 도메인이면 읽지도 않고 비운다 — 자기 이름을 채우면 화면이 모든 줄에\n               * 「우리 공장에서 정했습니다」를 달고, 「결재자 없음」 옆에서 그 말이 거짓이 된다.\n               */\n              borrowedFrom:\n                activity.domainId === domain.id ? undefined : await subdomainOf(manager, activity.domainId)\n            }\n          : undefined\n    })\n\n    /*\n     * The line that applies, as stored, with the domain it was set in - the status screen names its\n     * seats. It is the followed door's line when this one follows, so the names match what raising\n     * this door actually goes through. Only for a door that stands: a missing or unused door goes\n     * through no line.\n     */\n    const line = lineOwner?.approvalLine as unknown[] | undefined\n    const lineStands = door.kind === 'approval' && (judged.standing === 'on' || judged.standing === 'off')\n\n    doors.push(lineStands && line?.length ? { ...judged, line: { seats: line, domainId: lineOwner!.domainId } } : judged)\n  }\n\n  return doors\n}\n\n/**\n * 그 역할의 이름. 없으면 없다 — 지어내지 않는다.\n *\n * 문마다 부르지 않고 배정 문에서만 부른다. 배정 문이 하나도 없는 지금은 한 번도 안 돈다.\n */\n/** The pool's role names, in the order the activity lists them. */\nasync function roleNamesOf(manager: EntityManager, roleIds: string[]): Promise<string[]> {\n  if (!roleIds.length) {\n    return []\n  }\n\n  const found = await manager.find(Role, { where: { id: In(roleIds) } })\n\n  return roleIds.map(id => found.find(role => role.id === id)?.name).filter(Boolean)\n}\n\n/**\n * 부모 도메인의 이름. 못 읽으면 지어내지 않고 비운다 — 「본사」라고 적으면 없는 이름이 화면에 남는다.\n *\n * 원문 SQL 로 안 읽는다. 자리표시자 철자가 드라이버마다 달라(`?` · `$1`) sqlite 에서는 통과하고\n * postgres 에서만 죽는다 — 그 부류는 여기서 절대 못 잡는다.\n */\nasync function subdomainOf(manager: EntityManager, domainId: string): Promise<string | undefined> {\n  const found = await manager.findOne(Domain, { where: { id: domainId } })\n\n  return found?.subdomain\n}\n\n/**\n * 이 제품이 내놓는 역할 자리 중 이 공장에 선 것이 몇인가.\n *\n * 결재선은 **역할을 가리킨다**(`[{type:'Role', value:<역할 id>}]`). 그러니 역할이 없는 공장에서는\n * 결재선을 만들 수 없다 — 양식 화면까지 가서야 그걸 알게 된다. 문 현황과 함께 내서 화면이 순서를\n * 말하게 한다.\n *\n * 공장이 스스로 만든 다른 역할은 안 센다. 이 수가 말하는 것은 「이 제품이 내놓은 자리」이고,\n * 그 밖의 역할로 결재선을 짜는 것도 물론 된다.\n */\nexport async function seatsStanding(manager: EntityManager, domain: Domain): Promise<number> {\n  const offered = offeredSeatNames()\n  const here = await manager.find(Role, { where: { domain: { id: domain.id } } })\n  const names = new Set(here.map(one => one.name))\n\n  return offered.filter(one => names.has(one)).length\n}\n\n/** 이 설치본의 앱들이 내놓는 자리의 수 — 화면이 목록을 따로 들지 않게 여기서 센다. */\nexport function seatsOffered(): number {\n  return offeredSeatNames().length\n}\n"]}

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

@@ -0,0 +1,88 @@
+import { ApprovalLineItem } from '@things-factory/organization';
+import type { WorkDoor } from './work-door.js';
+/**
+ * 「이 공장에서 어느 결재 문이 서 있나」를 화면에 낼 모양.
+ *
+ * **사실만 낸다. 문장은 화면이 번역으로 짓는다.** 서버가 한국어 문장을 지어 보내던 때 영어·일본어·
+ * 중국어·말레이어 사용자도 한국어를 읽었고, 화면이 상태별로 달리 그리려면 그 문장을 다시 뜯어 읽어야
+ * 했다. 열거형 값 셋은 `registerEnumType` 이 **멤버 이름**을 싣는다 — 화면이 `door-words.ts` 한 곳에서
+ * 옮긴다.
+ */
+export declare enum DoorStandingValue {
+    /** 채워졌다. */
+    On = "on",
+    /** 양식은 섰는데 받을 사람이 없다. 조치 대상. */
+    Off = "off",
+    /** 양식이 아예 안 섰다 — 설정이 아니라 결함이다. 조치 대상. */
+    Missing = "missing",
+    /** 이 공장이 안 쓰기로 했다. 조치 대상이 아니다. */
+    NotUsed = "not-used"
+}
+/** 결재냐 배정이냐 — 비었을 때 결과가 반대라 화면이 갈라 그려야 한다. */
+export declare enum DoorKindValue {
+    Approval = "approval",
+    Assignment = "assignment"
+}
+/** 왜 그 상태인가 — 까닭마다 관리자가 할 일이 다르다(§`DoorReason`). */
+export declare enum DoorReasonValue {
+    NotUsed = "not-used",
+    Missing = "missing",
+    LineEmpty = "line-empty",
+    RoleEmpty = "role-empty",
+    PersonAbsent = "person-absent",
+    NoAssignee = "no-assignee",
+    LineFilled = "line-filled",
+    AssigneeBound = "assignee-bound"
+}
+/** 결재선이 비면 이 문이 어떻게 하나 — 선언 그대로(ADR-0077 결정 1). */
+export declare enum WhenNoLineValue {
+    Run = "run",
+    Refuse = "refuse",
+    AsEstablished = "as-established"
+}
+/** 결재를 요구하는 까닭 — `refuse` · `as-established` 문만. */
+export declare enum WhenNoLineBecauseValue {
+    Irreversible = "irreversible",
+    ApprovalIsTheAct = "approval-is-the-act",
+    LowersAControl = "lowers-a-control"
+}
+export declare class WorkDoorType {
+    name: string;
+    labelKey: string;
+    kind: DoorKindValue;
+    standing: DoorStandingValue;
+    reason: DoorReasonValue;
+    approvers: number;
+    from?: string;
+    whenNoLine?: WhenNoLineValue;
+    whenNoLineBecause?: WhenNoLineBecauseValue;
+    followsLabelKey?: string;
+    assigneeRoles?: string[];
+    notUsedBecause?: string;
+    approvalLine?: ApprovalLineItem[];
+}
+export declare class WorkDoorsType {
+    doors: WorkDoorType[];
+    todo: number;
+    on: number;
+    off: number;
+    missing: number;
+    notUsed: number;
+    /**
+     * 이 제품이 내놓는 역할 자리 중 **이 공장에 실제로 선 것.**
+     *
+     * ── 왜 문 목록에 자리 수가 붙나 ────────────────────────────────────────
+     * 문이 비었다는 말만 하면 사람은 양식 화면으로 간다. 그런데 **고를 역할이 없으면 그 화면의
+     * 결재선 칸이 빈 목록**이다. 헛걸음하고 돌아와서, 무엇이 잘못됐는지 모른 채 이 화면을 다시 본다.
+     *
+     * 두 수를 함께 내면 화면이 순서를 말할 수 있다 — 자리부터 세우고, 그다음에 결재선을 건다.
+     */
+    seatsStanding: number;
+    seatsOffered: number;
+}
+/**
+ * 판단의 모양을 화면의 모양으로. 판단부의 낱말(`'line-empty'`)을 열거형 **값**으로 찾아 멤버를 싣는다 —
+ * 값과 낱말이 같게 적혀 있으니 표를 따로 들지 않는다. 못 찾으면 던진다: 새 낱말이 전선에서 조용히
+ * 사라지면 화면이 「모른다」조차 못 그린다.
+ */
+export declare function toDoorType(door: WorkDoor): WorkDoorType;