@things-factory/station 10.1.33

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

@@ -0,0 +1,36 @@
+import type { StationFlow } from './station-flow';
+import { StationScreenSpec } from './station-screen-spec';
+export declare class StationScreenSpecInput {
+    boardId: string;
+    requires?: string[];
+    target?: Record<string, unknown>;
+    controlled?: boolean;
+    kind?: 'work' | 'signal';
+    flow?: StationFlow;
+}
+/**
+ * Reading and writing the manufacturing side of a board.
+ *
+ * The drawing stays in board-service; this is only what the drawing needs in order to stand in
+ * front of an operator. Written by the modeller when a screen is saved, read by the assignment
+ * screen and by whoever is deciding whether a release needs approval.
+ */
+export declare class StationScreenSpecResolver {
+    stationScreenSpec(boardId: string, context: any): Promise<StationScreenSpec | null>;
+    /**
+     * Specs for several boards at once.
+     *
+     * The assignment screen needs one per row. Asked one at a time it is a round trip per assignment,
+     * and that list is the screen a plant manager keeps open.
+     */
+    stationScreenSpecs(boardIds: string[], context: any): Promise<StationScreenSpec[]>;
+    /**
+     * Write the spec for a board — one row per board, replaced rather than appended.
+     *
+     * There is no version history here on purpose. The spec describes whatever the board currently
+     * is; the board keeps its own versions, and a spec that drifted from the drawing would answer a
+     * question nobody asked.
+     */
+    saveStationScreenSpec(patch: StationScreenSpecInput, context: any): Promise<StationScreenSpec>;
+    deleteStationScreenSpec(boardId: string, context: any): Promise<boolean>;
+}

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

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StationScreenSpecResolver = exports.StationScreenSpecInput = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const station_flow_1 = require("./station-flow");
+const station_screen_spec_1 = require("./station-screen-spec");
+const station_screen_release_gate_1 = require("./station-screen-release-gate");
+const station_screen_control_withdrawal_1 = require("./station-screen-control-withdrawal");
+const station_screen_control_withdrawal_resolver_1 = require("./station-screen-control-withdrawal-resolver");
+const worklist_1 = require("@things-factory/worklist");
+/**
+ * 통제를 **이 저장으로는** 거둘 수 없다 — 결재로 세운 것은 결재로 거둔다(ADR-0047 ⑨).
+ *
+ * 저장과 삭제는 작성자의 권한(`station:mutation`)으로 열린다. 그 문으로 통제를 끄거나 통제 중인 설정을
+ * 지우면, 발행 관문은 통제가 아닌 화면을 그대로 내보낸다 — 작성자가 서명 없는 판을 내보내는 길이다.
+ * 그래서 이 둘은 막고 「통제 해제 승인」으로 보낸다.
+ */
+function controlWithdrawalNeedsApproval() {
+    return new shell_1.Refusal('control-withdrawal-needs-approval', {}, 'document control can only be removed through a control withdrawal approval.');
+}
+let StationScreenSpecInput = class StationScreenSpecInput {
+};
+exports.StationScreenSpecInput = StationScreenSpecInput;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: "the board's id in board-service" }),
+    tslib_1.__metadata("design:type", String)
+], StationScreenSpecInput.prototype, "boardId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [String], { nullable: true, description: 'station context axes the drawing reads' }),
+    tslib_1.__metadata("design:type", Array)
+], StationScreenSpecInput.prototype, "requires", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], StationScreenSpecInput.prototype, "target", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Boolean)
+], StationScreenSpecInput.prototype, "controlled", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: "'work' or 'signal'" }),
+    tslib_1.__metadata("design:type", String)
+], StationScreenSpecInput.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'the steps, and where each argument comes from' }),
+    tslib_1.__metadata("design:type", Object)
+], StationScreenSpecInput.prototype, "flow", void 0);
+exports.StationScreenSpecInput = StationScreenSpecInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'what a board needs in order to work as a station screen' })
+], StationScreenSpecInput);
+/**
+ * Reading and writing the manufacturing side of a board.
+ *
+ * The drawing stays in board-service; this is only what the drawing needs in order to stand in
+ * front of an operator. Written by the modeller when a screen is saved, read by the assignment
+ * screen and by whoever is deciding whether a release needs approval.
+ */
+let StationScreenSpecResolver = class StationScreenSpecResolver {
+    async stationScreenSpec(boardId, context) {
+        const { domain } = context.state;
+        return await (0, shell_1.getRepository)(station_screen_spec_1.StationScreenSpec).findOne({ where: { domain: { id: domain.id }, boardId } });
+    }
+    /**
+     * Specs for several boards at once.
+     *
+     * The assignment screen needs one per row. Asked one at a time it is a round trip per assignment,
+     * and that list is the screen a plant manager keeps open.
+     */
+    async stationScreenSpecs(boardIds, context) {
+        const { domain } = context.state;
+        if (!boardIds.length) {
+            return [];
+        }
+        return await (0, shell_1.getRepository)(station_screen_spec_1.StationScreenSpec).find({ where: { domain: { id: domain.id }, boardId: (0, typeorm_1.In)(boardIds) } });
+    }
+    /**
+     * Write the spec for a board — one row per board, replaced rather than appended.
+     *
+     * There is no version history here on purpose. The spec describes whatever the board currently
+     * is; the board keeps its own versions, and a spec that drifted from the drawing would answer a
+     * question nobody asked.
+     */
+    async saveStationScreenSpec(patch, context) {
+        const { domain, user, tx } = context.state;
+        const repository = tx.getRepository(station_screen_spec_1.StationScreenSpec);
+        const existing = await repository.findOne({ where: { domain: { id: domain.id }, boardId: patch.boardId } });
+        /*
+         * `requires` 는 **흐름에서 나온다.** 저작자가 따로 적지 않는다 — 손으로 적으면 부품을 고칠 때
+         * 어긋나고, 그러면 배정 검증이 이미 사실이 아닌 것을 검사한다.
+         *
+         * 흐름을 안 보낸 저장(예: `controlled` 만 켜는 것)에서는 손대지 않는다. 그때 다시 계산하면
+         * 이미 있던 축이 빈 흐름 때문에 지워진다.
+         */
+        const derived = patch.flow ? { requires: (0, station_flow_1.axesRead)(patch.flow) } : {};
+        if ((0, station_screen_release_gate_1.turnsControlOn)(existing?.controlled, patch.controlled)) {
+            await refuseControlWithoutApprovers(context);
+        }
+        if ((0, station_screen_control_withdrawal_1.turnsControlOff)(existing?.controlled, patch.controlled)) {
+            throw controlWithdrawalNeedsApproval();
+        }
+        return await repository.save({
+            domain,
+            ...(existing ?? { creator: user }),
+            ...patch,
+            ...derived,
+            updater: user
+        });
+    }
+    async deleteStationScreenSpec(boardId, context) {
+        const { domain, tx } = context.state;
+        const repository = tx.getRepository(station_screen_spec_1.StationScreenSpec);
+        /*
+         * **통제 중인 설정은 여기서 안 지운다.** 지우면 발행 관문이 「통제 아님」으로 읽고 서명 없는 판을
+         * 내보낸다 — 통제를 끄는 것과 같은 일이다(ADR-0047 ⑨). 통제가 아닌 설정은 지금처럼 바로 지운다.
+         */
+        const existing = await repository.findOne({ where: { domain: { id: domain.id }, boardId } });
+        if (existing?.controlled) {
+            throw controlWithdrawalNeedsApproval();
+        }
+        await repository.delete({ domain: { id: domain.id }, boardId });
+        return true;
+    }
+};
+exports.StationScreenSpecResolver = StationScreenSpecResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "station", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => station_screen_spec_1.StationScreenSpec, { nullable: true, description: 'the station spec for one board' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('boardId')),
+    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)
+], StationScreenSpecResolver.prototype, "stationScreenSpec", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "station", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => [station_screen_spec_1.StationScreenSpec], { description: 'station specs for these boards' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('boardIds', type => [String])),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], StationScreenSpecResolver.prototype, "stationScreenSpecs", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "station", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => station_screen_spec_1.StationScreenSpec, { description: 'record what a board needs as a station screen' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('patch', type => StationScreenSpecInput)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [StationScreenSpecInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], StationScreenSpecResolver.prototype, "saveStationScreenSpec", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "station", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, { description: 'forget the station spec for a board' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('boardId')),
+    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)
+], StationScreenSpecResolver.prototype, "deleteStationScreenSpec", null);
+exports.StationScreenSpecResolver = StationScreenSpecResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(station_screen_spec_1.StationScreenSpec),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], StationScreenSpecResolver);
+/**
+ * 통제 문서로 켜려면 **결재할 사람이 실제로 있어야 한다** (ADR-0047 ②).
+ *
+ * ── 왜 못 켜게 하는 쪽인가 ─────────────────────────────────────────────────
+ * 「켜 두되 발행할 때 막는다」도 규칙이 될 수 있었다. 그러면 결재선이 없는 공장에서 켠 화면은 영원히
+ * 발행이 안 되고, 현장이 낼 수 있는 답은 하나뿐이다 — 통제를 끈다. **통제를 위해 넣은 칸이 통제를
+ * 끄는 손잡이가 된다.** 그래서 못 지킬 약속은 애초에 못 켜게 한다.
+ *
+ * ── 왜 서버인가 ────────────────────────────────────────────────────────────
+ * 저작면도 이 판정을 보여 준다. 그러나 **브라우저가 건너뛸 수 있는 검사는 닫힌 것이 아니다** —
+ * `saveStationScreenSpec` 은 공개된 mutation 이라 화면을 거치지 않고 부를 수 있다.
+ *
+ * ── 왜 거절이 셋인가 ───────────────────────────────────────────────────────
+ * 관리자가 할 일이 셋 다 다르다. 결재선을 세우는 것 · 역할에 사람을 넣는 것 · 지목된 사람을 이 공장에
+ * 들이는 것. 하나로 묶으면 무엇을 해야 하는지 말하지 않고 막기만 한다. 그리고 이 말은 화면을 만드는
+ * 저작자가 아니라 **관리자**에게 가야 하는 말이라, 문장이 그렇게 되어 있다.
+ */
+async function refuseControlWithoutApprovers(context) {
+    /* 끌 때(`requestStationScreenControlWithdrawal`)와 **같은 함수로** 판정한다. */
+    const { standing } = await (0, station_screen_control_withdrawal_resolver_1.controlLineStanding)(context);
+    /*
+     * 판정은 **한 객체에 선택 칸**이다 — `refusal` 이 있으면 그 결재선은 안 선다(ADR-0047 ⑤ 개정).
+     * 앞서는 `{ok:true}|{ok:false,…}` union 이었는데 이 패키지의 서버가 `strict: false` 로 컴파일해
+     * **boolean 판별자로 안 좁혀졌고**, 이 자리에서 오늘 서버 빌드가 한 번 섰다. 그때 넓은 타입으로
+     * 받아 두었던 것을 지금 지운다.
+     */
+    if (!standing.refusal) {
+        return;
+    }
+    /* 켤 수 없는 까닭은 결재선이 안 서는 까닭 그대로다 — 관리자가 할 일이 셋 다르다. */
+    throw (0, worklist_1.approvalLineRefusal)(standing.refusal);
+}
+//# sourceMappingURL=station-screen-spec-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"station-screen-spec-resolver.js","sourceRoot":"","sources":["../../../server/service/station/station-screen-spec-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Directive, Field, InputType, Mutation, Query, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { In } from 'typeorm'\n\nimport { ScalarObject, getRepository, Refusal, SpeakRefusals } from '@things-factory/shell'\n\nimport { axesRead } from './station-flow'\nimport type { StationFlow } from './station-flow'\nimport { StationScreenSpec } from './station-screen-spec'\nimport { turnsControlOn } from './station-screen-release-gate'\nimport { turnsControlOff } from './station-screen-control-withdrawal'\nimport { controlLineStanding } from './station-screen-control-withdrawal-resolver'\nimport { approvalLineRefusal } from '@things-factory/worklist'\n\n/**\n * 통제를 **이 저장으로는** 거둘 수 없다 — 결재로 세운 것은 결재로 거둔다(ADR-0047 ⑨).\n *\n * 저장과 삭제는 작성자의 권한(`station:mutation`)으로 열린다. 그 문으로 통제를 끄거나 통제 중인 설정을\n * 지우면, 발행 관문은 통제가 아닌 화면을 그대로 내보낸다 — 작성자가 서명 없는 판을 내보내는 길이다.\n * 그래서 이 둘은 막고 「통제 해제 승인」으로 보낸다.\n */\nfunction controlWithdrawalNeedsApproval(): Refusal {\n  return new Refusal(\n    'control-withdrawal-needs-approval',\n    {},\n    'document control can only be removed through a control withdrawal approval.'\n  )\n}\n\n@InputType({ description: 'what a board needs in order to work as a station screen' })\nexport class StationScreenSpecInput {\n  @Field({ description: \"the board's id in board-service\" })\n  boardId: string\n\n  @Field(type => [String], { nullable: true, description: 'station context axes the drawing reads' })\n  requires?: string[]\n\n  @Field(type => ScalarObject, { nullable: true })\n  target?: Record<string, unknown>\n\n  @Field({ nullable: true })\n  controlled?: boolean\n\n  @Field({ nullable: true, description: \"'work' or 'signal'\" })\n  kind?: 'work' | 'signal'\n\n  @Field(type => ScalarObject, { nullable: true, description: 'the steps, and where each argument comes from' })\n  flow?: StationFlow\n}\n\n/**\n * Reading and writing the manufacturing side of a board.\n *\n * The drawing stays in board-service; this is only what the drawing needs in order to stand in\n * front of an operator. Written by the modeller when a screen is saved, read by the assignment\n * screen and by whoever is deciding whether a release needs approval.\n */\n@Resolver(StationScreenSpec)\n@UseMiddleware(SpeakRefusals)\nexport class StationScreenSpecResolver {\n  @Directive('@privilege(category: \"station\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => StationScreenSpec, { nullable: true, description: 'the station spec for one board' })\n  async stationScreenSpec(@Arg('boardId') boardId: string, @Ctx() context: any): Promise<StationScreenSpec | null> {\n    const { domain } = context.state\n\n    return await getRepository(StationScreenSpec).findOne({ where: { domain: { id: domain.id }, boardId } })\n  }\n\n  /**\n   * Specs for several boards at once.\n   *\n   * The assignment screen needs one per row. Asked one at a time it is a round trip per assignment,\n   * and that list is the screen a plant manager keeps open.\n   */\n  @Directive('@privilege(category: \"station\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [StationScreenSpec], { description: 'station specs for these boards' })\n  async stationScreenSpecs(@Arg('boardIds', type => [String]) boardIds: string[], @Ctx() context: any): Promise<StationScreenSpec[]> {\n    const { domain } = context.state\n\n    if (!boardIds.length) {\n      return []\n    }\n\n    return await getRepository(StationScreenSpec).find({ where: { domain: { id: domain.id }, boardId: In(boardIds) } })\n  }\n\n  /**\n   * Write the spec for a board — one row per board, replaced rather than appended.\n   *\n   * There is no version history here on purpose. The spec describes whatever the board currently\n   * is; the board keeps its own versions, and a spec that drifted from the drawing would answer a\n   * question nobody asked.\n   */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"station\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => StationScreenSpec, { description: 'record what a board needs as a station screen' })\n  async saveStationScreenSpec(@Arg('patch', type => StationScreenSpecInput) patch: StationScreenSpecInput, @Ctx() context: any): Promise<StationScreenSpec> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(StationScreenSpec)\n\n    const existing = await repository.findOne({ where: { domain: { id: domain.id }, boardId: patch.boardId } })\n\n    /*\n     * `requires` 는 **흐름에서 나온다.** 저작자가 따로 적지 않는다 — 손으로 적으면 부품을 고칠 때\n     * 어긋나고, 그러면 배정 검증이 이미 사실이 아닌 것을 검사한다.\n     *\n     * 흐름을 안 보낸 저장(예: `controlled` 만 켜는 것)에서는 손대지 않는다. 그때 다시 계산하면\n     * 이미 있던 축이 빈 흐름 때문에 지워진다.\n     */\n    const derived = patch.flow ? { requires: axesRead(patch.flow) } : {}\n\n    if (turnsControlOn(existing?.controlled, patch.controlled)) {\n      await refuseControlWithoutApprovers(context)\n    }\n\n    if (turnsControlOff(existing?.controlled, patch.controlled)) {\n      throw controlWithdrawalNeedsApproval()\n    }\n\n    return await repository.save({\n      domain,\n      ...(existing ?? { creator: user }),\n      ...patch,\n      ...derived,\n      updater: user\n    })\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"station\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Boolean, { description: 'forget the station spec for a board' })\n  async deleteStationScreenSpec(@Arg('boardId') boardId: string, @Ctx() context: any): Promise<boolean> {\n    const { domain, tx } = context.state\n    const repository = tx.getRepository(StationScreenSpec)\n\n    /*\n     * **통제 중인 설정은 여기서 안 지운다.** 지우면 발행 관문이 「통제 아님」으로 읽고 서명 없는 판을\n     * 내보낸다 — 통제를 끄는 것과 같은 일이다(ADR-0047 ⑨). 통제가 아닌 설정은 지금처럼 바로 지운다.\n     */\n    const existing = await repository.findOne({ where: { domain: { id: domain.id }, boardId } })\n\n    if (existing?.controlled) {\n      throw controlWithdrawalNeedsApproval()\n    }\n\n    await repository.delete({ domain: { id: domain.id }, boardId })\n\n    return true\n  }\n}\n\n/**\n * 통제 문서로 켜려면 **결재할 사람이 실제로 있어야 한다** (ADR-0047 ②).\n *\n * ── 왜 못 켜게 하는 쪽인가 ─────────────────────────────────────────────────\n * 「켜 두되 발행할 때 막는다」도 규칙이 될 수 있었다. 그러면 결재선이 없는 공장에서 켠 화면은 영원히\n * 발행이 안 되고, 현장이 낼 수 있는 답은 하나뿐이다 — 통제를 끈다. **통제를 위해 넣은 칸이 통제를\n * 끄는 손잡이가 된다.** 그래서 못 지킬 약속은 애초에 못 켜게 한다.\n *\n * ── 왜 서버인가 ────────────────────────────────────────────────────────────\n * 저작면도 이 판정을 보여 준다. 그러나 **브라우저가 건너뛸 수 있는 검사는 닫힌 것이 아니다** —\n * `saveStationScreenSpec` 은 공개된 mutation 이라 화면을 거치지 않고 부를 수 있다.\n *\n * ── 왜 거절이 셋인가 ───────────────────────────────────────────────────────\n * 관리자가 할 일이 셋 다 다르다. 결재선을 세우는 것 · 역할에 사람을 넣는 것 · 지목된 사람을 이 공장에\n * 들이는 것. 하나로 묶으면 무엇을 해야 하는지 말하지 않고 막기만 한다. 그리고 이 말은 화면을 만드는\n * 저작자가 아니라 **관리자**에게 가야 하는 말이라, 문장이 그렇게 되어 있다.\n */\nasync function refuseControlWithoutApprovers(context: any): Promise<void> {\n  /* 끌 때(`requestStationScreenControlWithdrawal`)와 **같은 함수로** 판정한다. */\n  const { standing } = await controlLineStanding(context)\n\n  /*\n   * 판정은 **한 객체에 선택 칸**이다 — `refusal` 이 있으면 그 결재선은 안 선다(ADR-0047 ⑤ 개정).\n   * 앞서는 `{ok:true}|{ok:false,…}` union 이었는데 이 패키지의 서버가 `strict: false` 로 컴파일해\n   * **boolean 판별자로 안 좁혀졌고**, 이 자리에서 오늘 서버 빌드가 한 번 섰다. 그때 넓은 타입으로\n   * 받아 두었던 것을 지금 지운다.\n   */\n\n  if (!standing.refusal) {\n    return\n  }\n\n  /* 켤 수 없는 까닭은 결재선이 안 서는 까닭 그대로다 — 관리자가 할 일이 셋 다르다. */\n  throw approvalLineRefusal(standing.refusal)\n}\n"]}

package/dist-server/service/station/station-screen-spec.d.ts

@@ -0,0 +1,104 @@
+import { Domain } from '@things-factory/shell';
+import type { StationFlow } from './station-flow';
+import { User } from '@things-factory/auth-base';
+/**
+ * What a board needs in order to work as a station screen.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ## Why this is beside a board and not instead of one
+ *
+ * The drawing, its versions, releasing and reverting are `Board`'s job and it already does all of
+ * them. This table was very nearly a copy of it under different words — same columns, same verbs —
+ * which would have meant tracking board's fixes forever for no difference.
+ *
+ * What is genuinely ours is not the drawing. It is what the drawing **needs** to be usable in front
+ * of an operator, and that is manufacturing vocabulary that has no business in shared
+ * infrastructure. So it sits here, keyed by the board.
+ *
+ * The monorepo already works this way in both directions: `board-ai` anchors its tables with a
+ * plain `boardId`, and `Board.sourceImportSessionId` is a plain string for the same stated reason —
+ * "모듈 의존을 강제하지 않기 위해 ManyToOne 대신 단순 string id 만 보관".
+ *
+ * ## Why not on the assignment
+ *
+ * An assignment is a pairing: this situation shows that drawing. Everything here is a property of
+ * the **drawing**, so putting it on the assignment would copy it into every assignment pointing at
+ * the same board, let those copies disagree, and ask the person doing the assigning to know things
+ * only the person who drew it knows.
+ */
+export declare class StationScreenSpec {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** The board this describes. One spec per board — a plain id, not a relation. */
+    boardId: string;
+    /**
+     * Which station context axes the drawing reads — `equipment`, `operation`, `workDirective`, …
+     *
+     * Filled by the modeller from the parts actually placed on the board, so it is a fact about the
+     * drawing rather than something someone remembered to type.
+     *
+     * ## What it is for
+     *
+     * A screen that reads `operation` shows nothing useful at a station whose assignment does not
+     * constrain an operation. Today that surfaces as a blank tile on a bench, discovered by whoever
+     * is standing there. With this declared, the assignment screen can say so before saving —
+     * "this screen reads the operation, and this assignment does not pin one".
+     *
+     * This is what makes composing screens with no code safe rather than merely possible.
+     */
+    requires?: string[];
+    /**
+     * What it was drawn for — a bench tablet, a wall andon, a rugged panel.
+     *
+     * Left open on purpose. A shop floor's device mix is not something we can enumerate up front, and
+     * narrowing it here would push whatever we left out into somebody's screen name.
+     */
+    target?: Record<string, unknown>;
+    /**
+     * Whether this screen is a controlled document.
+     *
+     * When it is, releasing it is not one person clicking: a change to what an operator reads off the
+     * screen — a torque figure, a tolerance — has to be reviewed and approved, and the approval has
+     * to be findable afterwards. This package already has that machinery
+     * (`report/disposition-approval-*`); this flag is what sends a release through it.
+     */
+    controlled?: boolean;
+    /**
+     * What this screen is for — **declared, not derived.**
+     *
+     * The rule was going to be "no write step means it is a signal board". An andon's acknowledge is
+     * a write step, so the day somebody can answer a call from the screen, its kind would change with
+     * no error anywhere. A value that decides wiring cannot be a value that flips when somebody edits
+     * an unrelated field [아키텍트 판정 2026-09-10].
+     *
+     * Named for what the screen does, not for how it looks. "Andon" is a presentation and
+     * presentations change; `signal` still describes it when the presentation does not.
+     *
+     * A closed set. Growing it means a new kind of screen exists, which is an architect's call.
+     */
+    kind?: 'work' | 'signal';
+    /**
+     * What the operator does here, and what each step calls.
+     *
+     * ## Why it lives beside the board rather than in it
+     *
+     * The drawing is board-service's. **Which services get called is ours** — putting it in
+     * `Board.model` would have board carry vocabulary it cannot read, and a board opened in the board
+     * modeller would show data nobody there can explain.
+     *
+     * Keeping it here also means the flow can be read without the drawing, which is what lets a
+     * generator build the flow first and compute the drawing after.
+     *
+     * `requires` above is derived from this — see `axesRead()`. An author who has to keep a list in
+     * step with a screen will not, and then the assignment check is checking something that used to
+     * be true.
+     */
+    flow?: StationFlow;
+    createdAt?: Date;
+    updatedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}

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

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StationScreenSpec = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+/**
+ * What a board needs in order to work as a station screen.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * ## Why this is beside a board and not instead of one
+ *
+ * The drawing, its versions, releasing and reverting are `Board`'s job and it already does all of
+ * them. This table was very nearly a copy of it under different words — same columns, same verbs —
+ * which would have meant tracking board's fixes forever for no difference.
+ *
+ * What is genuinely ours is not the drawing. It is what the drawing **needs** to be usable in front
+ * of an operator, and that is manufacturing vocabulary that has no business in shared
+ * infrastructure. So it sits here, keyed by the board.
+ *
+ * The monorepo already works this way in both directions: `board-ai` anchors its tables with a
+ * plain `boardId`, and `Board.sourceImportSessionId` is a plain string for the same stated reason —
+ * "모듈 의존을 강제하지 않기 위해 ManyToOne 대신 단순 string id 만 보관".
+ *
+ * ## Why not on the assignment
+ *
+ * An assignment is a pairing: this situation shows that drawing. Everything here is a property of
+ * the **drawing**, so putting it on the assignment would copy it into every assignment pointing at
+ * the same board, let those copies disagree, and ask the person doing the assigning to know things
+ * only the person who drew it knows.
+ */
+let StationScreenSpec = class StationScreenSpec {
+};
+exports.StationScreenSpec = StationScreenSpec;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], StationScreenSpec.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], StationScreenSpec.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((spec) => spec.domain),
+    tslib_1.__metadata("design:type", String)
+], StationScreenSpec.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: "the board's id in board-service" }),
+    tslib_1.__metadata("design:type", String)
+], StationScreenSpec.prototype, "boardId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-array', nullable: true }),
+    (0, type_graphql_1.Field)(type => [String], { nullable: true, description: 'station context axes the drawing reads' }),
+    tslib_1.__metadata("design:type", Array)
+], StationScreenSpec.prototype, "requires", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'what this screen was drawn for — size, input, viewing distance' }),
+    tslib_1.__metadata("design:type", Object)
+], StationScreenSpec.prototype, "target", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, default: false }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'releasing this screen goes through approval' }),
+    tslib_1.__metadata("design:type", Boolean)
+], StationScreenSpec.prototype, "controlled", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, default: 'work' }),
+    (0, type_graphql_1.Field)({ nullable: true, description: "'work' — the operator works here · 'signal' — the operator watches it" }),
+    tslib_1.__metadata("design:type", String)
+], StationScreenSpec.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'the steps, and where each argument comes from' }),
+    tslib_1.__metadata("design:type", Object)
+], StationScreenSpec.prototype, "flow", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], StationScreenSpec.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], StationScreenSpec.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], StationScreenSpec.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((spec) => spec.creator),
+    tslib_1.__metadata("design:type", String)
+], StationScreenSpec.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], StationScreenSpec.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((spec) => spec.updater),
+    tslib_1.__metadata("design:type", String)
+], StationScreenSpec.prototype, "updaterId", void 0);
+exports.StationScreenSpec = StationScreenSpec = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_mes_station_screen_spec_0', (spec) => [spec.domain, spec.boardId], { unique: true }),
+    (0, type_graphql_1.ObjectType)({ description: 'what a board needs in order to work as a station screen' })
+], StationScreenSpec);
+//# sourceMappingURL=station-screen-spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"station-screen-spec.js","sourceRoot":"","sources":["../../../server/service/station/station-screen-spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { Column, CreateDateColumn, Entity, Index, ManyToOne, PrimaryGeneratedColumn, RelationId, UpdateDateColumn } from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\n\nimport type { StationFlow } from './station-flow'\nimport { User } from '@things-factory/auth-base'\n\n/**\n * What a board needs in order to work as a station screen.\n *\n * ═══════════════════════════════════════════════════════════════════════════\n * ## Why this is beside a board and not instead of one\n *\n * The drawing, its versions, releasing and reverting are `Board`'s job and it already does all of\n * them. This table was very nearly a copy of it under different words — same columns, same verbs —\n * which would have meant tracking board's fixes forever for no difference.\n *\n * What is genuinely ours is not the drawing. It is what the drawing **needs** to be usable in front\n * of an operator, and that is manufacturing vocabulary that has no business in shared\n * infrastructure. So it sits here, keyed by the board.\n *\n * The monorepo already works this way in both directions: `board-ai` anchors its tables with a\n * plain `boardId`, and `Board.sourceImportSessionId` is a plain string for the same stated reason —\n * \"모듈 의존을 강제하지 않기 위해 ManyToOne 대신 단순 string id 만 보관\".\n *\n * ## Why not on the assignment\n *\n * An assignment is a pairing: this situation shows that drawing. Everything here is a property of\n * the **drawing**, so putting it on the assignment would copy it into every assignment pointing at\n * the same board, let those copies disagree, and ask the person doing the assigning to know things\n * only the person who drew it knows.\n */\n@Entity()\n@Index('ix_mes_station_screen_spec_0', (spec: StationScreenSpec) => [spec.domain, spec.boardId], { unique: true })\n@ObjectType({ description: 'what a board needs in order to work as a station screen' })\nexport class StationScreenSpec {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true })\n  domain?: Domain\n\n  @RelationId((spec: StationScreenSpec) => spec.domain)\n  domainId?: string\n\n  /** The board this describes. One spec per board — a plain id, not a relation. */\n  @Column()\n  @Field({ description: \"the board's id in board-service\" })\n  boardId: string\n\n  /**\n   * Which station context axes the drawing reads — `equipment`, `operation`, `workDirective`, …\n   *\n   * Filled by the modeller from the parts actually placed on the board, so it is a fact about the\n   * drawing rather than something someone remembered to type.\n   *\n   * ## What it is for\n   *\n   * A screen that reads `operation` shows nothing useful at a station whose assignment does not\n   * constrain an operation. Today that surfaces as a blank tile on a bench, discovered by whoever\n   * is standing there. With this declared, the assignment screen can say so before saving —\n   * \"this screen reads the operation, and this assignment does not pin one\".\n   *\n   * This is what makes composing screens with no code safe rather than merely possible.\n   */\n  @Column({ type: 'simple-array', nullable: true })\n  @Field(type => [String], { nullable: true, description: 'station context axes the drawing reads' })\n  requires?: string[]\n\n  /**\n   * What it was drawn for — a bench tablet, a wall andon, a rugged panel.\n   *\n   * Left open on purpose. A shop floor's device mix is not something we can enumerate up front, and\n   * narrowing it here would push whatever we left out into somebody's screen name.\n   */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'what this screen was drawn for — size, input, viewing distance' })\n  target?: Record<string, unknown>\n\n  /**\n   * Whether this screen is a controlled document.\n   *\n   * When it is, releasing it is not one person clicking: a change to what an operator reads off the\n   * screen — a torque figure, a tolerance — has to be reviewed and approved, and the approval has\n   * to be findable afterwards. This package already has that machinery\n   * (`report/disposition-approval-*`); this flag is what sends a release through it.\n   */\n  @Column({ nullable: true, default: false })\n  @Field({ nullable: true, description: 'releasing this screen goes through approval' })\n  controlled?: boolean\n\n  /**\n   * What this screen is for — **declared, not derived.**\n   *\n   * The rule was going to be \"no write step means it is a signal board\". An andon's acknowledge is\n   * a write step, so the day somebody can answer a call from the screen, its kind would change with\n   * no error anywhere. A value that decides wiring cannot be a value that flips when somebody edits\n   * an unrelated field [아키텍트 판정 2026-09-10].\n   *\n   * Named for what the screen does, not for how it looks. \"Andon\" is a presentation and\n   * presentations change; `signal` still describes it when the presentation does not.\n   *\n   * A closed set. Growing it means a new kind of screen exists, which is an architect's call.\n   */\n  @Column({ nullable: true, default: 'work' })\n  @Field({ nullable: true, description: \"'work' — the operator works here · 'signal' — the operator watches it\" })\n  kind?: 'work' | 'signal'\n\n  /**\n   * What the operator does here, and what each step calls.\n   *\n   * ## Why it lives beside the board rather than in it\n   *\n   * The drawing is board-service's. **Which services get called is ours** — putting it in\n   * `Board.model` would have board carry vocabulary it cannot read, and a board opened in the board\n   * modeller would show data nobody there can explain.\n   *\n   * Keeping it here also means the flow can be read without the drawing, which is what lets a\n   * generator build the flow first and compute the drawing after.\n   *\n   * `requires` above is derived from this — see `axesRead()`. An author who has to keep a list in\n   * step with a screen will not, and then the assignment check is checking something that used to\n   * be true.\n   */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'the steps, and where each argument comes from' })\n  flow?: StationFlow\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  creator?: User\n\n  @RelationId((spec: StationScreenSpec) => spec.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  updater?: User\n\n  @RelationId((spec: StationScreenSpec) => spec.updater)\n  updaterId?: string\n}\n"]}

package/dist-server/service/station/station-screen-thumbnail.d.ts

@@ -0,0 +1,11 @@
+/** `data:image/png;base64,...` → image response metadata. */
+export declare function decodeStationThumbnail(dataUrl: string): {
+    type: string;
+    buffer: Buffer;
+} | undefined;
+/**
+ * Old seed records predate Board's background image scheduler. A blank/broken card makes a real
+ * Station Screen indistinguishable from a failed request, so render a safe structural preview from
+ * the persisted model until a raster thumbnail exists. It deliberately exposes labels/types only.
+ */
+export declare function renderStationThumbnail(name: string, model: string | undefined): Buffer | undefined;

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeStationThumbnail = decodeStationThumbnail;
+exports.renderStationThumbnail = renderStationThumbnail;
+/** `data:image/png;base64,...` → image response metadata. */
+function decodeStationThumbnail(dataUrl) {
+    const matched = /^data:([^;,]+);base64,(.*)$/s.exec(dataUrl);
+    return matched ? { type: matched[1], buffer: Buffer.from(matched[2], 'base64') } : undefined;
+}
+/**
+ * Old seed records predate Board's background image scheduler. A blank/broken card makes a real
+ * Station Screen indistinguishable from a failed request, so render a safe structural preview from
+ * the persisted model until a raster thumbnail exists. It deliberately exposes labels/types only.
+ */
+function renderStationThumbnail(name, model) {
+    try {
+        const parsed = JSON.parse(model ?? '');
+        const components = Array.isArray(parsed?.components) ? parsed.components : [];
+        const labels = components
+            .filter((component) => component?.top < 720)
+            .map((component) => String(component?.label || component?.field || component?.type || ''))
+            .filter(Boolean)
+            .slice(0, 6);
+        const escape = (value) => value.replace(/[&<>"']/g, character => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[character]);
+        const rows = labels.length ? labels : ['화면 구성 없음'];
+        const cards = rows.map((label, index) => {
+            const y = 84 + index * 42;
+            return `<rect x="30" y="${y}" width="580" height="30" rx="5" fill="#f2f5f7"/><text x="46" y="${y + 20}" fill="#334155" font-size="15">${escape(label)}</text>`;
+        });
+        return Buffer.from(`<svg xmlns="http://www.w3.org/2000/svg" width="640" height="360" viewBox="0 0 640 360"><rect width="640" height="360" fill="#ffffff"/><rect width="640" height="64" fill="#164e63"/><text x="30" y="40" fill="#ffffff" font-family="Arial, sans-serif" font-size="20" font-weight="700">${escape(name)}</text>${cards.join('')}</svg>`);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=station-screen-thumbnail.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"station-screen-thumbnail.js","sourceRoot":"","sources":["../../../server/service/station/station-screen-thumbnail.ts"],"names":[],"mappings":";;AACA,wDAIC;AAOD,wDAuBC;AAnCD,6DAA6D;AAC7D,SAAgB,sBAAsB,CAAC,OAAe;IACpD,MAAM,OAAO,GAAG,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAE5D,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9F,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,IAAY,EAAE,KAAyB;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;QACtC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7E,MAAM,MAAM,GAAG,UAAU;aACtB,MAAM,CAAC,CAAC,SAAc,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,CAAC;aAChD,GAAG,CAAC,CAAC,SAAc,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,IAAI,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;aAC9F,MAAM,CAAC,OAAO,CAAC;aACf,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAEd,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAE,CAAC,CAAA;QAC/J,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACtC,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,EAAE,CAAA;YACzB,OAAO,mBAAmB,CAAC,oEAAoE,CAAC,GAAG,EAAE,mCAAmC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAA;QAChK,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAC,IAAI,CAChB,2RAA2R,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CACxU,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC","sourcesContent":["/** `data:image/png;base64,...` → image response metadata. */\nexport function decodeStationThumbnail(dataUrl: string): { type: string; buffer: Buffer } | undefined {\n  const matched = /^data:([^;,]+);base64,(.*)$/s.exec(dataUrl)\n\n  return matched ? { type: matched[1], buffer: Buffer.from(matched[2], 'base64') } : undefined\n}\n\n/**\n * Old seed records predate Board's background image scheduler. A blank/broken card makes a real\n * Station Screen indistinguishable from a failed request, so render a safe structural preview from\n * the persisted model until a raster thumbnail exists. It deliberately exposes labels/types only.\n */\nexport function renderStationThumbnail(name: string, model: string | undefined): Buffer | undefined {\n  try {\n    const parsed = JSON.parse(model ?? '')\n    const components = Array.isArray(parsed?.components) ? parsed.components : []\n    const labels = components\n      .filter((component: any) => component?.top < 720)\n      .map((component: any) => String(component?.label || component?.field || component?.type || ''))\n      .filter(Boolean)\n      .slice(0, 6)\n\n    const escape = (value: string) => value.replace(/[&<>\"']/g, character => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '\"': '&quot;', \"'\": '&#39;' })[character]!)\n    const rows = labels.length ? labels : ['화면 구성 없음']\n    const cards = rows.map((label, index) => {\n      const y = 84 + index * 42\n      return `<rect x=\"30\" y=\"${y}\" width=\"580\" height=\"30\" rx=\"5\" fill=\"#f2f5f7\"/><text x=\"46\" y=\"${y + 20}\" fill=\"#334155\" font-size=\"15\">${escape(label)}</text>`\n    })\n\n    return Buffer.from(\n      `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"640\" height=\"360\" viewBox=\"0 0 640 360\"><rect width=\"640\" height=\"360\" fill=\"#ffffff\"/><rect width=\"640\" height=\"64\" fill=\"#164e63\"/><text x=\"30\" y=\"40\" fill=\"#ffffff\" font-family=\"Arial, sans-serif\" font-size=\"20\" font-weight=\"700\">${escape(name)}</text>${cards.join('')}</svg>`\n    )\n  } catch {\n    return undefined\n  }\n}\n"]}

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

@@ -0,0 +1,27 @@
+export declare class StationServiceFieldType {
+    name: string;
+    required: boolean;
+    describes?: string;
+    notable: boolean;
+    suggested?: Record<string, unknown>;
+}
+export declare class StationServiceType {
+    name: string;
+    describes: string;
+    fields: StationServiceFieldType[];
+}
+/**
+ * What a step can call, and what each call needs.
+ *
+ * ── Why the server answers this and not introspection in the browser ─────
+ * The browser could ask the schema itself. It would get every mutation in the app, and then the
+ * composer would have to decide which of them belong at a bench — a judgement, made in a place
+ * nobody would think to look. Worse, introspection alone cannot say that `goodCount` is nullable
+ * *and* must not be left empty; that is domain knowledge, and it lives beside the declaration.
+ *
+ * The field names and their nullability still come from the schema's own metadata. Nothing here
+ * is a second copy of the input types.
+ */
+export declare class StationServiceResolver {
+    stationServices(): Promise<StationServiceType[]>;
+}