PredictionOperation

PredictionOperation represents a single manufacturing operation within the production sequence for a brief element. Each operation contains detailed information about machine selection, material usage, sheet layouts, logistics calculations, and cost breakdowns. Operations are ordered sequentially to form the complete manufacturing process.

Main Purpose

Define individual manufacturing steps in production sequence
Specify machine and material requirements for each operation
Calculate sheet layouts and optimize material usage
Track production timing (setup, rolling time)
Store logistics data (packing, pallets, delivery)
Break down costs by operation type

Key Properties

Core Properties

Property	Type	Description
`id`	UUID	Unique identifier
`partNumber`	number	Part number (0-indexed, for multi-part products)
`position`	number	Operation position in sequence (0-indexed)
`operationId`	UUID	Reference to Operation entity
`operation`	Operation	Operation details (name, type, etc.)
`predictionRequestComputedId`	UUID	Parent PredictionRequestComputed reference

Sheet and Layout Data

Property	Type	Description
`sheetQuantity`	number	Number of sheets required
`sheetWidth`	number	Sheet width (mm)
`sheetHeight`	number	Sheet height (mm)
`layoutCountWidth`	number	Layouts across width
`layoutCountHeight`	number	Layouts across height
`sheetSurfacePurchased`	number	Purchased sheet surface (mm²)
`sheetSurfaceRequired`	number	Required sheet surface (mm²)
`sheetUpgrade`	number	Sheet upgrade factor
`sheetMultiUpTotalRuleLength`	number	Total rule length for multi-up
`sheetCadMultiUpTotalRuleLength`	number	CAD-calculated rule length
`sheetLayoutPattern`	string	Layout pattern code
`sheetOptimiseByCad`	boolean	Whether CAD optimized layout
`sheetCadPayload`	CadPayload	CAD optimization data (JSONB)
`sheetWidthInMachineDirection`	SheetWidthInMachineDirection	Sheet orientation in machine

Machine and Production

Property	Type	Description
`machineId`	UUID	Selected machine reference
`machine`	Machine	Machine details
`computedPace`	number	Production pace/speed
`computedPaceUnit`	PaceMeasureUnit	Pace measurement unit (e.g., sheets/hour)
`rollingTime`	number	Production rolling time (hours)
`setupTime`	number	Machine setup time (hours)
`wasteType`	WasteBaseMeasureUnit	Waste measurement unit
`wasteTotal`	number	Total waste amount
`machineRatesCoefficientSetId`	UUID	Rate coefficient set
`machineRatesCoefficientSet`	MachineRateCoefficientSet	Rate coefficients for pricing

Material and Composition

Property	Type	Description
`corrugatedMaterialCompositionPriceId`	UUID	Corrugated composition price reference
`corrugatedMaterialCompositionPrice`	CorrugatedMaterialCompositionPrice	Composition pricing details
`corrugatedMaterialCompositionId`	UUID	Corrugated composition reference
`corrugatedMaterialComposition`	CorrugatedMaterialComposition	Composition specification
`materialReferenceSheetSizeId`	UUID	Material sheet size reference
`materialReferenceSheetSize`	MaterialReferenceSheetSize	Sheet size details
`materialReferenceId`	UUID	Material reference
`materialReference`	MaterialReference	Material details
`compositionPrice`	number	Composition cost (€)
`compositionStock`	boolean	Whether in stock

Product Details

Property	Type	Description
`productQuantity`	number	Product quantity for this operation
`productWidth`	number	Product width (mm)
`productHeight`	number	Product height (mm)
`productCreased`	boolean	Whether product is creased
`productTotalSealingStripLength`	number	Total sealing strip length (mm)

Decoration and Printing

Property	Type	Description
`side`	SideName	Printing side (FRONT, BACK, BOTH)
`colorCount`	number	Number of colors
`varnishCount`	number	Number of varnish applications
`singleSideCrease`	boolean	Single-sided crease
`suppliesExtrafFlatCardBoard`	boolean	Supplies extra-flat cardboard

Pallet Configuration

Property	Type	Description
`palletCount`	number	Number of pallets
`palletWidth`	number	Pallet width (mm)
`palletLength`	number	Pallet length (mm)
`palletHeight`	number	Pallet height (mm)
`palletId`	string	Pallet identifier
`palletName`	string	Pallet name
`palletMaximumHeight`	number	Maximum pallet height (mm)
`productPerPallet`	number	Products per pallet
`productPerStack`	number	Products per stack
`stackPerPallet`	number	Stacks per pallet
`palletFloorEfficiency`	number	Floor space efficiency (0-1)
`palletVolumetricEfficiency`	number	Volume efficiency (0-1)
`palletPattern`	string	Pallet pattern code
`palletSolutionId`	string	Pallet solution identifier
`palletAxis`	string	Pallet orientation axis
`maxProductPerPallet`	number	Maximum products per pallet
`maxWeightPerPallet`	number	Maximum weight per pallet (kg)
`maxHeightPerPallet`	number	Maximum height per pallet (mm)
`maxHeightConsumePercentPerPallet`	number	Height consumption percentage
`palletProductPerLayer`	number	Products per pallet layer
`palletLayerCount`	number	Number of pallet layers
`palletProductCount`	number	Total products on pallet
`palletTotalWeight`	number	Total pallet weight (kg)

Box/Case Configuration

Property	Type	Description
`boxCaseSolutionId`	string	Box/case solution identifier
`boxCasePattern`	string	Box/case pattern code
`boxCaseAxis`	string	Box/case orientation axis
`maxProductPerCase`	number	Maximum products per case
`maxWeightPerCase`	number	Maximum weight per case (kg)
`maxHeightPerCase`	number	Maximum height per case (mm)
`maxHeightConsumePercentPerCase`	number	Height consumption percentage
`boxCaseFloorEfficiency`	number	Floor space efficiency (0-1)
`boxCaseVolumetricEfficiency`	number	Volume efficiency (0-1)
`boxCaseProductPerLayer`	number	Products per case layer
`boxCaseLayerCount`	number	Number of case layers
`boxCaseWidth`	number	Case width (mm)
`boxCaseLength`	number	Case length (mm)
`boxCaseHeight`	number	Case height (mm)
`boxCasePalletCount`	number	Cases per pallet
`boxCaseCount`	number	Total number of cases
`boxCaseTotalWeight`	number	Total case weight (kg)

Bundle Configuration

Property	Type	Description
`bundleWidth`	number	Bundle width (mm)
`bundleLength`	number	Bundle length (mm)
`bundleHeight`	number	Bundle height (mm)
`bundleWeight`	number	Bundle weight (kg)
`bundleTotalWeight`	number	Total bundle weight (kg)
`productPerBundle`	number	Products per bundle
`bundleCount`	number	Number of bundles

Truck/Delivery Configuration

Property	Type	Description
`truckSolutionId`	string	Truck solution identifier
`truckPattern`	string	Truck loading pattern code
`truckAxis`	string	Truck loading axis
`maxPalletPerTruck`	number	Maximum pallets per truck
`maxWeightPerTruck`	number	Maximum weight per truck (kg)
`maxHeightPerTruck`	number	Maximum height per truck (mm)
`maxHeightConsumePercentPerTruck`	number	Height consumption percentage
`truckFloorEfficiency`	number	Floor space efficiency (0-1)
`truckVolumetricEfficiency`	number	Volume efficiency (0-1)
`truckProductPerLayer`	number	Products per truck layer
`truckLayerCount`	number	Number of truck layers
`truckWidth`	number	Truck width (mm)
`truckLength`	number	Truck length (mm)
`truckHeight`	number	Truck height (mm)
`truckPalletCount`	number	Pallets per truck
`truckCount`	number	Number of trucks
`truckTotalWeight`	number	Total truck weight (kg)
`linearMeterConsumedPerTruck`	number	Linear meters consumed per truck
`truckTotalLinearMeterConsumed`	number	Total linear meters consumed

Cost Details (JSONB Arrays)

Property	Type	Description
`production`	PredictionCost[]	Production costs breakdown
`tooling`	PredictionCost[]	Tooling costs
`supply`	PredictionCost[]	Supply costs
`delivery`	PredictionCost[]	Delivery costs
`external`	PredictionCost[]	External provider costs

Provider and Configuration

Property	Type	Description
`providerId`	UUID	External provider reference
`provider`	Provider	Provider details
`metaOperations`	string[]	Meta operation names (JSONB)
`configNames`	string[]	Configuration names (JSONB)

Main Relationships

Relationship	Entity	Type	Description
`predictionRequestComputed`	PredictionRequestComputed	Many-to-One	Parent manufacturing data
`operation`	Operation	Many-to-One	Operation definition
`machine`	Machine	Many-to-One	Selected machine
`provider`	Provider	Many-to-One	External provider
`corrugatedMaterialCompositionPrice`	CorrugatedMaterialCompositionPrice	Many-to-One	Material composition pricing
`materialReferenceSheetSize`	MaterialReferenceSheetSize	Many-to-One	Sheet size specification

Schemas

PredictionCost Schema

interface PredictionCost {
  name: string;           // Cost item name
  cost: number;          // Cost amount (€)
  quantity?: number;     // Quantity
  unit?: string;         // Unit of measurement
  category?: string;     // Cost category
}

CadPayload Schema

interface CadPayload {
  // CAD-specific optimization data
  // Structure varies based on CAD system
  [key: string]: any;
}

Operation Sequence

Operations are ordered by their position property to form the manufacturing sequence:

// Access operations in sequence order
const operations = predictionRequestComputed.predictionOperationSequence;

// Sort by position (0-indexed)
operations.sort((a, b) => a.position - b.position);

// Example: First operation (position: 0)
const firstOp = operations[0];
console.log(`Operation: ${firstOp.operation.name}`);
console.log(`Machine: ${firstOp.machine.name}`);
console.log(`Setup: ${firstOp.setupTime}h, Rolling: ${firstOp.rollingTime}h`);
console.log(`Sheets: ${firstOp.sheetQuantity} @ ${firstOp.sheetWidth}x${firstOp.sheetHeight}mm`);

// Material information
if (firstOp.corrugatedMaterialCompositionPrice) {
  console.log(`Material: ${firstOp.corrugatedMaterialCompositionPrice.composition.name}`);
  console.log(`Price: €${firstOp.compositionPrice}`);
}

// Production costs
if (firstOp.production) {
  const totalProductionCost = firstOp.production.reduce((sum, cost) => sum + cost.cost, 0);
  console.log(`Production cost: €${totalProductionCost}`);
}

Multi-Part Products

For products with multiple parts, operations are grouped by partNumber:

// Group operations by part
const operationsByPart = operations.reduce((acc, op) => {
  if (!acc[op.partNumber]) acc[op.partNumber] = [];
  acc[op.partNumber].push(op);
  return acc;
}, {});

// Process each part
Object.entries(operationsByPart).forEach(([partNum, partOps]) => {
  console.log(`Part ${partNum}: ${partOps.length} operations`);
  partOps.forEach(op => {
    console.log(`  ${op.position}. ${op.operation.name}`);
  });
});

Use Cases

Manufacturing Planning: Use operation sequence to plan production workflow
Material Requirements: Calculate material needs from sheet dimensions and quantities
Production Timing: Sum setupTime and rollingTime for total production time
Machine Scheduling: Identify required machines for production planning
Cost Analysis: Break down costs by operation type (production, tooling, supply, delivery, external)
Logistics Planning: Use pallet, case, and truck data for shipping optimization
CAD Integration: Access sheetCadPayload for CAD system integration

Important Notes

Position is 0-indexed: First operation in sequence is position 0
Part numbering: Multi-part products have operations grouped by partNumber (also 0-indexed)
Operation order matters: Operations must be executed in sequence order
JSONB fields: production, tooling, supply, delivery, external, metaOperations, configNames, and sheetCadPayload are stored as JSONB
Eager loading: operation, machine, provider, and related entities are eagerly loaded
Nullable relationships: Some relationships like provider, materialReference are optional

GET /briefs/:id/process/:position - Returns PredictionRequestComputed with full predictionOperationSequence
GET /briefs/:id/details - Returns complete brief with all operations