PredictionRequestComputed

PredictionRequestComputed contains computed manufacturing process data and pricing details for individual brief elements. This entity stores the detailed production sequences, machine operations, cost calculations, and optimization data generated by the pricing engine for each product in a brief. It represents one manufacturing process variant for a specific element.

Main Purpose

Store manufacturing process sequences and operations
Link element positions to manufacturing details
Provide detailed cost breakdowns by category
Track machine operations and provider services
Support production optimization recommendations
Calculate unit pricing and production time

Key Properties

Core Properties

Property	Type	Description
`id`	UUID	Unique identifier
`position`	number	Element position (0-indexed, matches BriefElement.position)
`predictionRequestId`	UUID	Parent BriefPrice reference

Pricing Data

Property	Type	Description
`unitPrice`	number	Unit price per piece (€)
`toolingCost`	number	Tooling cost (€)
`deliveryCost`	number	Delivery cost (€)
`productCost`	number	Product manufacturing cost (€)

Production Data

Property	Type	Description
`productionTime`	number	Production time (hours)
`partsCount`	number	Number of parts/components
`parts`	Record<string, string>	Parts breakdown (JSONB)
`productIds`	string[]	Related product IDs

Sheet and Layout

Property	Type	Description
`sheetSizeWidth`	number	Sheet width (mm)
`sheetSizeHeight`	number	Sheet height (mm)
`layoutCount`	number	Number of layouts per sheet
`simulationPliantLargeurPredis`	number	Simulated flat width (mm)
`simulationPliantHauteurPredis`	number	Simulated flat height (mm)
`simulationNbPosesPliantPredis`	number	Number of positions on sheet
`nbFeuilleTotalPliantPredis`	number	Total sheet count
`pliantObjFoldingWeight`	number	Folding weight (kg)

Cost Components (Legacy Fields)

Property	Type	Description
`pliantPredis`	number	Flat cost
`cartonStructurePredis`	number	Cardboard structure cost
`encrageRectoDeBasePredis`	number	Base printing cost
`plaqueOffsetPredis`	number	Offset plate cost
`vernisDeBasePredis`	number	Base varnish cost
`plaqueVernisPredis`	number	Varnish plate cost
`pelliculagePredis`	number	Lamination cost
`varnishOrScreenprintingPredis`	number	Varnish/screenprinting cost
`ecranSerigraphiePredis`	number	Screen printing cost
`dorurePredis`	number	Hot stamping cost
`colleContreCollagePredis`	number	Counter-mounting glue cost
`colleFenetrePrixPredis`	number	Window glue cost
`petFenetrePrixPredis`	number	Window PET cost
`digipackPredis`	number	Digipack cost
`sachetsPrixPredis`	number	Bags cost
`cellophanePredis`	number	Cellophane cost
`caissePredis`	number	Box cost
`palettePredis`	number	Pallet cost
`predictedDeliveryPrice`	number	Predicted delivery price
`predictedThousandPrice`	number	Price per thousand units
`prixFinalTotalPredis`	number	Final total price
`decorticageCarcassePredis`	number	Carcass stripping cost
`decoupeCarcassePredis`	number	Carcass cutting cost
`sealingStripPredis`	number	Sealing strip cost
`totalPrixMachinePredis`	number	Total machine price

Structured Cost Data

Property	Type	Description
`costBreakdown`	CostBreakdown	Detailed cost breakdown (JSONB)
`costSummary`	CostSummary	Cost summary (JSONB)

Margin and Optimization

Property	Type	Description
`commercialMarginInitial`	number	Initial commercial margin (0-0.99)
`commercialMargin`	number	Applied commercial margin (0-0.99)
`optimisations`	RequestOptimisation[]	Optimization recommendations
`optimisationQuantity`	number	Optimized quantity
`optimiseProductQuantityPerDecoration`	DecorationCount[]	Optimized quantities per decoration

Metadata

Property	Type	Description
`createdAt`	Date	Creation timestamp
`updatedAt`	Date	Last update timestamp

Main Relationships

Relationship	Entity	Type	Description
`predictionRequest`	BriefPrice	Many-to-One	Parent pricing data
`predictionMachineOperationRates`	PredictionMachineOperationRate[]	One-to-Many	Machine operation details with rates and pace
`predictionProvidersOperationsRates`	PredictionProvidersOperationsRate[]	One-to-Many	External provider operation details
`predictionOperationSequence`	PredictionOperation[]	One-to-Many	Ordered sequence of manufacturing operations

Position Linking

The position property is critical for linking manufacturing data to brief elements:

// Access manufacturing details for first element (position: 0)
GET /briefs/:briefId/process/0

// The position matches:
const element = brief.briefElements[0];  // position: 0
const computed = briefPrice.predictionRequestComputed.find(prc => prc.position === 0);

Cost Breakdown Schema

interface CostBreakdown {
  // Materials
  materialsCost: number;
  materialsDetails: {
    paper: number;
    cardboard: number;
    corrugated: number;
    other: number;
  };

  // Operations
  printingCost: number;
  dieCuttingCost: number;
  finishingCost: number;
  assemblyCost: number;

  // Breakdown by operation
  operationsCost: {
    operationId: string;
    operationName: string;
    cost: number;
  }[];

  // Total
  totalCost: number;
}

Cost Summary Schema

interface CostSummary {
  subtotal: number;
  taxes: number;
  total: number;
  margin: number;
  marginPercentage: number;
}

Optimization Recommendations

The optimisations field contains recommendations for cost reduction:

enum RequestOptimisation {
  INCREASE_QUANTITY = 'INCREASE_QUANTITY',
  CHANGE_MATERIAL = 'CHANGE_MATERIAL',
  SIMPLIFY_FINISHING = 'SIMPLIFY_FINISHING',
  ADJUST_DIMENSIONS = 'ADJUST_DIMENSIONS'
}

Use Cases

Manufacturing Details: Access via GET /briefs/:id/process/:position to get full manufacturing process for element
Cost Analysis: Use costBreakdown for detailed cost components
Production Planning: Reference predictionOperationSequence for operation order
Machine Selection: Check predictionMachineOperationRates for required machines
Optimization: Review optimisations array for cost-saving recommendations
Multi-Product Briefs: Use position to match elements with their manufacturing data

Accessing Data

PredictionRequestComputed data is accessed through Brief endpoints:

# Get manufacturing details for specific element
GET /briefs/:id/process/:elementPosition

# Get complete pricing with all computed data
GET /briefs/:id/details

The /process/:elementPosition endpoint returns the PredictionRequestComputed for the specified element position (0-indexed).

Important Notes

Position is 0-indexed: First element is position 0, second is position 1, etc.
One per element per variant: Each BriefElement may have multiple PredictionRequestComputed entities representing different manufacturing approaches
Legacy fields: Many *Predis fields are legacy cost components from older prediction models
Cost structures: Prefer costBreakdown and costSummary over individual *Predis fields for modern integrations
Margin validation: Commercial margin fields are constrained between 0 and 0.99 (0% to 99%)
JSONB fields: costBreakdown, costSummary, parts, and optimiseProductQuantityPerDecoration are stored as JSONB for flexible structure

PredictionOperation Sequence

The predictionOperationSequence relationship contains the ordered sequence of manufacturing operations required to produce the element. Each operation represents one step in the manufacturing process with complete details about machines, materials, layouts, and costs.

Key Information:

Operations ordered by position (0-indexed)
Multi-part products grouped by partNumber
Each operation links to specific machine, materials, and provider
Contains detailed sheet layouts, logistics, and cost breakdowns

📖 Full PredictionOperation Entity Documentation

Quick Example:

// Access operations in sequence
const operations = predictionRequestComputed.predictionOperationSequence;
operations.sort((a, b) => a.position - b.position);

// First operation details
const op = operations[0];
console.log(`${op.operation.name} on ${op.machine.name}`);
console.log(`Time: ${op.setupTime}h setup + ${op.rollingTime}h rolling`);
console.log(`Sheets: ${op.sheetQuantity} @ ${op.sheetWidth}x${op.sheetHeight}mm`);

GET /briefs/:id/process/:position - Get manufacturing details for specific element (includes full PredictionRequestComputed with predictionOperationSequence)
GET /briefs/:id/details - Get complete brief with all PredictionRequestComputed data
GET /briefs/:id/value-analysis - Get cost analysis with optimization recommendations