@things-factory/ops-master 10.0.18

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

@@ -0,0 +1,54 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+/**
+ * 인원 등급 — **ISA-95 `PersonnelClass`**.
+ *
+ * 등급은 자격이다. 「용접 자격」이 등급이고, 그 자격을 가진 사람이 개체다. 공정은 특정인을 지목하지
+ * 않고 등급으로 요구한다 — 「용접 자격자 2명」.
+ *
+ * ── 왜 이 패키지가 이것을 갖나 ──────────────────────────────────────────────
+ * 인원은 제품의 사실이 아니라 현장의 사실이다. 같은 사람이 MES 에서도 WMS 에서도 일한다. 제품마다
+ * 표를 두면 한 사실에 표가 둘이 된다.
+ *
+ * 그리고 트윈 커널에 `personnelClasses` 자리가 있는데, 지금까지 붙인 원본에는 그 사실이 없었다.
+ * 그래서 「자격자가 둘뿐이라 설비가 논다」를 말할 수 없었다
+ * (`operato-twin/design/integration/operato-mes.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

@@ -0,0 +1,114 @@
+"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-twin/design/integration/operato-mes.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 => String, { nullable: true, description: 'ResourceProperty[] as JSON text' }),
+    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

@@ -0,0 +1 @@
+{"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 } 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-twin/design/integration/operato-mes.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 => String, { nullable: true, description: 'ResourceProperty[] as JSON text' })\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

@@ -0,0 +1,44 @@
+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>;
+    /**
+     * 그리드가 보낸 변경을 한 번에 적용한다.
+     *
+     * 패치를 `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[]>;
+}

package/dist-server/service/personnel/personnel-master-resolver.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersonResolver = exports.PersonList = exports.PersonnelClassResolver = exports.PersonnelClassList = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = 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 personnel_class_1 = require("./personnel-class");
+const person_1 = require("./person");
+/**
+ * 인원 축을 채우고 고친다.
+ *
+ * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────
+ * 업무 기록과 달리 마스터는 **선언**이다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 지금의
+ * 규정이고, 규정은 바뀐다. 없앨 때 행을 지우지 않고 유효 기간의 끝을 채우는 것이 그래서다 —
+ * 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.
+ *
+ * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다.
+ */
+let PersonnelClassList = class PersonnelClassList {
+};
+exports.PersonnelClassList = PersonnelClassList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [personnel_class_1.PersonnelClass]),
+    tslib_1.__metadata("design:type", Array)
+], PersonnelClassList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], PersonnelClassList.prototype, "total", void 0);
+exports.PersonnelClassList = PersonnelClassList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A page of personnel classes' })
+], PersonnelClassList);
+let PersonnelClassResolver = class PersonnelClassResolver {
+    async personnelClasses(params, context) {
+        const { domain } = context.state;
+        const { items, total } = await (0, master_list_1.listMaster)('personnelClass', params, domain);
+        return { items: items, total };
+    }
+    /**
+     * 그리드가 보낸 변경을 한 번에 적용한다.
+     *
+     * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을
+     * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
+     * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
+     */
+    async updateMultiplePersonnelClass(patches, context) {
+        const { domain, user, tx } = context.state;
+        const axis = (0, master_axis_1.masterAxisOf)('personnelClass');
+        const saved = await (0, master_crud_1.saveMasterPatches)(tx, domain, axis.entity, patches, user, {
+            hasEffectivePeriod: axis.hasEffectivePeriod
+        });
+        return saved;
+    }
+};
+exports.PersonnelClassResolver = PersonnelClassResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => PersonnelClassList, { description: 'To fetch personnel classes' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], PersonnelClassResolver.prototype, "personnelClasses", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => [personnel_class_1.PersonnelClass], { description: 'To create, change or retire personnel classes' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('patches', type => [shell_1.ScalarObject])),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], PersonnelClassResolver.prototype, "updateMultiplePersonnelClass", null);
+exports.PersonnelClassResolver = PersonnelClassResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(personnel_class_1.PersonnelClass)
+], PersonnelClassResolver);
+let PersonList = class PersonList {
+};
+exports.PersonList = PersonList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [person_1.Person]),
+    tslib_1.__metadata("design:type", Array)
+], PersonList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], PersonList.prototype, "total", void 0);
+exports.PersonList = PersonList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A page of people' })
+], PersonList);
+let PersonResolver = class PersonResolver {
+    async persons(params, context) {
+        const { domain } = context.state;
+        const { items, total } = await (0, master_list_1.listMaster)('person', params, domain);
+        return { items: items, total };
+    }
+    /**
+     * 그리드가 보낸 변경을 한 번에 적용한다.
+     *
+     * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을
+     * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
+     * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
+     */
+    async updateMultiplePerson(patches, context) {
+        const { domain, user, tx } = context.state;
+        const axis = (0, master_axis_1.masterAxisOf)('person');
+        const saved = await (0, master_crud_1.saveMasterPatches)(tx, domain, axis.entity, patches, user, {
+            hasEffectivePeriod: axis.hasEffectivePeriod
+        });
+        return saved;
+    }
+};
+exports.PersonResolver = PersonResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => PersonList, { description: 'To fetch people' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], PersonResolver.prototype, "persons", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => [person_1.Person], { description: 'To create, change or retire people' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('patches', type => [shell_1.ScalarObject])),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], PersonResolver.prototype, "updateMultiplePerson", null);
+exports.PersonResolver = PersonResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(person_1.Person)
+], PersonResolver);
+//# sourceMappingURL=personnel-master-resolver.js.map

package/dist-server/service/personnel/personnel-master-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personnel-master-resolver.js","sourceRoot":"","sources":["../../../server/service/personnel/personnel-master-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { Args, Arg, Ctx, Directive, Int, Mutation, ObjectType, Field, Query, Resolver } from 'type-graphql'\n\nimport { ListParam, ScalarObject } from '@things-factory/shell'\n\nimport { MasterPatch, saveMasterPatches } from '../master-crud'\nimport { masterAxisOf } from '../master-axis'\nimport { listMaster } from '../master-list'\nimport { PersonnelClass } from './personnel-class'\nimport { Person } from './person'\n\n/**\n * 인원 축을 채우고 고친다.\n *\n * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────\n * 업무 기록과 달리 마스터는 **선언**이다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 지금의\n * 규정이고, 규정은 바뀐다. 없앨 때 행을 지우지 않고 유효 기간의 끝을 채우는 것이 그래서다 —\n * 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.\n *\n * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다.\n */\n\n@ObjectType({ description: 'A page of personnel classes' })\nexport class PersonnelClassList {\n  @Field(type => [PersonnelClass])\n  items: PersonnelClass[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@Resolver(PersonnelClass)\nexport class PersonnelClassResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => PersonnelClassList, { description: 'To fetch personnel classes' })\n  async personnelClasses(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<PersonnelClassList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('personnelClass', params, domain)\n\n    return { items: items as PersonnelClass[], total }\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [PersonnelClass], { description: 'To create, change or retire personnel classes' })\n  async updateMultiplePersonnelClass(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<PersonnelClass[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('personnelClass')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as PersonnelClass[]\n  }\n}\n\n@ObjectType({ description: 'A page of people' })\nexport class PersonList {\n  @Field(type => [Person])\n  items: Person[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@Resolver(Person)\nexport class PersonResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => PersonList, { description: 'To fetch people' })\n  async persons(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<PersonList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('person', params, domain)\n\n    return { items: items as Person[], total }\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [Person], { description: 'To create, change or retire people' })\n  async updateMultiplePerson(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<Person[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('person')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as Person[]\n  }\n}\n"]}

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

@@ -0,0 +1,39 @@
+import type { ResourceClassDef } from '@operato/ops-contract';
+import type { Person } from './person';
+import type { PersonnelClass } from './personnel-class';
+/**
+ * MES 의 인원 마스터를 **트윈이 받는 모양**으로 옮긴다.
+ *
+ * ── 여기가 어긋남이 생기는 자리다 ───────────────────────────────────────────
+ * 필드 이름을 계약과 같게 지었으므로 옮기는 일은 거의 없다. 그래도 옮기는 함수를 따로 두는 이유는,
+ * **어긋난다면 반드시 여기서 어긋나기** 때문이다. 한 곳에 모아 두면 테스트가 그 한 곳을 본다.
+ *
+ * 계약 층의 타입(`ResourceClassDef`)을 그대로 쓴다. 우리가 다시 선언하면 그것이 두 번째 어휘가 된다.
+ */
+/** 트윈 `ReferenceMaster.persons` 의 한 항목. 계약에 이름 붙은 타입이 없어 여기서 모양만 적는다. */
+export interface PersonEntry {
+    id: string;
+    personnelClassIds?: string[];
+    homeLocation?: string;
+    workCalendar?: unknown[];
+    properties?: unknown[];
+    testSpecificationIds?: string[];
+    testResults?: unknown[];
+    effectiveStart?: string;
+    effectiveEnd?: string;
+}
+export declare function toPersonEntry(person: Person): PersonEntry;
+/**
+ * 인원 축 전체 — 트윈이 당겨 갈 조각.
+ *
+ * ── 왜 구조는 밀지 않고 당겨 가나 ───────────────────────────────────────────
+ * 사실(생산·이동·검사)은 한 건씩 밀어야 실시간이 된다. 구조는 다르다. 사람이 자기 등급을 가리키므로
+ * **서로 맞아야** 하고, 한 건씩 밀면 사람이 먼저 도착하고 등급이 나중에 오는 순간이 생긴다.
+ * 그 순간 트윈은 없는 등급을 가리키는 사람을 갖는다.
+ *
+ * 그래서 구조는 **바뀌었다는 것만 알리고 트윈이 이 조각을 통째로 당겨 간다.**
+ */
+export declare function personnelMaster(classes: PersonnelClass[], persons: Person[]): {
+    personnelClasses: ResourceClassDef[];
+    persons: PersonEntry[];
+};

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPersonEntry = toPersonEntry;
+exports.personnelMaster = personnelMaster;
+const resource_class_1 = require("../resource/resource-class");
+function toPersonEntry(person) {
+    const out = { id: person.name };
+    (0, resource_class_1.put)(out, 'personnelClassIds', person.personnelClassIds);
+    (0, resource_class_1.put)(out, 'homeLocation', person.homeLocation);
+    (0, resource_class_1.put)(out, 'workCalendar', person.workCalendar);
+    (0, resource_class_1.put)(out, 'properties', person.properties);
+    (0, resource_class_1.put)(out, 'testSpecificationIds', person.testSpecificationIds);
+    (0, resource_class_1.put)(out, 'testResults', person.testResults);
+    (0, resource_class_1.put)(out, 'effectiveStart', (0, resource_class_1.iso)(person.effectiveStart));
+    (0, resource_class_1.put)(out, 'effectiveEnd', (0, resource_class_1.iso)(person.effectiveEnd));
+    return out;
+}
+/**
+ * 인원 축 전체 — 트윈이 당겨 갈 조각.
+ *
+ * ── 왜 구조는 밀지 않고 당겨 가나 ───────────────────────────────────────────
+ * 사실(생산·이동·검사)은 한 건씩 밀어야 실시간이 된다. 구조는 다르다. 사람이 자기 등급을 가리키므로
+ * **서로 맞아야** 하고, 한 건씩 밀면 사람이 먼저 도착하고 등급이 나중에 오는 순간이 생긴다.
+ * 그 순간 트윈은 없는 등급을 가리키는 사람을 갖는다.
+ *
+ * 그래서 구조는 **바뀌었다는 것만 알리고 트윈이 이 조각을 통째로 당겨 간다.**
+ */
+function personnelMaster(classes, persons) {
+    return {
+        personnelClasses: classes.map(resource_class_1.toResourceClassDef),
+        persons: persons.map(toPersonEntry)
+    };
+}
+//# sourceMappingURL=personnel-master.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personnel-master.js","sourceRoot":"","sources":["../../../server/service/personnel/personnel-master.ts"],"names":[],"mappings":";;AA6BA,sCAaC;AAYD,0CAQC;AA5DD,+DAAyE;AA2BzE,SAAgB,aAAa,CAAC,MAAc;IAC1C,MAAM,GAAG,GAA4B,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;IAExD,IAAA,oBAAG,EAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAA;IACvD,IAAA,oBAAG,EAAC,GAAG,EAAE,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;IAC7C,IAAA,oBAAG,EAAC,GAAG,EAAE,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;IAC7C,IAAA,oBAAG,EAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IACzC,IAAA,oBAAG,EAAC,GAAG,EAAE,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAA;IAC7D,IAAA,oBAAG,EAAC,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;IAC3C,IAAA,oBAAG,EAAC,GAAG,EAAE,gBAAgB,EAAE,IAAA,oBAAG,EAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAA;IACtD,IAAA,oBAAG,EAAC,GAAG,EAAE,cAAc,EAAE,IAAA,oBAAG,EAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;IAElD,OAAO,GAA6B,CAAA;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAC7B,OAAyB,EACzB,OAAiB;IAEjB,OAAO;QACL,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,mCAAkB,CAAC;QACjD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;KACpC,CAAA;AACH,CAAC","sourcesContent":["import type { ResourceClassDef } from '@operato/ops-contract'\n\nimport { iso, put, toResourceClassDef } from '../resource/resource-class'\nimport type { Person } from './person'\nimport type { PersonnelClass } from './personnel-class'\n\n/**\n * MES 의 인원 마스터를 **트윈이 받는 모양**으로 옮긴다.\n *\n * ── 여기가 어긋남이 생기는 자리다 ───────────────────────────────────────────\n * 필드 이름을 계약과 같게 지었으므로 옮기는 일은 거의 없다. 그래도 옮기는 함수를 따로 두는 이유는,\n * **어긋난다면 반드시 여기서 어긋나기** 때문이다. 한 곳에 모아 두면 테스트가 그 한 곳을 본다.\n *\n * 계약 층의 타입(`ResourceClassDef`)을 그대로 쓴다. 우리가 다시 선언하면 그것이 두 번째 어휘가 된다.\n */\n\n/** 트윈 `ReferenceMaster.persons` 의 한 항목. 계약에 이름 붙은 타입이 없어 여기서 모양만 적는다. */\nexport interface PersonEntry {\n  id: string\n  personnelClassIds?: string[]\n  homeLocation?: string\n  workCalendar?: unknown[]\n  properties?: unknown[]\n  testSpecificationIds?: string[]\n  testResults?: unknown[]\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport function toPersonEntry(person: Person): PersonEntry {\n  const out: Record<string, unknown> = { id: person.name }\n\n  put(out, 'personnelClassIds', person.personnelClassIds)\n  put(out, 'homeLocation', person.homeLocation)\n  put(out, 'workCalendar', person.workCalendar)\n  put(out, 'properties', person.properties)\n  put(out, 'testSpecificationIds', person.testSpecificationIds)\n  put(out, 'testResults', person.testResults)\n  put(out, 'effectiveStart', iso(person.effectiveStart))\n  put(out, 'effectiveEnd', iso(person.effectiveEnd))\n\n  return out as unknown as PersonEntry\n}\n\n/**\n * 인원 축 전체 — 트윈이 당겨 갈 조각.\n *\n * ── 왜 구조는 밀지 않고 당겨 가나 ───────────────────────────────────────────\n * 사실(생산·이동·검사)은 한 건씩 밀어야 실시간이 된다. 구조는 다르다. 사람이 자기 등급을 가리키므로\n * **서로 맞아야** 하고, 한 건씩 밀면 사람이 먼저 도착하고 등급이 나중에 오는 순간이 생긴다.\n * 그 순간 트윈은 없는 등급을 가리키는 사람을 갖는다.\n *\n * 그래서 구조는 **바뀌었다는 것만 알리고 트윈이 이 조각을 통째로 당겨 간다.**\n */\nexport function personnelMaster(\n  classes: PersonnelClass[],\n  persons: Person[]\n): { personnelClasses: ResourceClassDef[]; persons: PersonEntry[] } {\n  return {\n    personnelClasses: classes.map(toResourceClassDef),\n    persons: persons.map(toPersonEntry)\n  }\n}\n"]}

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

@@ -0,0 +1,21 @@
+export declare class PersonnelMaster {
+    /**
+     * 트윈이 그대로 받는 모양이라 JSON 문자열로 낸다.
+     *
+     * 계약 층의 타입을 GraphQL 타입으로 다시 선언하지 않는 이유는, 그렇게 하면 같은 모양이 두 곳에
+     * 적히고 한쪽만 고쳐지기 때문이다. 받는 쪽은 이 문자열을 계약 층의 타입으로 읽는다.
+     */
+    personnelClasses: string;
+    persons: string;
+}
+export declare class PersonnelQuery {
+    /**
+     * 인원 축 전체를 한 번에 낸다 — 트윈이 당겨 가는 자리.
+     *
+     * 사람이 자기 등급을 가리키므로 **둘이 서로 맞아야 한다.** 한 건씩 밀면 사람이 먼저 도착하고 등급이
+     * 나중에 오는 순간이 생기고, 그 순간 트윈은 없는 등급을 가리키는 사람을 갖는다.
+     *
+     * 자르지 않는다. 인원 마스터는 현장 하나에서 수천을 넘지 않고, 잘라서 보내면 등급과 사람이 나뉜다.
+     */
+    personnelMaster(context: ResolverContext): Promise<PersonnelMaster>;
+}

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersonnelQuery = exports.PersonnelMaster = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const person_1 = require("./person");
+const personnel_class_1 = require("./personnel-class");
+const personnel_master_1 = require("./personnel-master");
+let PersonnelMaster = class PersonnelMaster {
+};
+exports.PersonnelMaster = PersonnelMaster;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => String, { description: 'ResourceClassDef[] as JSON text' }),
+    tslib_1.__metadata("design:type", String)
+], PersonnelMaster.prototype, "personnelClasses", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => String, { description: 'ReferenceMaster persons[] as JSON text' }),
+    tslib_1.__metadata("design:type", String)
+], PersonnelMaster.prototype, "persons", void 0);
+exports.PersonnelMaster = PersonnelMaster = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Personnel master as the twin receives it' })
+], PersonnelMaster);
+let PersonnelQuery = class PersonnelQuery {
+    /**
+     * 인원 축 전체를 한 번에 낸다 — 트윈이 당겨 가는 자리.
+     *
+     * 사람이 자기 등급을 가리키므로 **둘이 서로 맞아야 한다.** 한 건씩 밀면 사람이 먼저 도착하고 등급이
+     * 나중에 오는 순간이 생기고, 그 순간 트윈은 없는 등급을 가리키는 사람을 갖는다.
+     *
+     * 자르지 않는다. 인원 마스터는 현장 하나에서 수천을 넘지 않고, 잘라서 보내면 등급과 사람이 나뉜다.
+     */
+    async personnelMaster(context) {
+        const { domain } = context.state;
+        const [classes, persons] = await Promise.all([
+            (0, shell_1.getRepository)(personnel_class_1.PersonnelClass).find({ where: { domain: { id: domain.id } }, order: { name: 'ASC' } }),
+            (0, shell_1.getRepository)(person_1.Person).find({ where: { domain: { id: domain.id } }, order: { name: 'ASC' } })
+        ]);
+        const master = (0, personnel_master_1.personnelMaster)(classes, persons);
+        return {
+            personnelClasses: JSON.stringify(master.personnelClasses),
+            persons: JSON.stringify(master.persons)
+        };
+    }
+};
+exports.PersonnelQuery = PersonnelQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => PersonnelMaster, { description: 'Personnel master for the twin to pull' }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], PersonnelQuery.prototype, "personnelMaster", null);
+exports.PersonnelQuery = PersonnelQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(person_1.Person)
+], PersonnelQuery);
+//# sourceMappingURL=personnel-query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personnel-query.js","sourceRoot":"","sources":["../../../server/service/personnel/personnel-query.ts"],"names":[],"mappings":";;;;AAAA,+CAAsE;AAEtE,iDAAqD;AAErD,qCAAiC;AACjC,uDAAkD;AAClD,yDAA4E;AAGrE,IAAM,eAAe,GAArB,MAAM,eAAe;CAY3B,CAAA;AAZY,0CAAe;AAQ1B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC;;yDAClD;AAGxB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC;;gDAClE;0BAXJ,eAAe;IAD3B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;GAC3D,eAAe,CAY3B;AAGM,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB;;;;;;;OAOG;IAEG,AAAN,KAAK,CAAC,eAAe,CAAQ,OAAwB;QACnD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,IAAA,qBAAa,EAAC,gCAAc,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpG,IAAA,qBAAa,EAAC,eAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;SAC7F,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,IAAA,kCAAoB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAErD,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACzD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;SACxC,CAAA;IACH,CAAC;CACF,CAAA;AAzBY,wCAAc;AAUnB;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;IACrE,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;qDAc3B;yBAxBU,cAAc;IAD1B,IAAA,uBAAQ,EAAC,eAAM,CAAC;GACJ,cAAc,CAyB1B","sourcesContent":["import { Ctx, Field, ObjectType, Query, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { Person } from './person'\nimport { PersonnelClass } from './personnel-class'\nimport { personnelMaster as buildPersonnelMaster } from './personnel-master'\n\n@ObjectType({ description: 'Personnel master as the twin receives it' })\nexport class PersonnelMaster {\n  /**\n   * 트윈이 그대로 받는 모양이라 JSON 문자열로 낸다.\n   *\n   * 계약 층의 타입을 GraphQL 타입으로 다시 선언하지 않는 이유는, 그렇게 하면 같은 모양이 두 곳에\n   * 적히고 한쪽만 고쳐지기 때문이다. 받는 쪽은 이 문자열을 계약 층의 타입으로 읽는다.\n   */\n  @Field(type => String, { description: 'ResourceClassDef[] as JSON text' })\n  personnelClasses: string\n\n  @Field(type => String, { description: 'ReferenceMaster persons[] as JSON text' })\n  persons: string\n}\n\n@Resolver(Person)\nexport class PersonnelQuery {\n  /**\n   * 인원 축 전체를 한 번에 낸다 — 트윈이 당겨 가는 자리.\n   *\n   * 사람이 자기 등급을 가리키므로 **둘이 서로 맞아야 한다.** 한 건씩 밀면 사람이 먼저 도착하고 등급이\n   * 나중에 오는 순간이 생기고, 그 순간 트윈은 없는 등급을 가리키는 사람을 갖는다.\n   *\n   * 자르지 않는다. 인원 마스터는 현장 하나에서 수천을 넘지 않고, 잘라서 보내면 등급과 사람이 나뉜다.\n   */\n  @Query(returns => PersonnelMaster, { description: 'Personnel master for the twin to pull' })\n  async personnelMaster(@Ctx() context: ResolverContext): Promise<PersonnelMaster> {\n    const { domain } = context.state\n\n    const [classes, persons] = await Promise.all([\n      getRepository(PersonnelClass).find({ where: { domain: { id: domain.id } }, order: { name: 'ASC' } }),\n      getRepository(Person).find({ where: { domain: { id: domain.id } }, order: { name: 'ASC' } })\n    ])\n\n    const master = buildPersonnelMaster(classes, persons)\n\n    return {\n      personnelClasses: JSON.stringify(master.personnelClasses),\n      persons: JSON.stringify(master.persons)\n    }\n  }\n}\n"]}