BriefPrice (PredictionRequest)

BriefPrice contains pricing and prediction data for a brief. This entity is also known as “PredictionRequest” in the database. It stores the results of AI-powered pricing calculations including total price, cost breakdowns, production time estimates, and manufacturing process sequences. The entity provides comprehensive pricing analysis and supports quote versioning.

Main Purpose

Store AI-generated pricing predictions
Provide detailed cost breakdowns by category
Track manufacturing process sequences
Support price adjustments and deltas
Enable quote versioning and optimization
Link to machines and providers for manufacturing

Key Properties

Core Properties

Property	Type	Description
`id`	UUID	Unique identifier
`code`	number	Sequential code (auto-generated)
`briefId`	UUID	Parent brief reference
`userId`	UUID	Creator user

Price Breakdown

Property	Type	Description
`totalPrice`	number	Total price (€)
`productCost`	number	Product manufacturing cost (€)
`toolingCost`	number	Tooling cost (€)
`toolingCostDelta`	number	Manual tooling adjustment (€)
`deliveryCost`	number	Delivery cost (€)
`deliveryCostDelta`	number	Manual delivery adjustment (€)
`additionalCosts`	Partial	Extra costs

Production Data

Property	Type	Description
`quantity`	number	Production quantity
`productionTime`	number	Estimated production time (hours)
`processCount`	number	Number of manufacturing processes

Versioning

Property	Type	Description
`version`	string	Quote version (format: “XX”)
`parentId`	UUID	Parent quote (for iterations)
`rootId`	UUID	Root quote (first version)
`locked`	boolean	Quote locked for editing

Main Relationships

Relationship	Entity	Type	Description
`brief`	Brief	One-to-One	Parent brief
`user`	User	Many-to-One	Creator
`machines`	Machine[]	Many-to-Many	Selected machines
`providers`	Provider[]	Many-to-Many	External service providers
`priceSequence`	BriefPriceSequence[]	One-to-Many	Metadata to manage the semi-supervised edition
`predictionRequestComputed`	PredictionRequestComputed[]	One-to-Many	Manufacturing process

Cost Breakdown Schema

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

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

  // Overhead
  toolingOverhead: number;
  productionOverhead: number;
  deliveryOverhead: number;

  // Margin
  marginPercentage: number;
  marginAmount: number;

  // Totals
  subtotal: number;
  taxes: number;
  grandTotal: number;
}

Price Calculation

Total Product Cost:

const totalCost = briefPrice.productCost
  + briefPrice.toolingCost
  + briefPrice.toolingCostDelta
  + briefPrice.deliveryCost
  + briefPrice.deliveryCostDelta;

Use Cases

Quote Generation: Access totalPrice for customer quotes
Cost Analysis: Use costBreakdown for detailed analysis
Manufacturing Planning: Reference priceSequence for process details
Price Adjustments: Apply deltas for manual corrections
Quote Versioning: Track iterations via parentId and rootId
ERP Integration: Map costs to ERP pricing modules

Accessing Data

BriefPrice data is included when fetching brief details:

GET /briefs/:id/details

Returns brief with nested predictionRequest object.

For value analysis with optimization:

GET /briefs/:id/value-analysis

Returns BriefPrice with detailed cost breakdown and optimization opportunities.

Important Notes

The entity is stored as prediction_requests table but exposed as BriefPrice in API
Always has a 1:1 relationship with Brief
aliciaResponse contains the raw AI prediction data (not loaded by default)
processCount determines number of manufacturing sequences
Deltas (toolingCostDelta, deliveryCostDelta) allow manual price adjustments

GET /briefs/:id/details - Get complete brief including BriefPrice
GET /briefs/:id/value-analysis - Get detailed cost breakdown