@things-factory/ops-master 10.1.248 → 10.1.250

package/dist-server/service/personnel/qualification.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.personnelSpecificationOf = personnelSpecificationOf;
+exports.qualificationGapsFor = qualificationGapsFor;
+exports.judgePersonnel = judgePersonnel;
+exports.nearestQualificationExpiry = nearestQualificationExpiry;
+const ops_contract_1 = require("@operato/ops-contract");
+/**
+ * 선언된 필요 인원을 읽는다.
+ *
+ * `OperationDefinition.personnelSpecification` 은 JSON 칸이라 모양이 보장되지 않는다. 등급 이름이 없는
+ * 줄은 **버리지 않고 걸러 낸다** — 그런 줄로 요구를 만들면 아무도 만족시킬 수 없는 공정이 된다.
+ * 수량이 없으면 1명으로 읽는다(ISA-95 `Quantity` 는 선택 항목이고, 요구했다는 것 자체가 최소 한 명이다).
+ */
+function personnelSpecificationOf(raw) {
+    if (!raw?.length) {
+        return [];
+    }
+    const entries = [];
+    for (const row of raw) {
+        const classId = row?.personnelClassId ?? row?.personnelClassID ?? row?.classId;
+        if (typeof classId !== 'string' || !classId) {
+            continue;
+        }
+        const quantity = Number(row?.quantity);
+        entries.push({ personnelClassId: classId, quantity: Number.isFinite(quantity) && quantity > 0 ? quantity : 1 });
+    }
+    return entries;
+}
+/**
+ * 이 사람이 이 등급의 자격을 갖췄나. 모자라면 **무엇이** 모자란지 돌려준다.
+ *
+ * 상속을 탄다 — 「6축 용접 자격」을 가진 사람은 「용접 자격」을 요구하는 공정에 선다. 그 상속은
+ * 계약의 `classClosure` 가 닫으므로 여기서 다시 만들지 않는다.
+ */
+function qualificationGapsFor(person, classId, classDefs, at) {
+    const period = {
+        effectiveStart: isoOf(person.effectiveStart),
+        effectiveEnd: isoOf(person.effectiveEnd)
+    };
+    /* 유효기간 밖이면 자격을 볼 것도 없다 — 퇴사자의 용접 자격은 유효해도 배정 대상이 아니다. */
+    if ((0, ops_contract_1.effectivityAt)(period, at) !== undefined) {
+        return [{ personName: person.name, classId, lack: 'not-effective' }];
+    }
+    const closure = (0, ops_contract_1.classClosure)(person.personnelClassIds, classDefs, at);
+    if (!closure.has(classId)) {
+        return [{ personName: person.name, classId, lack: 'not-in-class' }];
+    }
+    const required = (0, ops_contract_1.requiredTestsFor)([classId], classDefs, at);
+    if (!required.length) {
+        return [];
+    }
+    const bySpec = new Map((person.testResults ?? []).map(result => [result.specId, result]));
+    const gaps = [];
+    for (const specId of required) {
+        const result = bySpec.get(specId);
+        /*
+         * 여기가 커널과 갈리는 한 줄이다. 계약은 없는 결과를 제약으로 보지 않고, 실행 시스템은 막는다.
+         * 기록이 없다는 것은 「자격이 있다」가 아니라 「모른다」이고, 모르는 채로 작업을 보내지 않는다.
+         */
+        if (!result) {
+            gaps.push({ personName: person.name, classId, lack: 'test-missing', specId });
+            continue;
+        }
+        if (result.result === 'fail') {
+            gaps.push({ personName: person.name, classId, lack: 'test-failed', specId });
+            continue;
+        }
+        /* 판정이 비어 있는 것도 통과가 아니다 — 「재기만 하고 판정하지 않았다」는 합격이 아니다. */
+        if (result.result !== 'pass') {
+            gaps.push({ personName: person.name, classId, lack: 'test-missing', specId });
+            continue;
+        }
+        if (!(0, ops_contract_1.testPassedAt)(result, at)) {
+            gaps.push({ personName: person.name, classId, lack: 'test-expired', specId, expiredAt: result.expiresAt });
+        }
+    }
+    return gaps;
+}
+/**
+ * 이 사람들로 이 공정을 돌릴 수 있나.
+ *
+ * 등급마다 수량을 센다. 한 사람이 여러 등급을 만족시킬 수 있으므로 **등급별로 따로 센다** — 「용접
+ * 1명 · 지게차 1명」을 두 자격을 가진 한 사람으로 채울 수 있는지는 현장이 정할 일이지 여기서 정할
+ * 일이 아니다. 여기서는 각 요구가 채워졌는지만 본다.
+ */
+function judgePersonnel(spec, persons, classDefs, at) {
+    if (!spec.length) {
+        return { qualified: true, gaps: [], shortfalls: [] };
+    }
+    const gaps = [];
+    const shortfalls = [];
+    for (const { personnelClassId, quantity } of spec) {
+        const required = quantity ?? 1;
+        let count = 0;
+        for (const person of persons) {
+            const found = qualificationGapsFor(person, personnelClassId, classDefs, at);
+            if (!found.length) {
+                count += 1;
+                continue;
+            }
+            /*
+             * 그 등급에 아예 속하지 않는 사람은 이유로 내지 않는다. 실적에 이름이 다섯이면 그 중 넷은
+             * 다른 일을 하는 사람이고, 그들까지 「용접 자격 없음」으로 늘어놓으면 진짜 이유가 묻힌다.
+             */
+            if (found.some(gap => gap.lack === 'not-in-class')) {
+                continue;
+            }
+            gaps.push(...found);
+        }
+        if (count < required) {
+            shortfalls.push({ classId: personnelClassId, required, qualified: count });
+        }
+    }
+    return { qualified: shortfalls.length === 0, gaps, shortfalls };
+}
+function isoOf(at) {
+    if (!at) {
+        return undefined;
+    }
+    return typeof at === 'string' ? at : at.toISOString();
+}
+/**
+ * 이 사람의 이 등급 자격이 **언제 가장 먼저 끊기나.**
+ *
+ * 요구되는 검사가 여럿이면 가장 이른 만료가 그 등급의 만료다 — 하나라도 끊기면 자격이 성립하지 않는다.
+ * 만료가 선언되지 않은 검사는 무기한이므로 세지 않는다(모르는 것과 지난 것은 다르다).
+ */
+function nearestQualificationExpiry(person, classId, classDefs, at) {
+    const required = new Set((0, ops_contract_1.requiredTestsFor)([classId], classDefs, at));
+    if (!required.size) {
+        return undefined;
+    }
+    const bySpec = new Map((person.testResults ?? []).map(result => [result.specId, result]));
+    let nearest;
+    for (const specId of required) {
+        const result = bySpec.get(specId);
+        if (!result?.expiresAt || result.result !== 'pass') {
+            continue;
+        }
+        if (!nearest || Date.parse(result.expiresAt) < Date.parse(nearest)) {
+            nearest = result.expiresAt;
+        }
+    }
+    return nearest;
+}
+//# sourceMappingURL=qualification.js.map

package/dist-server/service/personnel/qualification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualification.js","sourceRoot":"","sources":["../../../server/service/personnel/qualification.ts"],"names":[],"mappings":"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","sourcesContent":["import { classClosure, effectivityAt, requiredTestsFor, testPassedAt } from '@operato/ops-contract'\nimport type { ResourceClassDef, TestResult } from '@operato/ops-contract'\n\n/**\n * 이 사람이 이 공정을 할 자격이 있나 — **ISA-95 `PersonnelSpecification` 을 실제로 거는 자리.**\n *\n * 공정은 등급으로 요구하고(`OperationDefinition.personnelSpecification`), 등급은 검사를 요구하고\n * (`PersonnelClass.testSpecificationIds`), 사람은 결과를 든다(`Person.testResults`). 세 자리가 다\n * 있었는데 그것을 잇는 판단이 없어서, 마스터에 적힌 자격이 아무 일도 하지 않고 있었다.\n *\n * ── 기록이 없을 때의 판단이 커널과 반대다 ──────────────────────────────────\n * 계약의 `meetsTests` 는 결과가 선언되지 않은 검사를 **제약으로 보지 않는다**(`contract.ts` §meetsTests).\n * 트윈에서는 그것이 맞다 — 모델 데이터가 성긴데 기록이 없다고 다 막으면 라인이 굶는다.\n *\n * 실행 시스템에서는 반대다. 「이 사람의 용접 자격 기록이 없다」는 통과 사유가 아니라 막을 사유다.\n * 그래서 등급 상속(`classClosure`) · 필수 검사 수집(`requiredTestsFor`) · 만료 판정(`testPassedAt`) 은\n * 계약 것을 그대로 쓰고, **없을 때의 판단만 여기서 뒤집는다.** 커널 함수는 고치지 않는다.\n *\n * ── 왜 이유를 종류별로 돌려주나 ────────────────────────────────────────────\n * 막기만 하고 무엇이 모자란지 말하지 않는 화면은 현장에서 우회 대상이 된다. 자격이 없는 것과 만료된\n * 것은 할 일이 다르다 — 앞은 사람을 바꾸고, 뒤는 갱신하면 된다.\n */\n\n/** 무엇이 모자란가. 종류마다 현장이 할 일이 다르다. */\nexport type QualificationLack =\n  /** 그 등급에 속하지 않는다 — 다른 사람을 부르는 수밖에 없다. */\n  | 'not-in-class'\n  /** 등급이 요구하는 검사의 기록이 없다 — 받았는지 확인하고 기록한다. */\n  | 'test-missing'\n  /** 불합격 기록이다. */\n  | 'test-failed'\n  /** 합격했으나 유효기간이 지났다 — 갱신하면 된다. */\n  | 'test-expired'\n  /** 아직 현장에 없거나(입사 전) 이미 없다(퇴사). */\n  | 'not-effective'\n  /**\n   * 그 이름이 인원 마스터에 없다 — 자격을 따질 수가 없다.\n   *\n   * 「자격 없음」으로 내면 안 된다. 자격이 없는 것과 그 사람이 누구인지 모르는 것은 할 일이 다르다\n   * (앞은 사람을 바꾸고, 뒤는 등록하거나 이름을 고친다).\n   */\n  | 'not-registered'\n\nexport interface QualificationGap {\n  /** 누가 — `Person.name`. */\n  personName: string\n  /** 어느 등급을 요구했나 — `PersonnelClass.name`. */\n  classId: string\n  lack: QualificationLack\n  /** 검사 때문이면 어느 검사인가 — `TestSpecification.id`. */\n  specId?: string\n  /** 만료된 것이면 언제 만료됐나(ISO). */\n  expiredAt?: string\n}\n\n/** 등급별로 몇 명이 필요한데 몇 명이 자격을 갖췄나. */\nexport interface QualificationShortfall {\n  classId: string\n  required: number\n  qualified: number\n}\n\nexport interface QualificationVerdict {\n  qualified: boolean\n  gaps: QualificationGap[]\n  shortfalls: QualificationShortfall[]\n}\n\n/** 판단에 필요한 사람의 사실만. 엔티티를 통째로 받지 않는다 — 그러면 테스트가 DB 를 끌고 온다. */\nexport interface QualifiablePerson {\n  name: string\n  personnelClassIds?: string[]\n  testResults?: TestResult[]\n  effectiveStart?: Date | string\n  effectiveEnd?: Date | string\n}\n\n/** ISA-95 `PersonnelSpecification` — 등급 하나와 그 등급으로 몇 명이 필요한가. */\nexport interface PersonnelSpecificationEntry {\n  personnelClassId: string\n  quantity?: number\n}\n\n/**\n * 선언된 필요 인원을 읽는다.\n *\n * `OperationDefinition.personnelSpecification` 은 JSON 칸이라 모양이 보장되지 않는다. 등급 이름이 없는\n * 줄은 **버리지 않고 걸러 낸다** — 그런 줄로 요구를 만들면 아무도 만족시킬 수 없는 공정이 된다.\n * 수량이 없으면 1명으로 읽는다(ISA-95 `Quantity` 는 선택 항목이고, 요구했다는 것 자체가 최소 한 명이다).\n */\nexport function personnelSpecificationOf(raw: readonly Record<string, unknown>[] | undefined): PersonnelSpecificationEntry[] {\n  if (!raw?.length) {\n    return []\n  }\n\n  const entries: PersonnelSpecificationEntry[] = []\n\n  for (const row of raw) {\n    const classId = row?.personnelClassId ?? row?.personnelClassID ?? row?.classId\n    if (typeof classId !== 'string' || !classId) {\n      continue\n    }\n\n    const quantity = Number(row?.quantity)\n    entries.push({ personnelClassId: classId, quantity: Number.isFinite(quantity) && quantity > 0 ? quantity : 1 })\n  }\n\n  return entries\n}\n\n/**\n * 이 사람이 이 등급의 자격을 갖췄나. 모자라면 **무엇이** 모자란지 돌려준다.\n *\n * 상속을 탄다 — 「6축 용접 자격」을 가진 사람은 「용접 자격」을 요구하는 공정에 선다. 그 상속은\n * 계약의 `classClosure` 가 닫으므로 여기서 다시 만들지 않는다.\n */\nexport function qualificationGapsFor(\n  person: QualifiablePerson,\n  classId: string,\n  classDefs: readonly ResourceClassDef[],\n  at: string\n): QualificationGap[] {\n  const period = {\n    effectiveStart: isoOf(person.effectiveStart),\n    effectiveEnd: isoOf(person.effectiveEnd)\n  }\n\n  /* 유효기간 밖이면 자격을 볼 것도 없다 — 퇴사자의 용접 자격은 유효해도 배정 대상이 아니다. */\n  if (effectivityAt(period, at) !== undefined) {\n    return [{ personName: person.name, classId, lack: 'not-effective' }]\n  }\n\n  const closure = classClosure(person.personnelClassIds, classDefs, at)\n  if (!closure.has(classId)) {\n    return [{ personName: person.name, classId, lack: 'not-in-class' }]\n  }\n\n  const required = requiredTestsFor([classId], classDefs, at)\n  if (!required.length) {\n    return []\n  }\n\n  const bySpec = new Map((person.testResults ?? []).map(result => [result.specId, result]))\n  const gaps: QualificationGap[] = []\n\n  for (const specId of required) {\n    const result = bySpec.get(specId)\n\n    /*\n     * 여기가 커널과 갈리는 한 줄이다. 계약은 없는 결과를 제약으로 보지 않고, 실행 시스템은 막는다.\n     * 기록이 없다는 것은 「자격이 있다」가 아니라 「모른다」이고, 모르는 채로 작업을 보내지 않는다.\n     */\n    if (!result) {\n      gaps.push({ personName: person.name, classId, lack: 'test-missing', specId })\n      continue\n    }\n\n    if (result.result === 'fail') {\n      gaps.push({ personName: person.name, classId, lack: 'test-failed', specId })\n      continue\n    }\n\n    /* 판정이 비어 있는 것도 통과가 아니다 — 「재기만 하고 판정하지 않았다」는 합격이 아니다. */\n    if (result.result !== 'pass') {\n      gaps.push({ personName: person.name, classId, lack: 'test-missing', specId })\n      continue\n    }\n\n    if (!testPassedAt(result, at)) {\n      gaps.push({ personName: person.name, classId, lack: 'test-expired', specId, expiredAt: result.expiresAt })\n    }\n  }\n\n  return gaps\n}\n\n/**\n * 이 사람들로 이 공정을 돌릴 수 있나.\n *\n * 등급마다 수량을 센다. 한 사람이 여러 등급을 만족시킬 수 있으므로 **등급별로 따로 센다** — 「용접\n * 1명 · 지게차 1명」을 두 자격을 가진 한 사람으로 채울 수 있는지는 현장이 정할 일이지 여기서 정할\n * 일이 아니다. 여기서는 각 요구가 채워졌는지만 본다.\n */\nexport function judgePersonnel(\n  spec: readonly PersonnelSpecificationEntry[],\n  persons: readonly QualifiablePerson[],\n  classDefs: readonly ResourceClassDef[],\n  at: string\n): QualificationVerdict {\n  if (!spec.length) {\n    return { qualified: true, gaps: [], shortfalls: [] }\n  }\n\n  const gaps: QualificationGap[] = []\n  const shortfalls: QualificationShortfall[] = []\n\n  for (const { personnelClassId, quantity } of spec) {\n    const required = quantity ?? 1\n    let count = 0\n\n    for (const person of persons) {\n      const found = qualificationGapsFor(person, personnelClassId, classDefs, at)\n\n      if (!found.length) {\n        count += 1\n        continue\n      }\n\n      /*\n       * 그 등급에 아예 속하지 않는 사람은 이유로 내지 않는다. 실적에 이름이 다섯이면 그 중 넷은\n       * 다른 일을 하는 사람이고, 그들까지 「용접 자격 없음」으로 늘어놓으면 진짜 이유가 묻힌다.\n       */\n      if (found.some(gap => gap.lack === 'not-in-class')) {\n        continue\n      }\n\n      gaps.push(...found)\n    }\n\n    if (count < required) {\n      shortfalls.push({ classId: personnelClassId, required, qualified: count })\n    }\n  }\n\n  return { qualified: shortfalls.length === 0, gaps, shortfalls }\n}\n\nfunction isoOf(at: Date | string | undefined): string | undefined {\n  if (!at) {\n    return undefined\n  }\n\n  return typeof at === 'string' ? at : at.toISOString()\n}\n\n/**\n * 이 사람의 이 등급 자격이 **언제 가장 먼저 끊기나.**\n *\n * 요구되는 검사가 여럿이면 가장 이른 만료가 그 등급의 만료다 — 하나라도 끊기면 자격이 성립하지 않는다.\n * 만료가 선언되지 않은 검사는 무기한이므로 세지 않는다(모르는 것과 지난 것은 다르다).\n */\nexport function nearestQualificationExpiry(\n  person: QualifiablePerson,\n  classId: string,\n  classDefs: readonly ResourceClassDef[],\n  at: string\n): string | undefined {\n  const required = new Set(requiredTestsFor([classId], classDefs, at))\n  if (!required.size) {\n    return undefined\n  }\n\n  const bySpec = new Map((person.testResults ?? []).map(result => [result.specId, result]))\n  let nearest: string | undefined\n\n  for (const specId of required) {\n    const result = bySpec.get(specId)\n    if (!result?.expiresAt || result.result !== 'pass') {\n      continue\n    }\n    if (!nearest || Date.parse(result.expiresAt) < Date.parse(nearest)) {\n      nearest = result.expiresAt\n    }\n  }\n\n  return nearest\n}\n"]}

package/dist-server/service/quality/index.d.ts

@@ -0,0 +1,4 @@
+import { NonconformanceCause } from './nonconformance-cause';
+import { NonconformanceCauseResolver } from './nonconformance-cause-resolver';
+export declare const entities: (typeof NonconformanceCause)[];
+export declare const resolvers: (typeof NonconformanceCauseResolver)[];

package/dist-server/service/quality/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvers = exports.entities = void 0;
+const nonconformance_cause_1 = require("./nonconformance-cause");
+const nonconformance_cause_resolver_1 = require("./nonconformance-cause-resolver");
+exports.entities = [nonconformance_cause_1.NonconformanceCause];
+exports.resolvers = [nonconformance_cause_resolver_1.NonconformanceCauseResolver];
+//# sourceMappingURL=index.js.map

package/dist-server/service/quality/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/quality/index.ts"],"names":[],"mappings":";;;AAAA,iEAA4D;AAC5D,mFAA6E;AAChE,QAAA,QAAQ,GAAG,CAAC,0CAAmB,CAAC,CAAA;AAChC,QAAA,SAAS,GAAG,CAAC,2DAA2B,CAAC,CAAA","sourcesContent":["import { NonconformanceCause } from './nonconformance-cause'\nimport { NonconformanceCauseResolver } from './nonconformance-cause-resolver'\nexport const entities = [NonconformanceCause]\nexport const resolvers = [NonconformanceCauseResolver]\n"]}

package/dist-server/service/quality/nonconformance-cause-resolver.d.ts

@@ -0,0 +1,12 @@
+import { ListParam } from '@things-factory/shell';
+import { MasterPatch } from '../master-crud';
+import { NonconformanceCause } from './nonconformance-cause';
+declare class NonconformanceCauseList {
+    items: NonconformanceCause[];
+    total: number;
+}
+export declare class NonconformanceCauseResolver {
+    nonconformanceCauseList(params: ListParam, context: ResolverContext): Promise<NonconformanceCauseList>;
+    updateMultipleNonconformanceCause(patches: MasterPatch[], context: ResolverContext): Promise<NonconformanceCause[]>;
+}
+export {};

package/dist-server/service/quality/nonconformance-cause-resolver.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NonconformanceCauseResolver = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const type_graphql_2 = require("type-graphql");
+const shell_2 = require("@things-factory/shell");
+const master_crud_1 = require("../master-crud");
+const master_axis_1 = require("../master-axis");
+const master_list_1 = require("../master-list");
+const nonconformance_cause_1 = require("./nonconformance-cause");
+let NonconformanceCauseList = class NonconformanceCauseList {
+};
+tslib_1.__decorate([
+    (0, type_graphql_2.Field)(type => [nonconformance_cause_1.NonconformanceCause]),
+    tslib_1.__metadata("design:type", Array)
+], NonconformanceCauseList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_2.Field)(type => type_graphql_2.Int),
+    tslib_1.__metadata("design:type", Number)
+], NonconformanceCauseList.prototype, "total", void 0);
+NonconformanceCauseList = tslib_1.__decorate([
+    (0, type_graphql_2.ObjectType)()
+], NonconformanceCauseList);
+let NonconformanceCauseResolver = class NonconformanceCauseResolver {
+    async nonconformanceCauseList(params, context) {
+        const { items, total } = await (0, master_list_1.listMaster)('nonconformanceCause', params, context.state.domain);
+        return { items: items, total };
+    }
+    async updateMultipleNonconformanceCause(patches, context) {
+        const { domain, user, tx } = context.state;
+        return await (0, master_crud_1.saveMasterPatches)(tx, domain, (0, master_axis_1.masterAxisOf)('nonconformanceCause').entity, patches, user, { hasEffectivePeriod: true });
+    }
+};
+exports.NonconformanceCauseResolver = NonconformanceCauseResolver;
+tslib_1.__decorate([
+    (0, type_graphql_2.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_2.Query)(returns => NonconformanceCauseList),
+    tslib_1.__param(0, (0, type_graphql_2.Args)(type => shell_2.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_2.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NonconformanceCauseResolver.prototype, "nonconformanceCauseList", null);
+tslib_1.__decorate([
+    (0, type_graphql_2.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_2.Directive)('@transaction'),
+    (0, type_graphql_2.Mutation)(returns => [nonconformance_cause_1.NonconformanceCause]),
+    tslib_1.__param(0, (0, type_graphql_2.Arg)('patches', type => [shell_2.ScalarObject])),
+    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NonconformanceCauseResolver.prototype, "updateMultipleNonconformanceCause", null);
+exports.NonconformanceCauseResolver = NonconformanceCauseResolver = tslib_1.__decorate([
+    (0, type_graphql_2.Resolver)(nonconformance_cause_1.NonconformanceCause),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], NonconformanceCauseResolver);
+//# sourceMappingURL=nonconformance-cause-resolver.js.map

package/dist-server/service/quality/nonconformance-cause-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonconformance-cause-resolver.js","sourceRoot":"","sources":["../../../server/service/quality/nonconformance-cause-resolver.ts"],"names":[],"mappings":";;;;AAAA,+CAA4C;AAC5C,iDAAqD;AACrD,+CAA2G;AAC3G,iDAA+D;AAC/D,gDAA+D;AAC/D,gDAA6C;AAC7C,gDAA2C;AAC3C,iEAA4D;AAG5D,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAA0G,CAAA;AAAjE;IAArC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,0CAAmB,CAAC,CAAC;;sDAA8B;AAAqB;IAAnB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,CAAC;;sDAAc;AAA/H,uBAAuB;IAD5B,IAAA,yBAAU,GAAE;GACP,uBAAuB,CAA0G;AAIhI,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IAGhC,AAAN,KAAK,CAAC,uBAAuB,CAA0B,MAAiB,EAAS,OAAwB;QACvG,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,IAAA,wBAAU,EAAC,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC9F,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,KAAK,EAAE,CAAA;IACzD,CAAC;IAIK,AAAN,KAAK,CAAC,iCAAiC,CAAyC,OAAsB,EAAS,OAAwB;QACrI,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1C,OAAO,MAAM,IAAA,+BAAiB,EAAC,EAAE,EAAE,MAAM,EAAE,IAAA,0BAAY,EAAC,qBAAqB,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAA0B,CAAA;IAC9J,CAAC;CACF,CAAA;AAdY,kEAA2B;AAGhC;IAFL,IAAA,wBAAS,EAAC,kFAAkF,CAAC;IAC7F,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC;IACX,mBAAA,IAAA,mBAAI,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAS,CAAC,CAAA;IAAqB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CAAjB,iBAAS;;0EAGvE;AAIK;IAHL,IAAA,wBAAS,EAAC,qFAAqF,CAAC;IAChG,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,0CAAmB,CAAC,CAAC;IACF,mBAAA,IAAA,kBAAG,EAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,oBAAY,CAAC,CAAC,CAAA;IAA0B,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;oFAG7G;sCAbU,2BAA2B;IAFvC,IAAA,uBAAQ,EAAC,0CAAmB,CAAC;IAC7B,IAAA,4BAAa,EAAC,qBAAa,CAAC;GAChB,2BAA2B,CAcvC","sourcesContent":["import { UseMiddleware } from 'type-graphql'\nimport { SpeakRefusals } from '@things-factory/shell'\nimport { Arg, Args, Ctx, Directive, Int, Mutation, ObjectType, Field, Query, Resolver } from 'type-graphql'\nimport { ListParam, ScalarObject } from '@things-factory/shell'\nimport { MasterPatch, saveMasterPatches } from '../master-crud'\nimport { masterAxisOf } from '../master-axis'\nimport { listMaster } from '../master-list'\nimport { NonconformanceCause } from './nonconformance-cause'\n\n@ObjectType()\nclass NonconformanceCauseList { @Field(type => [NonconformanceCause]) items: NonconformanceCause[]; @Field(type => Int) total: number }\n\n@Resolver(NonconformanceCause)\n@UseMiddleware(SpeakRefusals)\nexport class NonconformanceCauseResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => NonconformanceCauseList)\n  async nonconformanceCauseList(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<NonconformanceCauseList> {\n    const { items, total } = await listMaster('nonconformanceCause', params, context.state.domain)\n    return { items: items as NonconformanceCause[], total }\n  }\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [NonconformanceCause])\n  async updateMultipleNonconformanceCause(@Arg('patches', type => [ScalarObject]) patches: MasterPatch[], @Ctx() context: ResolverContext): Promise<NonconformanceCause[]> {\n    const { domain, user, tx } = context.state\n    return await saveMasterPatches(tx, domain, masterAxisOf('nonconformanceCause').entity, patches, user, { hasEffectivePeriod: true }) as NonconformanceCause[]\n  }\n}\n"]}

package/dist-server/service/quality/nonconformance-cause.d.ts

@@ -0,0 +1,20 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/** 제품 부적합의 원인 코드. 설비 상태용 StopReason과 섞지 않는다. */
+export declare class NonconformanceCause {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    name: string;
+    description?: string;
+    parentName?: string;
+    detailRequired?: boolean;
+    effectiveStart?: Date;
+    effectiveEnd?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}

package/dist-server/service/quality/nonconformance-cause.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NonconformanceCause = 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");
+/** 제품 부적합의 원인 코드. 설비 상태용 StopReason과 섞지 않는다. */
+let NonconformanceCause = class NonconformanceCause {
+};
+exports.NonconformanceCause = NonconformanceCause;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], NonconformanceCause.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], NonconformanceCause.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((cause) => cause.domain),
+    tslib_1.__metadata("design:type", String)
+], NonconformanceCause.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], NonconformanceCause.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], NonconformanceCause.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], NonconformanceCause.prototype, "parentName", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'boolean', nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Boolean)
+], NonconformanceCause.prototype, "detailRequired", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], NonconformanceCause.prototype, "effectiveStart", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], NonconformanceCause.prototype, "effectiveEnd", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], NonconformanceCause.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], NonconformanceCause.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)
+], NonconformanceCause.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((cause) => cause.creator),
+    tslib_1.__metadata("design:type", String)
+], NonconformanceCause.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)
+], NonconformanceCause.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((cause) => cause.updater),
+    tslib_1.__metadata("design:type", String)
+], NonconformanceCause.prototype, "updaterId", void 0);
+exports.NonconformanceCause = NonconformanceCause = tslib_1.__decorate([
+    (0, typeorm_1.Entity)({ name: 'ops_nonconformance_cause' }),
+    (0, typeorm_1.Index)('ix_ops_nonconformance_cause_0', (cause) => [cause.domain, cause.name], { unique: true }),
+    (0, type_graphql_1.ObjectType)({ description: 'A classified product nonconformance cause' })
+], NonconformanceCause);
+//# sourceMappingURL=nonconformance-cause.js.map

package/dist-server/service/quality/nonconformance-cause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonconformance-cause.js","sourceRoot":"","sources":["../../../server/service/quality/nonconformance-cause.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'\nimport { Domain } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/** 제품 부적합의 원인 코드. 설비 상태용 StopReason과 섞지 않는다. */\n@Entity({ name: 'ops_nonconformance_cause' })\n@Index('ix_ops_nonconformance_cause_0', (cause: NonconformanceCause) => [cause.domain, cause.name], { unique: true })\n@ObjectType({ description: 'A classified product nonconformance cause' })\nexport class NonconformanceCause {\n  @PrimaryGeneratedColumn('uuid') @Field(type => ID) readonly id: string\n  @ManyToOne(type => Domain) @Field(type => Domain) domain?: Domain\n  @RelationId((cause: NonconformanceCause) => cause.domain) domainId?: string\n  @Column() @Field() name: string\n  @Column({ nullable: true }) @Field({ nullable: true }) description?: string\n  @Column({ nullable: true }) @Field({ nullable: true }) parentName?: string\n  @Column({ type: 'boolean', nullable: true }) @Field({ nullable: true }) detailRequired?: boolean\n  @Column({ nullable: true }) @Field({ nullable: true }) effectiveStart?: Date\n  @Column({ nullable: true }) @Field({ nullable: true }) effectiveEnd?: Date\n  @CreateDateColumn() @Field({ nullable: true }) createdAt?: Date\n  @UpdateDateColumn() @Field({ nullable: true }) updatedAt?: Date\n  @ManyToOne(type => User, { nullable: true }) @Field(type => User, { nullable: true }) creator?: User\n  @RelationId((cause: NonconformanceCause) => cause.creator) creatorId?: string\n  @ManyToOne(type => User, { nullable: true }) @Field(type => User, { nullable: true }) updater?: User\n  @RelationId((cause: NonconformanceCause) => cause.updater) updaterId?: string\n}\n"]}

package/dist-server/service/recipe/index.d.ts

@@ -0,0 +1,10 @@
+import { RecipeDefinition } from './recipe-definition';
+import { RouteDefinition } from './route-definition';
+import { RecipeDefinitionResolver, RouteDefinitionResolver } from './recipe-master-resolver';
+import { RecipeQuery } from './recipe-query';
+import { RecipeRevisionResolver } from './recipe-revision-resolver';
+export declare const entities: (typeof RecipeDefinition | typeof RouteDefinition | typeof import("./recipe-revision").RecipeRevision | typeof import("./recipe-revision-line").RecipeRevisionOutput | typeof import("./recipe-revision").RecipePlan | typeof import("./recipe-revision").RecipeSegment | typeof import("./recipe-revision").RecipeBasis)[];
+export declare const resolvers: (typeof RecipeDefinitionResolver | typeof RouteDefinitionResolver | typeof RecipeRevisionResolver | typeof RecipeQuery)[];
+export * from './recipe-definition';
+export * from './route-definition';
+export * from './recipe-master';

package/dist-server/service/recipe/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvers = exports.entities = void 0;
+const tslib_1 = require("tslib");
+const recipe_definition_1 = require("./recipe-definition");
+const route_definition_1 = require("./route-definition");
+const recipe_master_resolver_1 = require("./recipe-master-resolver");
+const recipe_query_1 = require("./recipe-query");
+const recipe_revision_1 = require("./recipe-revision");
+const recipe_revision_resolver_1 = require("./recipe-revision-resolver");
+exports.entities = [recipe_definition_1.RecipeDefinition, route_definition_1.RouteDefinition, ...recipe_revision_1.RECIPE_REVISION_ENTITIES];
+exports.resolvers = [recipe_master_resolver_1.RecipeDefinitionResolver, recipe_master_resolver_1.RouteDefinitionResolver, recipe_query_1.RecipeQuery, recipe_revision_resolver_1.RecipeRevisionResolver];
+tslib_1.__exportStar(require("./recipe-definition"), exports);
+tslib_1.__exportStar(require("./route-definition"), exports);
+tslib_1.__exportStar(require("./recipe-master"), exports);
+//# sourceMappingURL=index.js.map

package/dist-server/service/recipe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/recipe/index.ts"],"names":[],"mappings":";;;;AAAA,2DAAsD;AACtD,yDAAoD;AACpD,qEAA4F;AAC5F,iDAA4C;AAC5C,uDAA4D;AAC5D,yEAAmE;AAEtD,QAAA,QAAQ,GAAG,CAAC,oCAAgB,EAAE,kCAAe,EAAE,GAAG,0CAAwB,CAAC,CAAA;AAC3E,QAAA,SAAS,GAAG,CAAC,iDAAwB,EAAE,gDAAuB,EAAE,0BAAW,EAAE,iDAAsB,CAAC,CAAA;AAEjH,8DAAmC;AACnC,6DAAkC;AAClC,0DAA+B","sourcesContent":["import { RecipeDefinition } from './recipe-definition'\nimport { RouteDefinition } from './route-definition'\nimport { RecipeDefinitionResolver, RouteDefinitionResolver } from './recipe-master-resolver'\nimport { RecipeQuery } from './recipe-query'\nimport { RECIPE_REVISION_ENTITIES } from './recipe-revision'\nimport { RecipeRevisionResolver } from './recipe-revision-resolver'\n\nexport const entities = [RecipeDefinition, RouteDefinition, ...RECIPE_REVISION_ENTITIES]\nexport const resolvers = [RecipeDefinitionResolver, RouteDefinitionResolver, RecipeQuery, RecipeRevisionResolver]\n\nexport * from './recipe-definition'\nexport * from './route-definition'\nexport * from './recipe-master'\n"]}

package/dist-server/service/recipe/recipe-definition.d.ts

@@ -0,0 +1,75 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/**
+ * 레시피 — **무엇으로 무엇을 만드나**. 커널 `RecipeDef` 와 같은 모양이다.
+ *
+ * ── 이 자리가 답하는 것 ──────────────────────────────────────────────────
+ * 「이 품목은 무엇으로 만드나」와 「이 품목을 만드는 것은 어느 레시피인가」다. 둘째가 MES 가 물어야 했던
+ * 것인데 물을 곳이 없었다.
+ *
+ * ── 품목에 지시서를 달지 않는 이유 ───────────────────────────────────────
+ * ISA-95 에는 자재 명세가 붙는 자리가 둘이고 뜻이 다르다(§`RecipePart.operation`).
+ *
+ *  · `ProcessSegment` — 그 자리가 **할 수 있는 일**. 품목에 매이지 않는다 → `OperationDefinition`
+ *  · `OperationsSegment` — 그 **품목을 만드는 절차**의 한 단계. 품목에 매인다 → **레시피가 그 범위다**
+ *
+ * 그래서 품목→지시서를 이으려면 그 사이에 레시피가 있어야 한다. 공정에 품목을 붙이면 범주 오류이고,
+ * 실 데이터가 그 크기를 보였다 — 「배합」에 품목별 BOM 을 붙이면 배합을 지나는 **모든** 로트가 자재
+ * 631종 36톤을 먹는다.
+ *
+ * ── 같은 품목에 레시피가 둘일 수 있다 ────────────────────────────────────
+ * 대체 레시피가 정상이다(첫 실 연동에서 라우팅이 둘 이상인 레시피가 306/471). 그래서 **품목이 레시피를
+ * 가리키지 않고 레시피가 품목을 가리킨다** — 품목은 하나를 고를 수 없다.
+ */
+export declare class RecipeDefinition {
+    /** Read projection of the effective revision, not a mutable identity column. */
+    revisionNumber?: number;
+    planGeneration: number;
+    revisionLock: number;
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    /** 레시피 키 — 오더의 `recipeKey` 가 이 값을 가리킨다(커널 `RecipeDef.key`). */
+    name: string;
+    description?: string;
+    /**
+     * **무엇을 만드나** — `MaterialDefinition.name`.
+     *
+     * `outputs` 안에도 있지만 이 칸을 따로 둔다. 「이 품목을 만드는 레시피」를 JSON 안을 뒤져 찾으면
+     * 다섯 드라이버에서 색인이 서지 않고, 그 질의는 MES 가 지시를 받을 때마다 부른다.
+     *
+     * 산출이 여럿인 레시피(부산물)에서는 **주 산출**을 적는다. 나머지는 `outputs` 가 든다.
+     */
+    materialDefinitionName: string;
+    /**
+     * 투입 — 커널 `RecipePart[]`(`material` · `qty` · `operation?`).
+     *
+     * `operation` 은 **이 투입이 들어가는 공정**이다. 없으면 오더 착수에 확보한다. 그 태그가 여기 있는
+     * 이유는 품목별 소요가 사는 자리가 레시피이기 때문이다.
+     */
+    inputs: Record<string, unknown>[];
+    /** 산출 — 커널 `RecipePart[]`. 부산물이 있으면 여기 함께 든다. */
+    outputs: Record<string, unknown>[];
+    /**
+     * 이 산출물을 만드는 공정 라우팅 — `RouteDefinition.name`(커널 `RecipeDef.route`).
+     *
+     * 순서는 라우팅이 소유하고 레시피는 그것을 가리킨다. 레시피에 단계 목록을 또 두면 두 목록이 어긋날 수
+     * 있고, 어긋났을 때 어느 쪽이 맞는지 말할 근거가 없다.
+     */
+    route?: string;
+    /** 언제부터 유효한가 — 표준 `EffectiveStartDate`. */
+    effectiveStart?: Date;
+    /**
+     * 언제까지 유효한가 — 표준 `EffectiveEndDate`.
+     *
+     * **개정할 때 행을 고치지 않고 이 칸을 채우고 새 행을 세운다.** 고치면 그 레시피로 만든 지난 실적이
+     * 어느 배합으로 만든 것인지 잃는다.
+     */
+    effectiveEnd?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}