@things-factory/erp-systemever 10.1.117 → 10.1.118

package/dist-server/systemever-query-task.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The least time between two queries of one screen over one connection in one domain — a person does not press
+ * 조회 more often than this, and a schedule must not either (ADR-0110, ruling 2026-10-05, condition 3).
+ */
+export declare const SYSTEMEVER_QUERY_FLOOR_MS = 60000;
+/** When each (domain, connection, screen) last started a query, in this process. */
+export declare const lastQueryStartedAt: Map<string, number>;

package/dist-server/systemever-query-task.js

@@ -0,0 +1,65 @@
+import integration from '@things-factory/integration-base';
+import { prepareSystemEverQuery, runSystemEverQuery } from './systemever-query-runner.js';
+import { SystemEverQueryError } from './systemever-query-policy.js';
+const { ConnectionManager, TaskRegistry } = integration;
+/**
+ * The least time between two queries of one screen over one connection in one domain — a person does not press
+ * 조회 more often than this, and a schedule must not either (ADR-0110, ruling 2026-10-05, condition 3).
+ */
+export const SYSTEMEVER_QUERY_FLOOR_MS = 60_000;
+/** When each (domain, connection, screen) last started a query, in this process. */
+export const lastQueryStartedAt = new Map();
+/** Refusals that are not ours to rename: they already say what happened and where (e.g. integration-runtime-off). */
+function isNamedPlatformRefusal(error) {
+    const code = error?.code;
+    return typeof code === 'string' && code.startsWith('integration-');
+}
+async function SystemEverQuery(step, { domain }) {
+    try {
+        prepareSystemEverQuery(step.params);
+        const key = `${domain?.id}:${step.connection}:${step.params?.screen}`;
+        const now = Date.now();
+        const last = lastQueryStartedAt.get(key);
+        if (last !== undefined && now - last < SYSTEMEVER_QUERY_FLOOR_MS) {
+            throw new SystemEverQueryError('systemever-query-too-frequent');
+        }
+        lastQueryStartedAt.set(key, now);
+        const entity = await ConnectionManager.getConnectionEntityByName(domain, step.connection);
+        if (!entity || entity.type !== 'systemever-connector' ||
+            new URL(entity.endpoint).origin !== 'https://mfg.systemevererp.com') {
+            throw new SystemEverQueryError('systemever-query-invalid-connection');
+        }
+        const instance = await ConnectionManager.getConnectionInstanceByName(domain, step.connection);
+        const connection = { ...instance, type: entity.type, name: entity.name, domain };
+        const data = await ConnectionManager.withSession(connection, async (page) => {
+            try {
+                return await runSystemEverQuery(page, step.params);
+            }
+            catch (error) {
+                if (!(error instanceof SystemEverQueryError) || error.code !== 'systemever-query-session-expired')
+                    throw error;
+                const recovered = await connection.reAuthenticateSession();
+                try {
+                    return await runSystemEverQuery(recovered.page, step.params);
+                }
+                finally {
+                    await connection.releasePage(recovered.page);
+                }
+            }
+        });
+        return { data };
+    }
+    catch (error) {
+        if (error instanceof SystemEverQueryError || isNamedPlatformRefusal(error))
+            throw error;
+        throw new SystemEverQueryError('systemever-query-connection-failed', error);
+    }
+}
+SystemEverQuery.parameterSpec = [
+    { type: 'select', name: 'screen', label: 'screen', property: { options: [{ display: '작업지시조회', value: 'work-order' }] } },
+    { type: 'string', name: 'dateFrom', label: 'date-from' },
+    { type: 'string', name: 'dateTo', label: 'date-to' },
+    { type: 'string', name: 'bizUnit', label: 'business-unit' }
+];
+TaskRegistry.registerTaskHandler('systemever-query', SystemEverQuery);
+//# sourceMappingURL=systemever-query-task.js.map

package/dist-server/systemever-query-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemever-query-task.js","sourceRoot":"","sources":["../server/systemever-query-task.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,kCAAkC,CAAA;AAC1D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,GAAG,WAAW,CAAA;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAA;AAE/C,oFAAoF;AACpF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAA;AAE3D,qHAAqH;AACrH,SAAS,sBAAsB,CAAC,KAAc;IAC5C,MAAM,IAAI,GAAI,KAAa,EAAE,IAAI,CAAA;IACjC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;AACpE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAS,EAAE,EAAE,MAAM,EAAO;IACvD,IAAI,CAAC;QACH,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACnC,MAAM,GAAG,GAAG,GAAG,MAAM,EAAE,EAAE,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,GAAG,IAAI,GAAG,yBAAyB,EAAE,CAAC;YACjE,MAAM,IAAI,oBAAoB,CAAC,+BAA+B,CAAC,CAAA;QACjE,CAAC;QACD,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAChC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QACzF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,sBAAsB;YACjD,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,+BAA+B,EAAE,CAAC;YACxE,MAAM,IAAI,oBAAoB,CAAC,qCAAqC,CAAC,CAAA;QACvE,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC7F,MAAM,UAAU,GAAG,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;QAChF,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;YACxE,IAAI,CAAC;gBACH,OAAO,MAAM,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,KAAK,YAAY,oBAAoB,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,kCAAkC;oBAAE,MAAM,KAAK,CAAA;gBAC9G,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,qBAAqB,EAAE,CAAA;gBAC1D,IAAI,CAAC;oBAAC,OAAO,MAAM,kBAAkB,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBAAC,CAAC;wBAC5D,CAAC;oBAAC,MAAM,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;gBAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAA;QACF,OAAO,EAAE,IAAI,EAAE,CAAA;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,oBAAoB,IAAI,sBAAsB,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QACvF,MAAM,IAAI,oBAAoB,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;IAC7E,CAAC;AACH,CAAC;AAED,eAAe,CAAC,aAAa,GAAG;IAC9B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE;IACxH,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE;IACxD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IACpD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE;CAC5D,CAAA;AAED,YAAY,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAA","sourcesContent":["import integration from '@things-factory/integration-base'\nimport { prepareSystemEverQuery, runSystemEverQuery } from './systemever-query-runner.js'\nimport { SystemEverQueryError } from './systemever-query-policy.js'\nconst { ConnectionManager, TaskRegistry } = integration\n\n/**\n * The least time between two queries of one screen over one connection in one domain — a person does not press\n * 조회 more often than this, and a schedule must not either (ADR-0110, ruling 2026-10-05, condition 3).\n */\nexport const SYSTEMEVER_QUERY_FLOOR_MS = 60_000\n\n/** When each (domain, connection, screen) last started a query, in this process. */\nexport const lastQueryStartedAt = new Map<string, number>()\n\n/** Refusals that are not ours to rename: they already say what happened and where (e.g. integration-runtime-off). */\nfunction isNamedPlatformRefusal(error: unknown): boolean {\n  const code = (error as any)?.code\n  return typeof code === 'string' && code.startsWith('integration-')\n}\n\nasync function SystemEverQuery(step: any, { domain }: any) {\n  try {\n    prepareSystemEverQuery(step.params)\n    const key = `${domain?.id}:${step.connection}:${step.params?.screen}`\n    const now = Date.now()\n    const last = lastQueryStartedAt.get(key)\n    if (last !== undefined && now - last < SYSTEMEVER_QUERY_FLOOR_MS) {\n      throw new SystemEverQueryError('systemever-query-too-frequent')\n    }\n    lastQueryStartedAt.set(key, now)\n    const entity = await ConnectionManager.getConnectionEntityByName(domain, step.connection)\n    if (!entity || entity.type !== 'systemever-connector' ||\n        new URL(entity.endpoint).origin !== 'https://mfg.systemevererp.com') {\n      throw new SystemEverQueryError('systemever-query-invalid-connection')\n    }\n    const instance = await ConnectionManager.getConnectionInstanceByName(domain, step.connection)\n    const connection = { ...instance, type: entity.type, name: entity.name, domain }\n    const data = await ConnectionManager.withSession(connection, async page => {\n      try {\n        return await runSystemEverQuery(page, step.params)\n      } catch (error) {\n        if (!(error instanceof SystemEverQueryError) || error.code !== 'systemever-query-session-expired') throw error\n        const recovered = await connection.reAuthenticateSession()\n        try { return await runSystemEverQuery(recovered.page, step.params) }\n        finally { await connection.releasePage(recovered.page) }\n      }\n    })\n    return { data }\n  } catch (error) {\n    if (error instanceof SystemEverQueryError || isNamedPlatformRefusal(error)) throw error\n    throw new SystemEverQueryError('systemever-query-connection-failed', error)\n  }\n}\n\nSystemEverQuery.parameterSpec = [\n  { type: 'select', name: 'screen', label: 'screen', property: { options: [{ display: '작업지시조회', value: 'work-order' }] } },\n  { type: 'string', name: 'dateFrom', label: 'date-from' },\n  { type: 'string', name: 'dateTo', label: 'date-to' },\n  { type: 'string', name: 'bizUnit', label: 'business-unit' }\n]\n\nTaskRegistry.registerTaskHandler('systemever-query', SystemEverQuery)\n"]}

package/dist-server/systemever-schedule-task.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-server/systemever-schedule-task.js

@@ -0,0 +1,35 @@
+import integration from '@things-factory/integration-base';
+import utils from '@things-factory/utils';
+import { SystemEverQueryError } from './systemever-query-policy.js';
+import { toScheduleEntries } from './systemever-work-order.js';
+const { TaskRegistry } = integration;
+const { access } = utils;
+/**
+ * **SystemEver work-order rows → contract schedule entries**, as a scenario step (ADR-0110 addition 1 amended).
+ *
+ * `systemever-query` returns the 작업지시조회 rows with SystemEver's column names; this step maps them with the same
+ * `toScheduleEntries` the adapter would use, so the plant task that comes next receives only the contract's
+ * `ProductionScheduleEntry` and knows nothing of SystemEver. Orders it cannot map are passed on as `skipped`,
+ * each with its reason — none is dropped without a word.
+ */
+async function SystemEverWorkOrdersToSchedule(step, { data }) {
+    const { accessor, timeZone } = step.params || {};
+    const rows = accessor ? access(accessor, data) : undefined;
+    if (!Array.isArray(rows))
+        throw new SystemEverQueryError('systemever-schedule-invalid-rows');
+    if (typeof timeZone !== 'string' || !timeZone.trim())
+        throw new SystemEverQueryError('systemever-schedule-invalid-time-zone');
+    try {
+        return { data: toScheduleEntries(rows, { timeZone }) };
+    }
+    catch (error) {
+        /* toScheduleEntries throws only for the zone: missing or unknown. */
+        throw new SystemEverQueryError('systemever-schedule-invalid-time-zone', error);
+    }
+}
+SystemEverWorkOrdersToSchedule.parameterSpec = [
+    { type: 'scenario-step-input', name: 'accessor', label: 'accessor' },
+    { type: 'string', name: 'timeZone', label: 'time-zone' }
+];
+TaskRegistry.registerTaskHandler('systemever-work-orders-to-schedule', SystemEverWorkOrdersToSchedule);
+//# sourceMappingURL=systemever-schedule-task.js.map

package/dist-server/systemever-schedule-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemever-schedule-task.js","sourceRoot":"","sources":["../server/systemever-schedule-task.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,kCAAkC,CAAA;AAC1D,OAAO,KAAK,MAAM,uBAAuB,CAAA;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAAA;AACpC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;AAExB;;;;;;;GAOG;AACH,KAAK,UAAU,8BAA8B,CAAC,IAAS,EAAE,EAAE,IAAI,EAAO;IACpE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAA;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,oBAAoB,CAAC,kCAAkC,CAAC,CAAA;IAC5F,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,oBAAoB,CAAC,uCAAuC,CAAC,CAAA;IAE7H,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qEAAqE;QACrE,MAAM,IAAI,oBAAoB,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAA;IAChF,CAAC;AACH,CAAC;AAED,8BAA8B,CAAC,aAAa,GAAG;IAC7C,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IACpE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE;CACzD,CAAA;AAED,YAAY,CAAC,mBAAmB,CAAC,oCAAoC,EAAE,8BAA8B,CAAC,CAAA","sourcesContent":["import integration from '@things-factory/integration-base'\nimport utils from '@things-factory/utils'\n\nimport { SystemEverQueryError } from './systemever-query-policy.js'\nimport { toScheduleEntries } from './systemever-work-order.js'\n\nconst { TaskRegistry } = integration\nconst { access } = utils\n\n/**\n * **SystemEver work-order rows → contract schedule entries**, as a scenario step (ADR-0110 addition 1 amended).\n *\n * `systemever-query` returns the 작업지시조회 rows with SystemEver's column names; this step maps them with the same\n * `toScheduleEntries` the adapter would use, so the plant task that comes next receives only the contract's\n * `ProductionScheduleEntry` and knows nothing of SystemEver. Orders it cannot map are passed on as `skipped`,\n * each with its reason — none is dropped without a word.\n */\nasync function SystemEverWorkOrdersToSchedule(step: any, { data }: any) {\n  const { accessor, timeZone } = step.params || {}\n  const rows = accessor ? access(accessor, data) : undefined\n  if (!Array.isArray(rows)) throw new SystemEverQueryError('systemever-schedule-invalid-rows')\n  if (typeof timeZone !== 'string' || !timeZone.trim()) throw new SystemEverQueryError('systemever-schedule-invalid-time-zone')\n\n  try {\n    return { data: toScheduleEntries(rows, { timeZone }) }\n  } catch (error) {\n    /* toScheduleEntries throws only for the zone: missing or unknown. */\n    throw new SystemEverQueryError('systemever-schedule-invalid-time-zone', error)\n  }\n}\n\nSystemEverWorkOrdersToSchedule.parameterSpec = [\n  { type: 'scenario-step-input', name: 'accessor', label: 'accessor' },\n  { type: 'string', name: 'timeZone', label: 'time-zone' }\n]\n\nTaskRegistry.registerTaskHandler('systemever-work-orders-to-schedule', SystemEverWorkOrdersToSchedule)\n"]}

package/dist-server/systemever-work-order-query.d.ts

@@ -0,0 +1,14 @@
+export declare function workOrderQueryData(params: {
+    dateFrom: string;
+    dateTo: string;
+    bizUnit: string;
+}): {
+    Tables: {
+        TableName: string;
+        Columns: string[];
+        ColumnsType: number[];
+        Rows: (string | number)[][];
+    }[];
+    IsSendXml: boolean;
+    DataBlock1: string;
+};

package/dist-server/systemever-work-order-query.js

@@ -0,0 +1,157 @@
+import { SystemEverQueryError } from './systemever-query-policy.js';
+// Captured from a read-only work-order query on 2026-10-05. No session values.
+const template = {
+    "TableName": "DataBlock1",
+    "Columns": [
+        "WorkingTag",
+        "IDX_NO",
+        "DataSeq",
+        "Status",
+        "Selected",
+        "IsChangedMst",
+        "TABLE_NAME",
+        "IsSum",
+        "ItemClassSSeq",
+        "ItemClassSName",
+        "ItemClassLSeq",
+        "ItemClassLName",
+        "ItemClassMSeq",
+        "BizUnit",
+        "BizUnitName",
+        "WorkDateFr",
+        "WorkDateTo",
+        "WorkOrderNo",
+        "ProgStatus",
+        "ProgStatusName",
+        "WorkCenterSeq",
+        "WorkCenterName",
+        "DeptSeq",
+        "DeptName",
+        "ProcSeq",
+        "ProcName",
+        "WorkType",
+        "WorkTypeName",
+        "GoodItemName",
+        "GoodItemNo",
+        "GoodItemSpec",
+        "WorkOrderDateFr",
+        "WorkOrderDateTo",
+        "FileSeq",
+        "ProdPlanNo",
+        "OrderNo",
+        "CustSeq",
+        "CustName",
+        "WHSeq",
+        "WHName",
+        "PoNo"
+    ],
+    "ColumnsType": [
+        0,
+        1,
+        1,
+        1,
+        1,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0
+    ],
+    "Rows": [
+        [
+            "A",
+            1,
+            1,
+            0,
+            1,
+            "0",
+            "DataBlock1",
+            "0",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "1",
+            "본사",
+            "20261005",
+            "20261012",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            0,
+            "",
+            "",
+            "",
+            "",
+            "",
+            "",
+            ""
+        ]
+    ]
+};
+export function workOrderQueryData(params) {
+    for (const value of [params.dateFrom, params.dateTo]) {
+        if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(value) ||
+            !Number.isFinite(Date.parse(value)) || new Date(value).toISOString().slice(0, 10) !== value) {
+            throw new SystemEverQueryError('systemever-query-invalid-date');
+        }
+    }
+    if (params.dateFrom > params.dateTo)
+        throw new SystemEverQueryError('systemever-query-invalid-date-range');
+    if (typeof params.bizUnit !== 'string' || !/^\d+$/.test(params.bizUnit)) {
+        throw new SystemEverQueryError('systemever-query-invalid-biz-unit');
+    }
+    const table = structuredClone(template);
+    const row = table.Rows[0];
+    row[table.Columns.indexOf('WorkDateFr')] = params.dateFrom.replaceAll('-', '');
+    row[table.Columns.indexOf('WorkDateTo')] = params.dateTo.replaceAll('-', '');
+    row[table.Columns.indexOf('BizUnit')] = params.bizUnit;
+    row[table.Columns.indexOf('BizUnitName')] = '';
+    return { Tables: [table], IsSendXml: true, DataBlock1: 'DataBlock1' };
+}
+//# sourceMappingURL=systemever-work-order-query.js.map

package/dist-server/systemever-work-order-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemever-work-order-query.js","sourceRoot":"","sources":["../server/systemever-work-order-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAEnE,+EAA+E;AAC/E,MAAM,QAAQ,GAAG;IACf,WAAW,EAAE,YAAY;IACzB,SAAS,EAAE;QACT,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,UAAU;QACV,cAAc;QACd,YAAY;QACZ,OAAO;QACP,eAAe;QACf,gBAAgB;QAChB,eAAe;QACf,gBAAgB;QAChB,eAAe;QACf,SAAS;QACT,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,YAAY;QACZ,gBAAgB;QAChB,eAAe;QACf,gBAAgB;QAChB,SAAS;QACT,UAAU;QACV,SAAS;QACT,UAAU;QACV,UAAU;QACV,cAAc;QACd,cAAc;QACd,YAAY;QACZ,cAAc;QACd,iBAAiB;QACjB,iBAAiB;QACjB,SAAS;QACT,YAAY;QACZ,SAAS;QACT,SAAS;QACT,UAAU;QACV,OAAO;QACP,QAAQ;QACR,MAAM;KACP;IACD,aAAa,EAAE;QACb,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;QACD,CAAC;KACF;IACD,MAAM,EAAE;QACN;YACE,GAAG;YACH,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,GAAG;YACH,YAAY;YACZ,GAAG;YACH,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,GAAG;YACH,IAAI;YACJ,UAAU;YACV,UAAU;YACV,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,CAAC;YACD,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;YACF,EAAE;SACH;KACF;CACF,CAAA;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA6D;IAC9F,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;YAC/D,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;YAChG,MAAM,IAAI,oBAAoB,CAAC,+BAA+B,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,oBAAoB,CAAC,qCAAqC,CAAC,CAAA;IAC1G,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,oBAAoB,CAAC,mCAAmC,CAAC,CAAA;IACrE,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC9E,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC5E,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAA;IACtD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,EAAE,CAAA;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,CAAA;AACvE,CAAC","sourcesContent":["import { SystemEverQueryError } from './systemever-query-policy.js'\n\n// Captured from a read-only work-order query on 2026-10-05. No session values.\nconst template = {\n  \"TableName\": \"DataBlock1\",\n  \"Columns\": [\n    \"WorkingTag\",\n    \"IDX_NO\",\n    \"DataSeq\",\n    \"Status\",\n    \"Selected\",\n    \"IsChangedMst\",\n    \"TABLE_NAME\",\n    \"IsSum\",\n    \"ItemClassSSeq\",\n    \"ItemClassSName\",\n    \"ItemClassLSeq\",\n    \"ItemClassLName\",\n    \"ItemClassMSeq\",\n    \"BizUnit\",\n    \"BizUnitName\",\n    \"WorkDateFr\",\n    \"WorkDateTo\",\n    \"WorkOrderNo\",\n    \"ProgStatus\",\n    \"ProgStatusName\",\n    \"WorkCenterSeq\",\n    \"WorkCenterName\",\n    \"DeptSeq\",\n    \"DeptName\",\n    \"ProcSeq\",\n    \"ProcName\",\n    \"WorkType\",\n    \"WorkTypeName\",\n    \"GoodItemName\",\n    \"GoodItemNo\",\n    \"GoodItemSpec\",\n    \"WorkOrderDateFr\",\n    \"WorkOrderDateTo\",\n    \"FileSeq\",\n    \"ProdPlanNo\",\n    \"OrderNo\",\n    \"CustSeq\",\n    \"CustName\",\n    \"WHSeq\",\n    \"WHName\",\n    \"PoNo\"\n  ],\n  \"ColumnsType\": [\n    0,\n    1,\n    1,\n    1,\n    1,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0,\n    0\n  ],\n  \"Rows\": [\n    [\n      \"A\",\n      1,\n      1,\n      0,\n      1,\n      \"0\",\n      \"DataBlock1\",\n      \"0\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"1\",\n      \"본사\",\n      \"20261005\",\n      \"20261012\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      0,\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\",\n      \"\"\n    ]\n  ]\n}\n\nexport function workOrderQueryData(params: { dateFrom: string; dateTo: string; bizUnit: string }) {\n  for (const value of [params.dateFrom, params.dateTo]) {\n    if (typeof value !== 'string' || !/^\\d{4}-\\d{2}-\\d{2}$/.test(value) ||\n        !Number.isFinite(Date.parse(value)) || new Date(value).toISOString().slice(0, 10) !== value) {\n      throw new SystemEverQueryError('systemever-query-invalid-date')\n    }\n  }\n  if (params.dateFrom > params.dateTo) throw new SystemEverQueryError('systemever-query-invalid-date-range')\n  if (typeof params.bizUnit !== 'string' || !/^\\d+$/.test(params.bizUnit)) {\n    throw new SystemEverQueryError('systemever-query-invalid-biz-unit')\n  }\n  const table = structuredClone(template)\n  const row = table.Rows[0]\n  row[table.Columns.indexOf('WorkDateFr')] = params.dateFrom.replaceAll('-', '')\n  row[table.Columns.indexOf('WorkDateTo')] = params.dateTo.replaceAll('-', '')\n  row[table.Columns.indexOf('BizUnit')] = params.bizUnit\n  row[table.Columns.indexOf('BizUnitName')] = ''\n  return { Tables: [table], IsSendXml: true, DataBlock1: 'DataBlock1' }\n}\n"]}

package/dist-server/systemever-work-order.d.ts

@@ -0,0 +1,33 @@
+import type { ProductionScheduleEntry, ScheduleStatus } from '@operato/ops-contract';
+/** The columns this mapping reads — all present in the 2026-10-01 response. */
+export declare const WORK_ORDER_COLUMNS: readonly ["WorkOrderNo", "WorkOrderSerl", "ProgStatusName", "IsStop", "GoodItemNo", "OrderQty", "ItemUnitName", "WorkDate", "WorkStartTime", "WorkEndTime", "WorkCenterName", "LastDateTime"];
+/**
+ * SystemEver progress status → contract status. Read by name; only 완료 has been seen (code 6036004).
+ * 중단 · 미완료 are left out on purpose (see the file head).
+ */
+export declare const WORK_ORDER_STATUS: Readonly<Record<string, ScheduleStatus>>;
+export type WorkOrderRow = Record<string, unknown>;
+export interface WorkOrderSkip {
+    orderId?: string;
+    reason: string;
+}
+export interface WorkOrderMapping {
+    entries: ProductionScheduleEntry[];
+    skipped: WorkOrderSkip[];
+}
+/** A plant-local wall time as an ISO instant. Undefined when the parts are not a time. */
+export declare function localToIso(date: string, time: string, timeZone: string): string | undefined;
+/** The content revision — what the floor would act on, in a fixed order. */
+export declare function contentRevision(e: Omit<ProductionScheduleEntry, 'revision' | 'recordTime' | 'orderId'>): string;
+/**
+ * Map a 작업지시조회 response.
+ *
+ * An order that comes as more than one line (several `WorkOrderSerl`, i.e. several processes) is skipped whole:
+ * the contract entry is one order, and picking one line would drop the others. Miratek's in-house orders are one
+ * process each; if that changes, this says so instead of guessing.
+ *
+ * @throws when `timeZone` is missing or unknown — no row can be read without it.
+ */
+export declare function toScheduleEntries(rows: WorkOrderRow[], options: {
+    timeZone: string;
+}): WorkOrderMapping;

package/dist-server/systemever-work-order.js

@@ -0,0 +1,160 @@
+/*
+ * **SystemEver work orders → contract schedule entries** — a pure mapping, no I/O.
+ *
+ * Both reading roads reach it (ADR-0110 addition 1, amended 2026-10-05): the adapter's own `readSchedules` when
+ * it reads `/api/WebApi` directly, and the plant task when an integration scenario brings the rows. The rows
+ * are the 작업지시조회 response as SystemEver sends them (svc 501041 / pgm 500880), column names untouched.
+ *
+ * ── What was seen (2026-10-01 response, two rows) ────────────────────────
+ *   WorkDate "20251107" · WorkStartTime "0900" · WorkEndTime "1800"   planned day and hours, plant-local
+ *   OrderQty "200.00000"                                               a decimal in a string
+ *   ItemUnitName "EA" · GoodItemNo "F0102-H1003"                       unit and item
+ *   ProgStatus 6036004 · ProgStatusName "완료"                          the only status seen
+ *   WorkOrderNo "20251107-0001" · WorkOrderSerl 1                      one line per order
+ *   LastDateTime "2025-11-28 14:35:13"                                 plant-local
+ *
+ * ── What it does not decide ──────────────────────────────────────────────
+ *  · **A status it does not know is not mapped.** Only 완료 was seen. 작성 · 확정 · 진행중 are read by their
+ *    names; 중단 · 미완료 and anything else skip the order with the reason — read as `cancelled`, an order the
+ *    floor has not started would be cancelled without a word.
+ *  · **The revision is the content, not the last update time** (user decision 2026-09-30): a remark edit must
+ *    not look like a new revision, which holds a started order for a person.
+ *  · **No zone is assumed.** The plant's zone is required; the ERP's times are local.
+ */
+import { createHash } from 'node:crypto';
+/** The columns this mapping reads — all present in the 2026-10-01 response. */
+export const WORK_ORDER_COLUMNS = [
+    'WorkOrderNo',
+    'WorkOrderSerl',
+    'ProgStatusName',
+    'IsStop',
+    'GoodItemNo',
+    'OrderQty',
+    'ItemUnitName',
+    'WorkDate',
+    'WorkStartTime',
+    'WorkEndTime',
+    'WorkCenterName',
+    'LastDateTime'
+];
+/**
+ * SystemEver progress status → contract status. Read by name; only 완료 has been seen (code 6036004).
+ * 중단 · 미완료 are left out on purpose (see the file head).
+ */
+export const WORK_ORDER_STATUS = {
+    작성: 'draft',
+    확정: 'released',
+    진행중: 'started',
+    완료: 'completed'
+};
+const text = (v) => (v == null ? '' : String(v).trim());
+/** Offset of `timeZone` from UTC at `utcMs`, in ms. */
+function offsetMs(utcMs, timeZone) {
+    const parts = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit'
+    }).formatToParts(new Date(utcMs));
+    const n = (type) => Number(parts.find(p => p.type === type)?.value);
+    return Date.UTC(n('year'), n('month') - 1, n('day'), n('hour'), n('minute'), n('second')) - utcMs;
+}
+/** A plant-local wall time as an ISO instant. Undefined when the parts are not a time. */
+export function localToIso(date, time, timeZone) {
+    const d = /^(\d{4})-?(\d{2})-?(\d{2})$/.exec(date);
+    const t = /^(\d{2}):?(\d{2})(?::?(\d{2}))?$/.exec(time);
+    if (!d || !t)
+        return undefined;
+    const wall = Date.UTC(+d[1], +d[2] - 1, +d[3], +t[1], +t[2], +(t[3] ?? 0));
+    if (!Number.isFinite(wall))
+        return undefined;
+    /* two passes: the offset at the guessed instant, then at the corrected one (around a DST change) */
+    let at = wall - offsetMs(wall, timeZone);
+    at = wall - offsetMs(at, timeZone);
+    return new Date(at).toISOString();
+}
+/** The content revision — what the floor would act on, in a fixed order. */
+export function contentRevision(e) {
+    const content = [e.materialDefinitionId, e.quantity, e.uom, e.startTime ?? '', e.endTime ?? '', e.status];
+    return createHash('sha256').update(JSON.stringify(content)).digest('hex').slice(0, 16);
+}
+function one(row, timeZone) {
+    const orderId = text(row.WorkOrderNo);
+    if (!orderId)
+        return { reason: 'no WorkOrderNo' };
+    if (text(row.IsStop) === '1')
+        return { orderId, reason: 'stopped in SystemEver (IsStop) — not mapped' };
+    const statusName = text(row.ProgStatusName);
+    const status = WORK_ORDER_STATUS[statusName];
+    if (!status)
+        return { orderId, reason: `unknown progress status "${statusName}" — not mapped` };
+    const materialDefinitionId = text(row.GoodItemNo);
+    if (!materialDefinitionId)
+        return { orderId, reason: 'no GoodItemNo' };
+    const quantity = Number(text(row.OrderQty));
+    if (!text(row.OrderQty) || !Number.isFinite(quantity))
+        return { orderId, reason: `OrderQty "${text(row.OrderQty)}" is not a number` };
+    const uom = text(row.ItemUnitName);
+    if (!uom)
+        return { orderId, reason: 'no ItemUnitName — a unit is not invented' };
+    const day = text(row.WorkDate);
+    const startTime = day && text(row.WorkStartTime) ? localToIso(day, text(row.WorkStartTime), timeZone) : undefined;
+    const endTime = day && text(row.WorkEndTime) ? localToIso(day, text(row.WorkEndTime), timeZone) : undefined;
+    const [lastDay, lastTime] = text(row.LastDateTime).split(/\s+/);
+    const recordTime = lastDay && lastTime ? localToIso(lastDay, lastTime, timeZone) : undefined;
+    const content = {
+        materialDefinitionId,
+        quantity,
+        uom,
+        ...(startTime ? { startTime } : {}),
+        ...(endTime ? { endTime } : {}),
+        status
+    };
+    return {
+        orderId,
+        ...content,
+        revision: contentRevision(content),
+        ...(text(row.WorkCenterName) ? { workCenter: text(row.WorkCenterName) } : {}),
+        ...(recordTime ? { recordTime } : {})
+    };
+}
+/**
+ * Map a 작업지시조회 response.
+ *
+ * An order that comes as more than one line (several `WorkOrderSerl`, i.e. several processes) is skipped whole:
+ * the contract entry is one order, and picking one line would drop the others. Miratek's in-house orders are one
+ * process each; if that changes, this says so instead of guessing.
+ *
+ * @throws when `timeZone` is missing or unknown — no row can be read without it.
+ */
+export function toScheduleEntries(rows, options) {
+    const timeZone = text(options?.timeZone);
+    if (!timeZone)
+        throw new Error('timeZone is not set — SystemEver times are plant-local');
+    new Intl.DateTimeFormat('en-US', { timeZone });
+    const lines = new Map();
+    for (const row of rows) {
+        const no = text(row.WorkOrderNo);
+        if (no)
+            lines.set(no, (lines.get(no) ?? 0) + 1);
+    }
+    const result = { entries: [], skipped: [] };
+    for (const row of rows) {
+        const no = text(row.WorkOrderNo);
+        if (no && (lines.get(no) ?? 0) > 1) {
+            result.skipped.push({ orderId: no, reason: `${lines.get(no)} lines (WorkOrderSerl) for one order — not mapped` });
+            continue;
+        }
+        const mapped = one(row, timeZone);
+        if ('reason' in mapped)
+            result.skipped.push(mapped);
+        else
+            result.entries.push(mapped);
+    }
+    return result;
+}
+//# sourceMappingURL=systemever-work-order.js.map

package/dist-server/systemever-work-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemever-work-order.js","sourceRoot":"","sources":["../server/systemever-work-order.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * **SystemEver work orders → contract schedule entries** — a pure mapping, no I/O.\n *\n * Both reading roads reach it (ADR-0110 addition 1, amended 2026-10-05): the adapter's own `readSchedules` when\n * it reads `/api/WebApi` directly, and the plant task when an integration scenario brings the rows. The rows\n * are the 작업지시조회 response as SystemEver sends them (svc 501041 / pgm 500880), column names untouched.\n *\n * ── What was seen (2026-10-01 response, two rows) ────────────────────────\n *   WorkDate \"20251107\" · WorkStartTime \"0900\" · WorkEndTime \"1800\"   planned day and hours, plant-local\n *   OrderQty \"200.00000\"                                               a decimal in a string\n *   ItemUnitName \"EA\" · GoodItemNo \"F0102-H1003\"                       unit and item\n *   ProgStatus 6036004 · ProgStatusName \"완료\"                          the only status seen\n *   WorkOrderNo \"20251107-0001\" · WorkOrderSerl 1                      one line per order\n *   LastDateTime \"2025-11-28 14:35:13\"                                 plant-local\n *\n * ── What it does not decide ──────────────────────────────────────────────\n *  · **A status it does not know is not mapped.** Only 완료 was seen. 작성 · 확정 · 진행중 are read by their\n *    names; 중단 · 미완료 and anything else skip the order with the reason — read as `cancelled`, an order the\n *    floor has not started would be cancelled without a word.\n *  · **The revision is the content, not the last update time** (user decision 2026-09-30): a remark edit must\n *    not look like a new revision, which holds a started order for a person.\n *  · **No zone is assumed.** The plant's zone is required; the ERP's times are local.\n */\nimport { createHash } from 'node:crypto'\n\nimport type { ProductionScheduleEntry, ScheduleStatus } from '@operato/ops-contract'\n\n/** The columns this mapping reads — all present in the 2026-10-01 response. */\nexport const WORK_ORDER_COLUMNS = [\n  'WorkOrderNo',\n  'WorkOrderSerl',\n  'ProgStatusName',\n  'IsStop',\n  'GoodItemNo',\n  'OrderQty',\n  'ItemUnitName',\n  'WorkDate',\n  'WorkStartTime',\n  'WorkEndTime',\n  'WorkCenterName',\n  'LastDateTime'\n] as const\n\n/**\n * SystemEver progress status → contract status. Read by name; only 완료 has been seen (code 6036004).\n * 중단 · 미완료 are left out on purpose (see the file head).\n */\nexport const WORK_ORDER_STATUS: Readonly<Record<string, ScheduleStatus>> = {\n  작성: 'draft',\n  확정: 'released',\n  진행중: 'started',\n  완료: 'completed'\n}\n\nexport type WorkOrderRow = Record<string, unknown>\n\nexport interface WorkOrderSkip {\n  orderId?: string\n  reason: string\n}\n\nexport interface WorkOrderMapping {\n  entries: ProductionScheduleEntry[]\n  skipped: WorkOrderSkip[]\n}\n\nconst text = (v: unknown) => (v == null ? '' : String(v).trim())\n\n/** Offset of `timeZone` from UTC at `utcMs`, in ms. */\nfunction offsetMs(utcMs: number, timeZone: string): number {\n  const parts = new Intl.DateTimeFormat('en-US', {\n    timeZone,\n    hourCycle: 'h23',\n    year: 'numeric',\n    month: '2-digit',\n    day: '2-digit',\n    hour: '2-digit',\n    minute: '2-digit',\n    second: '2-digit'\n  }).formatToParts(new Date(utcMs))\n  const n = (type: string) => Number(parts.find(p => p.type === type)?.value)\n  return Date.UTC(n('year'), n('month') - 1, n('day'), n('hour'), n('minute'), n('second')) - utcMs\n}\n\n/** A plant-local wall time as an ISO instant. Undefined when the parts are not a time. */\nexport function localToIso(\n  date: string,\n  time: string,\n  timeZone: string\n): string | undefined {\n  const d = /^(\\d{4})-?(\\d{2})-?(\\d{2})$/.exec(date)\n  const t = /^(\\d{2}):?(\\d{2})(?::?(\\d{2}))?$/.exec(time)\n  if (!d || !t) return undefined\n  const wall = Date.UTC(+d[1], +d[2] - 1, +d[3], +t[1], +t[2], +(t[3] ?? 0))\n  if (!Number.isFinite(wall)) return undefined\n  /* two passes: the offset at the guessed instant, then at the corrected one (around a DST change) */\n  let at = wall - offsetMs(wall, timeZone)\n  at = wall - offsetMs(at, timeZone)\n  return new Date(at).toISOString()\n}\n\n/** The content revision — what the floor would act on, in a fixed order. */\nexport function contentRevision(e: Omit<ProductionScheduleEntry, 'revision' | 'recordTime' | 'orderId'>): string {\n  const content = [e.materialDefinitionId, e.quantity, e.uom, e.startTime ?? '', e.endTime ?? '', e.status]\n  return createHash('sha256').update(JSON.stringify(content)).digest('hex').slice(0, 16)\n}\n\nfunction one(row: WorkOrderRow, timeZone: string): ProductionScheduleEntry | WorkOrderSkip {\n  const orderId = text(row.WorkOrderNo)\n  if (!orderId) return { reason: 'no WorkOrderNo' }\n\n  if (text(row.IsStop) === '1') return { orderId, reason: 'stopped in SystemEver (IsStop) — not mapped' }\n\n  const statusName = text(row.ProgStatusName)\n  const status = WORK_ORDER_STATUS[statusName]\n  if (!status) return { orderId, reason: `unknown progress status \"${statusName}\" — not mapped` }\n\n  const materialDefinitionId = text(row.GoodItemNo)\n  if (!materialDefinitionId) return { orderId, reason: 'no GoodItemNo' }\n\n  const quantity = Number(text(row.OrderQty))\n  if (!text(row.OrderQty) || !Number.isFinite(quantity)) return { orderId, reason: `OrderQty \"${text(row.OrderQty)}\" is not a number` }\n\n  const uom = text(row.ItemUnitName)\n  if (!uom) return { orderId, reason: 'no ItemUnitName — a unit is not invented' }\n\n  const day = text(row.WorkDate)\n  const startTime = day && text(row.WorkStartTime) ? localToIso(day, text(row.WorkStartTime), timeZone) : undefined\n  const endTime = day && text(row.WorkEndTime) ? localToIso(day, text(row.WorkEndTime), timeZone) : undefined\n\n  const [lastDay, lastTime] = text(row.LastDateTime).split(/\\s+/)\n  const recordTime = lastDay && lastTime ? localToIso(lastDay, lastTime, timeZone) : undefined\n\n  const content = {\n    materialDefinitionId,\n    quantity,\n    uom,\n    ...(startTime ? { startTime } : {}),\n    ...(endTime ? { endTime } : {}),\n    status\n  }\n\n  return {\n    orderId,\n    ...content,\n    revision: contentRevision(content),\n    ...(text(row.WorkCenterName) ? { workCenter: text(row.WorkCenterName) } : {}),\n    ...(recordTime ? { recordTime } : {})\n  }\n}\n\n/**\n * Map a 작업지시조회 response.\n *\n * An order that comes as more than one line (several `WorkOrderSerl`, i.e. several processes) is skipped whole:\n * the contract entry is one order, and picking one line would drop the others. Miratek's in-house orders are one\n * process each; if that changes, this says so instead of guessing.\n *\n * @throws when `timeZone` is missing or unknown — no row can be read without it.\n */\nexport function toScheduleEntries(rows: WorkOrderRow[], options: { timeZone: string }): WorkOrderMapping {\n  const timeZone = text(options?.timeZone)\n  if (!timeZone) throw new Error('timeZone is not set — SystemEver times are plant-local')\n  new Intl.DateTimeFormat('en-US', { timeZone })\n\n  const lines = new Map<string, number>()\n  for (const row of rows) {\n    const no = text(row.WorkOrderNo)\n    if (no) lines.set(no, (lines.get(no) ?? 0) + 1)\n  }\n\n  const result: WorkOrderMapping = { entries: [], skipped: [] }\n  for (const row of rows) {\n    const no = text(row.WorkOrderNo)\n    if (no && (lines.get(no) ?? 0) > 1) {\n      result.skipped.push({ orderId: no, reason: `${lines.get(no)} lines (WorkOrderSerl) for one order — not mapped` })\n      continue\n    }\n    const mapped = one(row, timeZone)\n    if ('reason' in mapped) result.skipped.push(mapped)\n    else result.entries.push(mapped)\n  }\n  return result\n}\n"]}

package/logs/.5e5d741d8b7784a2fbad65eedc0fd46946aaf6f2-audit.json

@@ -0,0 +1,15 @@
+{
+    "keep": {
+        "days": true,
+        "amount": 14
+    },
+    "auditLog": "logs/.5e5d741d8b7784a2fbad65eedc0fd46946aaf6f2-audit.json",
+    "files": [
+        {
+            "date": 1791166847865,
+            "name": "logs/connections-2026-10-05-11.log",
+            "hash": "5647fcfe1bef3c9ddec598c57f6b17fdfdd80114133657ed3f064381a430548d"
+        }
+    ],
+    "hashType": "sha256"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/erp-systemever",
-  "version": "10.1.117",
+  "version": "10.1.118",
   "main": "dist-server/index.js",
   "type": "module",
   "description": "Younglimwon SystemEver adapter for the ERP (Level 4) ↔ MES (Level 3) boundary — a manual-export ERP: work report lines a person pastes into the work report sheet.",
@@ -22,7 +22,9 @@
     "test": "node --import ./test/resolve-ts-siblings.mjs --test test/*.test.ts"
   },
   "dependencies": {
-    "@operato/ops-contract": "^0.9.41"
+    "@operato/ops-contract": "^0.9.41",
+    "@things-factory/integration-base": "^10.1.118",
+    "@things-factory/utils": "^10.1.20"
   },
-  "gitHead": "cab2426c1c6e63b53a0a2087eef28c9c55df71dd"
+  "gitHead": "53d4c1839c41c7305c8f18021120fd3ad82871c6"
 }

package/server/index.ts

@@ -1 +1,9 @@
 export * from './systemever-adapter.js'
+export * from './systemever-work-order.js'
+export * from './systemever-query-policy.js'
+export * from './systemever-query-response.js'
+export * from './systemever-work-order-query.js'
+export * from './systemever-query-runner.js'
+import './systemever-connector.js'
+import './systemever-query-task.js'
+import './systemever-schedule-task.js'