@things-factory/ops-master 10.1.248 → 10.1.250

package/dist-server/service/ai-entry/master-entry-targets.js

@@ -0,0 +1,293 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.changeableFieldsOf = exports.OPS_MASTER_ENTRY_SPECS = void 0;
+exports.opsMasterEntryTargetOf = opsMasterEntryTargetOf;
+exports.opsMasterEntryTargets = opsMasterEntryTargets;
+/*
+ * AI 입력 대상 — the master records the assistant may enter and change from material: a spreadsheet of locations, a
+ * list of equipment, a page of stop reasons (operato-application/design/ai/data-entry.md).
+ *
+ * Plain declarations. An application that runs `@things-factory/ai-assistant` registers each one:
+ *
+ *   for (const target of opsMasterEntryTargets()) registerEntryTarget(target)
+ *
+ * and opens the ones a mode should offer by key (`entryTargets: ['ops-master.equipment']`).
+ *
+ * Every row goes through the master screen's own mutation (`updateMultiple<Axis>`), one row per call, run with the
+ * person's request state - the same privilege, the same change policy, the same refusals as the grid. A row is sent
+ * with **only the declared fields**: a change saves `{ ...found, ...values }`, so anything else would overwrite the
+ * record. `applied` is never sent: a tracked field changed here is claimed from now.
+ */
+const ops_contract_1 = require("@operato/ops-contract");
+const state_period_rules_1 = require("../equipment/state-period-rules");
+const master_entry_rules_1 = require("./master-entry-rules");
+const PAGE = { page: 1, limit: 20 };
+const namedBy = (list) => ({
+    query: `query ($search: String, $pagination: Pagination) { ${list}(search: $search, pagination: $pagination) { items { name description } } }`,
+    variables: text => ({ search: text, pagination: PAGE }),
+    recordsOf: (data, text) => (0, master_entry_rules_1.mastersNamed)(data, list, text)
+});
+const NAME = { name: 'name', type: 'string', required: true, labelKey: 'field.name', description: 'the name (code) exactly as the material writes it - unique on this list; never make one up' };
+const DESCRIPTION = { name: 'description', type: 'string', labelKey: 'field.description', description: 'what it is, in the words of the material' };
+const homeLocation = (required) => ({
+    name: 'homeLocation',
+    type: 'reference',
+    ...(required ? { required } : {}),
+    labelKey: 'field.home-location',
+    description: 'the operational location it belongs to, as the material names it - its name or its description',
+    reference: namedBy('operationalLocations')
+});
+const classList = (name, labelKey, what) => ({
+    name,
+    type: 'string',
+    labelKey,
+    description: `the ${what} it belongs to, as names separated by commas - each must already exist`
+});
+const baseClasses = (what) => ({
+    name: 'baseIds',
+    type: 'string',
+    labelKey: 'field.base-classes',
+    description: `the ${what} this one inherits from, as names separated by commas - each must already exist; enter a base before the classes under it`
+});
+const classAxis = (axis, list, mutation, what, snapshotKey) => ({
+    axis,
+    list,
+    mutation,
+    description: `one ${what}: its name, what it is, and the ${what}es it inherits from.`,
+    fields: [NAME, DESCRIPTION, baseClasses(`${what}es`)],
+    lists: { baseIds: axis },
+    snapshotKey,
+    recordFields: ['name', 'description', 'baseIds']
+});
+exports.OPS_MASTER_ENTRY_SPECS = [
+    {
+        axis: 'operationalLocation',
+        list: 'operationalLocations',
+        mutation: 'updateMultipleOperationalLocation',
+        description: 'one operational location - a site, area, line, cell, store or dock: its name, what it is, its type, which system owns it, its ISA-95 level, ' +
+            'how many it holds and works at once, and the location it sits under. A change of the parent is recorded as a tracked change from now.',
+        fields: [
+            NAME,
+            DESCRIPTION,
+            { name: 'type', type: 'string', required: true, labelKey: 'field.location-type', description: "the location type key of the site's catalog as the material writes it (raw-store, weld-station, dock)" },
+            { name: 'system', type: 'enum', values: [...ops_contract_1.DOMAIN_SYSTEMS], labelKey: 'field.owning-system', description: 'which system owns the place: wms = warehouse, yms = yard, mes = factory, ems = energy; leave empty when the material does not say' },
+            { name: 'level', type: 'enum', values: [...ops_contract_1.EQUIPMENT_LEVEL], labelKey: 'field.equipment-level', description: 'the ISA-95 equipment hierarchy level' },
+            { name: 'capacity', type: 'integer', labelKey: 'field.capacity', description: 'how many it holds - leave empty when unknown' },
+            { name: 'parallelism', type: 'integer', labelKey: 'field.parallelism', description: 'how many it works on at once - leave empty when unknown' },
+            {
+                name: 'parentId',
+                type: 'reference',
+                labelKey: 'field.parent-location',
+                description: 'the location it sits under, as the material names it; empty for a top location. A change is recorded as a tracked change from now',
+                reference: namedBy('operationalLocations')
+            }
+        ],
+        lists: {},
+        parentField: 'parentId',
+        snapshotKey: 'operationalLocations',
+        recordFields: ['name', 'description', 'type', 'system', 'level', 'capacity', 'parallelism', 'parentId']
+    },
+    {
+        axis: 'equipment',
+        list: 'equipmentList',
+        mutation: 'updateMultipleEquipment',
+        description: 'one equipment: its name, what it is, its kind, where it is installed, its identifier and its classes. A change of where it is installed is recorded as a tracked change from now.',
+        fields: [
+            NAME,
+            DESCRIPTION,
+            { name: 'kind', type: 'string', required: true, labelKey: 'field.equipment-class', description: 'the kind of equipment as the material writes it (press, robot, conveyor)' },
+            { ...homeLocation(true), description: 'where it is installed - the operational location as the material names it. A change is recorded as a tracked change from now' },
+            { name: 'identity', type: 'string', labelKey: 'field.identity', description: 'its GS1 identifier, only when the material gives one' },
+            classList('equipmentClassIds', 'field.equipment-classes', 'equipment classes')
+        ],
+        lists: { equipmentClassIds: 'equipmentClass' },
+        snapshotKey: 'equipment',
+        recordFields: ['name', 'description', 'kind', 'homeLocation', 'identity', 'equipmentClassIds']
+    },
+    {
+        axis: 'person',
+        list: 'persons',
+        mutation: 'updateMultiplePerson',
+        description: 'one person on the floor: the name they are known by, a note, their qualifications and where they work.',
+        fields: [NAME, DESCRIPTION, classList('personnelClassIds', 'field.personnel-classes', 'personnel classes (qualifications)'), homeLocation(false)],
+        lists: { personnelClassIds: 'personnelClass' },
+        snapshotKey: 'persons',
+        recordFields: ['name', 'description', 'personnelClassIds', 'homeLocation']
+    },
+    {
+        axis: 'physicalAsset',
+        list: 'physicalAssets',
+        mutation: 'updateMultiplePhysicalAsset',
+        description: 'one physical asset - a tool, jig, mold or gauge: its name, what it is, its classes, where it is kept and its identifier.',
+        fields: [
+            NAME,
+            DESCRIPTION,
+            classList('assetClassIds', 'field.asset-classes', 'physical asset classes'),
+            { ...homeLocation(false), description: 'where it is kept - the operational location as the material names it' },
+            { name: 'identity', type: 'string', labelKey: 'field.grai', description: 'its GRAI, only when the material gives one' }
+        ],
+        lists: { assetClassIds: 'physicalAssetClass' },
+        snapshotKey: 'physicalAssets',
+        recordFields: ['name', 'description', 'assetClassIds', 'homeLocation', 'identity']
+    },
+    {
+        axis: 'stopReason',
+        list: 'stopReasonList',
+        mutation: 'updateMultipleStopReason',
+        description: 'one equipment stop reason: its code, what it means, the equipment state it is for, its parent reason, and whether the floor must add a note.',
+        fields: [
+            { ...NAME, description: 'the reason code exactly as the material writes it - unique on this list; never make one up' },
+            DESCRIPTION,
+            {
+                name: 'status',
+                type: 'enum',
+                required: true,
+                values: [...state_period_rules_1.STOP_REASON_STATUS],
+                labelKey: 'field.status',
+                valueKeyPrefix: 'text.state-',
+                description: 'the equipment state the reason is for: down = broken down, setup = changeover, planned-stop = a planned stop, idle = waiting'
+            },
+            { name: 'parentName', type: 'reference', labelKey: 'field.parent-reason', description: 'the reason it sits under, as the material names it', reference: namedBy('stopReasonList') },
+            { name: 'detailRequired', type: 'boolean', labelKey: 'field.detail-required', description: 'true when the floor must add a note on choosing it' }
+        ],
+        lists: {},
+        parentField: 'parentName',
+        snapshotKey: 'stopReasons',
+        recordFields: ['name', 'description', 'status', 'parentName', 'detailRequired']
+    },
+    {
+        axis: 'nonconformanceCause',
+        list: 'nonconformanceCauseList',
+        mutation: 'updateMultipleNonconformanceCause',
+        description: 'one nonconformance cause: its code, what it means, its parent cause, and whether a note must be added.',
+        fields: [
+            { ...NAME, description: 'the cause code exactly as the material writes it - unique on this list; never make one up' },
+            DESCRIPTION,
+            { name: 'parentName', type: 'reference', labelKey: 'field.parent-reason', description: 'the cause it sits under, as the material names it', reference: namedBy('nonconformanceCauseList') },
+            { name: 'detailRequired', type: 'boolean', labelKey: 'field.detail-required', description: 'true when a note must be added on choosing it' }
+        ],
+        lists: {},
+        parentField: 'parentName',
+        recordFields: ['name', 'description', 'parentName', 'detailRequired']
+    },
+    classAxis('equipmentClass', 'equipmentClasses', 'updateMultipleEquipmentClass', 'equipment class', 'equipmentClasses'),
+    classAxis('personnelClass', 'personnelClasses', 'updateMultiplePersonnelClass', 'personnel class', 'personnelClasses'),
+    classAxis('physicalAssetClass', 'physicalAssetClasses', 'updateMultiplePhysicalAssetClass', 'physical asset class', 'physicalAssetClasses'),
+    classAxis('materialClass', 'materialClasses', 'updateMultipleMaterialClass', 'material class', 'materialClasses')
+];
+/** The fields a change may touch - every declared field; the update check reads the names a change gives. */
+const changeableFieldsOf = (spec) => spec.fields.map(field => field.name);
+exports.changeableFieldsOf = changeableFieldsOf;
+/** A list field read back as the comma list it was written as. */
+function recordOf(spec, item) {
+    const record = { id: item.id };
+    for (const name of spec.recordFields) {
+        const value = item[name];
+        record[name] = spec.lists[name] && Array.isArray(value) ? value.join(', ') : value ?? null;
+    }
+    return record;
+}
+const labelOf = (record) => [record.name, record.description].filter(value => typeof value === 'string' && value).join(' · ');
+/** Names on an axis in the domain, read from the master table - lazy, so the rules load without the shell. */
+async function namesInDomain(domain, axis, names) {
+    const found = new Map();
+    if (!names.length)
+        return found;
+    const [{ getRepository }, { In }, { masterAxisOf }] = await Promise.all([Promise.resolve().then(() => __importStar(require('@things-factory/shell'))), Promise.resolve().then(() => __importStar(require('typeorm'))), Promise.resolve().then(() => __importStar(require('../master-axis')))]);
+    const repository = getRepository(masterAxisOf(axis).entity);
+    for (let at = 0; at < names.length; at += 500) {
+        const rows = await repository.find({ where: { domain: { id: domain.id }, name: In(names.slice(at, at + 500)) } });
+        for (const row of rows)
+            found.set(row.name, row);
+    }
+    return found;
+}
+/** One axis as an entry target. */
+function opsMasterEntryTargetOf(spec, options = {}) {
+    const returned = `{ id name }`;
+    const mutation = `mutation ($patches: [Object!]!) { ${spec.mutation}(patches: $patches) ${returned} }`;
+    const items = `items { id ${spec.recordFields.join(' ')} }`;
+    const lookup = options.lookup ?? ((domain) => (axis, names) => namesInDomain(domain, axis, names));
+    return {
+        key: (0, master_entry_rules_1.opsMasterEntryKey)(spec.axis),
+        labelKey: (0, master_entry_rules_1.opsMasterEntryLabelKey)(spec.axis),
+        description: spec.description,
+        fields: spec.fields,
+        mutation,
+        /* One row per call - each row is answered by its place, and one taken name does not undo the others. */
+        variables: row => ({ patches: [{ cuFlag: '+', ...(0, master_entry_rules_1.masterPatchOf)(row.values, spec) }] }),
+        appliedOf: (data, row) => {
+            const saved = data?.[spec.mutation]?.[0];
+            return { ...(saved?.id ? { id: saved.id } : {}), label: saved?.name ?? (0, master_entry_rules_1.nameOf)(row.values) };
+        },
+        maxRows: 200,
+        check: async (rows, { state }) => {
+            const domain = state?.domain;
+            if (!domain?.id)
+                return rows.map(() => []);
+            return (0, master_entry_rules_1.checkMasterRows)(spec, rows, lookup(domain));
+        },
+        update: {
+            read: {
+                query: `query ($filters: [Filter!], $pagination: Pagination) { ${spec.list}(filters: $filters, pagination: $pagination) { ${items} } }`,
+                variables: ids => ({ filters: [{ name: 'id', operator: 'in', value: ids }], pagination: { page: 1, limit: Math.max(ids.length, 1) } }),
+                recordsOf: (data, ids) => (data?.[spec.list]?.items ?? []).filter((item) => ids.includes(item?.id)).map((item) => recordOf(spec, item))
+            },
+            find: {
+                query: `query ($search: String, $pagination: Pagination) { ${spec.list}(search: $search, pagination: $pagination) { ${items} } }`,
+                variables: criteria => ({ ...(typeof criteria.text === 'string' && criteria.text ? { search: criteria.text } : {}), pagination: PAGE }),
+                recordsOf: data => (data?.[spec.list]?.items ?? []).map((item) => recordOf(spec, item)),
+                criteria: [{ name: 'text', type: 'string', description: 'a name, a code or words of the description, as the person said them' }]
+            },
+            mutation,
+            /* Only the fields that change - the rest of the record is the saved one, not a copy the card read. */
+            variables: ({ id, values }) => ({ patches: [{ cuFlag: 'M', id, ...(0, master_entry_rules_1.masterPatchOf)(values, spec, true) }] }),
+            labelOf,
+            fields: (0, exports.changeableFieldsOf)(spec),
+            check: async (changes, { state }) => {
+                const domain = state?.domain;
+                if (!domain?.id)
+                    return changes.map(() => []);
+                return (0, master_entry_rules_1.checkMasterChanges)(spec, changes, lookup(domain));
+            }
+        }
+    };
+}
+/** Every master axis the assistant may enter, as targets to register. */
+function opsMasterEntryTargets(options = {}) {
+    return exports.OPS_MASTER_ENTRY_SPECS.map(spec => opsMasterEntryTargetOf(spec, options));
+}
+//# sourceMappingURL=master-entry-targets.js.map

package/dist-server/service/ai-entry/master-entry-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-entry-targets.js","sourceRoot":"","sources":["../../../server/service/ai-entry/master-entry-targets.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * AI 입력 대상 — the master records the assistant may enter and change from material: a spreadsheet of locations, a\n * list of equipment, a page of stop reasons (operato-application/design/ai/data-entry.md).\n *\n * Plain declarations. An application that runs `@things-factory/ai-assistant` registers each one:\n *\n *   for (const target of opsMasterEntryTargets()) registerEntryTarget(target)\n *\n * and opens the ones a mode should offer by key (`entryTargets: ['ops-master.equipment']`).\n *\n * Every row goes through the master screen's own mutation (`updateMultiple<Axis>`), one row per call, run with the\n * person's request state - the same privilege, the same change policy, the same refusals as the grid. A row is sent\n * with **only the declared fields**: a change saves `{ ...found, ...values }`, so anything else would overwrite the\n * record. `applied` is never sent: a tracked field changed here is claimed from now.\n */\nimport { DOMAIN_SYSTEMS, EQUIPMENT_LEVEL } from '@operato/ops-contract'\n\nimport { STOP_REASON_STATUS } from '../equipment/state-period-rules'\nimport {\n  checkMasterChanges,\n  checkMasterRows,\n  masterPatchOf,\n  mastersNamed,\n  nameOf,\n  opsMasterEntryKey,\n  opsMasterEntryLabelKey,\n  type MasterEntryRuleSpec,\n  type MasterNamesLookup,\n  type MasterRow,\n  type OpsMasterEntryAxis,\n  type OpsMasterEntryField,\n  type OpsMasterEntryRecord,\n  type OpsMasterEntryTarget\n} from './master-entry-rules'\n\nconst PAGE = { page: 1, limit: 20 }\n\n/** The list query an axis is read and searched through, and the grid's mutation. */\nexport interface OpsMasterEntryAxisSpec extends MasterEntryRuleSpec {\n  /** `operationalLocations` · `equipmentList` … */\n  list: string\n  /** `updateMultipleOperationalLocation` … */\n  mutation: string\n  /** What one row is, for the model. */\n  description: string\n  /** The fields the read query asks besides `id`. */\n  recordFields: string[]\n}\n\nconst namedBy = (list: string): OpsMasterEntryField['reference'] => ({\n  query: `query ($search: String, $pagination: Pagination) { ${list}(search: $search, pagination: $pagination) { items { name description } } }`,\n  variables: text => ({ search: text, pagination: PAGE }),\n  recordsOf: (data, text) => mastersNamed(data, list, text)\n})\n\nconst NAME: OpsMasterEntryField = { name: 'name', type: 'string', required: true, labelKey: 'field.name', description: 'the name (code) exactly as the material writes it - unique on this list; never make one up' }\nconst DESCRIPTION: OpsMasterEntryField = { name: 'description', type: 'string', labelKey: 'field.description', description: 'what it is, in the words of the material' }\n\nconst homeLocation = (required: boolean): OpsMasterEntryField => ({\n  name: 'homeLocation',\n  type: 'reference',\n  ...(required ? { required } : {}),\n  labelKey: 'field.home-location',\n  description: 'the operational location it belongs to, as the material names it - its name or its description',\n  reference: namedBy('operationalLocations')\n})\n\nconst classList = (name: string, labelKey: string, what: string): OpsMasterEntryField => ({\n  name,\n  type: 'string',\n  labelKey,\n  description: `the ${what} it belongs to, as names separated by commas - each must already exist`\n})\n\nconst baseClasses = (what: string): OpsMasterEntryField => ({\n  name: 'baseIds',\n  type: 'string',\n  labelKey: 'field.base-classes',\n  description: `the ${what} this one inherits from, as names separated by commas - each must already exist; enter a base before the classes under it`\n})\n\nconst classAxis = (axis: OpsMasterEntryAxis, list: string, mutation: string, what: string, snapshotKey: OpsMasterEntryAxisSpec['snapshotKey']): OpsMasterEntryAxisSpec => ({\n  axis,\n  list,\n  mutation,\n  description: `one ${what}: its name, what it is, and the ${what}es it inherits from.`,\n  fields: [NAME, DESCRIPTION, baseClasses(`${what}es`)],\n  lists: { baseIds: axis },\n  snapshotKey,\n  recordFields: ['name', 'description', 'baseIds']\n})\n\nexport const OPS_MASTER_ENTRY_SPECS: readonly OpsMasterEntryAxisSpec[] = [\n  {\n    axis: 'operationalLocation',\n    list: 'operationalLocations',\n    mutation: 'updateMultipleOperationalLocation',\n    description:\n      'one operational location - a site, area, line, cell, store or dock: its name, what it is, its type, which system owns it, its ISA-95 level, ' +\n      'how many it holds and works at once, and the location it sits under. A change of the parent is recorded as a tracked change from now.',\n    fields: [\n      NAME,\n      DESCRIPTION,\n      { name: 'type', type: 'string', required: true, labelKey: 'field.location-type', description: \"the location type key of the site's catalog as the material writes it (raw-store, weld-station, dock)\" },\n      { name: 'system', type: 'enum', values: [...DOMAIN_SYSTEMS], labelKey: 'field.owning-system', description: 'which system owns the place: wms = warehouse, yms = yard, mes = factory, ems = energy; leave empty when the material does not say' },\n      { name: 'level', type: 'enum', values: [...EQUIPMENT_LEVEL], labelKey: 'field.equipment-level', description: 'the ISA-95 equipment hierarchy level' },\n      { name: 'capacity', type: 'integer', labelKey: 'field.capacity', description: 'how many it holds - leave empty when unknown' },\n      { name: 'parallelism', type: 'integer', labelKey: 'field.parallelism', description: 'how many it works on at once - leave empty when unknown' },\n      {\n        name: 'parentId',\n        type: 'reference',\n        labelKey: 'field.parent-location',\n        description: 'the location it sits under, as the material names it; empty for a top location. A change is recorded as a tracked change from now',\n        reference: namedBy('operationalLocations')\n      }\n    ],\n    lists: {},\n    parentField: 'parentId',\n    snapshotKey: 'operationalLocations',\n    recordFields: ['name', 'description', 'type', 'system', 'level', 'capacity', 'parallelism', 'parentId']\n  },\n  {\n    axis: 'equipment',\n    list: 'equipmentList',\n    mutation: 'updateMultipleEquipment',\n    description:\n      'one equipment: its name, what it is, its kind, where it is installed, its identifier and its classes. A change of where it is installed is recorded as a tracked change from now.',\n    fields: [\n      NAME,\n      DESCRIPTION,\n      { name: 'kind', type: 'string', required: true, labelKey: 'field.equipment-class', description: 'the kind of equipment as the material writes it (press, robot, conveyor)' },\n      { ...homeLocation(true), description: 'where it is installed - the operational location as the material names it. A change is recorded as a tracked change from now' },\n      { name: 'identity', type: 'string', labelKey: 'field.identity', description: 'its GS1 identifier, only when the material gives one' },\n      classList('equipmentClassIds', 'field.equipment-classes', 'equipment classes')\n    ],\n    lists: { equipmentClassIds: 'equipmentClass' },\n    snapshotKey: 'equipment',\n    recordFields: ['name', 'description', 'kind', 'homeLocation', 'identity', 'equipmentClassIds']\n  },\n  {\n    axis: 'person',\n    list: 'persons',\n    mutation: 'updateMultiplePerson',\n    description: 'one person on the floor: the name they are known by, a note, their qualifications and where they work.',\n    fields: [NAME, DESCRIPTION, classList('personnelClassIds', 'field.personnel-classes', 'personnel classes (qualifications)'), homeLocation(false)],\n    lists: { personnelClassIds: 'personnelClass' },\n    snapshotKey: 'persons',\n    recordFields: ['name', 'description', 'personnelClassIds', 'homeLocation']\n  },\n  {\n    axis: 'physicalAsset',\n    list: 'physicalAssets',\n    mutation: 'updateMultiplePhysicalAsset',\n    description: 'one physical asset - a tool, jig, mold or gauge: its name, what it is, its classes, where it is kept and its identifier.',\n    fields: [\n      NAME,\n      DESCRIPTION,\n      classList('assetClassIds', 'field.asset-classes', 'physical asset classes'),\n      { ...homeLocation(false), description: 'where it is kept - the operational location as the material names it' },\n      { name: 'identity', type: 'string', labelKey: 'field.grai', description: 'its GRAI, only when the material gives one' }\n    ],\n    lists: { assetClassIds: 'physicalAssetClass' },\n    snapshotKey: 'physicalAssets',\n    recordFields: ['name', 'description', 'assetClassIds', 'homeLocation', 'identity']\n  },\n  {\n    axis: 'stopReason',\n    list: 'stopReasonList',\n    mutation: 'updateMultipleStopReason',\n    description: 'one equipment stop reason: its code, what it means, the equipment state it is for, its parent reason, and whether the floor must add a note.',\n    fields: [\n      { ...NAME, description: 'the reason code exactly as the material writes it - unique on this list; never make one up' },\n      DESCRIPTION,\n      {\n        name: 'status',\n        type: 'enum',\n        required: true,\n        values: [...STOP_REASON_STATUS],\n        labelKey: 'field.status',\n        valueKeyPrefix: 'text.state-',\n        description: 'the equipment state the reason is for: down = broken down, setup = changeover, planned-stop = a planned stop, idle = waiting'\n      },\n      { name: 'parentName', type: 'reference', labelKey: 'field.parent-reason', description: 'the reason it sits under, as the material names it', reference: namedBy('stopReasonList') },\n      { name: 'detailRequired', type: 'boolean', labelKey: 'field.detail-required', description: 'true when the floor must add a note on choosing it' }\n    ],\n    lists: {},\n    parentField: 'parentName',\n    snapshotKey: 'stopReasons',\n    recordFields: ['name', 'description', 'status', 'parentName', 'detailRequired']\n  },\n  {\n    axis: 'nonconformanceCause',\n    list: 'nonconformanceCauseList',\n    mutation: 'updateMultipleNonconformanceCause',\n    description: 'one nonconformance cause: its code, what it means, its parent cause, and whether a note must be added.',\n    fields: [\n      { ...NAME, description: 'the cause code exactly as the material writes it - unique on this list; never make one up' },\n      DESCRIPTION,\n      { name: 'parentName', type: 'reference', labelKey: 'field.parent-reason', description: 'the cause it sits under, as the material names it', reference: namedBy('nonconformanceCauseList') },\n      { name: 'detailRequired', type: 'boolean', labelKey: 'field.detail-required', description: 'true when a note must be added on choosing it' }\n    ],\n    lists: {},\n    parentField: 'parentName',\n    recordFields: ['name', 'description', 'parentName', 'detailRequired']\n  },\n  classAxis('equipmentClass', 'equipmentClasses', 'updateMultipleEquipmentClass', 'equipment class', 'equipmentClasses'),\n  classAxis('personnelClass', 'personnelClasses', 'updateMultiplePersonnelClass', 'personnel class', 'personnelClasses'),\n  classAxis('physicalAssetClass', 'physicalAssetClasses', 'updateMultiplePhysicalAssetClass', 'physical asset class', 'physicalAssetClasses'),\n  classAxis('materialClass', 'materialClasses', 'updateMultipleMaterialClass', 'material class', 'materialClasses')\n]\n\n/** The fields a change may touch - every declared field; the update check reads the names a change gives. */\nexport const changeableFieldsOf = (spec: Pick<OpsMasterEntryAxisSpec, 'fields'>) => spec.fields.map(field => field.name)\n\n/** A list field read back as the comma list it was written as. */\nfunction recordOf(spec: OpsMasterEntryAxisSpec, item: any): OpsMasterEntryRecord {\n  const record: OpsMasterEntryRecord = { id: item.id }\n  for (const name of spec.recordFields) {\n    const value = item[name]\n    record[name] = spec.lists[name] && Array.isArray(value) ? value.join(', ') : value ?? null\n  }\n  return record\n}\n\nconst labelOf = (record: OpsMasterEntryRecord) => [record.name, record.description].filter(value => typeof value === 'string' && value).join(' · ')\n\n/** Names on an axis in the domain, read from the master table - lazy, so the rules load without the shell. */\nasync function namesInDomain(domain: any, axis: OpsMasterEntryAxis, names: string[]): Promise<Map<string, MasterRow>> {\n  const found = new Map<string, MasterRow>()\n  if (!names.length) return found\n  const [{ getRepository }, { In }, { masterAxisOf }] = await Promise.all([import('@things-factory/shell'), import('typeorm'), import('../master-axis')])\n  const repository = getRepository(masterAxisOf(axis).entity)\n  for (let at = 0; at < names.length; at += 500) {\n    const rows = await repository.find({ where: { domain: { id: domain.id }, name: In(names.slice(at, at + 500)) } as any })\n    for (const row of rows) found.set(row.name, row as MasterRow)\n  }\n  return found\n}\n\nexport interface OpsMasterEntryOptions {\n  /** Which names exist - the master tables by default; a test gives its own. */\n  lookup?: (domain: any) => MasterNamesLookup\n}\n\n/** One axis as an entry target. */\nexport function opsMasterEntryTargetOf(spec: OpsMasterEntryAxisSpec, options: OpsMasterEntryOptions = {}): OpsMasterEntryTarget {\n  const returned = `{ id name }`\n  const mutation = `mutation ($patches: [Object!]!) { ${spec.mutation}(patches: $patches) ${returned} }`\n  const items = `items { id ${spec.recordFields.join(' ')} }`\n  const lookup = options.lookup ?? ((domain: any): MasterNamesLookup => (axis, names) => namesInDomain(domain, axis, names))\n\n  return {\n    key: opsMasterEntryKey(spec.axis),\n    labelKey: opsMasterEntryLabelKey(spec.axis),\n    description: spec.description,\n    fields: spec.fields,\n    mutation,\n    /* One row per call - each row is answered by its place, and one taken name does not undo the others. */\n    variables: row => ({ patches: [{ cuFlag: '+', ...masterPatchOf(row.values, spec) }] }),\n    appliedOf: (data, row) => {\n      const saved = data?.[spec.mutation]?.[0]\n      return { ...(saved?.id ? { id: saved.id } : {}), label: saved?.name ?? nameOf(row.values) }\n    },\n    maxRows: 200,\n    check: async (rows, { state }) => {\n      const domain = state?.domain\n      if (!domain?.id) return rows.map(() => [])\n      return checkMasterRows(spec, rows, lookup(domain))\n    },\n    update: {\n      read: {\n        query: `query ($filters: [Filter!], $pagination: Pagination) { ${spec.list}(filters: $filters, pagination: $pagination) { ${items} } }`,\n        variables: ids => ({ filters: [{ name: 'id', operator: 'in', value: ids }], pagination: { page: 1, limit: Math.max(ids.length, 1) } }),\n        recordsOf: (data, ids) => (data?.[spec.list]?.items ?? []).filter((item: any) => ids.includes(item?.id)).map((item: any) => recordOf(spec, item))\n      },\n      find: {\n        query: `query ($search: String, $pagination: Pagination) { ${spec.list}(search: $search, pagination: $pagination) { ${items} } }`,\n        variables: criteria => ({ ...(typeof criteria.text === 'string' && criteria.text ? { search: criteria.text } : {}), pagination: PAGE }),\n        recordsOf: data => (data?.[spec.list]?.items ?? []).map((item: any) => recordOf(spec, item)),\n        criteria: [{ name: 'text', type: 'string', description: 'a name, a code or words of the description, as the person said them' }]\n      },\n      mutation,\n      /* Only the fields that change - the rest of the record is the saved one, not a copy the card read. */\n      variables: ({ id, values }) => ({ patches: [{ cuFlag: 'M', id, ...masterPatchOf(values, spec, true) }] }),\n      labelOf,\n      fields: changeableFieldsOf(spec),\n      check: async (changes, { state }) => {\n        const domain = state?.domain\n        if (!domain?.id) return changes.map(() => [])\n        return checkMasterChanges(spec, changes, lookup(domain))\n      }\n    }\n  }\n}\n\n/** Every master axis the assistant may enter, as targets to register. */\nexport function opsMasterEntryTargets(options: OpsMasterEntryOptions = {}): OpsMasterEntryTarget[] {\n  return OPS_MASTER_ENTRY_SPECS.map(spec => opsMasterEntryTargetOf(spec, options))\n}\n"]}

package/dist-server/service/approval-route.d.ts

@@ -0,0 +1,37 @@
+import { EntityManager } from 'typeorm';
+/**
+ * **규제를 걸려면 누가 결재할지가 정해져 있어야 한다.**
+ *
+ * ── 왜 이 길이 필요한가 ────────────────────────────────────────────────────
+ * 소유자가 어느 축을 「승인 후 변경」으로 바꾸면, 그 축의 기준정보는 그때부터 결재를 지나야 바뀐다.
+ * 그런데 결재선은 양식이 아니라 **그 현장이 정하는 것**이라, 비어 있을 수 있다 — 기동 로그가 매번
+ * 「결재선 비어 있음 miratek, system」이라고 말하고 있었다. 비어 있는 채로 규제를 걸면 상신은 되고
+ * 내려 줄 사람이 없어서, 그 축의 기준정보가 통째로 멈춘다.
+ *
+ * ── 왜 여기서 직접 안 보나 ─────────────────────────────────────────────────
+ * 결재 단계 수는 `worklist` 가 안다. 그런데 **어느 축이 어느 결재 양식을 쓰는가**는 앱이 안다 —
+ * plant 의 `activity-recipe-change`·`activity-work-shift-change` 가 그것이다. 이 묶음은 둘 다
+ * 모르므로, 아는 쪽이 자기 짝을 등록한다.
+ *
+ * ⚠ **아무도 등록 안 했으면 지나간다.** 등록이 없다는 것은 「결재선이 없다」가 아니라 「이 앱은 이
+ * 물음에 답할 길을 아직 안 냈다」이다. 모른다고 막으면 아직 등록하지 않은 앱이 전부 멈춘다.
+ */
+export interface ApprovalRouteReport {
+    /** 이 축을 규제로 걸어도 되는가 — 결재할 사람이 정해져 있는가. */
+    ready: boolean;
+    /** 어느 결재 양식을 말하는가. 사람이 어디를 고쳐야 하는지 알아야 한다. */
+    activity?: string;
+}
+export type ApprovalRouteInspector = (manager: EntityManager, domainId: string, axis: string) => Promise<ApprovalRouteReport | undefined>;
+/** 앱이 자기 결재 양식을 아는 길을 낸다. 나중 것이 앞의 것을 대신한다. */
+export declare function registerApprovalRouteInspector(one: ApprovalRouteInspector): void;
+/** 시험이 자기 자리를 되돌린다. */
+export declare function clearApprovalRouteInspector(): void;
+/**
+ * 이 축의 결재 길이 준비됐나 — **묻기만 한다.**
+ *
+ * 화면이 누르기 전에 먼저 본다. 눌러서 거절당하고 나서야 「결재선을 정하십시오」를 듣는 것은, 고를 수
+ * 없는 것을 골라 보게 한 것이다.
+ */
+export declare function inspectApprovalRoute(manager: EntityManager, domainId: string, axis: string): Promise<ApprovalRouteReport>;
+export declare function assertApprovalRouteReady(manager: EntityManager, domainId: string, axis: string): Promise<void>;

package/dist-server/service/approval-route.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerApprovalRouteInspector = registerApprovalRouteInspector;
+exports.clearApprovalRouteInspector = clearApprovalRouteInspector;
+exports.inspectApprovalRoute = inspectApprovalRoute;
+exports.assertApprovalRouteReady = assertApprovalRouteReady;
+const shell_1 = require("@things-factory/shell");
+let inspector;
+/** 앱이 자기 결재 양식을 아는 길을 낸다. 나중 것이 앞의 것을 대신한다. */
+function registerApprovalRouteInspector(one) {
+    inspector = one;
+}
+/** 시험이 자기 자리를 되돌린다. */
+function clearApprovalRouteInspector() {
+    inspector = undefined;
+}
+/**
+ * 이 축의 결재 길이 준비됐나 — **묻기만 한다.**
+ *
+ * 화면이 누르기 전에 먼저 본다. 눌러서 거절당하고 나서야 「결재선을 정하십시오」를 듣는 것은, 고를 수
+ * 없는 것을 골라 보게 한 것이다.
+ */
+function inspectApprovalRoute(manager, domainId, axis) {
+    return inspector?.(manager, domainId, axis);
+}
+async function assertApprovalRouteReady(manager, domainId, axis) {
+    const report = await inspector?.(manager, domainId, axis);
+    /* 답이 없으면 이 앱은 아직 이 물음에 답할 길이 없다 — 막지 않는다. */
+    if (!report || report.ready) {
+        return;
+    }
+    throw new shell_1.Refusal('MASTER_APPROVAL_LINE_REQUIRED', { axis, activity: report.activity }, 'Set the approval line for this activity before requiring approval on this master axis.');
+}
+//# sourceMappingURL=approval-route.js.map

package/dist-server/service/approval-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-route.js","sourceRoot":"","sources":["../../server/service/approval-route.ts"],"names":[],"mappings":";;AAoCA,wEAEC;AAGD,kEAEC;AAQD,oDAEC;AAED,4DAaC;AAnED,iDAA+C;AAgC/C,IAAI,SAA6C,CAAA;AAEjD,+CAA+C;AAC/C,SAAgB,8BAA8B,CAAC,GAA2B;IACxE,SAAS,GAAG,GAAG,CAAA;AACjB,CAAC;AAED,uBAAuB;AACvB,SAAgB,2BAA2B;IACzC,SAAS,GAAG,SAAS,CAAA;AACvB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,OAAsB,EAAE,QAAgB,EAAE,IAAY;IACzF,OAAO,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;AAC7C,CAAC;AAEM,KAAK,UAAU,wBAAwB,CAAC,OAAsB,EAAE,QAAgB,EAAE,IAAY;IACnG,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;IAEzD,6CAA6C;IAC7C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5B,OAAM;IACR,CAAC;IAED,MAAM,IAAI,eAAO,CACf,+BAA+B,EAC/B,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EACnC,wFAAwF,CACzF,CAAA;AACH,CAAC","sourcesContent":["import { EntityManager } from 'typeorm'\nimport { Refusal } from '@things-factory/shell'\n\n/**\n * **규제를 걸려면 누가 결재할지가 정해져 있어야 한다.**\n *\n * ── 왜 이 길이 필요한가 ────────────────────────────────────────────────────\n * 소유자가 어느 축을 「승인 후 변경」으로 바꾸면, 그 축의 기준정보는 그때부터 결재를 지나야 바뀐다.\n * 그런데 결재선은 양식이 아니라 **그 현장이 정하는 것**이라, 비어 있을 수 있다 — 기동 로그가 매번\n * 「결재선 비어 있음 miratek, system」이라고 말하고 있었다. 비어 있는 채로 규제를 걸면 상신은 되고\n * 내려 줄 사람이 없어서, 그 축의 기준정보가 통째로 멈춘다.\n *\n * ── 왜 여기서 직접 안 보나 ─────────────────────────────────────────────────\n * 결재 단계 수는 `worklist` 가 안다. 그런데 **어느 축이 어느 결재 양식을 쓰는가**는 앱이 안다 —\n * plant 의 `activity-recipe-change`·`activity-work-shift-change` 가 그것이다. 이 묶음은 둘 다\n * 모르므로, 아는 쪽이 자기 짝을 등록한다.\n *\n * ⚠ **아무도 등록 안 했으면 지나간다.** 등록이 없다는 것은 「결재선이 없다」가 아니라 「이 앱은 이\n * 물음에 답할 길을 아직 안 냈다」이다. 모른다고 막으면 아직 등록하지 않은 앱이 전부 멈춘다.\n */\nexport interface ApprovalRouteReport {\n  /** 이 축을 규제로 걸어도 되는가 — 결재할 사람이 정해져 있는가. */\n  ready: boolean\n  /** 어느 결재 양식을 말하는가. 사람이 어디를 고쳐야 하는지 알아야 한다. */\n  activity?: string\n}\n\nexport type ApprovalRouteInspector = (\n  manager: EntityManager,\n  domainId: string,\n  axis: string\n) => Promise<ApprovalRouteReport | undefined>\n\nlet inspector: ApprovalRouteInspector | undefined\n\n/** 앱이 자기 결재 양식을 아는 길을 낸다. 나중 것이 앞의 것을 대신한다. */\nexport function registerApprovalRouteInspector(one: ApprovalRouteInspector) {\n  inspector = one\n}\n\n/** 시험이 자기 자리를 되돌린다. */\nexport function clearApprovalRouteInspector() {\n  inspector = undefined\n}\n\n/**\n * 이 축의 결재 길이 준비됐나 — **묻기만 한다.**\n *\n * 화면이 누르기 전에 먼저 본다. 눌러서 거절당하고 나서야 「결재선을 정하십시오」를 듣는 것은, 고를 수\n * 없는 것을 골라 보게 한 것이다.\n */\nexport function inspectApprovalRoute(manager: EntityManager, domainId: string, axis: string) {\n  return inspector?.(manager, domainId, axis)\n}\n\nexport async function assertApprovalRouteReady(manager: EntityManager, domainId: string, axis: string) {\n  const report = await inspector?.(manager, domainId, axis)\n\n  /* 답이 없으면 이 앱은 아직 이 물음에 답할 길이 없다 — 막지 않는다. */\n  if (!report || report.ready) {\n    return\n  }\n\n  throw new Refusal(\n    'MASTER_APPROVAL_LINE_REQUIRED',\n    { axis, activity: report.activity },\n    'Set the approval line for this activity before requiring approval on this master axis.'\n  )\n}\n"]}

package/dist-server/service/asset/asset-lifecycle.d.ts

@@ -0,0 +1,106 @@
+import type { RatedUsage, RatedUsageMissing, ResourceClassDef, TestResult } from '@operato/ops-contract';
+/**
+ * 이 자산을 지금 써도 되나 — **반복해서 쓰는 물건의 수명을 거는 자리.**
+ *
+ * 자산은 설비와 달리 **돌아온다.** 그래서 「고장인가」가 아니라 「몇 번 더 쓸 수 있나 · 교정이 살아
+ * 있나」를 묻는다. 정격을 넘긴 지그로 계속 찍으면 치수가 벌어지고, 그 사실은 며칠 뒤 검사에서야
+ * 드러난다. 그때는 이미 만든 것이 다 나가 있다.
+ *
+ * ── 교정에 새 칸을 만들지 않았다 ────────────────────────────────────────────
+ * 자산은 이미 `testSpecificationIds` 와 `testResults` 를 든다. 교정은 검사이고, 교정 기한이 지난 것은
+ * **검사 결과가 만료된 것**이다. 자격에서 쓴 판단이 그대로 붙는다 — `calibrationDue` 같은 칸을 새로
+ * 만들면 같은 사실이 두 곳에 살고, 둘이 어긋나는 날이 온다.
+ *
+ * 새로 필요한 것은 **사용 횟수** 하나뿐이다. 그것만 정격(`cycleLimit`)과 견준다.
+ *
+ * ── 기록이 없을 때 (인원과 같은 규율) ──────────────────────────────────────
+ * 교정 기록이 없으면 막는다. 「교정한 적이 없다」는 「교정이 살아 있다」가 아니다.
+ */
+export type AssetLack = 
+/** 그 이름이 자산 마스터에 없다 — 등록하거나 이름을 고친다. */
+'not-registered'
+/** 폐기했거나 아직 들여오지 않았다. */
+ | 'not-effective'
+/** 요구된 교정의 기록이 없다. */
+ | 'calibration-missing'
+/** 교정에 불합격했다. */
+ | 'calibration-failed'
+/** 교정 기한이 지났다 — 교정하면 된다. */
+ | 'calibration-expired'
+/** 정격 사용량을 넘겼다 — 교체하거나 정격을 다시 정한다. */
+ | 'cycle-exceeded'
+/**
+ * 정격과 쓴 양의 **단위가 달라 견줄 수 없다.**
+ *
+ * 50미터 정격에 「120번 썼다」가 오면 답할 수 있는 것이 없다. 숫자만 견주면 120 > 50 이라
+ * 「수명 끝」이라고 말하는데, 그것은 참일 수도 거짓일 수도 있다. 막지도 통과시키지도 않고
+ * 이 사실을 낸다 — 마스터를 고쳐야 하는 자리다.
+ */
+ | 'usage-uom-mismatch';
+export interface AssetGap {
+    assetName: string;
+    lack: AssetLack;
+    /** 교정 때문이면 어느 검사인가. */
+    specId?: string;
+    /** 만료된 것이면 언제 만료됐나(ISO). */
+    expiredAt?: string;
+    /** 정격을 넘긴 것이면 얼마를 썼고 정격이 얼마인가. */
+    used?: number;
+    /** 정격. */
+    limit?: number;
+    /** 정격의 단위 — 「번」이면 `C62`, 길이는 `MTR`. */
+    uom?: string;
+}
+/** 화면이 보여 줄 수명. 남은 횟수를 **모르면 비운다** — 0 으로 두면 「다 썼다」로 읽힌다. */
+export interface AssetLifecycle {
+    assetName: string;
+    /** 교정 이후 몇 번 썼나. */
+    used: number;
+    /** 정격 — 선언하지 않았으면 없다. */
+    limit?: number;
+    /** 정격의 단위. */
+    uom?: string;
+    /**
+     * 남은 양 — **낼 수 없으면 없다.**
+     *
+     * 정격이 없으면 무한이 아니고, 단위가 다르면 견줄 수 없다. 그때 0 으로 두면 「다 썼다」로
+     * 읽힌다.
+     */
+    remaining?: number;
+    /** 왜 판정하지 못했나 — 계약의 낱말 그대로(§`RatedUsageMissing`). */
+    usageMissing?: RatedUsageMissing[];
+    /** 언제 교정했나(ISO) — 그 시점부터 센다. */
+    calibratedAt?: string;
+    /** 교정이 언제 만료되나(ISO). */
+    calibrationExpiresAt?: string;
+    gaps: AssetGap[];
+}
+/** 판단에 필요한 자산의 사실만. 엔티티를 통째로 받지 않는다. */
+export interface JudgeableAsset {
+    name: string;
+    assetClassIds?: string[];
+    /**
+     * 정격 사용량 — 얼마를 쓰면 교체하나. 선언하지 않았으면 이 축으로 막지 않는다.
+     *
+     * **단위가 함께 온다.** 「번」으로 세는 것만 다루면 라우터 비트의 50미터를 담을 수 없다.
+     */
+    ratedUsage?: RatedUsage;
+    testResults?: TestResult[];
+    effectiveStart?: Date | string;
+    effectiveEnd?: Date | string;
+}
+/**
+ * **언제부터 세나** — 마지막으로 통과한 교정 시각.
+ *
+ * 사용 횟수는 교정 이후로 센다. 교정은 자산을 처음 상태로 되돌리는 일이고, 되돌린 뒤에도 예전 횟수를
+ * 계속 세면 멀쩡한 지그가 정격 초과로 잠긴다.
+ *
+ * 교정 기록이 없으면 비운다 — 부르는 쪽이 **처음부터** 센다.
+ */
+export declare function calibrationBaselineOf(asset: JudgeableAsset): string | undefined;
+/**
+ * 이 자산을 지금 써도 되나.
+ *
+ * `usedSinceCalibration` 은 부르는 쪽이 센다 — 사용 기록은 실적에 있고 여기는 마스터이기 때문이다.
+ */
+export declare function assetLifecycleOf(asset: JudgeableAsset, classDefs: readonly ResourceClassDef[], usedSinceCalibration: number, at: string): AssetLifecycle;