@things-factory/ops-master 10.1.248 → 10.1.249

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

@@ -0,0 +1,183 @@
+import { EntityManager } from 'typeorm';
+import { Refusal } from '@things-factory/shell';
+import { RecipeDefinition } from './recipe-definition';
+import { RecipeRevisionInput, RecipeRevisionOutput } from './recipe-revision-line';
+import { MaterialDefinition } from '../material/material-definition';
+import { RouteDefinition } from './route-definition';
+import { RecipeDraftContent } from './recipe-revision-content';
+import { RecipeBasis, RecipePlan, RecipeRevision, RecipeSegment } from './recipe-revision';
+export declare class RecipeRefusal extends Refusal {
+    constructor(code: string, detail?: string);
+}
+export declare function recipeSubmissionHash(revision: RecipeRevision): string;
+/** Display values are a checked projection of the frozen revision, never a second editable source. */
+export declare function recipeApprovalInput(manager: EntityManager, domainId: string, revisionId: string): Promise<{
+    headline: string;
+    reason: string;
+    effectiveFrom: string;
+    before: {
+        detail: {
+            validFrom?: string;
+            validTo?: string;
+            releaseKind?: "policy" | "approved" | "baseline";
+            revisionId: string;
+            createdAt: string;
+            frozenAt: string;
+            effectiveFrom: string;
+            reason: string;
+        };
+        materialDefinitionName: string;
+        description: string;
+        route: string;
+        inputs: import("./recipe-revision-content").RecipeLineContent[];
+        outputs: import("./recipe-revision-content").RecipeLineContent[];
+        revisionNumber: number;
+    };
+    after: {
+        detail: {
+            validFrom?: string;
+            validTo?: string;
+            releaseKind?: "policy" | "approved" | "baseline";
+            revisionId: string;
+            createdAt: string;
+            frozenAt: string;
+            effectiveFrom: string;
+            reason: string;
+        };
+        materialDefinitionName: string;
+        description: string;
+        route: string;
+        inputs: import("./recipe-revision-content").RecipeLineContent[];
+        outputs: import("./recipe-revision-content").RecipeLineContent[];
+        revisionNumber: number;
+    };
+    revision: {
+        revisionId: string;
+        hash: string;
+        recipeId: string;
+        baseGeneration: number;
+    };
+}>;
+export declare function assertRecipeApprovalInput(manager: EntityManager, domainId: string, input: Record<string, unknown>): Promise<void>;
+export declare function createRecipeDraft(manager: EntityManager, domainId: string, creatorId: string, asked: {
+    recipeId?: string;
+    name?: string;
+    baseRevisionId?: string;
+    content: RecipeDraftContent;
+}): Promise<RecipeRevision>;
+export declare function editRecipeDraft(manager: EntityManager, domainId: string, actorId: string, revisionId: string, expectedEditGeneration: number, input: RecipeDraftContent): Promise<RecipeRevision>;
+/** Product calls this in the same transaction as issuing its worklist approval. */
+export declare function freezeRecipeDraft(manager: EntityManager, domainId: string, actorId: string, revisionId: string, expectedEditGeneration: number): Promise<RecipeRevision>;
+export declare function bindRecipeApproval(manager: EntityManager, domainId: string, revisionId: string, activityInstanceId: string): Promise<void>;
+/** Internal completion callback only. Never expose this as an approved=true mutation. */
+export declare function publishRecipeRevision(manager: EntityManager, domainId: string, revisionId: string, decision: {
+    activityInstanceId: string;
+    approverId: string;
+    submissionHash: string;
+}): Promise<RecipePlan>;
+export declare function publishUnregulatedRecipe(manager: EntityManager, domainId: string, actorId: string, revisionId: string, editGeneration: number): Promise<RecipePlan>;
+export declare function resolveRecipe(manager: EntityManager, domainId: string, recipeId: string, businessTime: Date | string, knownAt?: Date | string): Promise<{
+    revision: RecipeRevision;
+    plan: RecipePlan;
+    segment: RecipeSegment;
+}>;
+/**
+ * **개정본이 하나도 없는 제조법**마다 지금 서 있는 행을 첫 개정본으로 적는다 — 기준선(2026-09-24).
+ * 규칙은 검사 명세의 `standTestSpecificationBaselines` 와 같다. 제조법만의 것 둘:
+ *
+ * - 옛 행의 줄에는 `lineKey` 가 없다. **자리로 붙인다** — `input-1` · `output-1`. plant 시드가 쓰는 규칙과
+ *   같고, 줄의 차례가 뜻을 가지는 모델이라 자리에서 온 키는 내용을 바꾸지 않는다.
+ * - 품목 · 공정 · 경로는 이름으로 가리킨다. **쓰기 전에 전부 대조한다** — 줄을 쓰다가 거절되면 반쯤 쓴
+ *   개정본이 트랜잭션에 남는다. 없는 것을 가리키는 행은 세우지 않고 까닭을 남긴다.
+ */
+export declare function standRecipeBaselines(manager: EntityManager, domainId: string, at: Date, edition: string): Promise<{
+    stood: number;
+    unreadable: {
+        name: string;
+        problem: string;
+    }[];
+}>;
+/** Replay reads verify the captured digest too, not only the currently effective schedule. */
+export declare function recipeRevisionForBasis(manager: EntityManager, domainId: string, basis: RecipeBasis): Promise<RecipeRevision>;
+/** Must run inside the transaction that writes the execution result. */
+export declare function captureRecipeBasis(manager: EntityManager, domainId: string, recipeId: string, recordKey: string, businessTime: Date | string): Promise<RecipeBasis>;
+export declare function recipeRevisionOverview(manager: EntityManager, domainId: string, recipeId: string, at?: Date): Promise<{
+    recipeId: string;
+    name: string;
+    generation: number;
+    at: string;
+    schedule: {
+        state: string;
+        id: string;
+        domain: import("@things-factory/shell").Domain;
+        domainId: string;
+        recipe: RecipeDefinition;
+        recipeId: string;
+        plan: RecipePlan;
+        planId: string;
+        revision: RecipeRevision;
+        revisionId: string;
+        validFrom: Date;
+        validTo: Date | null;
+    }[];
+    revisions: {
+        inputs: RecipeRevisionInput[];
+        outputs: RecipeRevisionOutput[];
+        state: string;
+        releaseKind: import("../master-change-approval/approval-input").ReleaseKind;
+        revisionNumber: number;
+        policy: import("../master-change-policy").MasterChangePolicy;
+        policyId: string;
+        id: string;
+        domain: import("@things-factory/shell").Domain;
+        domainId: string;
+        recipe: RecipeDefinition;
+        recipeId: string;
+        baseRevision: RecipeRevision | null;
+        baseRevisionId: string | null;
+        baseGeneration: number;
+        editGeneration: number;
+        description: string | null;
+        materialDefinitionName: string;
+        primaryMaterial: MaterialDefinition;
+        primaryMaterialId: string;
+        routeDefinition: RouteDefinition | null;
+        routeDefinitionId: string | null;
+        route: string | null;
+        effectiveFrom: Date;
+        reason: string;
+        creator: import("@things-factory/auth-base").User | null;
+        creatorId: string | null;
+        createdAt: Date;
+        frozenAt: Date | null;
+        contentHash: string | null;
+        activityInstanceId: string | null;
+    }[];
+}>;
+/** Read-time projection, never a clock-driven rewrite of the identity row. */
+export declare function effectiveRecipe(manager: EntityManager, domainId: string, recipe: RecipeDefinition, at?: Date): Promise<RecipeDefinition & {
+    effectiveStart: Date;
+    effectiveEnd: Date;
+    materialDefinitionName: string;
+    description: string;
+    route: string;
+    inputs: import("./recipe-revision-content").RecipeLineContent[];
+    outputs: import("./recipe-revision-content").RecipeLineContent[];
+}>;
+/**
+ * **비규제 사업장의 「저장」 한 번** — 초안을 만들고 바로 발행한다, 한 트랜잭션에서(ADR-0086 09-22 보탬).
+ * 비규제면 사람이 누를 것은 저장 하나다. 두 걸음(초안 저장 → 발행)이 구조상 필연인 것처럼 보이게 하지 않는다.
+ * 이 축이 승인제면 발행이 `MASTER_APPROVAL_REQUIRED` 로 거절되고, 같은 트랜잭션이라 초안도 함께 물러난다 —
+ * 반쯤 저장된 것이 남지 않는다. 개정본 · 적용계획 · 구간은 두 걸음 때와 똑같이 선다.
+ */
+export declare function saveAndPublishRecipe(manager: EntityManager, domainId: string, actorId: string, asked: {
+    recipeId?: string;
+    name?: string;
+    baseRevisionId?: string;
+    content: RecipeDraftContent;
+    revisionId?: string;
+    editGeneration?: number;
+}): Promise<{
+    revision: RecipeRevision;
+    plan: RecipePlan;
+}>;