@things-factory/ops-master 10.1.246 → 10.1.248

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

@@ -1,119 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Person = 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");
-/**
- * 작업자 — **ISA-95 `Person`**.
- *
- * 사람은 설비와 다르게 산다. 고장 나지 않고 교대로 일하며, 자격이 만료된다. 그래서 자원 넷을 한 그릇에
- * 담지 않는다 — 한쪽의 어휘가 다른 쪽에 붙으면 둘 다 거짓이 된다.
- *
- * 필드 이름은 커널 계약의 `persons` 항목과 같다(`@operato/ops-contract`). 옮길 때 번역이 없다.
- */
-let Person = class Person {
-};
-exports.Person = Person;
-tslib_1.__decorate([
-    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
-    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
-    tslib_1.__metadata("design:type", String)
-], Person.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)
-], Person.prototype, "domain", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.RelationId)((person) => person.domain),
-    tslib_1.__metadata("design:type", String)
-], Person.prototype, "domainId", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)(),
-    (0, type_graphql_1.Field)(),
-    tslib_1.__metadata("design:type", String)
-], Person.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)
-], Person.prototype, "description", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
-    tslib_1.__metadata("design:type", Array)
-], Person.prototype, "personnelClassIds", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ nullable: true }),
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", String)
-], Person.prototype, "homeLocation", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'WorkCalendarEntry[]' }),
-    tslib_1.__metadata("design:type", Array)
-], Person.prototype, "workCalendar", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'ResourceProperty[]' }),
-    tslib_1.__metadata("design:type", Array)
-], Person.prototype, "properties", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
-    tslib_1.__metadata("design:type", Array)
-], Person.prototype, "testSpecificationIds", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'TestResult[]' }),
-    tslib_1.__metadata("design:type", Array)
-], Person.prototype, "testResults", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ nullable: true }),
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", Date
-    /** 언제까지 — 표준 `EffectiveEndDate`. 퇴사한 사람이 영원히 배정 대상으로 남지 않게 한다. */
-    )
-], Person.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)
-], Person.prototype, "effectiveEnd", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.CreateDateColumn)(),
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", Date)
-], Person.prototype, "createdAt", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.UpdateDateColumn)(),
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", Date)
-], Person.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)
-], Person.prototype, "creator", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.RelationId)((person) => person.creator),
-    tslib_1.__metadata("design:type", String)
-], Person.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)
-], Person.prototype, "updater", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.RelationId)((person) => person.updater),
-    tslib_1.__metadata("design:type", String)
-], Person.prototype, "updaterId", void 0);
-exports.Person = Person = tslib_1.__decorate([
-    (0, typeorm_1.Entity)({ name: 'ops_person' }),
-    (0, typeorm_1.Index)('ix_ops_person_0', (person) => [person.domain, person.name], { unique: true }),
-    (0, type_graphql_1.ObjectType)({ description: 'ISA-95 Person — a worker who can be assigned to operations' })
-], Person);
-//# sourceMappingURL=person.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"person.js","sourceRoot":"","sources":["../../../server/service/personnel/person.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/**\n * 작업자 — **ISA-95 `Person`**.\n *\n * 사람은 설비와 다르게 산다. 고장 나지 않고 교대로 일하며, 자격이 만료된다. 그래서 자원 넷을 한 그릇에\n * 담지 않는다 — 한쪽의 어휘가 다른 쪽에 붙으면 둘 다 거짓이 된다.\n *\n * 필드 이름은 커널 계약의 `persons` 항목과 같다(`@operato/ops-contract`). 옮길 때 번역이 없다.\n */\n@Entity({ name: 'ops_person' })\n@Index('ix_ops_person_0', (person: Person) => [person.domain, person.name], { unique: true })\n@ObjectType({ description: 'ISA-95 Person — a worker who can be assigned to operations' })\nexport class Person {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain)\n  domain?: Domain\n\n  @RelationId((person: Person) => person.domain)\n  domainId?: string\n\n  /** 표준 `PersonID` — 트윈으로 나갈 때 `persons[].id` 가 된다. */\n  @Column()\n  @Field()\n  name: string\n\n  /** 사람이 읽는 이름. 표준 `PersonName`. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  description?: string\n\n  /**\n   * 속한 등급들 — 표준 `PersonnelClassID`(복수).\n   *\n   * 복수인 것이 중요하다. 한 사람이 용접 자격과 지게차 자격을 함께 갖는 일이 흔하고, 하나만 담으면\n   * 그 사람은 한쪽 공정에서 보이지 않는다.\n   */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  personnelClassIds?: string[]\n\n  /** 이 사람이 주로 있는 자리 — 표준 `OperationalLocation`. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  homeLocation?: string\n\n  /** 근무 캘린더 — 표준 `WorkCalendar`. 교대 이름과 구간이 여기 있다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'WorkCalendarEntry[]' })\n  workCalendar?: Record<string, unknown>[]\n\n  /** 개체 속성 — 표준 `PersonProperty`. `classPropertyId` 로 등급 속성을 구체화한다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'ResourceProperty[]' })\n  properties?: Record<string, unknown>[]\n\n  /** 이 사람에게 요구되는 `TestSpecification` 참조들 — 표준 `TestSpecificationID`. 참조만 갖는다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  testSpecificationIds?: string[]\n\n  /**\n   * `TestResult` — 표준 `TestResult`.\n   *\n   * 등급이 `TestSpecification` 을 요구하는데 그 사람에게 결과가 아예 없으면, 자격이 성립하는지 판단할 수 없다.\n   * 만료되었거나 떨어졌으면 그 사람에게 작업이 가지 않는다.\n   */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'TestResult[]' })\n  testResults?: Record<string, unknown>[]\n\n  /** 언제부터 이 사람이 현장에 있나 — 표준 `EffectiveStartDate`. 입사 예정자를 미리 등록할 수 있다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveStart?: Date\n\n  /** 언제까지 — 표준 `EffectiveEndDate`. 퇴사한 사람이 영원히 배정 대상으로 남지 않게 한다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveEnd?: Date\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  creator?: User\n\n  @RelationId((person: Person) => person.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  updater?: User\n\n  @RelationId((person: Person) => person.updater)\n  updaterId?: string\n}\n"]}

package/dist-server/service/personnel/personnel-class-readiness.d.ts

@@ -1,22 +0,0 @@
-import { EntityManager } from 'typeorm';
-import { Domain } from '@things-factory/shell';
-import { PersonnelClass } from './personnel-class';
-export interface RequiringOperation {
-    operationName: string;
-    /** 그 공정이 이 등급으로 몇 명을 요구하나. */
-    required: number;
-}
-export interface PersonnelClassReadiness {
-    personnelClass: PersonnelClass;
-    /** 이 등급을 상속하는 하위 등급들 — 이들의 자격자도 이 등급을 만족시킨다. */
-    descendants: string[];
-    /** 지금 이 자격을 갖춘 인원. */
-    holders: string[];
-    /** 그중 곧 끊기는 인원 수. */
-    expiringSoon: number;
-    /** 이 등급을 요구하는 공정들 — 역방향이다. */
-    requiredBy: RequiringOperation[];
-    peopleTotal: number;
-    peopleScanned: number;
-}
-export declare function personnelClassReadiness(manager: EntityManager, domain: Domain, name: string, now?: Date): Promise<PersonnelClassReadiness | undefined>;

package/dist-server/service/personnel/personnel-class-readiness.js

@@ -1,98 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.personnelClassReadiness = personnelClassReadiness;
-const ops_contract_1 = require("@operato/ops-contract");
-const operation_definition_1 = require("../operation/operation-definition");
-const resource_class_1 = require("../resource/resource-class");
-const person_1 = require("./person");
-const personnel_class_1 = require("./personnel-class");
-const qualification_1 = require("./qualification");
-/**
- * 인원 등급 하나의 **선언과 현실**.
- *
- * ── 이 화면에서 내리는 판단 ────────────────────────────────────────────────
- * 「이 자격은 무엇을 요구하나」와 **「이 자격이 어디에 쓰이나」**다. 두 번째가 표로는 나오지 않는다 —
- * 공정이 등급을 가리키므로 정방향은 가지만, 등급에서 공정으로 되돌아오는 길이 없다.
- *
- * ── 왜 「누가 갖고 있나」를 함께 내나 ──────────────────────────────────────
- * 자격을 등록하는 이유는 그것으로 사람을 고르기 위해서다. 등급만 보이고 보유자를 안 보이면 「이 자격을
- * 만들어 둔 값이 있나」를 알 수 없다.
- */
-/** 한 번에 자격을 확인하는 인원 수의 상한. */
-const MAX_PEOPLE_SCANNED = 2000;
-/** 이 기간 안에 끊기는 자격을 「곧 만료」로 센다. */
-const EXPIRING_SOON_DAYS = 30;
-async function personnelClassReadiness(manager, domain, name, now = new Date()) {
-    const personnelClass = await manager.findOne(personnel_class_1.PersonnelClass, { where: { domain: { id: domain.id }, name } });
-    if (!personnelClass) {
-        return undefined;
-    }
-    const at = now.toISOString();
-    const soonMs = now.getTime() + EXPIRING_SOON_DAYS * 24 * 3_600_000;
-    const [classes, people, peopleTotal, operations] = await Promise.all([
-        manager.find(personnel_class_1.PersonnelClass, { where: { domain: { id: domain.id } } }),
-        manager.find(person_1.Person, { where: { domain: { id: domain.id } }, take: MAX_PEOPLE_SCANNED }),
-        manager.count(person_1.Person, { where: { domain: { id: domain.id } } }),
-        manager.find(operation_definition_1.OperationDefinition, { where: { domain: { id: domain.id } } })
-    ]);
-    const classDefs = classes.map(resource_class_1.toResourceClassDef);
-    const holders = [];
-    let expiringSoon = 0;
-    for (const person of people) {
-        const judgeable = {
-            name: person.name,
-            personnelClassIds: person.personnelClassIds,
-            testResults: person.testResults,
-            effectiveStart: person.effectiveStart,
-            effectiveEnd: person.effectiveEnd
-        };
-        if ((0, qualification_1.qualificationGapsFor)(judgeable, name, classDefs, at).length) {
-            continue;
-        }
-        holders.push(person.name);
-        const expiry = (0, qualification_1.nearestQualificationExpiry)(judgeable, name, classDefs, at);
-        if (expiry && Date.parse(expiry) <= soonMs) {
-            expiringSoon += 1;
-        }
-    }
-    return {
-        personnelClass,
-        descendants: descendantsOf(name, classes, classDefs, at),
-        holders,
-        expiringSoon,
-        requiredBy: requiringOperations(name, operations),
-        peopleTotal,
-        peopleScanned: people.length
-    };
-}
-/**
- * 이 등급을 상속하는 등급들.
- *
- * 「6축 용접 자격」이 「용접 자격」을 상속하면, 용접을 요구하는 공정에 6축 용접 자격자도 선다. 그것이
- * 이 화면에 보여야 「이 등급의 자격자가 왜 이렇게 많은가」에 답할 수 있다.
- *
- * 상속은 계약의 `classClosure` 가 닫으므로 여기서 다시 만들지 않는다.
- */
-function descendantsOf(name, classes, classDefs, at) {
-    return classes
-        .filter(candidate => candidate.name !== name && (0, ops_contract_1.classClosure)([candidate.name], classDefs, at).has(name))
-        .map(candidate => candidate.name);
-}
-/**
- * 이 등급을 요구하는 공정들.
- *
- * 상속을 보지 않는다 — 공정이 「용접」을 요구했으면 그것이 선언이고, 「6축 용접」 화면에서 「용접을
- * 요구하는 공정」을 내면 선언하지 않은 것을 선언한 것처럼 보이게 된다.
- */
-function requiringOperations(name, operations) {
-    const found = [];
-    for (const operation of operations) {
-        for (const entry of (0, qualification_1.personnelSpecificationOf)(operation.personnelSpecification)) {
-            if (entry.personnelClassId === name) {
-                found.push({ operationName: operation.name, required: entry.quantity ?? 1 });
-            }
-        }
-    }
-    return found;
-}
-//# sourceMappingURL=personnel-class-readiness.js.map

package/dist-server/service/personnel/personnel-class-readiness.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"personnel-class-readiness.js","sourceRoot":"","sources":["../../../server/service/personnel/personnel-class-readiness.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager } from 'typeorm'\n\nimport { Domain } from '@things-factory/shell'\nimport { classClosure } from '@operato/ops-contract'\nimport type { TestResult } from '@operato/ops-contract'\n\nimport { OperationDefinition } from '../operation/operation-definition'\nimport { toResourceClassDef } from '../resource/resource-class'\nimport { Person } from './person'\nimport { PersonnelClass } from './personnel-class'\nimport { nearestQualificationExpiry, personnelSpecificationOf, qualificationGapsFor } from './qualification'\n\n/**\n * 인원 등급 하나의 **선언과 현실**.\n *\n * ── 이 화면에서 내리는 판단 ────────────────────────────────────────────────\n * 「이 자격은 무엇을 요구하나」와 **「이 자격이 어디에 쓰이나」**다. 두 번째가 표로는 나오지 않는다 —\n * 공정이 등급을 가리키므로 정방향은 가지만, 등급에서 공정으로 되돌아오는 길이 없다.\n *\n * ── 왜 「누가 갖고 있나」를 함께 내나 ──────────────────────────────────────\n * 자격을 등록하는 이유는 그것으로 사람을 고르기 위해서다. 등급만 보이고 보유자를 안 보이면 「이 자격을\n * 만들어 둔 값이 있나」를 알 수 없다.\n */\n\n/** 한 번에 자격을 확인하는 인원 수의 상한. */\nconst MAX_PEOPLE_SCANNED = 2000\n\n/** 이 기간 안에 끊기는 자격을 「곧 만료」로 센다. */\nconst EXPIRING_SOON_DAYS = 30\n\nexport interface RequiringOperation {\n  operationName: string\n  /** 그 공정이 이 등급으로 몇 명을 요구하나. */\n  required: number\n}\n\nexport interface PersonnelClassReadiness {\n  personnelClass: PersonnelClass\n  /** 이 등급을 상속하는 하위 등급들 — 이들의 자격자도 이 등급을 만족시킨다. */\n  descendants: string[]\n  /** 지금 이 자격을 갖춘 인원. */\n  holders: string[]\n  /** 그중 곧 끊기는 인원 수. */\n  expiringSoon: number\n  /** 이 등급을 요구하는 공정들 — 역방향이다. */\n  requiredBy: RequiringOperation[]\n  peopleTotal: number\n  peopleScanned: number\n}\n\nexport async function personnelClassReadiness(\n  manager: EntityManager,\n  domain: Domain,\n  name: string,\n  now = new Date()\n): Promise<PersonnelClassReadiness | undefined> {\n  const personnelClass = await manager.findOne(PersonnelClass, { where: { domain: { id: domain.id }, name } })\n\n  if (!personnelClass) {\n    return undefined\n  }\n\n  const at = now.toISOString()\n  const soonMs = now.getTime() + EXPIRING_SOON_DAYS * 24 * 3_600_000\n\n  const [classes, people, peopleTotal, operations] = await Promise.all([\n    manager.find(PersonnelClass, { where: { domain: { id: domain.id } } }),\n    manager.find(Person, { where: { domain: { id: domain.id } }, take: MAX_PEOPLE_SCANNED }),\n    manager.count(Person, { where: { domain: { id: domain.id } } }),\n    manager.find(OperationDefinition, { where: { domain: { id: domain.id } } })\n  ])\n\n  const classDefs = classes.map(toResourceClassDef)\n\n  const holders: string[] = []\n  let expiringSoon = 0\n\n  for (const person of people) {\n    const judgeable = {\n      name: person.name,\n      personnelClassIds: person.personnelClassIds,\n      testResults: person.testResults as unknown as TestResult[] | undefined,\n      effectiveStart: person.effectiveStart,\n      effectiveEnd: person.effectiveEnd\n    }\n\n    if (qualificationGapsFor(judgeable, name, classDefs, at).length) {\n      continue\n    }\n\n    holders.push(person.name)\n\n    const expiry = nearestQualificationExpiry(judgeable, name, classDefs, at)\n    if (expiry && Date.parse(expiry) <= soonMs) {\n      expiringSoon += 1\n    }\n  }\n\n  return {\n    personnelClass,\n    descendants: descendantsOf(name, classes, classDefs, at),\n    holders,\n    expiringSoon,\n    requiredBy: requiringOperations(name, operations),\n    peopleTotal,\n    peopleScanned: people.length\n  }\n}\n\n/**\n * 이 등급을 상속하는 등급들.\n *\n * 「6축 용접 자격」이 「용접 자격」을 상속하면, 용접을 요구하는 공정에 6축 용접 자격자도 선다. 그것이\n * 이 화면에 보여야 「이 등급의 자격자가 왜 이렇게 많은가」에 답할 수 있다.\n *\n * 상속은 계약의 `classClosure` 가 닫으므로 여기서 다시 만들지 않는다.\n */\nfunction descendantsOf(\n  name: string,\n  classes: readonly PersonnelClass[],\n  classDefs: readonly ReturnType<typeof toResourceClassDef>[],\n  at: string\n): string[] {\n  return classes\n    .filter(candidate => candidate.name !== name && classClosure([candidate.name], classDefs, at).has(name))\n    .map(candidate => candidate.name)\n}\n\n/**\n * 이 등급을 요구하는 공정들.\n *\n * 상속을 보지 않는다 — 공정이 「용접」을 요구했으면 그것이 선언이고, 「6축 용접」 화면에서 「용접을\n * 요구하는 공정」을 내면 선언하지 않은 것을 선언한 것처럼 보이게 된다.\n */\nfunction requiringOperations(name: string, operations: readonly OperationDefinition[]): RequiringOperation[] {\n  const found: RequiringOperation[] = []\n\n  for (const operation of operations) {\n    for (const entry of personnelSpecificationOf(operation.personnelSpecification)) {\n      if (entry.personnelClassId === name) {\n        found.push({ operationName: operation.name, required: entry.quantity ?? 1 })\n      }\n    }\n  }\n\n  return found\n}\n"]}

package/dist-server/service/personnel/personnel-class.d.ts

@@ -1,54 +0,0 @@
-import { Domain } from '@things-factory/shell';
-import { User } from '@things-factory/auth-base';
-/**
- * 인원 등급 — **ISA-95 `PersonnelClass`**.
- *
- * 등급은 자격이다. 「용접 자격」이 등급이고, 그 자격을 가진 사람이 개체다. 공정은 특정인을 지목하지
- * 않고 등급으로 요구한다 — 「용접 자격자 2명」.
- *
- * ── 왜 이 패키지가 이것을 갖나 ──────────────────────────────────────────────
- * 인원은 제품의 사실이 아니라 현장의 사실이다. 같은 사람이 MES 에서도 WMS 에서도 일한다. 제품마다
- * 표를 두면 한 사실에 표가 둘이 된다.
- *
- * 그리고 트윈 커널에 `personnelClasses` 자리가 있는데, 지금까지 붙인 원본에는 그 사실이 없었다.
- * 그래서 「자격자가 둘뿐이라 설비가 논다」를 말할 수 없었다
- * (`operato-application/design/charters/operato-plant.md` §5).
- *
- * ── 필드 이름을 새로 짓지 않는다 ────────────────────────────────────────────
- * 커널 계약의 `ResourceClassDef` 와 같은 이름을 쓴다(`@operato/ops-contract`). 같은 사실에 이름이
- * 둘이면 옮길 때마다 번역이 생기고, 번역이 있으면 틀릴 자리가 생긴다.
- */
-export declare class PersonnelClass {
-    readonly id: string;
-    domain?: Domain;
-    domainId?: string;
-    /** 표준 `PersonnelClassID` — 트윈으로 나갈 때 `ResourceClassDef.id` 가 된다. */
-    name: string;
-    description?: string;
-    /**
-     * 상위 등급들 — 표준 `PersonnelClassBaseID`(복수).
-     *
-     * 「6축 용접 자격」이 「용접 자격」을 상속한다. 배정 판단이 이 상속을 타므로, 상위 등급으로 요구해도
-     * 하위 자격자가 잡힌다.
-     */
-    baseIds?: string[];
-    /** 이 등급의 적격을 정하는 `TestSpecification` 참조들 — 표준 `TestSpecificationID`. 참조만 갖는다. */
-    testSpecificationIds?: string[];
-    /** 등급 속성 — 표준 `PersonnelClassProperty`. 개체 속성이 `classPropertyId` 로 이것을 구체화한다. */
-    properties?: Record<string, unknown>[];
-    /**
-     * 언제부터 유효한가 — 표준 `EffectiveStartDate`.
-     *
-     * 자격 규정은 미래 시점으로 선언된다(「9월부터 이 자격이 필요하다」). 이 자리가 없으면 그 선언을
-     * 받을 수 없거나, 받고 나서 오늘 배정에 바로 적용된다.
-     */
-    effectiveStart?: Date;
-    /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. 없으면 끝이 정해지지 않았다. */
-    effectiveEnd?: Date;
-    createdAt?: Date;
-    updatedAt?: Date;
-    creator?: User;
-    creatorId?: string;
-    updater?: User;
-    updaterId?: string;
-}

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

@@ -1,114 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PersonnelClass = 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");
-/**
- * 인원 등급 — **ISA-95 `PersonnelClass`**.
- *
- * 등급은 자격이다. 「용접 자격」이 등급이고, 그 자격을 가진 사람이 개체다. 공정은 특정인을 지목하지
- * 않고 등급으로 요구한다 — 「용접 자격자 2명」.
- *
- * ── 왜 이 패키지가 이것을 갖나 ──────────────────────────────────────────────
- * 인원은 제품의 사실이 아니라 현장의 사실이다. 같은 사람이 MES 에서도 WMS 에서도 일한다. 제품마다
- * 표를 두면 한 사실에 표가 둘이 된다.
- *
- * 그리고 트윈 커널에 `personnelClasses` 자리가 있는데, 지금까지 붙인 원본에는 그 사실이 없었다.
- * 그래서 「자격자가 둘뿐이라 설비가 논다」를 말할 수 없었다
- * (`operato-application/design/charters/operato-plant.md` §5).
- *
- * ── 필드 이름을 새로 짓지 않는다 ────────────────────────────────────────────
- * 커널 계약의 `ResourceClassDef` 와 같은 이름을 쓴다(`@operato/ops-contract`). 같은 사실에 이름이
- * 둘이면 옮길 때마다 번역이 생기고, 번역이 있으면 틀릴 자리가 생긴다.
- */
-let PersonnelClass = class PersonnelClass {
-};
-exports.PersonnelClass = PersonnelClass;
-tslib_1.__decorate([
-    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
-    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
-    tslib_1.__metadata("design:type", String)
-], PersonnelClass.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)
-], PersonnelClass.prototype, "domain", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.RelationId)((klass) => klass.domain),
-    tslib_1.__metadata("design:type", String)
-], PersonnelClass.prototype, "domainId", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)(),
-    (0, type_graphql_1.Field)(),
-    tslib_1.__metadata("design:type", String)
-], PersonnelClass.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)
-], PersonnelClass.prototype, "description", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
-    tslib_1.__metadata("design:type", Array)
-], PersonnelClass.prototype, "baseIds", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
-    tslib_1.__metadata("design:type", Array)
-], PersonnelClass.prototype, "testSpecificationIds", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
-    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'ResourceProperty[]' }),
-    tslib_1.__metadata("design:type", Array)
-], PersonnelClass.prototype, "properties", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.Column)({ nullable: true }),
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", Date
-    /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. 없으면 끝이 정해지지 않았다. */
-    )
-], PersonnelClass.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)
-], PersonnelClass.prototype, "effectiveEnd", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.CreateDateColumn)(),
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", Date)
-], PersonnelClass.prototype, "createdAt", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.UpdateDateColumn)(),
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", Date)
-], PersonnelClass.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)
-], PersonnelClass.prototype, "creator", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.RelationId)((klass) => klass.creator),
-    tslib_1.__metadata("design:type", String)
-], PersonnelClass.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)
-], PersonnelClass.prototype, "updater", void 0);
-tslib_1.__decorate([
-    (0, typeorm_1.RelationId)((klass) => klass.updater),
-    tslib_1.__metadata("design:type", String)
-], PersonnelClass.prototype, "updaterId", void 0);
-exports.PersonnelClass = PersonnelClass = tslib_1.__decorate([
-    (0, typeorm_1.Entity)({ name: 'ops_personnel_class' }),
-    (0, typeorm_1.Index)('ix_ops_personnel_class_0', (klass) => [klass.domain, klass.name], { unique: true }),
-    (0, type_graphql_1.ObjectType)({ description: 'ISA-95 PersonnelClass — a qualification that operations require' })
-], PersonnelClass);
-//# sourceMappingURL=personnel-class.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"personnel-class.js","sourceRoot":"","sources":["../../../server/service/personnel/personnel-class.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/**\n * 인원 등급 — **ISA-95 `PersonnelClass`**.\n *\n * 등급은 자격이다. 「용접 자격」이 등급이고, 그 자격을 가진 사람이 개체다. 공정은 특정인을 지목하지\n * 않고 등급으로 요구한다 — 「용접 자격자 2명」.\n *\n * ── 왜 이 패키지가 이것을 갖나 ──────────────────────────────────────────────\n * 인원은 제품의 사실이 아니라 현장의 사실이다. 같은 사람이 MES 에서도 WMS 에서도 일한다. 제품마다\n * 표를 두면 한 사실에 표가 둘이 된다.\n *\n * 그리고 트윈 커널에 `personnelClasses` 자리가 있는데, 지금까지 붙인 원본에는 그 사실이 없었다.\n * 그래서 「자격자가 둘뿐이라 설비가 논다」를 말할 수 없었다\n * (`operato-application/design/charters/operato-plant.md` §5).\n *\n * ── 필드 이름을 새로 짓지 않는다 ────────────────────────────────────────────\n * 커널 계약의 `ResourceClassDef` 와 같은 이름을 쓴다(`@operato/ops-contract`). 같은 사실에 이름이\n * 둘이면 옮길 때마다 번역이 생기고, 번역이 있으면 틀릴 자리가 생긴다.\n */\n@Entity({ name: 'ops_personnel_class' })\n@Index('ix_ops_personnel_class_0', (klass: PersonnelClass) => [klass.domain, klass.name], { unique: true })\n@ObjectType({ description: 'ISA-95 PersonnelClass — a qualification that operations require' })\nexport class PersonnelClass {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain)\n  domain?: Domain\n\n  @RelationId((klass: PersonnelClass) => klass.domain)\n  domainId?: string\n\n  /** 표준 `PersonnelClassID` — 트윈으로 나갈 때 `ResourceClassDef.id` 가 된다. */\n  @Column()\n  @Field()\n  name: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  description?: string\n\n  /**\n   * 상위 등급들 — 표준 `PersonnelClassBaseID`(복수).\n   *\n   * 「6축 용접 자격」이 「용접 자격」을 상속한다. 배정 판단이 이 상속을 타므로, 상위 등급으로 요구해도\n   * 하위 자격자가 잡힌다.\n   */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  baseIds?: string[]\n\n  /** 이 등급의 적격을 정하는 `TestSpecification` 참조들 — 표준 `TestSpecificationID`. 참조만 갖는다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => [String], { nullable: true })\n  testSpecificationIds?: string[]\n\n  /** 등급 속성 — 표준 `PersonnelClassProperty`. 개체 속성이 `classPropertyId` 로 이것을 구체화한다. */\n  @Column({ type: 'simple-json', nullable: true })\n  @Field(type => ScalarObject, { nullable: true, description: 'ResourceProperty[]' })\n  properties?: Record<string, unknown>[]\n\n  /**\n   * 언제부터 유효한가 — 표준 `EffectiveStartDate`.\n   *\n   * 자격 규정은 미래 시점으로 선언된다(「9월부터 이 자격이 필요하다」). 이 자리가 없으면 그 선언을\n   * 받을 수 없거나, 받고 나서 오늘 배정에 바로 적용된다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveStart?: Date\n\n  /** 언제까지 유효한가 — 표준 `EffectiveEndDate`. 없으면 끝이 정해지지 않았다. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveEnd?: Date\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  creator?: User\n\n  @RelationId((klass: PersonnelClass) => klass.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  updater?: User\n\n  @RelationId((klass: PersonnelClass) => klass.updater)\n  updaterId?: string\n}\n"]}

package/dist-server/service/personnel/personnel-master-resolver.d.ts

@@ -1,53 +0,0 @@
-import { ListParam } from '@things-factory/shell';
-import { MasterPatch } from '../master-crud';
-import { PersonnelClass } from './personnel-class';
-import { Person } from './person';
-/**
- * 인원 축을 채우고 고친다.
- *
- * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────
- * 업무 기록과 달리 마스터는 **선언**이다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 지금의
- * 규정이고, 규정은 바뀐다. 없앨 때 행을 지우지 않고 유효 기간의 끝을 채우는 것이 그래서다 —
- * 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.
- *
- * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다.
- */
-export declare class PersonnelClassList {
-    items: PersonnelClass[];
-    total: number;
-}
-export declare class PersonnelClassResolver {
-    personnelClasses(params: ListParam, context: ResolverContext): Promise<PersonnelClassList>;
-    /**
-     * 이 등급을 가진 사람들
-     *
-     * 아무도 안 들면 빈 목록이다. 다만 그것이 「없다」인지 「다 못 봤다」인지는 `memberScanCapped`
-     * 가 말한다 — 조용히 자르면 고쳐야 할 선언과 멀쩡한 등급이 같아 보인다.
-     */
-    members(klass: PersonnelClass, context: ResolverContext): Promise<string[]>;
-    /** 소속을 다 보지 못했나. */
-    memberScanCapped(klass: PersonnelClass, context: ResolverContext): Promise<boolean>;
-    /**
-     * 그리드가 보낸 변경을 한 번에 적용한다.
-     *
-     * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을
-     * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
-     * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
-     */
-    updateMultiplePersonnelClass(patches: MasterPatch[], context: ResolverContext): Promise<PersonnelClass[]>;
-}
-export declare class PersonList {
-    items: Person[];
-    total: number;
-}
-export declare class PersonResolver {
-    persons(params: ListParam, context: ResolverContext): Promise<PersonList>;
-    /**
-     * 그리드가 보낸 변경을 한 번에 적용한다.
-     *
-     * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을
-     * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
-     * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
-     */
-    updateMultiplePerson(patches: MasterPatch[], context: ResolverContext): Promise<Person[]>;
-}