@things-factory/station 10.1.33

package/dist-server/service/station/station-screen-layout.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.screenModel = screenModel;
+exports.partsOfFlow = partsOfFlow;
+exports.draftScreen = draftScreen;
+exports.axesOfParts = axesOfParts;
+const station_flow_1 = require("./station-flow");
+const station_runtime_binding_1 = require("./station-runtime-binding");
+/** 작업대 화면의 판 크기. 벤치 태블릿의 가로 기준이다. */
+const BOARD = { width: 1280, height: 720 };
+const PAD = 24;
+const GAP = 16;
+/** 부품마다의 높이. 읽는 거리에서 정해진다 — 한 걸음 떨어져 보는 화면이다. */
+const HEIGHT = {
+    field: 96,
+    fieldBig: 132,
+    who: 120,
+    order: 132,
+    counts: 132,
+    numpad: 260,
+    action: 88,
+    staged: 200,
+    directive: 220,
+    maintenance: 120,
+    context: 0
+};
+/** 한 줄에 여럿이 서는 것들. 나머지는 한 줄에 하나다. */
+const SIDE_BY_SIDE = new Set(['numpad', 'action']);
+/**
+ * 부품에서 모델을 만든다.
+ *
+ * `context` 는 그려지지 않지만 **모델에는 들어간다** — 갱신 주기를 든 부품이라, 없으면 그 화면이
+ * 무엇을 얼마나 자주 읽을지 아무 데도 안 적힌다. 자리는 판 밖에 둔다.
+ */
+function screenModel(parts) {
+    const components = [];
+    const inner = BOARD.width - PAD * 2;
+    let top = PAD;
+    let index = 0;
+    /* 나란히 설 것들을 묶어 가며 내려간다. */
+    for (let at = 0; at < parts.length; at++) {
+        const part = parts[at];
+        if (part.part === 'context') {
+            components.push({
+                type: 'station-context',
+                id: `part-${index++}`,
+                /* 판 아래에 둔다 — 그려지지 않지만 저작면에서는 집어야 한다. */
+                left: PAD,
+                top: BOARD.height + GAP,
+                width: 240,
+                height: 60,
+                refreshSeconds: part.refreshSeconds ?? 10
+            });
+            continue;
+        }
+        /* 같은 종류가 이어지고 그것이 나란히 서는 것이면 한 줄에 담는다. */
+        const row = [part];
+        if (SIDE_BY_SIDE.has(part.part)) {
+            while (at + 1 < parts.length && parts[at + 1].part === part.part) {
+                row.push(parts[++at]);
+            }
+        }
+        const width = Math.floor((inner - GAP * (row.length - 1)) / row.length);
+        const height = heightOf(row[0]);
+        row.forEach((one, column) => {
+            components.push({
+                ...propsOf(one),
+                id: `part-${index++}`,
+                left: PAD + column * (width + GAP),
+                top,
+                width,
+                height
+            });
+        });
+        top += height + GAP;
+    }
+    return JSON.stringify({ width: BOARD.width, height: Math.max(BOARD.height, top + PAD), components });
+}
+function heightOf(part) {
+    if (part.part === 'field') {
+        return part.big ? HEIGHT.fieldBig : HEIGHT.field;
+    }
+    return HEIGHT[part.part] ?? HEIGHT.field;
+}
+/**
+ * 부품 선언 → 씬 컴포넌트의 속성.
+ *
+ * `equipment` 를 넣지 않는다. 비우면 그 화면이 걸린 작업대를 따르고, 적으면 그 설비에 못 박힌다 —
+ * 데모 화면은 복제해 고치는 첫 장이라 못 박으면 안 된다.
+ */
+function propsOf(part) {
+    switch (part.part) {
+        case 'field':
+            return {
+                type: 'station-field',
+                field: part.field,
+                label: part.label ?? '',
+                /* 큰 값은 한 걸음 떨어져 읽는 자리다. */
+                valueSize: part.big ? 42 : 26
+            };
+        case 'who':
+            return { type: 'station-who', label: part.label ?? '', prompt: part.prompt ?? '' };
+        case 'numpad':
+            return { type: 'station-numpad', label: part.label ?? '', counts: part.counts ?? 'good', ...(part.disabled ? { disabled: true } : {}) };
+        case 'action':
+            return {
+                type: 'station-action',
+                label: part.label ?? '',
+                action: part.action,
+                ...(part.disabled ? { disabled: true } : {}),
+                ...(part.reasonCode ? { reasonCode: part.reasonCode } : {})
+            };
+        case 'staged':
+            return { type: 'station-staged', label: part.label ?? '', removable: part.removable ?? false };
+        default:
+            /* order · counts · directive · maintenance — 이름표 하나뿐이다. */
+            return { type: `station-${part.part}`, label: part.label ?? '' };
+    }
+}
+/**
+ * 흐름 → 그려질 부품.
+ *
+ * ── 단계와 부품은 하나가 아니다 ────────────────────────────────────────────
+ * 「값 넣기」 한 단계가 숫자패드 하나를 낳고, 「보기」 한 단계가 읽는 축 수만큼 값을 낳고, 「설정」은
+ * 하나도 안 낳는다(그려지지 않지만 모델에는 남는다 — 갱신 주기를 든 부품이라).
+ *
+ * ── 이름표가 없으면 축 이름을 쓴다 ─────────────────────────────────────────
+ * 빈 이름표로 두지 않는다. 작업대에서 맨숫자는 가장 자주 오독되는 것이고, 그 오독은 수량을 잘못
+ * 적는 것으로 이어진다.
+ */
+function partsOfFlow(flow) {
+    const parts = [];
+    for (const step of flow.steps) {
+        parts.push(...partsOfStep(step, flow));
+    }
+    return parts;
+}
+function partsOfStep(step, flow) {
+    switch (step.kind) {
+        case 'scan':
+            return [{ part: 'who', label: step.label, prompt: '' }];
+        case 'enter':
+            /*
+             * 무엇을 받는 자리인지는 이 단계를 **쓰는 쪽**이 안다(`{ from: 'input' }`). 여기서는 모르므로
+             * 기본값을 두고, 저작면이 고른 뒤에 바뀐다.
+             */
+            return [{ part: 'numpad', label: step.label, counts: (0, station_runtime_binding_1.entryCounts)(flow, step.id) ?? 'good', disabled: !(0, station_runtime_binding_1.entryCounts)(flow, step.id) }];
+        case 'run':
+            return [{ part: 'action', label: step.label, action: (0, station_runtime_binding_1.runAction)(step) ?? 'start', disabled: !(0, station_runtime_binding_1.runAction)(step) }];
+        case 'settings':
+            /* 갱신 주기를 여기서 떨어뜨리면, 계산해 둔 값이 판까지 안 가고 전부 기본값으로 선다. */
+            return [{ part: 'context', ...(step.refreshSeconds ? { refreshSeconds: step.refreshSeconds } : {}) }];
+        case 'legacy':
+            return step.legacyPart ? [step.legacyPart] : [];
+        default:
+            /* 보기 — 읽는 축마다 값 하나. 축이 없으면 그릴 것도 없다. */
+            return (step.reads ?? []).map(axis => ({ part: 'field', field: axis, label: step.label ?? axis }));
+    }
+}
+/**
+ * 흐름 하나가 낳는 **모든 것**을 한 번에 — 도안 · 읽는 축 · 저작자가 알아야 할 것.
+ *
+ * ── 왜 셋을 묶었나 ────────────────────────────────────────────────────────
+ * 저작면의 미리보기와 저장이 같은 계산을 봐야 한다. 미리보기가 도안만 받고 저장이 축을 따로 세면,
+ * 저작자가 본 화면과 배정 검증이 검사하는 축이 갈릴 수 있다 — 그리고 그 차이는 배정하는 날에야
+ * 드러난다.
+ *
+ * ── 빈 흐름은 오류가 아니다 ───────────────────────────────────────────────
+ * 저작면은 고칠 때마다 묻고, 그중에는 마지막 단계를 지운 편집도 있다. 그때 던지면 화면이 「그리지
+ * 못했습니다」를 말하는데 사실은 그릴 것이 없는 것뿐이다.
+ */
+function draftScreen(flow) {
+    const safe = { steps: Array.isArray(flow?.steps) ? flow.steps : [] };
+    return {
+        model: screenModel(partsOfFlow(safe)),
+        requires: (0, station_flow_1.axesRead)(safe),
+        problems: [...(0, station_flow_1.checkFlow)(safe), ...safe.steps.filter(step => (step.kind === 'run' && !(0, station_runtime_binding_1.runAction)(step)) || (step.kind === 'enter' && !(0, station_runtime_binding_1.entryCounts)(safe, step.id))).map(step => ({
+                level: 'error', stepId: step.id, code: 'text.station-runtime-not-connected',
+                params: { step: step.label ?? step.id },
+                says: `「${step.label ?? step.id}」의 실행 연결이 없습니다. 다른 업무로 대신 실행하지 않습니다.`
+            }))]
+    };
+}
+/**
+ * 이 부품들이 읽는 컨텍스트 축.
+ *
+ * `StationScreenSpec.requires` 는 **파생값이다.** 손으로 적으면 부품을 고칠 때 어긋나고, 그러면
+ * 배정 검증이 이미 사실이 아닌 것을 검사한다.
+ *
+ * 흐름 쪽에는 같은 일을 하는 `axesRead` 가 따로 있다 — 들어오는 어휘가 다르기 때문이다(시드는
+ * 부품으로, 저작면은 단계로 들어온다). 규칙이 갈리지 않게 둘 다 여기 계산기 옆에 산다.
+ */
+function axesOfParts(parts) {
+    const seen = new Set();
+    for (const part of parts) {
+        if (part.part === 'field') {
+            seen.add(part.field);
+        }
+    }
+    return [...seen].sort();
+}
+//# sourceMappingURL=station-screen-layout.js.map

package/dist-server/service/station/station-screen-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-screen-layout.js","sourceRoot":"","sources":["../../../server/service/station/station-screen-layout.ts"],"names":[],"mappings":"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","sourcesContent":["import { axesRead, checkFlow } from './station-flow'\nimport type { StationFlow, StationProblem, StationStep } from './station-flow'\nimport { entryCounts, runAction } from './station-runtime-binding'\n\n/**\n * 부품 목록 → things-scene 모델. **자리는 여기서 계산한다.**\n *\n * ── 왜 아무도 좌표를 안 드나 ───────────────────────────────────────────────\n * 부품 하나를 더할 때마다 나머지를 손으로 밀어야 하고, 그렇게 만든 판은 2px 씩 어긋난다. 폼에서\n * 눈에 걸리는 것이 대개 그 어긋남이다.\n *\n * ── 계산기는 **한 벌이다** ─────────────────────────────────────────────────\n * 시드도 저작면도 여기를 지난다. 두 벌을 두면 시드로 세운 화면과 사람이 만든 화면이 다르게 생기고,\n * 그때 어느 쪽이 맞는지 아무도 못 정한다. 그래서 이 파일은 시드가 아니라 **station 어휘**에 산다.\n *\n * ── 규칙은 하나다: 세로로 쌓고, 짝지을 것만 나란히 ─────────────────────────\n * 숫자패드와 단추는 여럿이 나란히 놓인다 — 작업자가 손을 옮기는 거리가 짧아야 한다. 나머지는\n * 한 줄에 하나다.\n */\n\n/**\n * 화면에 놓이는 부품 하나 — **그려지는 것만.**\n *\n * 흐름의 단계(`StationStep`)와 다르다. 단계는 「사람이 무엇을 하나」이고 여기는 「무엇이 그려지나」다.\n * 한 단계가 부품 둘을 낳기도 하고(값 넣기 → 숫자패드), 하나도 안 낳기도 한다(설정).\n */\nexport type StationScreenPart =\n  /** 컨텍스트 축 하나를 값으로. `stationBindingNames()` 가 이름의 유일한 원본이다. */\n  | { part: 'field'; field: string; label?: string; big?: boolean }\n  | { part: 'who'; label?: string; prompt?: string }\n  | { part: 'order'; label?: string }\n  | { part: 'counts'; label?: string }\n  | { part: 'numpad'; label?: string; counts?: 'good' | 'scrap'; disabled?: boolean }\n  | { part: 'action'; label?: string; action: 'start' | 'finish' | 'pause' | 'resume'; reasonCode?: string; disabled?: boolean }\n  | { part: 'staged'; label?: string; removable?: boolean }\n  | { part: 'directive'; label?: string }\n  | { part: 'maintenance'; label?: string }\n  | { part: 'context'; refreshSeconds?: number }\n\n/** 작업대 화면의 판 크기. 벤치 태블릿의 가로 기준이다. */\nconst BOARD = { width: 1280, height: 720 }\n\nconst PAD = 24\nconst GAP = 16\n\n/** 부품마다의 높이. 읽는 거리에서 정해진다 — 한 걸음 떨어져 보는 화면이다. */\nconst HEIGHT: Record<string, number> = {\n  field: 96,\n  fieldBig: 132,\n  who: 120,\n  order: 132,\n  counts: 132,\n  numpad: 260,\n  action: 88,\n  staged: 200,\n  directive: 220,\n  maintenance: 120,\n  context: 0\n}\n\n/** 한 줄에 여럿이 서는 것들. 나머지는 한 줄에 하나다. */\nconst SIDE_BY_SIDE = new Set(['numpad', 'action'])\n\ninterface Placed {\n  type: string\n  id: string\n  left: number\n  top: number\n  width: number\n  height: number\n  [more: string]: unknown\n}\n\n/**\n * 부품에서 모델을 만든다.\n *\n * `context` 는 그려지지 않지만 **모델에는 들어간다** — 갱신 주기를 든 부품이라, 없으면 그 화면이\n * 무엇을 얼마나 자주 읽을지 아무 데도 안 적힌다. 자리는 판 밖에 둔다.\n */\nexport function screenModel(parts: StationScreenPart[]): string {\n  const components: Placed[] = []\n  const inner = BOARD.width - PAD * 2\n\n  let top = PAD\n  let index = 0\n\n  /* 나란히 설 것들을 묶어 가며 내려간다. */\n  for (let at = 0; at < parts.length; at++) {\n    const part = parts[at]\n\n    if (part.part === 'context') {\n      components.push({\n        type: 'station-context',\n        id: `part-${index++}`,\n        /* 판 아래에 둔다 — 그려지지 않지만 저작면에서는 집어야 한다. */\n        left: PAD,\n        top: BOARD.height + GAP,\n        width: 240,\n        height: 60,\n        refreshSeconds: part.refreshSeconds ?? 10\n      })\n      continue\n    }\n\n    /* 같은 종류가 이어지고 그것이 나란히 서는 것이면 한 줄에 담는다. */\n    const row: StationScreenPart[] = [part]\n\n    if (SIDE_BY_SIDE.has(part.part)) {\n      while (at + 1 < parts.length && parts[at + 1].part === part.part) {\n        row.push(parts[++at])\n      }\n    }\n\n    const width = Math.floor((inner - GAP * (row.length - 1)) / row.length)\n    const height = heightOf(row[0])\n\n    row.forEach((one, column) => {\n      components.push({\n        ...(propsOf(one) as { type: string }),\n        id: `part-${index++}`,\n        left: PAD + column * (width + GAP),\n        top,\n        width,\n        height\n      })\n    })\n\n    top += height + GAP\n  }\n\n  return JSON.stringify({ width: BOARD.width, height: Math.max(BOARD.height, top + PAD), components })\n}\n\nfunction heightOf(part: StationScreenPart): number {\n  if (part.part === 'field') {\n    return part.big ? HEIGHT.fieldBig : HEIGHT.field\n  }\n\n  return HEIGHT[part.part] ?? HEIGHT.field\n}\n\n/**\n * 부품 선언 → 씬 컴포넌트의 속성.\n *\n * `equipment` 를 넣지 않는다. 비우면 그 화면이 걸린 작업대를 따르고, 적으면 그 설비에 못 박힌다 —\n * 데모 화면은 복제해 고치는 첫 장이라 못 박으면 안 된다.\n */\nfunction propsOf(part: StationScreenPart): Record<string, unknown> {\n  switch (part.part) {\n    case 'field':\n      return {\n        type: 'station-field',\n        field: part.field,\n        label: part.label ?? '',\n        /* 큰 값은 한 걸음 떨어져 읽는 자리다. */\n        valueSize: part.big ? 42 : 26\n      }\n\n    case 'who':\n      return { type: 'station-who', label: part.label ?? '', prompt: part.prompt ?? '' }\n\n    case 'numpad':\n      return { type: 'station-numpad', label: part.label ?? '', counts: part.counts ?? 'good', ...(part.disabled ? { disabled: true } : {}) }\n\n    case 'action':\n      return {\n        type: 'station-action',\n        label: part.label ?? '',\n        action: part.action,\n        ...(part.disabled ? { disabled: true } : {}),\n        ...(part.reasonCode ? { reasonCode: part.reasonCode } : {})\n      }\n\n    case 'staged':\n      return { type: 'station-staged', label: part.label ?? '', removable: part.removable ?? false }\n\n    default:\n      /* order · counts · directive · maintenance — 이름표 하나뿐이다. */\n      return { type: `station-${part.part}`, label: (part as { label?: string }).label ?? '' }\n  }\n}\n\n/**\n * 흐름 → 그려질 부품.\n *\n * ── 단계와 부품은 하나가 아니다 ────────────────────────────────────────────\n * 「값 넣기」 한 단계가 숫자패드 하나를 낳고, 「보기」 한 단계가 읽는 축 수만큼 값을 낳고, 「설정」은\n * 하나도 안 낳는다(그려지지 않지만 모델에는 남는다 — 갱신 주기를 든 부품이라).\n *\n * ── 이름표가 없으면 축 이름을 쓴다 ─────────────────────────────────────────\n * 빈 이름표로 두지 않는다. 작업대에서 맨숫자는 가장 자주 오독되는 것이고, 그 오독은 수량을 잘못\n * 적는 것으로 이어진다.\n */\nexport function partsOfFlow(flow: StationFlow): StationScreenPart[] {\n  const parts: StationScreenPart[] = []\n\n  for (const step of flow.steps) {\n    parts.push(...partsOfStep(step, flow))\n  }\n\n  return parts\n}\n\nfunction partsOfStep(step: StationStep, flow: StationFlow): StationScreenPart[] {\n  switch (step.kind) {\n    case 'scan':\n      return [{ part: 'who', label: step.label, prompt: '' }]\n\n    case 'enter':\n      /*\n       * 무엇을 받는 자리인지는 이 단계를 **쓰는 쪽**이 안다(`{ from: 'input' }`). 여기서는 모르므로\n       * 기본값을 두고, 저작면이 고른 뒤에 바뀐다.\n       */\n      return [{ part: 'numpad', label: step.label, counts: entryCounts(flow, step.id) ?? 'good', disabled: !entryCounts(flow, step.id) }]\n\n    case 'run':\n      return [{ part: 'action', label: step.label, action: runAction(step) ?? 'start', disabled: !runAction(step) }]\n\n    case 'settings':\n      /* 갱신 주기를 여기서 떨어뜨리면, 계산해 둔 값이 판까지 안 가고 전부 기본값으로 선다. */\n      return [{ part: 'context', ...(step.refreshSeconds ? { refreshSeconds: step.refreshSeconds } : {}) }]\n\n    case 'legacy':\n      return step.legacyPart ? [step.legacyPart as StationScreenPart] : []\n\n    default:\n      /* 보기 — 읽는 축마다 값 하나. 축이 없으면 그릴 것도 없다. */\n      return (step.reads ?? []).map(axis => ({ part: 'field', field: axis, label: step.label ?? axis }))\n  }\n}\n\n/**\n * 이 실행 단계가 어떤 단추인가.\n *\n * 단계의 `status` 출처가 `{ from: 'step' }` 이라는 것은 「단계의 뜻이 정한다」는 말이고, 그 뜻이\n * 여기서 단추 모양으로도 나온다. 아직 흐름이 그것을 따로 적지 않으므로 이름표에서 읽는다 —\n * 흐름에 칸이 생기면 그때 그것을 본다.\n */\n\n/** 저장하지 않고 흐름이 무엇을 그릴지 — 저작면의 미리보기가 이것을 받는다. */\nexport interface StationScreenDraftResult {\n  model: string\n  requires: string[]\n  problems: StationProblem[]\n}\n\n/**\n * 흐름 하나가 낳는 **모든 것**을 한 번에 — 도안 · 읽는 축 · 저작자가 알아야 할 것.\n *\n * ── 왜 셋을 묶었나 ────────────────────────────────────────────────────────\n * 저작면의 미리보기와 저장이 같은 계산을 봐야 한다. 미리보기가 도안만 받고 저장이 축을 따로 세면,\n * 저작자가 본 화면과 배정 검증이 검사하는 축이 갈릴 수 있다 — 그리고 그 차이는 배정하는 날에야\n * 드러난다.\n *\n * ── 빈 흐름은 오류가 아니다 ───────────────────────────────────────────────\n * 저작면은 고칠 때마다 묻고, 그중에는 마지막 단계를 지운 편집도 있다. 그때 던지면 화면이 「그리지\n * 못했습니다」를 말하는데 사실은 그릴 것이 없는 것뿐이다.\n */\nexport function draftScreen(flow: StationFlow | null | undefined): StationScreenDraftResult {\n  const safe: StationFlow = { steps: Array.isArray(flow?.steps) ? flow!.steps : [] }\n\n  return {\n    model: screenModel(partsOfFlow(safe)),\n    requires: axesRead(safe),\n    problems: [...checkFlow(safe), ...safe.steps.filter(step =>\n      (step.kind === 'run' && !runAction(step)) || (step.kind === 'enter' && !entryCounts(safe, step.id))\n    ).map(step => ({\n      level: 'error' as const, stepId: step.id, code: 'text.station-runtime-not-connected',\n      params: { step: step.label ?? step.id },\n      says: `「${step.label ?? step.id}」의 실행 연결이 없습니다. 다른 업무로 대신 실행하지 않습니다.`\n    }))]\n  }\n}\n\n/**\n * 이 부품들이 읽는 컨텍스트 축.\n *\n * `StationScreenSpec.requires` 는 **파생값이다.** 손으로 적으면 부품을 고칠 때 어긋나고, 그러면\n * 배정 검증이 이미 사실이 아닌 것을 검사한다.\n *\n * 흐름 쪽에는 같은 일을 하는 `axesRead` 가 따로 있다 — 들어오는 어휘가 다르기 때문이다(시드는\n * 부품으로, 저작면은 단계로 들어온다). 규칙이 갈리지 않게 둘 다 여기 계산기 옆에 산다.\n */\nexport function axesOfParts(parts: StationScreenPart[]): string[] {\n  const seen = new Set<string>()\n\n  for (const part of parts) {\n    if (part.part === 'field') {\n      seen.add(part.field)\n    }\n  }\n\n  return [...seen].sort()\n}\n"]}

package/dist-server/service/station/station-screen-list-resolver.d.ts

@@ -0,0 +1,69 @@
+import { ListParam } from '@things-factory/shell';
+/**
+ * One board, seen as a station screen.
+ *
+ * ## Why this is a view and not a table
+ *
+ * The drawing is a `Board`; what makes it a *station* screen is the `StationScreenSpec` beside it.
+ * This type joins the two, plus the one fact neither of them holds — how many stations are pointed
+ * at it — so that a card can be chosen from rather than merely looked at.
+ */
+export declare class StationScreenCard {
+    boardId: string;
+    name: string;
+    description?: string;
+    /**
+     * The picture, as a path — **not the picture itself.**
+     *
+     * `Board.thumbnail` is a base64 column, and a page of them is megabytes in one response. The
+     * Station owns the card's image route. Asking board-service directly would require a separate
+     * Board privilege and make a Station manager see empty cards. The path is built here because
+     * whether it carries a `domain/{subdomain}` segment depends on how this deployment resolves
+     * tenants, and the server is the side that knows.
+     */
+    thumbnailPath: string;
+    /**
+     * `'draft'` or `'released'` — the state of the **working copy**, not of what the floor sees.
+     *
+     * A board reading `'draft'` may still have an older released version in front of operators. What
+     * is actually on the floor lives in `BoardHistory`, which board-service registers but does not
+     * export by name, so this card cannot say it yet. It says what it can and stays quiet about the
+     * rest rather than implying the two are the same.
+     */
+    state?: string;
+    updatedAt?: Date;
+    /**
+     * How many stations are pointed at this board.
+     *
+     * The reason a card is worth more than a row. Zero means nobody sees it — a drawing somebody made
+     * and never hung. Twelve means editing it changes twelve benches at once. Name and picture let
+     * you pick one; this is what lets you decide.
+     */
+    assignmentCount: number;
+    /** Which station context axes the drawing reads, as declared by the spec. */
+    requires?: string[];
+    target?: Record<string, unknown>;
+    /** Whether releasing this screen has to go through approval. */
+    controlled?: boolean;
+}
+export declare class StationScreenCardList {
+    items: StationScreenCard[];
+    total: number;
+}
+export declare class StationScreenListResolver {
+    /**
+     * Every board that has been declared a station screen.
+     *
+     * ## What makes a board a station screen
+     *
+     * Having a `StationScreenSpec`. Not "an assignment points at it" — a screen being drawn but not
+     * yet hung is exactly the state this list exists to show. The spec is the declaration; the
+     * assignment is a consequence.
+     *
+     * ## Paged, and the pictures stay out of it
+     *
+     * `Board.thumbnail` and `Board.model` are the two big columns and neither belongs in a listing.
+     * The projection leaves them out and the card fetches the image over HTTP instead.
+     */
+    stationScreens(params: ListParam, context: any): Promise<StationScreenCardList>;
+}

package/dist-server/service/station/station-screen-list-resolver.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StationScreenListResolver = exports.StationScreenCardList = exports.StationScreenCard = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const board_service_1 = require("@things-factory/board-service");
+const shell_1 = require("@things-factory/shell");
+const station_screen_assignment_1 = require("./station-screen-assignment");
+const station_screen_spec_1 = require("./station-screen-spec");
+/**
+ * One board, seen as a station screen.
+ *
+ * ## Why this is a view and not a table
+ *
+ * The drawing is a `Board`; what makes it a *station* screen is the `StationScreenSpec` beside it.
+ * This type joins the two, plus the one fact neither of them holds — how many stations are pointed
+ * at it — so that a card can be chosen from rather than merely looked at.
+ */
+let StationScreenCard = class StationScreenCard {
+};
+exports.StationScreenCard = StationScreenCard;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], StationScreenCard.prototype, "boardId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], StationScreenCard.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], StationScreenCard.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'path to the thumbnail image — not the image' }),
+    tslib_1.__metadata("design:type", String)
+], StationScreenCard.prototype, "thumbnailPath", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], StationScreenCard.prototype, "state", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date
+    /**
+     * How many stations are pointed at this board.
+     *
+     * The reason a card is worth more than a row. Zero means nobody sees it — a drawing somebody made
+     * and never hung. Twelve means editing it changes twelve benches at once. Name and picture let
+     * you pick one; this is what lets you decide.
+     */
+    )
+], StationScreenCard.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'how many station assignments point at this board' }),
+    tslib_1.__metadata("design:type", Number)
+], StationScreenCard.prototype, "assignmentCount", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
+    tslib_1.__metadata("design:type", Array)
+], StationScreenCard.prototype, "requires", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], StationScreenCard.prototype, "target", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Boolean)
+], StationScreenCard.prototype, "controlled", void 0);
+exports.StationScreenCard = StationScreenCard = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'a board seen as a station screen' })
+], StationScreenCard);
+let StationScreenCardList = class StationScreenCardList {
+};
+exports.StationScreenCardList = StationScreenCardList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [StationScreenCard]),
+    tslib_1.__metadata("design:type", Array)
+], StationScreenCardList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], StationScreenCardList.prototype, "total", void 0);
+exports.StationScreenCardList = StationScreenCardList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'a page of station screens' })
+], StationScreenCardList);
+let StationScreenListResolver = class StationScreenListResolver {
+    /**
+     * Every board that has been declared a station screen.
+     *
+     * ## What makes a board a station screen
+     *
+     * Having a `StationScreenSpec`. Not "an assignment points at it" — a screen being drawn but not
+     * yet hung is exactly the state this list exists to show. The spec is the declaration; the
+     * assignment is a consequence.
+     *
+     * ## Paged, and the pictures stay out of it
+     *
+     * `Board.thumbnail` and `Board.model` are the two big columns and neither belongs in a listing.
+     * The projection leaves them out and the card fetches the image over HTTP instead.
+     */
+    async stationScreens(params, context) {
+        const { domain } = context.state;
+        const { pagination, sortings = [], search } = params;
+        const page = pagination?.page ?? 1;
+        const limit = pagination?.limit ?? 30;
+        /*
+         * The query is built here rather than with `getQueryBuilderFromListParams`.
+         *
+         * That helper sorts and filters against **one repository's own columns**, and almost nothing a
+         * person wants to sort this list by is a column of `StationScreenSpec`: the name and the state
+         * belong to the board, and "how many stations show it" is counted, not stored. Declaring
+         * `assignmentCount` as a sorter with the helper sent it straight into SQL —
+         * `no such column: spec.assignmentCount` [seen 2026-09-09].
+         *
+         * So the board is joined and the count is a subquery, which puts every sortable value in the
+         * database where ordering and paging can actually agree with each other. Sorting a page after
+         * fetching it would order the page, not the list.
+         */
+        const counted = (sub) => sub.select('COUNT(1)').from(station_screen_assignment_1.StationScreenAssignment, 'assignment').where('assignment.boardId = spec.boardId');
+        const query = (0, shell_1.getRepository)(station_screen_spec_1.StationScreenSpec)
+            .createQueryBuilder('spec')
+            .innerJoin(board_service_1.Board, 'board', 'board.id = spec.boardId')
+            .where('spec.domain = :domain', { domain: domain.id })
+            .select('spec.boardId', 'boardId')
+            .addSelect('spec.requires', 'requires')
+            .addSelect('spec.target', 'target')
+            .addSelect('spec.controlled', 'controlled')
+            .addSelect('board.name', 'name')
+            .addSelect('board.description', 'description')
+            .addSelect('board.state', 'state')
+            .addSelect('board.updatedAt', 'updatedAt')
+            .addSelect('board.thumbnailUpdatedAt', 'thumbnailUpdatedAt')
+            .addSelect(counted, 'assignmentCount');
+        if (search?.trim()) {
+            query.andWhere('(board.name LIKE :term OR board.description LIKE :term)', { term: `%${search.trim()}%` });
+        }
+        /*
+         * Only these can be ordered by, and the list says so rather than passing whatever arrives
+         * through to the database. An unknown name coming from the client is a 500 otherwise.
+         */
+        const ORDERABLE = {
+            name: 'board.name',
+            state: 'board.state',
+            updatedAt: 'board.updatedAt',
+            assignmentCount: 'assignmentCount'
+        };
+        const asked = sortings.filter((sorting) => ORDERABLE[sorting.name]);
+        if (asked.length) {
+            asked.forEach((sorting, at) => {
+                const direction = sorting.desc ? 'DESC' : 'ASC';
+                at === 0 ? query.orderBy(ORDERABLE[sorting.name], direction) : query.addOrderBy(ORDERABLE[sorting.name], direction);
+            });
+        }
+        else {
+            /* Nobody has hung it anywhere — the most common unfinished state, so it comes first. */
+            query.orderBy('assignmentCount', 'ASC').addOrderBy('board.name', 'ASC');
+        }
+        const total = await query.getCount();
+        const rows = await query
+            .offset((page - 1) * limit)
+            .limit(limit)
+            .getRawMany();
+        /**
+         * Raw rows carry whatever the driver returns, and sqlite returns a datetime as the string it
+         * stored — `2026-09-09 05:25:16`, which the `DateTime` scalar refuses [seen 2026-09-09]. TypeORM
+         * writes those in UTC, so that is how they are read back; a driver that already hands over a
+         * `Date` passes straight through.
+         */
+        const asDate = (value) => {
+            if (!value)
+                return undefined;
+            if (value instanceof Date)
+                return value;
+            const text = String(value);
+            return new Date(text.includes('T') || text.endsWith('Z') ? text : `${text.replace(' ', 'T')}Z`);
+        };
+        const contextPath = (0, shell_1.getContextPath)(domain);
+        return {
+            total,
+            items: rows.map(row => ({
+                boardId: row.boardId,
+                name: row.name,
+                description: row.description,
+                thumbnailPath: `/${contextPath}station-screen-thumbnail/${row.boardId}${row.thumbnailUpdatedAt || row.updatedAt ? `?v=${new Date(row.thumbnailUpdatedAt ?? row.updatedAt).getTime()}` : ''}`,
+                state: row.state,
+                updatedAt: asDate(row.updatedAt),
+                assignmentCount: Number(row.assignmentCount ?? 0),
+                /*
+                 * Raw rows skip the column transforms, so the stored shapes come back as they are stored:
+                 * `simple-array` as a comma-joined string and `simple-json` as text. Converted here rather
+                 * than handed to the client as-is.
+                 */
+                requires: row.requires ? String(row.requires).split(',').filter(Boolean) : undefined,
+                target: row.target ? JSON.parse(String(row.target)) : undefined,
+                controlled: Boolean(row.controlled)
+            }))
+        };
+    }
+};
+exports.StationScreenListResolver = StationScreenListResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "station", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => StationScreenCardList, { description: 'a page of boards declared as station screens' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], StationScreenListResolver.prototype, "stationScreens", null);
+exports.StationScreenListResolver = StationScreenListResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(StationScreenCard),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], StationScreenListResolver);
+//# sourceMappingURL=station-screen-list-resolver.js.map

package/dist-server/service/station/station-screen-list-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-screen-list-resolver.js","sourceRoot":"","sources":["../../../server/service/station/station-screen-list-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { Args, Ctx, Directive, Field, Int, ObjectType, Query, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { Board } from '@things-factory/board-service'\nimport { ListParam, ScalarObject, getContextPath, getRepository, SpeakRefusals } from '@things-factory/shell'\n\nimport { StationScreenAssignment } from './station-screen-assignment'\nimport { StationScreenSpec } from './station-screen-spec'\n\n/**\n * One board, seen as a station screen.\n *\n * ## Why this is a view and not a table\n *\n * The drawing is a `Board`; what makes it a *station* screen is the `StationScreenSpec` beside it.\n * This type joins the two, plus the one fact neither of them holds — how many stations are pointed\n * at it — so that a card can be chosen from rather than merely looked at.\n */\n@ObjectType({ description: 'a board seen as a station screen' })\nexport class StationScreenCard {\n  @Field()\n  boardId: string\n\n  @Field()\n  name: string\n\n  @Field({ nullable: true })\n  description?: string\n\n  /**\n   * The picture, as a path — **not the picture itself.**\n   *\n   * `Board.thumbnail` is a base64 column, and a page of them is megabytes in one response. The\n   * Station owns the card's image route. Asking board-service directly would require a separate\n   * Board privilege and make a Station manager see empty cards. The path is built here because\n   * whether it carries a `domain/{subdomain}` segment depends on how this deployment resolves\n   * tenants, and the server is the side that knows.\n   */\n  @Field({ description: 'path to the thumbnail image — not the image' })\n  thumbnailPath: string\n\n  /**\n   * `'draft'` or `'released'` — the state of the **working copy**, not of what the floor sees.\n   *\n   * A board reading `'draft'` may still have an older released version in front of operators. What\n   * is actually on the floor lives in `BoardHistory`, which board-service registers but does not\n   * export by name, so this card cannot say it yet. It says what it can and stays quiet about the\n   * rest rather than implying the two are the same.\n   */\n  @Field({ nullable: true })\n  state?: string\n\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  /**\n   * How many stations are pointed at this board.\n   *\n   * The reason a card is worth more than a row. Zero means nobody sees it — a drawing somebody made\n   * and never hung. Twelve means editing it changes twelve benches at once. Name and picture let\n   * you pick one; this is what lets you decide.\n   */\n  @Field(type => Int, { description: 'how many station assignments point at this board' })\n  assignmentCount: number\n\n  /** Which station context axes the drawing reads, as declared by the spec. */\n  @Field(type => [String], { nullable: true })\n  requires?: string[]\n\n  @Field(type => ScalarObject, { nullable: true })\n  target?: Record<string, unknown>\n\n  /** Whether releasing this screen has to go through approval. */\n  @Field({ nullable: true })\n  controlled?: boolean\n}\n\n@ObjectType({ description: 'a page of station screens' })\nexport class StationScreenCardList {\n  @Field(type => [StationScreenCard])\n  items: StationScreenCard[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@Resolver(StationScreenCard)\n@UseMiddleware(SpeakRefusals)\nexport class StationScreenListResolver {\n  /**\n   * Every board that has been declared a station screen.\n   *\n   * ## What makes a board a station screen\n   *\n   * Having a `StationScreenSpec`. Not \"an assignment points at it\" — a screen being drawn but not\n   * yet hung is exactly the state this list exists to show. The spec is the declaration; the\n   * assignment is a consequence.\n   *\n   * ## Paged, and the pictures stay out of it\n   *\n   * `Board.thumbnail` and `Board.model` are the two big columns and neither belongs in a listing.\n   * The projection leaves them out and the card fetches the image over HTTP instead.\n   */\n  @Directive('@privilege(category: \"station\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => StationScreenCardList, { description: 'a page of boards declared as station screens' })\n  async stationScreens(@Args(type => ListParam) params: ListParam, @Ctx() context: any): Promise<StationScreenCardList> {\n    const { domain } = context.state\n    const { pagination, sortings = [], search } = params as any\n    const page = pagination?.page ?? 1\n    const limit = pagination?.limit ?? 30\n\n    /*\n     * The query is built here rather than with `getQueryBuilderFromListParams`.\n     *\n     * That helper sorts and filters against **one repository's own columns**, and almost nothing a\n     * person wants to sort this list by is a column of `StationScreenSpec`: the name and the state\n     * belong to the board, and \"how many stations show it\" is counted, not stored. Declaring\n     * `assignmentCount` as a sorter with the helper sent it straight into SQL —\n     * `no such column: spec.assignmentCount` [seen 2026-09-09].\n     *\n     * So the board is joined and the count is a subquery, which puts every sortable value in the\n     * database where ordering and paging can actually agree with each other. Sorting a page after\n     * fetching it would order the page, not the list.\n     */\n    const counted = (sub: any) => sub.select('COUNT(1)').from(StationScreenAssignment, 'assignment').where('assignment.boardId = spec.boardId')\n\n    const query = getRepository(StationScreenSpec)\n      .createQueryBuilder('spec')\n      .innerJoin(Board, 'board', 'board.id = spec.boardId')\n      .where('spec.domain = :domain', { domain: domain.id })\n      .select('spec.boardId', 'boardId')\n      .addSelect('spec.requires', 'requires')\n      .addSelect('spec.target', 'target')\n      .addSelect('spec.controlled', 'controlled')\n      .addSelect('board.name', 'name')\n      .addSelect('board.description', 'description')\n      .addSelect('board.state', 'state')\n      .addSelect('board.updatedAt', 'updatedAt')\n      .addSelect('board.thumbnailUpdatedAt', 'thumbnailUpdatedAt')\n      .addSelect(counted, 'assignmentCount')\n\n    if (search?.trim()) {\n      query.andWhere('(board.name LIKE :term OR board.description LIKE :term)', { term: `%${search.trim()}%` })\n    }\n\n    /*\n     * Only these can be ordered by, and the list says so rather than passing whatever arrives\n     * through to the database. An unknown name coming from the client is a 500 otherwise.\n     */\n    const ORDERABLE: Record<string, string> = {\n      name: 'board.name',\n      state: 'board.state',\n      updatedAt: 'board.updatedAt',\n      assignmentCount: 'assignmentCount'\n    }\n\n    const asked = sortings.filter((sorting: any) => ORDERABLE[sorting.name])\n\n    if (asked.length) {\n      asked.forEach((sorting: any, at: number) => {\n        const direction = sorting.desc ? 'DESC' : 'ASC'\n        at === 0 ? query.orderBy(ORDERABLE[sorting.name], direction) : query.addOrderBy(ORDERABLE[sorting.name], direction)\n      })\n    } else {\n      /* Nobody has hung it anywhere — the most common unfinished state, so it comes first. */\n      query.orderBy('assignmentCount', 'ASC').addOrderBy('board.name', 'ASC')\n    }\n\n    const total = await query.getCount()\n    const rows = await query\n      .offset((page - 1) * limit)\n      .limit(limit)\n      .getRawMany()\n\n    /**\n     * Raw rows carry whatever the driver returns, and sqlite returns a datetime as the string it\n     * stored — `2026-09-09 05:25:16`, which the `DateTime` scalar refuses [seen 2026-09-09]. TypeORM\n     * writes those in UTC, so that is how they are read back; a driver that already hands over a\n     * `Date` passes straight through.\n     */\n    const asDate = (value: unknown): Date | undefined => {\n      if (!value) return undefined\n      if (value instanceof Date) return value\n\n      const text = String(value)\n\n      return new Date(text.includes('T') || text.endsWith('Z') ? text : `${text.replace(' ', 'T')}Z`)\n    }\n\n    const contextPath = getContextPath(domain)\n\n    return {\n      total,\n      items: rows.map(row => ({\n        boardId: row.boardId,\n        name: row.name,\n        description: row.description,\n        thumbnailPath: `/${contextPath}station-screen-thumbnail/${row.boardId}${row.thumbnailUpdatedAt || row.updatedAt ? `?v=${new Date(row.thumbnailUpdatedAt ?? row.updatedAt).getTime()}` : ''}`,\n        state: row.state,\n        updatedAt: asDate(row.updatedAt),\n        assignmentCount: Number(row.assignmentCount ?? 0),\n        /*\n         * Raw rows skip the column transforms, so the stored shapes come back as they are stored:\n         * `simple-array` as a comma-joined string and `simple-json` as text. Converted here rather\n         * than handed to the client as-is.\n         */\n        requires: row.requires ? String(row.requires).split(',').filter(Boolean) : undefined,\n        target: row.target ? JSON.parse(String(row.target)) : undefined,\n        controlled: Boolean(row.controlled)\n      })) as StationScreenCard[]\n    }\n  }\n}\n"]}

package/dist-server/service/station/station-screen-publish-subscriber.d.ts

@@ -0,0 +1,22 @@
+import { EntitySubscriberInterface, InsertEvent, UpdateEvent, EntityManager } from 'typeorm';
+import { Board } from '@things-factory/board-service';
+import { type ReleaseRefusal } from './station-screen-release-gate';
+/** Enforce at persistence, including the common Board release API. Drafts remain editable. */
+export declare class StationScreenPublishSubscriber implements EntitySubscriberInterface<Board> {
+    listenTo(): typeof Board;
+    beforeInsert(event: InsertEvent<Board>): Promise<void>;
+    beforeUpdate(event: UpdateEvent<Board>): Promise<void>;
+}
+/**
+ * 통제 문서로 켠 화면은 **결재받은 그 도안일 때만** 나간다.
+ *
+ * ── 왜 여기인가 ────────────────────────────────────────────────────────────
+ * 위의 흐름 검사와 같은 이유다. board 는 우리 spec 을 모르고, `releaseBoard` 는 board-service 의
+ * 공용 문이다. 저작면에서만 막으면 그 문으로 그냥 나간다.
+ *
+ * ── 왜 boardId 하나로 찾나 ─────────────────────────────────────────────────
+ * 서명 줄의 색인은 `(domain, boardId)` 지만 `boardId` 는 uuid 라 그 자체로 한 화면을 가리킨다.
+ * 구독자가 받는 이벤트에 도메인이 실려 있다는 보장은 없어서, 있을지 없을지 모르는 것으로 범위를
+ * 좁히는 대신 확실한 것 하나로 찾는다. 발행 한 번에 한 번 도는 질의다.
+ */
+export declare function whyNotReleaseBoard(manager: EntityManager, boardId: string | undefined, model: unknown): Promise<ReleaseRefusal | undefined>;