@things-factory/ops-master 10.1.248 → 10.1.249

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

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecipeDefinition = 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");
+/**
+ * 레시피 — **무엇으로 무엇을 만드나**. 커널 `RecipeDef` 와 같은 모양이다.
+ *
+ * ── 이 자리가 답하는 것 ──────────────────────────────────────────────────
+ * 「이 품목은 무엇으로 만드나」와 「이 품목을 만드는 것은 어느 레시피인가」다. 둘째가 MES 가 물어야 했던
+ * 것인데 물을 곳이 없었다.
+ *
+ * ── 품목에 지시서를 달지 않는 이유 ───────────────────────────────────────
+ * ISA-95 에는 자재 명세가 붙는 자리가 둘이고 뜻이 다르다(§`RecipePart.operation`).
+ *
+ *  · `ProcessSegment` — 그 자리가 **할 수 있는 일**. 품목에 매이지 않는다 → `OperationDefinition`
+ *  · `OperationsSegment` — 그 **품목을 만드는 절차**의 한 단계. 품목에 매인다 → **레시피가 그 범위다**
+ *
+ * 그래서 품목→지시서를 이으려면 그 사이에 레시피가 있어야 한다. 공정에 품목을 붙이면 범주 오류이고,
+ * 실 데이터가 그 크기를 보였다 — 「배합」에 품목별 BOM 을 붙이면 배합을 지나는 **모든** 로트가 자재
+ * 631종 36톤을 먹는다.
+ *
+ * ── 같은 품목에 레시피가 둘일 수 있다 ────────────────────────────────────
+ * 대체 레시피가 정상이다(첫 실 연동에서 라우팅이 둘 이상인 레시피가 306/471). 그래서 **품목이 레시피를
+ * 가리키지 않고 레시피가 품목을 가리킨다** — 품목은 하나를 고를 수 없다.
+ */
+let RecipeDefinition = class RecipeDefinition {
+};
+exports.RecipeDefinition = RecipeDefinition;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.Int, { nullable: true }),
+    tslib_1.__metadata("design:type", Number)
+], RecipeDefinition.prototype, "revisionNumber", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('int', { default: 0 }),
+    tslib_1.__metadata("design:type", Number)
+], RecipeDefinition.prototype, "planGeneration", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('int', { default: 0 }),
+    tslib_1.__metadata("design:type", Number)
+], RecipeDefinition.prototype, "revisionLock", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], RecipeDefinition.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)
+], RecipeDefinition.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((recipe) => recipe.domain),
+    tslib_1.__metadata("design:type", String)
+], RecipeDefinition.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], RecipeDefinition.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)
+], RecipeDefinition.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], RecipeDefinition.prototype, "materialDefinitionName", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json' }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { description: 'RecipePart[] — material · qty · operation?' }),
+    tslib_1.__metadata("design:type", Array)
+], RecipeDefinition.prototype, "inputs", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json' }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { description: 'RecipePart[]' }),
+    tslib_1.__metadata("design:type", Array)
+], RecipeDefinition.prototype, "outputs", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], RecipeDefinition.prototype, "route", 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`.
+     *
+     * **개정할 때 행을 고치지 않고 이 칸을 채우고 새 행을 세운다.** 고치면 그 레시피로 만든 지난 실적이
+     * 어느 배합으로 만든 것인지 잃는다.
+     */
+    )
+], RecipeDefinition.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)
+], RecipeDefinition.prototype, "effectiveEnd", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], RecipeDefinition.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], RecipeDefinition.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)
+], RecipeDefinition.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((recipe) => recipe.creator),
+    tslib_1.__metadata("design:type", String)
+], RecipeDefinition.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)
+], RecipeDefinition.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((recipe) => recipe.updater),
+    tslib_1.__metadata("design:type", String)
+], RecipeDefinition.prototype, "updaterId", void 0);
+exports.RecipeDefinition = RecipeDefinition = tslib_1.__decorate([
+    (0, typeorm_1.Entity)({ name: 'ops_recipe_definition' }),
+    (0, typeorm_1.Index)('ix_ops_recipe_domain_identity', ['domain', 'id'], { unique: true }),
+    (0, typeorm_1.Index)('ix_ops_recipe_definition_0', (recipe) => [recipe.domain, recipe.name], { unique: true })
+    /* 「이 품목을 만드는 레시피」로 묻는 질의가 이 축으로 온다 — MES 가 지시를 받을 때마다 부른다. */
+    ,
+    (0, typeorm_1.Index)('ix_ops_recipe_definition_1', (recipe) => [recipe.domain, recipe.materialDefinitionName]),
+    (0, type_graphql_1.ObjectType)({ description: 'Recipe — what a material is made of and through which route (kernel RecipeDef).' })
+], RecipeDefinition);
+//# sourceMappingURL=recipe-definition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-definition.js","sourceRoot":"","sources":["../../../server/service/recipe/recipe-definition.ts"],"names":[],"mappings":";;;;AAAA,qCAAkI;AAClI,+CAAyD;AAEzD,iDAA4D;AAC5D,yDAAgD;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AAOI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAmG5B,CAAA;AAnGY,4CAAgB;AAG3B;IADC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,kBAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wDACd;AACQ;IAA9B,IAAA,gBAAM,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;wDAAuB;AACtB;IAA9B,IAAA,gBAAM,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;sDAAqB;AAG1C;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,CAAC;;4CACC;AAInB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;sCACb,cAAM;gDAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,MAAwB,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;;kDACvC;AAKjB;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,GAAE;;8CACI;AAIZ;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDACN;AAYpB;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gEACI;AAU9B;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC/B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC;;gDAC1D;AAKjC;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC/B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;;iDAC3B;AAUlC;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACZ;AAKd;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACT,IAAI;IAErB;;;;;OAKG;;wDAPkB;AAUrB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACX,IAAI;sDAAA;AAInB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;mDAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACd,IAAI;mDAAA;AAIhB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCAC9B,gBAAI;iDAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,MAAwB,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;;mDACvC;AAIlB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCAC9B,gBAAI;iDAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,MAAwB,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;;mDACvC;2BAlGP,gBAAgB;IAN5B,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IACzC,IAAA,eAAK,EAAC,+BAA+B,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1E,IAAA,eAAK,EAAC,4BAA4B,EAAE,CAAC,MAAwB,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClH,8DAA8D;;IAC7D,IAAA,eAAK,EAAC,4BAA4B,EAAE,CAAC,MAAwB,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACjH,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC;GAClG,gBAAgB,CAmG5B","sourcesContent":["import { Column, CreateDateColumn, Entity, Index, ManyToOne, PrimaryGeneratedColumn, RelationId, UpdateDateColumn } from 'typeorm'\nimport { Field, ID, Int, ObjectType } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/**\n * 레시피 — **무엇으로 무엇을 만드나**. 커널 `RecipeDef` 와 같은 모양이다.\n *\n * ── 이 자리가 답하는 것 ──────────────────────────────────────────────────\n * 「이 품목은 무엇으로 만드나」와 「이 품목을 만드는 것은 어느 레시피인가」다. 둘째가 MES 가 물어야 했던\n * 것인데 물을 곳이 없었다.\n *\n * ── 품목에 지시서를 달지 않는 이유 ───────────────────────────────────────\n * ISA-95 에는 자재 명세가 붙는 자리가 둘이고 뜻이 다르다(§`RecipePart.operation`).\n *\n *  · `ProcessSegment` — 그 자리가 **할 수 있는 일**. 품목에 매이지 않는다 → `OperationDefinition`\n *  · `OperationsSegment` — 그 **품목을 만드는 절차**의 한 단계. 품목에 매인다 → **레시피가 그 범위다**\n *\n * 그래서 품목→지시서를 이으려면 그 사이에 레시피가 있어야 한다. 공정에 품목을 붙이면 범주 오류이고,\n * 실 데이터가 그 크기를 보였다 — 「배합」에 품목별 BOM 을 붙이면 배합을 지나는 **모든** 로트가 자재\n * 631종 36톤을 먹는다.\n *\n * ── 같은 품목에 레시피가 둘일 수 있다 ────────────────────────────────────\n * 대체 레시피가 정상이다(첫 실 연동에서 라우팅이 둘 이상인 레시피가 306/471). 그래서 **품목이 레시피를\n * 가리키지 않고 레시피가 품목을 가리킨다** — 품목은 하나를 고를 수 없다.\n */\n@Entity({ name: 'ops_recipe_definition' })\n@Index('ix_ops_recipe_domain_identity', ['domain', 'id'], { unique: true })\n@Index('ix_ops_recipe_definition_0', (recipe: RecipeDefinition) => [recipe.domain, recipe.name], { unique: true })\n/* 「이 품목을 만드는 레시피」로 묻는 질의가 이 축으로 온다 — MES 가 지시를 받을 때마다 부른다. */\n@Index('ix_ops_recipe_definition_1', (recipe: RecipeDefinition) => [recipe.domain, recipe.materialDefinitionName])\n@ObjectType({ description: 'Recipe — what a material is made of and through which route (kernel RecipeDef).' })\nexport class RecipeDefinition {\n  /** Read projection of the effective revision, not a mutable identity column. */\n  @Field(() => Int, { nullable: true })\n  revisionNumber?: number\n  @Column('int', { default: 0 }) planGeneration: number\n  @Column('int', { default: 0 }) revisionLock: number\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((recipe: RecipeDefinition) => recipe.domain)\n  domainId?: string\n\n  /** 레시피 키 — 오더의 `recipeKey` 가 이 값을 가리킨다(커널 `RecipeDef.key`). */\n  @Column()\n  @Field()\n  name: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  description?: string\n\n  /**\n   * **무엇을 만드나** — `MaterialDefinition.name`.\n   *\n   * `outputs` 안에도 있지만 이 칸을 따로 둔다. 「이 품목을 만드는 레시피」를 JSON 안을 뒤져 찾으면\n   * 다섯 드라이버에서 색인이 서지 않고, 그 질의는 MES 가 지시를 받을 때마다 부른다.\n   *\n   * 산출이 여럿인 레시피(부산물)에서는 **주 산출**을 적는다. 나머지는 `outputs` 가 든다.\n   */\n  @Column()\n  @Field({ nullable: true })\n  materialDefinitionName: string\n\n  /**\n   * 투입 — 커널 `RecipePart[]`(`material` · `qty` · `operation?`).\n   *\n   * `operation` 은 **이 투입이 들어가는 공정**이다. 없으면 오더 착수에 확보한다. 그 태그가 여기 있는\n   * 이유는 품목별 소요가 사는 자리가 레시피이기 때문이다.\n   */\n  @Column({ type: 'simple-json' })\n  @Field(type => ScalarObject, { description: 'RecipePart[] — material · qty · operation?' })\n  inputs: Record<string, unknown>[]\n\n  /** 산출 — 커널 `RecipePart[]`. 부산물이 있으면 여기 함께 든다. */\n  @Column({ type: 'simple-json' })\n  @Field(type => ScalarObject, { description: 'RecipePart[]' })\n  outputs: Record<string, unknown>[]\n\n  /**\n   * 이 산출물을 만드는 공정 라우팅 — `RouteDefinition.name`(커널 `RecipeDef.route`).\n   *\n   * 순서는 라우팅이 소유하고 레시피는 그것을 가리킨다. 레시피에 단계 목록을 또 두면 두 목록이 어긋날 수\n   * 있고, 어긋났을 때 어느 쪽이 맞는지 말할 근거가 없다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  route?: string\n\n  /** 언제부터 유효한가 — 표준 `EffectiveStartDate`. */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  effectiveStart?: Date\n\n  /**\n   * 언제까지 유효한가 — 표준 `EffectiveEndDate`.\n   *\n   * **개정할 때 행을 고치지 않고 이 칸을 채우고 새 행을 세운다.** 고치면 그 레시피로 만든 지난 실적이\n   * 어느 배합으로 만든 것인지 잃는다.\n   */\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((recipe: RecipeDefinition) => recipe.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true })\n  updater?: User\n\n  @RelationId((recipe: RecipeDefinition) => recipe.updater)\n  updaterId?: string\n}\n"]}

package/dist-server/service/recipe/recipe-effective-list.d.ts

@@ -0,0 +1,49 @@
+import { EntityManager } from 'typeorm';
+import { Domain, ListParam } from '@things-factory/shell';
+import { RecipeDefinition } from './recipe-definition';
+/** Filter, sort, paginate and display the same time projection. No per-row resolution queries. */
+export declare function listEffectiveRecipes(manager: EntityManager, domain: Domain, params: ListParam, at?: Date): Promise<{
+    items: (RecipeDefinition & {
+        revisionNumber?: number;
+        planGeneration: number;
+        revisionLock: number;
+        id: string;
+        domain?: Domain;
+        domainId?: string;
+        name: string;
+        description?: string;
+        materialDefinitionName: string;
+        inputs: Record<string, unknown>[];
+        outputs: Record<string, unknown>[];
+        route?: string;
+        effectiveStart?: Date;
+        effectiveEnd?: Date;
+        createdAt?: Date;
+        updatedAt?: Date;
+        creator?: import("@things-factory/auth-base").User;
+        creatorId?: string;
+        updater?: import("@things-factory/auth-base").User;
+        updaterId?: string;
+    } & {
+        description: string;
+        revisionNumber: number;
+        materialDefinitionName: string;
+        route: string;
+        inputs: Record<string, unknown>[];
+        outputs: Record<string, unknown>[];
+        effectiveStart: Date;
+        effectiveEnd: Date;
+    })[];
+    total: number;
+}>;
+/** Candidate selection retains future/expired declarations so callers can explain why a choice is unavailable.
+ * One joined read; no per-order or per-recipe resolution queries. Payload rows are not loaded here.
+ */
+export declare function recipeChoicesAt(manager: EntityManager, domainId: string, materialNames: string[], at?: Date): Promise<{
+    id: string;
+    name: string;
+    materialDefinitionName: string;
+    route: string | undefined;
+    effectiveStart: Date;
+    effectiveEnd: Date | undefined;
+}[]>;

package/dist-server/service/recipe/recipe-effective-list.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listEffectiveRecipes = listEffectiveRecipes;
+exports.recipeChoicesAt = recipeChoicesAt;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const recipe_definition_1 = require("./recipe-definition");
+const recipe_revision_1 = require("./recipe-revision");
+const recipe_revision_line_1 = require("./recipe-revision-line");
+/** Filter, sort, paginate and display the same time projection. No per-row resolution queries. */
+async function listEffectiveRecipes(manager, domain, params, at = new Date()) {
+    const query = (0, shell_1.getQueryBuilderFromListParams)({
+        repository: manager.getRepository(recipe_definition_1.RecipeDefinition),
+        domain,
+        params,
+        alias: 'recipe',
+        searchables: ['name', 'description'],
+        sortables: ['id', 'name', 'revisionNumber', 'description', 'effectiveStart', 'effectiveEnd', 'createdAt', 'updatedAt'],
+        columnExpressions: {
+            revisionNumber: 'revision.revisionNumber',
+            description: 'revision.description',
+            materialDefinitionName: 'revision.materialDefinitionName',
+            route: 'revision.route',
+            effectiveStart: 'segment.validFrom',
+            effectiveEnd: 'segment.validTo'
+        }
+    });
+    query
+        .leftJoin(recipe_revision_1.RecipePlan, 'plan', 'plan.recipe_id = recipe.id AND plan.domain_id = recipe.domain_id AND plan.generation = recipe.plan_generation')
+        .leftJoinAndMapOne('recipe.selectedSegment', recipe_revision_1.RecipeSegment, 'segment', 'segment.plan_id = plan.id AND segment.validFrom <= :at AND (segment.validTo IS NULL OR segment.validTo > :at)', { at })
+        .leftJoinAndMapOne('recipe.selectedRevision', recipe_revision_1.RecipeRevision, 'revision', 'revision.id = segment.revision_id');
+    const [rows, total] = await query.getManyAndCount();
+    const revisionIds = rows.flatMap(row => row.selectedRevision ? [row.selectedRevision.id] : []);
+    const [inputs, outputs] = revisionIds.length ? await Promise.all([
+        manager.find(recipe_revision_line_1.RecipeRevisionInput, { where: { domain: { id: domain.id }, revision: { id: (0, typeorm_1.In)(revisionIds) } }, order: { position: 'ASC' } }),
+        manager.find(recipe_revision_line_1.RecipeRevisionOutput, { where: { domain: { id: domain.id }, revision: { id: (0, typeorm_1.In)(revisionIds) } }, order: { position: 'ASC' } })
+    ]) : [[], []];
+    const group = (lines) => {
+        const result = new Map();
+        for (const line of lines) {
+            const bucket = result.get(line.revisionId) ?? [];
+            bucket.push({ lineKey: line.lineKey, material: line.material, qty: line.qty,
+                ...('operation' in line && line.operation ? { operation: line.operation } : {}) });
+            result.set(line.revisionId, bucket);
+        }
+        return result;
+    };
+    const inputsByRevision = group(inputs), outputsByRevision = group(outputs);
+    const items = rows.map(row => {
+        const { selectedRevision, selectedSegment, ...identity } = row;
+        return Object.assign(new recipe_definition_1.RecipeDefinition(), identity, {
+            description: selectedRevision?.description ?? null,
+            revisionNumber: selectedRevision?.revisionNumber ?? null,
+            materialDefinitionName: selectedRevision?.materialDefinitionName ?? null,
+            route: selectedRevision?.route ?? null,
+            inputs: inputsByRevision.get(selectedRevision?.id) ?? [],
+            outputs: outputsByRevision.get(selectedRevision?.id) ?? [],
+            effectiveStart: selectedSegment?.validFrom ?? null,
+            effectiveEnd: selectedSegment?.validTo ?? null
+        });
+    });
+    return { items, total };
+}
+/** Candidate selection retains future/expired declarations so callers can explain why a choice is unavailable.
+ * One joined read; no per-order or per-recipe resolution queries. Payload rows are not loaded here.
+ */
+async function recipeChoicesAt(manager, domainId, materialNames, at = new Date()) {
+    if (!materialNames.length)
+        return [];
+    const rows = await manager.createQueryBuilder(recipe_definition_1.RecipeDefinition, 'recipe')
+        .innerJoin(recipe_revision_1.RecipePlan, 'plan', 'plan.recipe_id = recipe.id AND plan.domain_id = recipe.domain_id AND plan.generation = recipe.plan_generation')
+        .innerJoin(recipe_revision_1.RecipeSegment, 'segment', 'segment.plan_id = plan.id')
+        .innerJoin(recipe_revision_1.RecipeRevision, 'revision', 'revision.id = segment.revision_id')
+        .where('recipe.domain_id = :domainId', { domainId })
+        .select('recipe.id', 'id').addSelect('recipe.name', 'name')
+        .addSelect('revision.materialDefinitionName', 'materialDefinitionName').addSelect('revision.route', 'route')
+        .addSelect('segment.validFrom', 'validFrom').addSelect('segment.validTo', 'validTo')
+        .getRawMany();
+    const byRecipe = new Map();
+    for (const row of rows) {
+        // Driver raw dates may be SQLite's UTC "YYYY-MM-DD HH:mm:ss.sss" representation.
+        const date = (value) => value instanceof Date ? value : new Date(/(?:Z|[+-]\d\d:\d\d)$/.test(value) ? value : value.replace(' ', 'T') + 'Z');
+        row.effectiveStart = date(row.validFrom);
+        row.effectiveEnd = row.validTo ? date(row.validTo) : undefined;
+        const group = byRecipe.get(row.id) ?? [];
+        group.push(row);
+        byRecipe.set(row.id, group);
+    }
+    const rank = (row) => row.effectiveStart > at ? 1 : row.effectiveEnd && row.effectiveEnd <= at ? 2 : 0;
+    return [...byRecipe.values()].map(group => group.sort((a, b) => rank(a) - rank(b) ||
+        (rank(a) === 1 ? a.effectiveStart - b.effectiveStart : b.effectiveStart - a.effectiveStart))[0])
+        .filter(row => materialNames.includes(row.materialDefinitionName))
+        .map(row => ({ id: row.id, name: row.name, materialDefinitionName: row.materialDefinitionName,
+        route: row.route, effectiveStart: row.effectiveStart, effectiveEnd: row.effectiveEnd }));
+}
+//# sourceMappingURL=recipe-effective-list.js.map

package/dist-server/service/recipe/recipe-effective-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-effective-list.js","sourceRoot":"","sources":["../../../server/service/recipe/recipe-effective-list.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In } from 'typeorm'\nimport { Domain, getQueryBuilderFromListParams, ListParam } from '@things-factory/shell'\nimport { RecipeDefinition } from './recipe-definition'\nimport { RecipePlan, RecipeRevision, RecipeSegment } from './recipe-revision'\n\nimport { RecipeRevisionInput, RecipeRevisionOutput } from './recipe-revision-line'\n\ntype EffectiveRow = RecipeDefinition & {\n  selectedRevision?: RecipeRevision\n  selectedSegment?: RecipeSegment\n}\n\n/** Filter, sort, paginate and display the same time projection. No per-row resolution queries. */\nexport async function listEffectiveRecipes(\n  manager: EntityManager,\n  domain: Domain,\n  params: ListParam,\n  at = new Date()\n) {\n  const query = getQueryBuilderFromListParams({\n    repository: manager.getRepository(RecipeDefinition),\n    domain,\n    params,\n    alias: 'recipe',\n    searchables: ['name', 'description'],\n    sortables: ['id', 'name', 'revisionNumber', 'description', 'effectiveStart', 'effectiveEnd', 'createdAt', 'updatedAt'],\n    columnExpressions: {\n      revisionNumber: 'revision.revisionNumber',\n      description: 'revision.description',\n      materialDefinitionName: 'revision.materialDefinitionName',\n      route: 'revision.route',\n      effectiveStart: 'segment.validFrom',\n      effectiveEnd: 'segment.validTo'\n    }\n  })\n  query\n    .leftJoin(\n      RecipePlan,\n      'plan',\n      'plan.recipe_id = recipe.id AND plan.domain_id = recipe.domain_id AND plan.generation = recipe.plan_generation'\n    )\n    .leftJoinAndMapOne(\n      'recipe.selectedSegment',\n      RecipeSegment,\n      'segment',\n      'segment.plan_id = plan.id AND segment.validFrom <= :at AND (segment.validTo IS NULL OR segment.validTo > :at)',\n      { at }\n    )\n    .leftJoinAndMapOne(\n      'recipe.selectedRevision',\n      RecipeRevision,\n      'revision',\n      'revision.id = segment.revision_id'\n    )\n  const [rows, total] = await query.getManyAndCount()\n  const revisionIds = (rows as EffectiveRow[]).flatMap(row => row.selectedRevision ? [row.selectedRevision.id] : [])\n  const [inputs, outputs] = revisionIds.length ? await Promise.all([\n    manager.find(RecipeRevisionInput, { where: { domain: { id: domain.id }, revision: { id: In(revisionIds) } }, order: { position: 'ASC' } }),\n    manager.find(RecipeRevisionOutput, { where: { domain: { id: domain.id }, revision: { id: In(revisionIds) } }, order: { position: 'ASC' } })\n  ]) : [[], []]\n  const group = (lines: (RecipeRevisionInput | RecipeRevisionOutput)[]) => {\n    const result = new Map<string, Record<string, unknown>[]>()\n    for (const line of lines) {\n      const bucket = result.get(line.revisionId) ?? []\n      bucket.push({ lineKey: line.lineKey, material: line.material, qty: line.qty,\n        ...('operation' in line && line.operation ? { operation: line.operation } : {}) })\n      result.set(line.revisionId, bucket)\n    }\n    return result\n  }\n  const inputsByRevision = group(inputs), outputsByRevision = group(outputs)\n  const items = (rows as EffectiveRow[]).map(row => {\n    const { selectedRevision, selectedSegment, ...identity } = row\n    return Object.assign(new RecipeDefinition(), identity, {\n      description: selectedRevision?.description ?? null,\n      revisionNumber: selectedRevision?.revisionNumber ?? null,\n      materialDefinitionName: selectedRevision?.materialDefinitionName ?? null,\n      route: selectedRevision?.route ?? null,\n      inputs: inputsByRevision.get(selectedRevision?.id) ?? [],\n      outputs: outputsByRevision.get(selectedRevision?.id) ?? [],\n      effectiveStart: selectedSegment?.validFrom ?? null,\n      effectiveEnd: selectedSegment?.validTo ?? null\n    })\n  })\n  return { items, total }\n}\n\n/** Candidate selection retains future/expired declarations so callers can explain why a choice is unavailable.\n * One joined read; no per-order or per-recipe resolution queries. Payload rows are not loaded here.\n */\nexport async function recipeChoicesAt(manager: EntityManager, domainId: string, materialNames: string[], at = new Date()) {\n  if (!materialNames.length) return []\n  const rows = await manager.createQueryBuilder(RecipeDefinition, 'recipe')\n    .innerJoin(RecipePlan, 'plan', 'plan.recipe_id = recipe.id AND plan.domain_id = recipe.domain_id AND plan.generation = recipe.plan_generation')\n    .innerJoin(RecipeSegment, 'segment', 'segment.plan_id = plan.id')\n    .innerJoin(RecipeRevision, 'revision', 'revision.id = segment.revision_id')\n    .where('recipe.domain_id = :domainId', { domainId })\n    .select('recipe.id', 'id').addSelect('recipe.name', 'name')\n    .addSelect('revision.materialDefinitionName', 'materialDefinitionName').addSelect('revision.route', 'route')\n    .addSelect('segment.validFrom', 'validFrom').addSelect('segment.validTo', 'validTo')\n    .getRawMany()\n  const byRecipe = new Map<string, typeof rows>()\n  for (const row of rows) {\n    // Driver raw dates may be SQLite's UTC \"YYYY-MM-DD HH:mm:ss.sss\" representation.\n    const date = (value: string | Date) => value instanceof Date ? value : new Date(/(?:Z|[+-]\\d\\d:\\d\\d)$/.test(value) ? value : value.replace(' ', 'T') + 'Z')\n    row.effectiveStart = date(row.validFrom)\n    row.effectiveEnd = row.validTo ? date(row.validTo) : undefined\n    const group = byRecipe.get(row.id) ?? []\n    group.push(row); byRecipe.set(row.id, group)\n  }\n  const rank = (row: any) => row.effectiveStart > at ? 1 : row.effectiveEnd && row.effectiveEnd <= at ? 2 : 0\n  return [...byRecipe.values()].map(group => group.sort((a,b) => rank(a)-rank(b) ||\n    (rank(a) === 1 ? a.effectiveStart-b.effectiveStart : b.effectiveStart-a.effectiveStart))[0])\n    .filter(row => materialNames.includes(row.materialDefinitionName))\n    .map(row => ({ id: row.id as string, name: row.name as string, materialDefinitionName: row.materialDefinitionName as string,\n      route: row.route as string | undefined, effectiveStart: row.effectiveStart as Date, effectiveEnd: row.effectiveEnd as Date | undefined }))\n}\n"]}

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

@@ -0,0 +1,28 @@
+import { ListParam } from '@things-factory/shell';
+import { MasterPatch } from '../master-crud';
+import { RecipeDefinition } from './recipe-definition';
+import { RouteDefinition } from './route-definition';
+/**
+ * 레시피·라우팅 축을 채우고 고친다.
+ *
+ * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다 — 다른 열셋과 같은 모양이다.
+ *
+ * **개정할 때 행을 고치지 않고 유효 기간의 끝을 채운다.** 고치면 그 레시피로 만든 지난 실적이 어느
+ * 배합으로 만든 것인지 잃는다.
+ */
+export declare class RecipeDefinitionList {
+    items: RecipeDefinition[];
+    total: number;
+}
+export declare class RouteDefinitionList {
+    items: RouteDefinition[];
+    total: number;
+}
+export declare class RecipeDefinitionResolver {
+    recipeDefinitions(params: ListParam, context: ResolverContext): Promise<RecipeDefinitionList>;
+    updateMultipleRecipeDefinition(patches: MasterPatch[], context: ResolverContext): Promise<RecipeDefinition[]>;
+}
+export declare class RouteDefinitionResolver {
+    routeDefinitions(params: ListParam, context: ResolverContext): Promise<RouteDefinitionList>;
+    updateMultipleRouteDefinition(patches: MasterPatch[], context: ResolverContext): Promise<RouteDefinition[]>;
+}

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

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteDefinitionResolver = exports.RecipeDefinitionResolver = exports.RouteDefinitionList = exports.RecipeDefinitionList = 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 recipe_definition_1 = require("./recipe-definition");
+const route_definition_1 = require("./route-definition");
+/**
+ * 레시피·라우팅 축을 채우고 고친다.
+ *
+ * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다 — 다른 열셋과 같은 모양이다.
+ *
+ * **개정할 때 행을 고치지 않고 유효 기간의 끝을 채운다.** 고치면 그 레시피로 만든 지난 실적이 어느
+ * 배합으로 만든 것인지 잃는다.
+ */
+let RecipeDefinitionList = class RecipeDefinitionList {
+};
+exports.RecipeDefinitionList = RecipeDefinitionList;
+tslib_1.__decorate([
+    (0, type_graphql_2.Field)(type => [recipe_definition_1.RecipeDefinition]),
+    tslib_1.__metadata("design:type", Array)
+], RecipeDefinitionList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_2.Field)(type => type_graphql_2.Int),
+    tslib_1.__metadata("design:type", Number)
+], RecipeDefinitionList.prototype, "total", void 0);
+exports.RecipeDefinitionList = RecipeDefinitionList = tslib_1.__decorate([
+    (0, type_graphql_2.ObjectType)({ description: 'A page of recipe definitions' })
+], RecipeDefinitionList);
+let RouteDefinitionList = class RouteDefinitionList {
+};
+exports.RouteDefinitionList = RouteDefinitionList;
+tslib_1.__decorate([
+    (0, type_graphql_2.Field)(type => [route_definition_1.RouteDefinition]),
+    tslib_1.__metadata("design:type", Array)
+], RouteDefinitionList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_2.Field)(type => type_graphql_2.Int),
+    tslib_1.__metadata("design:type", Number)
+], RouteDefinitionList.prototype, "total", void 0);
+exports.RouteDefinitionList = RouteDefinitionList = tslib_1.__decorate([
+    (0, type_graphql_2.ObjectType)({ description: 'A page of route definitions' })
+], RouteDefinitionList);
+let RecipeDefinitionResolver = class RecipeDefinitionResolver {
+    async recipeDefinitions(params, context) {
+        const { domain } = context.state;
+        const { items, total } = await (0, master_list_1.listMaster)('recipeDefinition', params, domain);
+        return { items: items, total };
+    }
+    async updateMultipleRecipeDefinition(patches, context) {
+        const { domain, user, tx } = context.state;
+        const axis = (0, master_axis_1.masterAxisOf)('recipeDefinition');
+        const saved = await (0, master_crud_1.saveMasterPatches)(tx, domain, axis.entity, patches, user, {
+            hasEffectivePeriod: axis.hasEffectivePeriod
+        });
+        return saved;
+    }
+};
+exports.RecipeDefinitionResolver = RecipeDefinitionResolver;
+tslib_1.__decorate([
+    (0, type_graphql_2.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_2.Query)(returns => RecipeDefinitionList, { description: 'To fetch recipe definitions' }),
+    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)
+], RecipeDefinitionResolver.prototype, "recipeDefinitions", 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 => [recipe_definition_1.RecipeDefinition], { description: 'To create, change or retire recipe definitions' }),
+    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)
+], RecipeDefinitionResolver.prototype, "updateMultipleRecipeDefinition", null);
+exports.RecipeDefinitionResolver = RecipeDefinitionResolver = tslib_1.__decorate([
+    (0, type_graphql_2.Resolver)(recipe_definition_1.RecipeDefinition),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], RecipeDefinitionResolver);
+let RouteDefinitionResolver = class RouteDefinitionResolver {
+    async routeDefinitions(params, context) {
+        const { domain } = context.state;
+        const { items, total } = await (0, master_list_1.listMaster)('routeDefinition', params, domain);
+        return { items: items, total };
+    }
+    async updateMultipleRouteDefinition(patches, context) {
+        const { domain, user, tx } = context.state;
+        const axis = (0, master_axis_1.masterAxisOf)('routeDefinition');
+        const saved = await (0, master_crud_1.saveMasterPatches)(tx, domain, axis.entity, patches, user, {
+            hasEffectivePeriod: axis.hasEffectivePeriod
+        });
+        return saved;
+    }
+};
+exports.RouteDefinitionResolver = RouteDefinitionResolver;
+tslib_1.__decorate([
+    (0, type_graphql_2.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_2.Query)(returns => RouteDefinitionList, { description: 'To fetch route definitions' }),
+    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)
+], RouteDefinitionResolver.prototype, "routeDefinitions", 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 => [route_definition_1.RouteDefinition], { description: 'To create, change or retire route definitions' }),
+    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)
+], RouteDefinitionResolver.prototype, "updateMultipleRouteDefinition", null);
+exports.RouteDefinitionResolver = RouteDefinitionResolver = tslib_1.__decorate([
+    (0, type_graphql_2.Resolver)(route_definition_1.RouteDefinition),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], RouteDefinitionResolver);
+//# sourceMappingURL=recipe-master-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-master-resolver.js","sourceRoot":"","sources":["../../../server/service/recipe/recipe-master-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { UseMiddleware } from 'type-graphql'\nimport { SpeakRefusals } from '@things-factory/shell'\nimport { 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 { RecipeDefinition } from './recipe-definition'\nimport { RouteDefinition } from './route-definition'\n\n/**\n * 레시피·라우팅 축을 채우고 고친다.\n *\n * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다 — 다른 열셋과 같은 모양이다.\n *\n * **개정할 때 행을 고치지 않고 유효 기간의 끝을 채운다.** 고치면 그 레시피로 만든 지난 실적이 어느\n * 배합으로 만든 것인지 잃는다.\n */\n\n@ObjectType({ description: 'A page of recipe definitions' })\nexport class RecipeDefinitionList {\n  @Field(type => [RecipeDefinition])\n  items: RecipeDefinition[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@ObjectType({ description: 'A page of route definitions' })\nexport class RouteDefinitionList {\n  @Field(type => [RouteDefinition])\n  items: RouteDefinition[]\n\n  @Field(type => Int)\n  total: number\n}\n\n@Resolver(RecipeDefinition)\n@UseMiddleware(SpeakRefusals)\nexport class RecipeDefinitionResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => RecipeDefinitionList, { description: 'To fetch recipe definitions' })\n  async recipeDefinitions(\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<RecipeDefinitionList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('recipeDefinition', params, domain)\n\n    return { items: items as RecipeDefinition[], total }\n  }\n\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [RecipeDefinition], { description: 'To create, change or retire recipe definitions' })\n  async updateMultipleRecipeDefinition(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<RecipeDefinition[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('recipeDefinition')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as RecipeDefinition[]\n  }\n}\n\n@Resolver(RouteDefinition)\n@UseMiddleware(SpeakRefusals)\nexport class RouteDefinitionResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => RouteDefinitionList, { description: 'To fetch route definitions' })\n  async routeDefinitions(\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<RouteDefinitionList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('routeDefinition', params, domain)\n\n    return { items: items as RouteDefinition[], total }\n  }\n\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [RouteDefinition], { description: 'To create, change or retire route definitions' })\n  async updateMultipleRouteDefinition(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext\n  ): Promise<RouteDefinition[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('routeDefinition')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod\n    })\n\n    return saved as RouteDefinition[]\n  }\n}\n"]}

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

@@ -0,0 +1,37 @@
+import type { RecipeDefinition } from './recipe-definition';
+import type { RouteDefinition } from './route-definition';
+/**
+ * 트윈 선언의 `recipes`·`routes` 한 항목 — 계약의 `RecipeDef`·`RouteDef` 모양이다.
+ *
+ * 마스터가 다른 모양으로 들면 옮기는 코드가 두 겹이 되고, 그 코드가 언젠가 어긋난다. 그래서 칸 이름을
+ * 계약과 같게 둔다 — 다른 것은 마스터가 `name` 으로 부르는 것을 계약이 `key` 로 부르는 것 하나다.
+ */
+export interface RouteEntry {
+    key: string;
+    label: string;
+    steps: string[];
+    procedure?: unknown[];
+    effectiveStart?: string;
+    effectiveEnd?: string;
+}
+export interface RecipeEntry {
+    key: string;
+    label: string;
+    inputs: unknown[];
+    outputs: unknown[];
+    route?: string;
+    effectiveStart?: string;
+    effectiveEnd?: string;
+}
+export declare function toRouteEntry(route: RouteDefinition): RouteEntry;
+export declare function toRecipeEntry(recipe: RecipeDefinition): RecipeEntry;
+/**
+ * **이 품목을 만드는 레시피들** — 여럿일 수 있다.
+ *
+ * 하나를 골라 주지 않는다. 대체 레시피가 정상이고(첫 실 연동에서 라우팅이 둘 이상인 레시피가 306/471),
+ * 어느 것으로 만들지는 오더가 정하거나 사람이 고른다. 여기서 하나를 골라 주면 그 판정이 숨는다.
+ *
+ * 유효 기간은 여기서 걸러 내지 않는다 — 「지금 무엇을 쓸 수 있나」와 「그때 무엇을 썼나」가 다른 물음이고,
+ * 시각을 아는 것은 부르는 쪽이다.
+ */
+export declare function recipesFor(recipes: RecipeDefinition[], materialDefinitionName: string): RecipeEntry[];

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toRouteEntry = toRouteEntry;
+exports.toRecipeEntry = toRecipeEntry;
+exports.recipesFor = recipesFor;
+const resource_class_1 = require("../resource/resource-class");
+function toRouteEntry(route) {
+    /* `steps` 를 비울 수 없다 — 단계가 없는 라우팅은 지나갈 곳이 없다. */
+    const out = {
+        key: route.name,
+        label: route.description ?? route.name,
+        steps: route.steps ?? []
+    };
+    (0, resource_class_1.put)(out, 'procedure', route.procedure);
+    (0, resource_class_1.put)(out, 'effectiveStart', (0, resource_class_1.iso)(route.effectiveStart));
+    (0, resource_class_1.put)(out, 'effectiveEnd', (0, resource_class_1.iso)(route.effectiveEnd));
+    return out;
+}
+function toRecipeEntry(recipe) {
+    /*
+     * `inputs` 와 `outputs` 를 비울 수 없다. 산출이 없으면 무엇을 만드는지 알 수 없고, 투입이 없으면
+     * 무엇으로 만드는지 알 수 없다 — 둘 중 하나만으로는 레시피가 아니다.
+     */
+    const out = {
+        key: recipe.name,
+        label: recipe.description ?? recipe.name,
+        inputs: recipe.inputs ?? [],
+        outputs: recipe.outputs ?? []
+    };
+    (0, resource_class_1.put)(out, 'route', recipe.route);
+    (0, resource_class_1.put)(out, 'effectiveStart', (0, resource_class_1.iso)(recipe.effectiveStart));
+    (0, resource_class_1.put)(out, 'effectiveEnd', (0, resource_class_1.iso)(recipe.effectiveEnd));
+    return out;
+}
+/**
+ * **이 품목을 만드는 레시피들** — 여럿일 수 있다.
+ *
+ * 하나를 골라 주지 않는다. 대체 레시피가 정상이고(첫 실 연동에서 라우팅이 둘 이상인 레시피가 306/471),
+ * 어느 것으로 만들지는 오더가 정하거나 사람이 고른다. 여기서 하나를 골라 주면 그 판정이 숨는다.
+ *
+ * 유효 기간은 여기서 걸러 내지 않는다 — 「지금 무엇을 쓸 수 있나」와 「그때 무엇을 썼나」가 다른 물음이고,
+ * 시각을 아는 것은 부르는 쪽이다.
+ */
+function recipesFor(recipes, materialDefinitionName) {
+    return recipes.filter(r => r.materialDefinitionName === materialDefinitionName).map(toRecipeEntry);
+}
+//# sourceMappingURL=recipe-master.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-master.js","sourceRoot":"","sources":["../../../server/service/recipe/recipe-master.ts"],"names":[],"mappings":";;AA6BA,oCAWC;AAED,sCAeC;AAWD,gCAEC;AAtED,+DAAqD;AA6BrD,SAAgB,YAAY,CAAC,KAAsB;IACjD,gDAAgD;IAChD,MAAM,GAAG,GAA4B;QACnC,GAAG,EAAE,KAAK,CAAC,IAAI;QACf,KAAK,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI;QACtC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;KACzB,CAAA;IACD,IAAA,oBAAG,EAAC,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IACtC,IAAA,oBAAG,EAAC,GAAG,EAAE,gBAAgB,EAAE,IAAA,oBAAG,EAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAA;IACrD,IAAA,oBAAG,EAAC,GAAG,EAAE,cAAc,EAAE,IAAA,oBAAG,EAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;IACjD,OAAO,GAA4B,CAAA;AACrC,CAAC;AAED,SAAgB,aAAa,CAAC,MAAwB;IACpD;;;OAGG;IACH,MAAM,GAAG,GAA4B;QACnC,GAAG,EAAE,MAAM,CAAC,IAAI;QAChB,KAAK,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI;QACxC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;KAC9B,CAAA;IACD,IAAA,oBAAG,EAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;IAC/B,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;IAClD,OAAO,GAA6B,CAAA;AACtC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,OAA2B,EAAE,sBAA8B;IACpF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,sBAAsB,KAAK,sBAAsB,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;AACpG,CAAC","sourcesContent":["import { iso, put } from '../resource/resource-class'\nimport type { RecipeDefinition } from './recipe-definition'\nimport type { RouteDefinition } from './route-definition'\n\n/**\n * 트윈 선언의 `recipes`·`routes` 한 항목 — 계약의 `RecipeDef`·`RouteDef` 모양이다.\n *\n * 마스터가 다른 모양으로 들면 옮기는 코드가 두 겹이 되고, 그 코드가 언젠가 어긋난다. 그래서 칸 이름을\n * 계약과 같게 둔다 — 다른 것은 마스터가 `name` 으로 부르는 것을 계약이 `key` 로 부르는 것 하나다.\n */\nexport interface RouteEntry {\n  key: string\n  label: string\n  steps: string[]\n  procedure?: unknown[]\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport interface RecipeEntry {\n  key: string\n  label: string\n  inputs: unknown[]\n  outputs: unknown[]\n  route?: string\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport function toRouteEntry(route: RouteDefinition): RouteEntry {\n  /* `steps` 를 비울 수 없다 — 단계가 없는 라우팅은 지나갈 곳이 없다. */\n  const out: Record<string, unknown> = {\n    key: route.name,\n    label: route.description ?? route.name,\n    steps: route.steps ?? []\n  }\n  put(out, 'procedure', route.procedure)\n  put(out, 'effectiveStart', iso(route.effectiveStart))\n  put(out, 'effectiveEnd', iso(route.effectiveEnd))\n  return out as unknown as RouteEntry\n}\n\nexport function toRecipeEntry(recipe: RecipeDefinition): RecipeEntry {\n  /*\n   * `inputs` 와 `outputs` 를 비울 수 없다. 산출이 없으면 무엇을 만드는지 알 수 없고, 투입이 없으면\n   * 무엇으로 만드는지 알 수 없다 — 둘 중 하나만으로는 레시피가 아니다.\n   */\n  const out: Record<string, unknown> = {\n    key: recipe.name,\n    label: recipe.description ?? recipe.name,\n    inputs: recipe.inputs ?? [],\n    outputs: recipe.outputs ?? []\n  }\n  put(out, 'route', recipe.route)\n  put(out, 'effectiveStart', iso(recipe.effectiveStart))\n  put(out, 'effectiveEnd', iso(recipe.effectiveEnd))\n  return out as unknown as RecipeEntry\n}\n\n/**\n * **이 품목을 만드는 레시피들** — 여럿일 수 있다.\n *\n * 하나를 골라 주지 않는다. 대체 레시피가 정상이고(첫 실 연동에서 라우팅이 둘 이상인 레시피가 306/471),\n * 어느 것으로 만들지는 오더가 정하거나 사람이 고른다. 여기서 하나를 골라 주면 그 판정이 숨는다.\n *\n * 유효 기간은 여기서 걸러 내지 않는다 — 「지금 무엇을 쓸 수 있나」와 「그때 무엇을 썼나」가 다른 물음이고,\n * 시각을 아는 것은 부르는 쪽이다.\n */\nexport function recipesFor(recipes: RecipeDefinition[], materialDefinitionName: string): RecipeEntry[] {\n  return recipes.filter(r => r.materialDefinitionName === materialDefinitionName).map(toRecipeEntry)\n}\n"]}

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

@@ -0,0 +1,21 @@
+export declare class RecipeMaster {
+    recipes: string;
+    routes: string;
+    /**
+     * 더 있나 — **이 값을 안 보고 쓰면 조용히 잘린 마스터로 트윈을 세우게 된다.**
+     *
+     * 거짓이 될 때까지 `next` 를 `after` 로 넘겨 이어 받는다.
+     */
+    hasMore: boolean;
+    /** 이어 받을 자리. 더 없으면 없다. */
+    next?: string;
+}
+export declare class RecipeQuery {
+    /**
+     * 레시피와 라우팅을 **한 질의로** 낸다.
+     *
+     * 따로 물으면 그 사이에 마스터가 바뀌어 레시피가 없는 라우팅을 가리키는 순간이 생긴다. 구조는
+     * 서로를 가리키므로 통째로 맞아야 한다 — 마스터를 당겨 가는 다른 축과 같은 규율이다.
+     */
+    recipeMaster(after: string | undefined, limit: number | undefined, context: ResolverContext): Promise<RecipeMaster>;
+}