@things-factory/station 10.1.33

package/dist-server/service/station/station-generate.d.ts

@@ -0,0 +1,76 @@
+import type { StationFlow, StationServiceField } from './station-flow.js';
+/**
+ * A station screen from what the factory already declares — **rules, not inference.**
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ## Why a rule generator comes before an AI one
+ *
+ * Filling in a service's required fields is **arithmetic, not judgement**. The equipment is the
+ * station's equipment; the operation is the operation; `status` is what the button means. There is
+ * exactly one right answer and it is derivable, so a model that guesses it can only be right by
+ * accident and wrong without saying so.
+ *
+ * What is left for a sentence in plain language — «검사도 같이 하는 자리다» — is which *services*
+ * belong here. That is the part worth asking a person, or eventually a model, and it is a small
+ * closed choice rather than an open one.
+ *
+ * ## What it leaves out is part of the output
+ *
+ * A generator that quietly omits the inspection step leaves the author thinking they were given
+ * everything. They add it by hand, and it goes to the floor as a box that never fills, because the
+ * equipment has no test specification behind it. So every omission is returned with its reason.
+ *
+ * ## It closes the loop it opens
+ *
+ * `goodCount` has no automatic source — a person types it. The generator is the one creating the
+ * number pad, so it is also the one that can point the argument at it. A generator that produced
+ * the pad and left the wiring undone would hand the author the exact defect this module was built
+ * to warn about.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+/** What the factory says about this station. Gathered by the resolver; this module reads only. */
+export interface StationFacts {
+    equipmentName: string;
+    /** Where it stands. Drawn so an operator can tell one bench from the next. */
+    locationName?: string;
+    /** The operation this bench runs, when the assignment names one. */
+    operationKey?: string;
+    /** ISO 8601, e.g. `PT392S`. Decides how often the screen re-reads. */
+    operationDuration?: string;
+    /** Test specifications the equipment carries. Empty means no inspection step. */
+    testSpecifications: string[];
+    /** Stop reasons this factory declares. Empty means a pause button with no reason to give. */
+    stopReasons: string[];
+    /** Whether any job order names this operation. Decides whether order fields are worth drawing. */
+    hasJobOrders: boolean;
+    /** Every service a step could call, with its fields — the schema's own list. */
+    services: {
+        name: string;
+        fields: StationServiceField[];
+    }[];
+}
+/** Something the generator did not put in, and why. The screen says it in the reader's language. */
+export interface StationOmission {
+    code: string;
+    params?: Record<string, string>;
+    /** The same thing in Korean, for logs and the scenario tool. */
+    says: string;
+}
+export interface StationGenerated {
+    flow: StationFlow;
+    omitted: StationOmission[];
+}
+export declare function generateFlow(facts: StationFacts): StationGenerated;
+/**
+ * How often to re-read, from how long the work takes.
+ *
+ * ── Why not one number for everybody ─────────────────────────────────────
+ * A 30-second cut and a 392-second assembly are different screens. Reading every 5 seconds at the
+ * assembly bench is forty pointless round trips per piece across a plant of twelve benches; reading
+ * every 30 at the cutter means the count is a whole piece behind for most of the cycle.
+ *
+ * Roughly forty reads across one cycle, held between 5 and 60 seconds. The bounds matter more than
+ * the ratio: below 5 the screen is a load generator, above 60 it looks frozen to somebody standing
+ * in front of it.
+ */
+export declare function refreshFor(duration?: string): number;

package/dist-server/service/station/station-generate.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFlow = generateFlow;
+exports.refreshFor = refreshFor;
+const station_argument_sources_js_1 = require("./station-argument-sources.js");
+const GOOD = 'good';
+const SCRAP = 'scrap';
+function generateFlow(facts) {
+    const steps = [];
+    const omitted = [];
+    /*
+     * Who is at the bench, first and always.
+     *
+     * Without it every later fact is unattributed — the counts belong to nobody, and a report filed
+     * that way cannot answer the one question anybody asks it later.
+     */
+    steps.push({ id: 'who', kind: 'scan', label: '작업자' });
+    /* Where am I, and on what. Only axes the facts actually support. */
+    const reads = ['station.equipment'];
+    if (facts.locationName) {
+        reads.push('location.name');
+    }
+    if (facts.hasJobOrders) {
+        reads.push('order.name', 'materialDefinition.name');
+    }
+    else {
+        omitted.push({
+            code: 'text.omitted-order-fields',
+            says: '작업지시 칸을 넣지 않았습니다 — 이 공정에 걸린 작업지시가 아직 없습니다'
+        });
+    }
+    steps.push({ id: 'here', kind: 'show', label: '지금 이 자리', reads });
+    /* The two counts. Both are `notable` on a production report, and neither has an automatic source. */
+    steps.push({ id: GOOD, kind: 'enter', label: '양품 수' });
+    steps.push({ id: SCRAP, kind: 'enter', label: '불량 수' });
+    const report = facts.services.find(one => one.name === 'reportProduction');
+    steps.push({ id: 'start', kind: 'run', label: '시작', action: 'start' });
+    if (report) {
+        steps.push({
+            id: 'finish',
+            action: 'finish',
+            kind: 'run',
+            label: '완료',
+            service: report,
+            arguments: wire(report.fields, { goodCount: GOOD, nonconformingCount: SCRAP })
+        });
+        /*
+         * `materialActual` is left alone on purpose. What went in and how much is a recipe's business,
+         * and guessing it from an equipment declaration would put a box on the screen that an operator
+         * has to fill from memory.
+         */
+        if (report.fields.some(field => field.name === 'materialActual')) {
+            omitted.push({
+                code: 'text.omitted-material-actual',
+                says: '자재 실적을 넣지 않았습니다 — 무엇이 얼마나 들어갔는지는 레시피가 정하는 것이라 설비 선언에서 끌어올 수 없습니다'
+            });
+        }
+    }
+    else {
+        /* No production report service at all is a broken catalogue, not an ordinary omission. */
+        omitted.push({
+            code: 'text.omitted-no-report-service',
+            says: '완료 단추가 아무것도 기록하지 않습니다 — reportProduction 을 카탈로그에서 못 찾았습니다'
+        });
+        steps.push({ id: 'finish', kind: 'run', label: '완료', action: 'finish' });
+    }
+    /* Stopping, and saying why. A pause button with no reason to give records nothing useful. */
+    const stopping = facts.services.find(one => one.name === 'recordEquipmentStatePeriod');
+    if (stopping && facts.stopReasons.length) {
+        steps.push({
+            id: 'pause',
+            action: 'pause',
+            kind: 'run',
+            label: '일시정지',
+            service: stopping,
+            arguments: wire(stopping.fields, {})
+        });
+    }
+    else if (!facts.stopReasons.length) {
+        omitted.push({
+            code: 'text.omitted-no-stop-reasons',
+            says: '일시정지 단추를 넣지 않았습니다 — 이 공장에 정지 사유가 하나도 선언되어 있지 않습니다'
+        });
+    }
+    /*
+     * Inspection, and **only when there is one answer to which specification.**
+     *
+     * `specId` is required and there is no context axis for it — a bench does not carry "the
+     * current test spec" the way it carries its own name. It comes from the equipment declaration,
+     * which is known here and nowhere later, so it is written down as a fixed value.
+     *
+     * With two or more declared, no rule can pick. Generating the step anyway would hand over a
+     * button that fails when pressed; generating it without `specId` would hand over the exact
+     * defect this module exists to warn about. So it is left out and said out loud.
+     *
+     * This is why the generator is run end to end and not only unit tested: the first fixture here
+     * had no `specId` in it, and every test was green while the real thing produced a broken step.
+     */
+    const inspection = facts.services.find(one => one.name === 'recordInspectionResult');
+    const specs = facts.testSpecifications;
+    if (!specs.length) {
+        omitted.push({
+            code: 'text.omitted-no-test-spec',
+            params: { equipment: facts.equipmentName },
+            says: `검사 단계를 넣지 않았습니다 — ${facts.equipmentName} 에 검사 명세가 붙어 있지 않습니다`
+        });
+    }
+    else if (specs.length > 1) {
+        omitted.push({
+            code: 'text.omitted-many-test-specs',
+            params: { equipment: facts.equipmentName, specs: specs.join(' · ') },
+            says: `검사 단계를 넣지 않았습니다 — ${facts.equipmentName} 에 검사 명세가 ${specs.length}개(${specs.join(' · ')})라 어느 것인지 규칙으로 정할 수 없습니다`
+        });
+    }
+    else if (inspection) {
+        /* 검사 기록 mutation을 보내는 런타임은 아직 없다. 실적으로 대신 기록하지 않는다. */
+        omitted.push({
+            code: 'text.omitted-no-inspection-runtime',
+            says: '검사 단계를 넣지 않았습니다 — 검사 기록 실행 연결이 아직 구현되지 않았습니다'
+        });
+    }
+    /* Not drawn. How often the screen re-reads — computed from how long the work takes. */
+    steps.push({ id: 'settings', kind: 'settings', refreshSeconds: refreshFor(facts.operationDuration) });
+    return { flow: { steps }, omitted };
+}
+/**
+ * Fill in every argument that has one right answer, and point the rest at the steps we just made.
+ *
+ * A field with no suggestion and no step to take it from is left unset **on purpose** — that is
+ * exactly the state `checkFlow` names, and inventing a value here would silence a warning by
+ * making it untrue rather than by fixing it.
+ */
+function wire(fields, fromSteps) {
+    const wired = {};
+    for (const field of fields) {
+        const entry = fromSteps[field.name];
+        if (entry) {
+            wired[field.name] = { from: 'input', stepId: entry };
+            continue;
+        }
+        const suggested = (0, station_argument_sources_js_1.suggestSource)(field.name);
+        if (suggested) {
+            wired[field.name] = suggested;
+        }
+    }
+    return wired;
+}
+/**
+ * How often to re-read, from how long the work takes.
+ *
+ * ── Why not one number for everybody ─────────────────────────────────────
+ * A 30-second cut and a 392-second assembly are different screens. Reading every 5 seconds at the
+ * assembly bench is forty pointless round trips per piece across a plant of twelve benches; reading
+ * every 30 at the cutter means the count is a whole piece behind for most of the cycle.
+ *
+ * Roughly forty reads across one cycle, held between 5 and 60 seconds. The bounds matter more than
+ * the ratio: below 5 the screen is a load generator, above 60 it looks frozen to somebody standing
+ * in front of it.
+ */
+function refreshFor(duration) {
+    const seconds = secondsOf(duration);
+    if (!seconds) {
+        return 10;
+    }
+    return Math.min(60, Math.max(5, Math.round(seconds / 40)));
+}
+/** `PT392S` · `PT7M30S` · `PT1H` → seconds. Anything else → nothing, and the caller uses its default. */
+function secondsOf(duration) {
+    if (!duration) {
+        return undefined;
+    }
+    const said = /^PT(?:(\d+(?:\.\d+)?)H)?(?:(\d+(?:\.\d+)?)M)?(?:(\d+(?:\.\d+)?)S)?$/.exec(duration.trim().toUpperCase());
+    if (!said || (!said[1] && !said[2] && !said[3])) {
+        return undefined;
+    }
+    return Number(said[1] ?? 0) * 3600 + Number(said[2] ?? 0) * 60 + Number(said[3] ?? 0);
+}
+//# sourceMappingURL=station-generate.js.map

package/dist-server/service/station/station-generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-generate.js","sourceRoot":"","sources":["../../../server/service/station/station-generate.ts"],"names":[],"mappings":"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","sourcesContent":["import { suggestSource } from './station-argument-sources.js'\nimport type { StationArgumentSource, StationFlow, StationServiceField, StationStep } from './station-flow.js'\n\n/**\n * A station screen from what the factory already declares — **rules, not inference.**\n *\n * ═══════════════════════════════════════════════════════════════════════════\n * ## Why a rule generator comes before an AI one\n *\n * Filling in a service's required fields is **arithmetic, not judgement**. The equipment is the\n * station's equipment; the operation is the operation; `status` is what the button means. There is\n * exactly one right answer and it is derivable, so a model that guesses it can only be right by\n * accident and wrong without saying so.\n *\n * What is left for a sentence in plain language — «검사도 같이 하는 자리다» — is which *services*\n * belong here. That is the part worth asking a person, or eventually a model, and it is a small\n * closed choice rather than an open one.\n *\n * ## What it leaves out is part of the output\n *\n * A generator that quietly omits the inspection step leaves the author thinking they were given\n * everything. They add it by hand, and it goes to the floor as a box that never fills, because the\n * equipment has no test specification behind it. So every omission is returned with its reason.\n *\n * ## It closes the loop it opens\n *\n * `goodCount` has no automatic source — a person types it. The generator is the one creating the\n * number pad, so it is also the one that can point the argument at it. A generator that produced\n * the pad and left the wiring undone would hand the author the exact defect this module was built\n * to warn about.\n * ═══════════════════════════════════════════════════════════════════════════\n */\n\n/** What the factory says about this station. Gathered by the resolver; this module reads only. */\nexport interface StationFacts {\n  equipmentName: string\n  /** Where it stands. Drawn so an operator can tell one bench from the next. */\n  locationName?: string\n  /** The operation this bench runs, when the assignment names one. */\n  operationKey?: string\n  /** ISO 8601, e.g. `PT392S`. Decides how often the screen re-reads. */\n  operationDuration?: string\n  /** Test specifications the equipment carries. Empty means no inspection step. */\n  testSpecifications: string[]\n  /** Stop reasons this factory declares. Empty means a pause button with no reason to give. */\n  stopReasons: string[]\n  /** Whether any job order names this operation. Decides whether order fields are worth drawing. */\n  hasJobOrders: boolean\n  /** Every service a step could call, with its fields — the schema's own list. */\n  services: { name: string; fields: StationServiceField[] }[]\n}\n\n/** Something the generator did not put in, and why. The screen says it in the reader's language. */\nexport interface StationOmission {\n  code: string\n  params?: Record<string, string>\n  /** The same thing in Korean, for logs and the scenario tool. */\n  says: string\n}\n\nexport interface StationGenerated {\n  flow: StationFlow\n  omitted: StationOmission[]\n}\n\nconst GOOD = 'good'\nconst SCRAP = 'scrap'\n\nexport function generateFlow(facts: StationFacts): StationGenerated {\n  const steps: StationStep[] = []\n  const omitted: StationOmission[] = []\n\n  /*\n   * Who is at the bench, first and always.\n   *\n   * Without it every later fact is unattributed — the counts belong to nobody, and a report filed\n   * that way cannot answer the one question anybody asks it later.\n   */\n  steps.push({ id: 'who', kind: 'scan', label: '작업자' })\n\n  /* Where am I, and on what. Only axes the facts actually support. */\n  const reads = ['station.equipment']\n\n  if (facts.locationName) {\n    reads.push('location.name')\n  }\n\n  if (facts.hasJobOrders) {\n    reads.push('order.name', 'materialDefinition.name')\n  } else {\n    omitted.push({\n      code: 'text.omitted-order-fields',\n      says: '작업지시 칸을 넣지 않았습니다 — 이 공정에 걸린 작업지시가 아직 없습니다'\n    })\n  }\n\n  steps.push({ id: 'here', kind: 'show', label: '지금 이 자리', reads })\n\n  /* The two counts. Both are `notable` on a production report, and neither has an automatic source. */\n  steps.push({ id: GOOD, kind: 'enter', label: '양품 수' })\n  steps.push({ id: SCRAP, kind: 'enter', label: '불량 수' })\n\n  const report = facts.services.find(one => one.name === 'reportProduction')\n\n  steps.push({ id: 'start', kind: 'run', label: '시작', action: 'start' })\n\n  if (report) {\n    steps.push({\n      id: 'finish',\n      action: 'finish',\n      kind: 'run',\n      label: '완료',\n      service: report,\n      arguments: wire(report.fields, { goodCount: GOOD, nonconformingCount: SCRAP })\n    })\n\n    /*\n     * `materialActual` is left alone on purpose. What went in and how much is a recipe's business,\n     * and guessing it from an equipment declaration would put a box on the screen that an operator\n     * has to fill from memory.\n     */\n    if (report.fields.some(field => field.name === 'materialActual')) {\n      omitted.push({\n        code: 'text.omitted-material-actual',\n        says: '자재 실적을 넣지 않았습니다 — 무엇이 얼마나 들어갔는지는 레시피가 정하는 것이라 설비 선언에서 끌어올 수 없습니다'\n      })\n    }\n  } else {\n    /* No production report service at all is a broken catalogue, not an ordinary omission. */\n    omitted.push({\n      code: 'text.omitted-no-report-service',\n      says: '완료 단추가 아무것도 기록하지 않습니다 — reportProduction 을 카탈로그에서 못 찾았습니다'\n    })\n\n    steps.push({ id: 'finish', kind: 'run', label: '완료', action: 'finish' })\n  }\n\n  /* Stopping, and saying why. A pause button with no reason to give records nothing useful. */\n  const stopping = facts.services.find(one => one.name === 'recordEquipmentStatePeriod')\n\n  if (stopping && facts.stopReasons.length) {\n    steps.push({\n      id: 'pause',\n      action: 'pause',\n      kind: 'run',\n      label: '일시정지',\n      service: stopping,\n      arguments: wire(stopping.fields, {})\n    })\n  } else if (!facts.stopReasons.length) {\n    omitted.push({\n      code: 'text.omitted-no-stop-reasons',\n      says: '일시정지 단추를 넣지 않았습니다 — 이 공장에 정지 사유가 하나도 선언되어 있지 않습니다'\n    })\n  }\n\n  /*\n   * Inspection, and **only when there is one answer to which specification.**\n   *\n   * `specId` is required and there is no context axis for it — a bench does not carry \"the\n   * current test spec\" the way it carries its own name. It comes from the equipment declaration,\n   * which is known here and nowhere later, so it is written down as a fixed value.\n   *\n   * With two or more declared, no rule can pick. Generating the step anyway would hand over a\n   * button that fails when pressed; generating it without `specId` would hand over the exact\n   * defect this module exists to warn about. So it is left out and said out loud.\n   *\n   * This is why the generator is run end to end and not only unit tested: the first fixture here\n   * had no `specId` in it, and every test was green while the real thing produced a broken step.\n   */\n  const inspection = facts.services.find(one => one.name === 'recordInspectionResult')\n  const specs = facts.testSpecifications\n\n  if (!specs.length) {\n    omitted.push({\n      code: 'text.omitted-no-test-spec',\n      params: { equipment: facts.equipmentName },\n      says: `검사 단계를 넣지 않았습니다 — ${facts.equipmentName} 에 검사 명세가 붙어 있지 않습니다`\n    })\n  } else if (specs.length > 1) {\n    omitted.push({\n      code: 'text.omitted-many-test-specs',\n      params: { equipment: facts.equipmentName, specs: specs.join(' · ') },\n      says: `검사 단계를 넣지 않았습니다 — ${facts.equipmentName} 에 검사 명세가 ${specs.length}개(${specs.join(' · ')})라 어느 것인지 규칙으로 정할 수 없습니다`\n    })\n  } else if (inspection) {\n    /* 검사 기록 mutation을 보내는 런타임은 아직 없다. 실적으로 대신 기록하지 않는다. */\n    omitted.push({\n      code: 'text.omitted-no-inspection-runtime',\n      says: '검사 단계를 넣지 않았습니다 — 검사 기록 실행 연결이 아직 구현되지 않았습니다'\n    })\n  }\n\n  /* Not drawn. How often the screen re-reads — computed from how long the work takes. */\n  steps.push({ id: 'settings', kind: 'settings', refreshSeconds: refreshFor(facts.operationDuration) })\n\n  return { flow: { steps }, omitted }\n}\n\n/**\n * Fill in every argument that has one right answer, and point the rest at the steps we just made.\n *\n * A field with no suggestion and no step to take it from is left unset **on purpose** — that is\n * exactly the state `checkFlow` names, and inventing a value here would silence a warning by\n * making it untrue rather than by fixing it.\n */\nfunction wire(fields: StationServiceField[], fromSteps: Record<string, string>): Record<string, StationArgumentSource> {\n  const wired: Record<string, StationArgumentSource> = {}\n\n  for (const field of fields) {\n    const entry = fromSteps[field.name]\n\n    if (entry) {\n      wired[field.name] = { from: 'input', stepId: entry }\n      continue\n    }\n\n    const suggested = suggestSource(field.name)\n\n    if (suggested) {\n      wired[field.name] = suggested\n    }\n  }\n\n  return wired\n}\n\n/**\n * How often to re-read, from how long the work takes.\n *\n * ── Why not one number for everybody ─────────────────────────────────────\n * A 30-second cut and a 392-second assembly are different screens. Reading every 5 seconds at the\n * assembly bench is forty pointless round trips per piece across a plant of twelve benches; reading\n * every 30 at the cutter means the count is a whole piece behind for most of the cycle.\n *\n * Roughly forty reads across one cycle, held between 5 and 60 seconds. The bounds matter more than\n * the ratio: below 5 the screen is a load generator, above 60 it looks frozen to somebody standing\n * in front of it.\n */\nexport function refreshFor(duration?: string): number {\n  const seconds = secondsOf(duration)\n\n  if (!seconds) {\n    return 10\n  }\n\n  return Math.min(60, Math.max(5, Math.round(seconds / 40)))\n}\n\n/** `PT392S` · `PT7M30S` · `PT1H` → seconds. Anything else → nothing, and the caller uses its default. */\nfunction secondsOf(duration?: string): number | undefined {\n  if (!duration) {\n    return undefined\n  }\n\n  const said = /^PT(?:(\\d+(?:\\.\\d+)?)H)?(?:(\\d+(?:\\.\\d+)?)M)?(?:(\\d+(?:\\.\\d+)?)S)?$/.exec(duration.trim().toUpperCase())\n\n  if (!said || (!said[1] && !said[2] && !said[3])) {\n    return undefined\n  }\n\n  return Number(said[1] ?? 0) * 3600 + Number(said[2] ?? 0) * 60 + Number(said[3] ?? 0)\n}\n"]}

package/dist-server/service/station/station-product.d.ts

@@ -0,0 +1,123 @@
+import type { EntityManager } from 'typeorm';
+import type { Domain } from '@things-factory/shell';
+import type { StationAssignmentSituation } from './station-assignment-choice.js';
+import type { StationServiceField } from './station-flow.js';
+/**
+ * What a product has to say before the station machinery will run for it (ADR-0083 decision 2).
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ## Why this file exists
+ *
+ * The station machinery is going to `@things-factory/station`, where operato-warehouse, and later
+ * a yard and an energy product, will use the same authoring, the same flow model and the same
+ * release approval. Nothing of that is about a factory. What *is* about a factory is small: which
+ * values a screen may read, which mutations a step may call, who signs a release, and where those
+ * values actually come from.
+ *
+ * This is that boundary, drawn **before** anything moves. Splitting while moving would leave the
+ * first failure unattributable — was it the split or the move? — which is the order ADR-0078 used
+ * when it lifted the outbox judgement out one layer at a time.
+ *
+ * ## Declared, never defaulted
+ *
+ * A product that has not declared gets an error naming what is missing, not an empty list. A
+ * default here would mean a warehouse screen quietly offering a factory's mutations, or offering
+ * none and reading as "this product has no services" — the silent empty this codebase keeps
+ * finding. The same reason `registerWorkDoors` has no default door list.
+ *
+ * ## The assignment columns are the standard's general words (ADR-0083 decision 5)
+ *
+ * They used to be a factory's: `productionLineName` became `workCenterName` because the contract
+ * already says `WorkCenter` is the general term over `ProcessCell` · `ProductionLine` ·
+ * `ProductionUnit` · `StorageZone`. A warehouse zone and a yard block have somewhere to stand now.
+ * `routeKey` and `operationKey` stay — a warehouse has a picking route too. No union of both
+ * spellings: that would grow four products every time an axis is added.
+ * ═══════════════════════════════════════════════════════════════════════════
+ */
+/** Something a station step can call. The product owns the list; the machinery reads the shape. */
+export interface StationServiceDeclaration {
+    /** The mutation name, exactly as the schema spells it. */
+    name: string;
+    /** What an author is doing when they pick this — their words, not the mutation's. */
+    describes: string;
+    /** The `@InputType` whose fields this call takes. */
+    input: Function;
+    /**
+     * Nullable fields that still must not be left empty.
+     *
+     * Absent means "nobody wrote it down", not zero — and the two are different facts on a
+     * production report.
+     */
+    notable?: string[];
+}
+/**
+ * The facts this product knows about one station, in the words assignment selects on.
+ *
+ * The machinery reads what the platform owns (the equipment and its classes) itself. This answers
+ * only what the product's own domain knows — for a factory, which line it stands on and what the
+ * order running there is made of.
+ */
+export type StationGroundReader = (manager: EntityManager, domain: Domain, stationName: string, at?: {
+    operationKey?: string;
+    operatorName?: string;
+    jobOrderName?: string;
+}) => Promise<Pick<StationAssignmentSituation, 'workCenterName' | 'routeKey' | 'materialClassIds' | 'personnelClassIds'>>;
+/**
+ * 기계가 만든 변경 목록을 제품의 이력으로 보내는 자리 (ADR-0083 결정 7, 선언 다섯).
+ *
+ * **무엇이 바뀌었는지는 기계가 만든다** — 자기 엔티티를 자기가 안다. 화면 정의가 지워질 때 어느 칸이
+ * 무엇이었는지는 `deletionChanges` 가 이 모듈 안에서 만든다.
+ *
+ * **그것이 어느 이력으로 가는지는 제품이 정한다.** plant 는 `fact-change` 로 보내고, 창고는 자기
+ * 이력을 갖는다. 그 표와 그 낱말(`source` 같은 것)은 제품의 것이라 모듈이 알 까닭이 없다.
+ *
+ * 필수다. 선언하지 않으면 통제 문서를 지운 이력이 **오류 없이 안 남는다** — 통제 문서에서 그것은
+ * 「누가 언제 무엇을 지웠나」를 못 답하는 것이고, 감사에서 드러날 때는 이미 늦다.
+ */
+export type StationChangeRecorder = (manager: EntityManager, domain: Domain, what: {
+    factKind: string;
+    factName: string;
+    changes: {
+        field: string;
+        fromValue?: string;
+        toValue?: string;
+    }[];
+    at?: Date;
+}, by: {
+    user?: unknown;
+    /** 결재를 지나 온 것이면 그 건. 누가 승인했는지는 워크리스트가 들고 이것으로 찾아간다. */
+    activityInstanceId?: string;
+}) => Promise<unknown>;
+export interface StationProduct {
+    /** For the message when something is missing — the product says its own name. */
+    product: string;
+    services: StationServiceDeclaration[];
+    readGround: StationGroundReader;
+    recordChange: StationChangeRecorder;
+}
+/**
+ * Called once at boot, from the product's own declaration file.
+ *
+ * 빠진 자리를 여기서 잡는다. 타입이 이미 다섯을 다 요구하지만 서버 쪽은 `strict: false` 로 돌고
+ * 선언 파일에 `as any` 가 한 번 끼면 타입이 못 막는다. 그때 빠진 자리는 **부를 때**에야 드러나고,
+ * 그 자리가 `recordChange` 면 통제 문서를 지운 이력이 오류 없이 안 남는다 — 기동 때 말하는 쪽이
+ * 낫다(ADR-0083 결정 2 「선언은 필수이고 모듈에 기본값은 없다」).
+ */
+export declare function declareStationProduct(product: StationProduct): void;
+/**
+ * What the product declared — **or an error saying it has not.**
+ *
+ * Reading this before the declaration is loaded is a wiring mistake and shows as one. Answering
+ * with an empty product instead would draw a screen with no services on it and no reason given.
+ */
+export declare function stationProduct(): StationProduct;
+/** Tests only — a declaration is meant to be made once, at boot. */
+export declare function forgetStationProduct(): void;
+/**
+ * The fields of one service, as the running schema has them.
+ *
+ * Reads type-graphql's own metadata rather than issuing an introspection query: it is the same
+ * declaration the schema is built from, it needs no round trip, and it works before the server
+ * has finished starting.
+ */
+export declare function fieldsOfService(declared: StationServiceDeclaration): StationServiceField[];

package/dist-server/service/station/station-product.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.declareStationProduct = declareStationProduct;
+exports.stationProduct = stationProduct;
+exports.forgetStationProduct = forgetStationProduct;
+exports.fieldsOfService = fieldsOfService;
+const type_graphql_1 = require("type-graphql");
+let declared;
+/**
+ * Called once at boot, from the product's own declaration file.
+ *
+ * 빠진 자리를 여기서 잡는다. 타입이 이미 다섯을 다 요구하지만 서버 쪽은 `strict: false` 로 돌고
+ * 선언 파일에 `as any` 가 한 번 끼면 타입이 못 막는다. 그때 빠진 자리는 **부를 때**에야 드러나고,
+ * 그 자리가 `recordChange` 면 통제 문서를 지운 이력이 오류 없이 안 남는다 — 기동 때 말하는 쪽이
+ * 낫다(ADR-0083 결정 2 「선언은 필수이고 모듈에 기본값은 없다」).
+ */
+function declareStationProduct(product) {
+    const missing = ['services', 'readGround', 'recordChange'].filter(one => !product?.[one]);
+    if (missing.length) {
+        throw new Error(`station: ${product?.product ?? '이 제품'} 의 선언에 ${missing.join(' · ')} 이(가) 없습니다 — 현장 화면이 서려면 다 채워야 합니다.`);
+    }
+    declared = product;
+}
+/**
+ * What the product declared — **or an error saying it has not.**
+ *
+ * Reading this before the declaration is loaded is a wiring mistake and shows as one. Answering
+ * with an empty product instead would draw a screen with no services on it and no reason given.
+ */
+function stationProduct() {
+    if (!declared) {
+        throw new Error('station: 이 제품이 선언을 하지 않았습니다 — 서비스 목록 · 바탕을 읽는 자리 · 기록을 남기는 자리를 declareStationProduct 로 등록해야 현장 화면이 섭니다.');
+    }
+    return declared;
+}
+/** Tests only — a declaration is meant to be made once, at boot. */
+function forgetStationProduct() {
+    declared = undefined;
+}
+/**
+ * The fields of one service, as the running schema has them.
+ *
+ * Reads type-graphql's own metadata rather than issuing an introspection query: it is the same
+ * declaration the schema is built from, it needs no round trip, and it works before the server
+ * has finished starting.
+ */
+function fieldsOfService(declared) {
+    const storage = (0, type_graphql_1.getMetadataStorage)();
+    const notable = new Set(declared.notable ?? []);
+    /*
+     * Fields are stored against the class, and a class that extends another has its parent's fields
+     * under the parent's target. Walking the prototype chain keeps an inherited field from going
+     * missing — which would look exactly like the schema not having it.
+     */
+    const targets = new Set();
+    for (let at = declared.input; at && at !== Function.prototype; at = Object.getPrototypeOf(at)) {
+        targets.add(at);
+    }
+    return storage.fields
+        .filter(field => targets.has(field.target))
+        .map(field => ({
+        name: field.name,
+        required: !field.typeOptions?.nullable,
+        /*
+         * The description the field's own owner wrote.
+         *
+         * `goodCount` on a screen is a raw schema name to a plant manager. The input type already
+         * carries `@Field({ description })` for many of them — the person who added the field is the
+         * one who can say what it means, and they already did. Carrying it through beats a second
+         * table here that goes stale the day a field is added: a field with no description shows its
+         * name, which is what happened anyway before.
+         */
+        ...(field.description ? { describes: field.description } : {}),
+        ...(notable.has(field.name) ? { notable: true } : {})
+    }));
+}
+//# sourceMappingURL=station-product.js.map

package/dist-server/service/station/station-product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-product.js","sourceRoot":"","sources":["../../../server/service/station/station-product.ts"],"names":[],"mappings":";;AAqHA,sDAUC;AAQD,wCAQC;AAGD,oDAEC;AASD,0CAgCC;AA7LD,+CAAiD;AA2GjD,IAAI,QAAoC,CAAA;AAExC;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CAAC,OAAuB;IAC3D,MAAM,OAAO,GAAI,CAAC,UAAU,EAAE,YAAY,EAAE,cAAc,CAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAEpG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,EAAE,OAAO,IAAI,MAAM,UAAU,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,oCAAoC,CACxG,CAAA;IACH,CAAC;IAED,QAAQ,GAAG,OAAO,CAAA;AACpB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc;IAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAA;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,oEAAoE;AACpE,SAAgB,oBAAoB;IAClC,QAAQ,GAAG,SAAS,CAAA;AACtB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,QAAmC;IACjE,MAAM,OAAO,GAAG,IAAA,iCAAkB,GAAE,CAAA;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;IAE/C;;;;OAIG;IACH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAY,CAAA;IAEnC,KAAK,IAAI,EAAE,GAAoB,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,QAAQ,CAAC,SAAS,EAAE,EAAE,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/G,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,OAAO,CAAC,MAAM;SAClB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAkB,CAAC,CAAC;SACtD,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ;QACtC;;;;;;;;WAQG;QACH,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC,CAAA;AACP,CAAC","sourcesContent":["import { getMetadataStorage } from 'type-graphql'\nimport type { EntityManager } from 'typeorm'\nimport type { Domain } from '@things-factory/shell'\n\nimport type { StationAssignmentSituation } from './station-assignment-choice.js'\nimport type { StationServiceField } from './station-flow.js'\n\n/**\n * What a product has to say before the station machinery will run for it (ADR-0083 decision 2).\n *\n * ═══════════════════════════════════════════════════════════════════════════\n * ## Why this file exists\n *\n * The station machinery is going to `@things-factory/station`, where operato-warehouse, and later\n * a yard and an energy product, will use the same authoring, the same flow model and the same\n * release approval. Nothing of that is about a factory. What *is* about a factory is small: which\n * values a screen may read, which mutations a step may call, who signs a release, and where those\n * values actually come from.\n *\n * This is that boundary, drawn **before** anything moves. Splitting while moving would leave the\n * first failure unattributable — was it the split or the move? — which is the order ADR-0078 used\n * when it lifted the outbox judgement out one layer at a time.\n *\n * ## Declared, never defaulted\n *\n * A product that has not declared gets an error naming what is missing, not an empty list. A\n * default here would mean a warehouse screen quietly offering a factory's mutations, or offering\n * none and reading as \"this product has no services\" — the silent empty this codebase keeps\n * finding. The same reason `registerWorkDoors` has no default door list.\n *\n * ## The assignment columns are the standard's general words (ADR-0083 decision 5)\n *\n * They used to be a factory's: `productionLineName` became `workCenterName` because the contract\n * already says `WorkCenter` is the general term over `ProcessCell` · `ProductionLine` ·\n * `ProductionUnit` · `StorageZone`. A warehouse zone and a yard block have somewhere to stand now.\n * `routeKey` and `operationKey` stay — a warehouse has a picking route too. No union of both\n * spellings: that would grow four products every time an axis is added.\n * ═══════════════════════════════════════════════════════════════════════════\n */\n\n/** Something a station step can call. The product owns the list; the machinery reads the shape. */\nexport interface StationServiceDeclaration {\n  /** The mutation name, exactly as the schema spells it. */\n  name: string\n  /** What an author is doing when they pick this — their words, not the mutation's. */\n  describes: string\n  /** The `@InputType` whose fields this call takes. */\n  input: Function\n  /**\n   * Nullable fields that still must not be left empty.\n   *\n   * Absent means \"nobody wrote it down\", not zero — and the two are different facts on a\n   * production report.\n   */\n  notable?: string[]\n}\n\n/**\n * The facts this product knows about one station, in the words assignment selects on.\n *\n * The machinery reads what the platform owns (the equipment and its classes) itself. This answers\n * only what the product's own domain knows — for a factory, which line it stands on and what the\n * order running there is made of.\n */\nexport type StationGroundReader = (\n  manager: EntityManager,\n  domain: Domain,\n  stationName: string,\n  at?: { operationKey?: string; operatorName?: string; jobOrderName?: string }\n) => Promise<Pick<StationAssignmentSituation, 'workCenterName' | 'routeKey' | 'materialClassIds' | 'personnelClassIds'>>\n\n/**\n * 기계가 만든 변경 목록을 제품의 이력으로 보내는 자리 (ADR-0083 결정 7, 선언 다섯).\n *\n * **무엇이 바뀌었는지는 기계가 만든다** — 자기 엔티티를 자기가 안다. 화면 정의가 지워질 때 어느 칸이\n * 무엇이었는지는 `deletionChanges` 가 이 모듈 안에서 만든다.\n *\n * **그것이 어느 이력으로 가는지는 제품이 정한다.** plant 는 `fact-change` 로 보내고, 창고는 자기\n * 이력을 갖는다. 그 표와 그 낱말(`source` 같은 것)은 제품의 것이라 모듈이 알 까닭이 없다.\n *\n * 필수다. 선언하지 않으면 통제 문서를 지운 이력이 **오류 없이 안 남는다** — 통제 문서에서 그것은\n * 「누가 언제 무엇을 지웠나」를 못 답하는 것이고, 감사에서 드러날 때는 이미 늦다.\n */\nexport type StationChangeRecorder = (\n  manager: EntityManager,\n  domain: Domain,\n  what: {\n    factKind: string\n    factName: string\n    changes: { field: string; fromValue?: string; toValue?: string }[]\n    at?: Date\n  },\n  by: {\n    user?: unknown\n    /** 결재를 지나 온 것이면 그 건. 누가 승인했는지는 워크리스트가 들고 이것으로 찾아간다. */\n    activityInstanceId?: string\n  }\n) => Promise<unknown>\n\nexport interface StationProduct {\n  /** For the message when something is missing — the product says its own name. */\n  product: string\n  services: StationServiceDeclaration[]\n  readGround: StationGroundReader\n  recordChange: StationChangeRecorder\n}\n\nlet declared: StationProduct | undefined\n\n/**\n * Called once at boot, from the product's own declaration file.\n *\n * 빠진 자리를 여기서 잡는다. 타입이 이미 다섯을 다 요구하지만 서버 쪽은 `strict: false` 로 돌고\n * 선언 파일에 `as any` 가 한 번 끼면 타입이 못 막는다. 그때 빠진 자리는 **부를 때**에야 드러나고,\n * 그 자리가 `recordChange` 면 통제 문서를 지운 이력이 오류 없이 안 남는다 — 기동 때 말하는 쪽이\n * 낫다(ADR-0083 결정 2 「선언은 필수이고 모듈에 기본값은 없다」).\n */\nexport function declareStationProduct(product: StationProduct): void {\n  const missing = (['services', 'readGround', 'recordChange'] as const).filter(one => !product?.[one])\n\n  if (missing.length) {\n    throw new Error(\n      `station: ${product?.product ?? '이 제품'} 의 선언에 ${missing.join(' · ')} 이(가) 없습니다 — 현장 화면이 서려면 다 채워야 합니다.`\n    )\n  }\n\n  declared = product\n}\n\n/**\n * What the product declared — **or an error saying it has not.**\n *\n * Reading this before the declaration is loaded is a wiring mistake and shows as one. Answering\n * with an empty product instead would draw a screen with no services on it and no reason given.\n */\nexport function stationProduct(): StationProduct {\n  if (!declared) {\n    throw new Error(\n      'station: 이 제품이 선언을 하지 않았습니다 — 서비스 목록 · 바탕을 읽는 자리 · 기록을 남기는 자리를 declareStationProduct 로 등록해야 현장 화면이 섭니다.'\n    )\n  }\n\n  return declared\n}\n\n/** Tests only — a declaration is meant to be made once, at boot. */\nexport function forgetStationProduct(): void {\n  declared = undefined\n}\n\n/**\n * The fields of one service, as the running schema has them.\n *\n * Reads type-graphql's own metadata rather than issuing an introspection query: it is the same\n * declaration the schema is built from, it needs no round trip, and it works before the server\n * has finished starting.\n */\nexport function fieldsOfService(declared: StationServiceDeclaration): StationServiceField[] {\n  const storage = getMetadataStorage()\n  const notable = new Set(declared.notable ?? [])\n\n  /*\n   * Fields are stored against the class, and a class that extends another has its parent's fields\n   * under the parent's target. Walking the prototype chain keeps an inherited field from going\n   * missing — which would look exactly like the schema not having it.\n   */\n  const targets = new Set<Function>()\n\n  for (let at: Function | null = declared.input; at && at !== Function.prototype; at = Object.getPrototypeOf(at)) {\n    targets.add(at)\n  }\n\n  return storage.fields\n    .filter(field => targets.has(field.target as Function))\n    .map(field => ({\n      name: field.name,\n      required: !field.typeOptions?.nullable,\n      /*\n       * The description the field's own owner wrote.\n       *\n       * `goodCount` on a screen is a raw schema name to a plant manager. The input type already\n       * carries `@Field({ description })` for many of them — the person who added the field is the\n       * one who can say what it means, and they already did. Carrying it through beats a second\n       * table here that goes stale the day a field is added: a field with no description shows its\n       * name, which is what happened anyway before.\n       */\n      ...(field.description ? { describes: field.description } : {}),\n      ...(notable.has(field.name) ? { notable: true } : {})\n    }))\n}\n"]}

package/dist-server/service/station/station-runtime-binding.d.ts

@@ -0,0 +1,6 @@
+import type { StationFlow, StationStep } from './station-flow';
+export type StationRunAction = 'start' | 'finish' | 'pause' | 'resume';
+/** 실행 의미는 표시 이름과 분리한다. 옛 흐름의 명확한 이름만 호환한다. */
+export declare function runAction(step: StationStep): StationRunAction | undefined;
+/** 현 런타임은 good/scrap 두 수량만 가진다. 임의 입력을 양품으로 바꾸지 않는다. */
+export declare function entryCounts(flow: StationFlow, stepId: string): 'good' | 'scrap' | undefined;

package/dist-server/service/station/station-runtime-binding.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAction = runAction;
+exports.entryCounts = entryCounts;
+/** 실행 의미는 표시 이름과 분리한다. 옛 흐름의 명확한 이름만 호환한다. */
+function runAction(step) {
+    if (step.service && !['reportProduction', 'recordEquipmentStatePeriod'].includes(step.service.name))
+        return undefined;
+    const action = step.action ?? legacyAction(step.label);
+    if (step.service?.name === 'recordEquipmentStatePeriod' && action !== 'pause' && action !== 'resume')
+        return undefined;
+    if (step.service?.name === 'reportProduction' && action !== 'start' && action !== 'finish')
+        return undefined;
+    return action;
+}
+function legacyAction(label) {
+    const text = (label ?? '').trim().toLowerCase();
+    if (text === '완료' || text === 'finish')
+        return 'finish';
+    if (text === '일시정지' || text === 'pause')
+        return 'pause';
+    if (text === '재개' || text === 'resume')
+        return 'resume';
+    if (text === '시작' || text === 'start')
+        return 'start';
+}
+/** 현 런타임은 good/scrap 두 수량만 가진다. 임의 입력을 양품으로 바꾸지 않는다. */
+function entryCounts(flow, stepId) {
+    const targets = new Set();
+    for (const step of flow.steps) {
+        for (const [field, source] of Object.entries(step.arguments ?? {})) {
+            if (source.from !== 'input' || source.stepId !== stepId)
+                continue;
+            if (step.service?.name !== 'reportProduction')
+                return undefined;
+            targets.add(field);
+        }
+    }
+    if (targets.size !== 1)
+        return undefined;
+    if (targets.has('goodCount'))
+        return 'good';
+    if (targets.has('nonconformingCount'))
+        return 'scrap';
+}
+//# sourceMappingURL=station-runtime-binding.js.map

package/dist-server/service/station/station-runtime-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-runtime-binding.js","sourceRoot":"","sources":["../../../server/service/station/station-runtime-binding.ts"],"names":[],"mappings":";;AAKA,8BAMC;AAWD,kCAYC;AA9BD,8CAA8C;AAC9C,SAAgB,SAAS,CAAC,IAAiB;IACzC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,kBAAkB,EAAE,4BAA4B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IACrH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACtD,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,4BAA4B,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IACtH,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,kBAAkB,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC5G,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC/C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACvD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACvD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACvD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;AACvD,CAAC;AAED,wDAAwD;AACxD,SAAgB,WAAW,CAAC,IAAiB,EAAE,MAAc;IAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;YACnE,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;gBAAE,SAAQ;YACjE,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,kBAAkB;gBAAE,OAAO,SAAS,CAAA;YAC/D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAA;IAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAAE,OAAO,OAAO,CAAA;AACvD,CAAC","sourcesContent":["import type { StationFlow, StationStep } from './station-flow'\n\nexport type StationRunAction = 'start' | 'finish' | 'pause' | 'resume'\n\n/** 실행 의미는 표시 이름과 분리한다. 옛 흐름의 명확한 이름만 호환한다. */\nexport function runAction(step: StationStep): StationRunAction | undefined {\n  if (step.service && !['reportProduction', 'recordEquipmentStatePeriod'].includes(step.service.name)) return undefined\n  const action = step.action ?? legacyAction(step.label)\n  if (step.service?.name === 'recordEquipmentStatePeriod' && action !== 'pause' && action !== 'resume') return undefined\n  if (step.service?.name === 'reportProduction' && action !== 'start' && action !== 'finish') return undefined\n  return action\n}\n\nfunction legacyAction(label?: string): StationRunAction | undefined {\n  const text = (label ?? '').trim().toLowerCase()\n  if (text === '완료' || text === 'finish') return 'finish'\n  if (text === '일시정지' || text === 'pause') return 'pause'\n  if (text === '재개' || text === 'resume') return 'resume'\n  if (text === '시작' || text === 'start') return 'start'\n}\n\n/** 현 런타임은 good/scrap 두 수량만 가진다. 임의 입력을 양품으로 바꾸지 않는다. */\nexport function entryCounts(flow: StationFlow, stepId: string): 'good' | 'scrap' | undefined {\n  const targets = new Set<string>()\n  for (const step of flow.steps) {\n    for (const [field, source] of Object.entries(step.arguments ?? {})) {\n      if (source.from !== 'input' || source.stepId !== stepId) continue\n      if (step.service?.name !== 'reportProduction') return undefined\n      targets.add(field)\n    }\n  }\n  if (targets.size !== 1) return undefined\n  if (targets.has('goodCount')) return 'good'\n  if (targets.has('nonconformingCount')) return 'scrap'\n}\n"]}