DecisioQ System Architecture Decision Concepts Decision List API Guide Client Kit Developer Center Decision Studio Quick Start Playground End-to-End Examples

Decision Preparation Models

How Business Data is validated, transformed, calculated, and mapped into Prepared Criteria.

What Is a Decision Preparation Model?

Canonical definition: A Decision Preparation Model is a declarative model that defines how DecisioQ validates, normalizes, transforms, calculates, and maps Business Data into the Prepared Criteria required by a specific decision.

It describes both what data is accepted and how that data becomes decision-ready. A conventional data model describes what data exists; a Decision Preparation Model also declares validation, calculations, business rules, and criterion mappings.

Selection and Execution

Clients normally select a decision, not a model. In Business Data Mode, the selected decision resolves the appropriate versioned Decision Preparation Model automatically. The model validates the input contract and produces Prepared Criteria before invoking the Decision Engine.

Decision selectedDecision Preparation Model resolvedBusiness Data validatedPrepared Values calculatedBusiness rules appliedPrepared Criteria producedDecision Engine invoked

Two Input Modes

Business Data Mode

Business DataDecision Preparation ModelPrepared CriteriaDecision EngineRanking and Recommendation

Prepared Criteria Mode

Prepared CriteriaDecision EngineRanking and Recommendation

The model is bypassed because the client already owns criterion preparation.

Responsibilities

ComponentResponsibility
Input ContractFields, paths, types, required status, units, ranges, enumerations, constraints, examples, and schema version.
ValidationRequired, type, range, relationship, duplicate, conditional, and missing-data rules.
NormalizationUnits, currency, dates, enumerations, precision, rounding, and canonical formats.
Prepared ValuesFinancial, operational, risk, quality, compliance, sustainability, and other measurable values.
Business RulesConditions, eligibility, exclusions, penalties, caps, floors, defaults, and lookups.
Criterion MappingPrepared source, criterion ID, type, unit, range, scale, direction, and final mapping.
DocumentationAuthoritative metadata used to generate the Data Preparation Guide.

Five-Stage Semantic Model

StageOwner
Business ValueDecision Preparation Model
Prepared ValueDecision Preparation Model
Criterion ValueDecision Preparation Model
Normalized ScoreDecision Engine
Weighted ScoreDecision Engine
A Decision Preparation Model cannot author normalized or weighted scores.

End-to-End Example

For an auction purchase decision, the client supplies bid price, buyer fee, and transportation cost. The model validates each amount, calculates the Total Acquisition Cost Prepared Value, and maps it to the decision’s acquisition-cost criterion with a minimize direction.

Discovery and Data Preparation Guides

Use the decision-level Data Preparation Guide to discover required Business Data, validation, Prepared Values, and criterion mappings. Financial calculations link to the shared Financial Metrics definitions.