Decision Summary

Business question: Which option should be recommended for determine safety inspection outcome in the selected Vehicle Inspection & Testing context?

Outcome: a ranked recommendation that supports, but does not replace, accountable business judgment.

5-Minute Quick Path

First working request →

Data Preparation Guide

Business Data uses domain-shaped records and the published mapping profile. Prepared Criteria bypasses mapping and supplies canonical criterion IDs directly. Never send both modes in one request.

Business Data Mode

This complete illustrative request comes from certification case valid-business-payload. It demonstrates shape and mapping, not production data.

{
  "decisionId": "AUTO-INSP-001",
  "mappingProfileId": "vehicle-inspection-safety-outcome",
  "businessData": {
    "stationId": "INSP-08",
    "inspectionCases": [
      {
        "inspectionId": "INSP-7001",
        "vehicleLabel": "2019 Mazda CX-5",
        "safetyScore": 82,
        "complianceScore": 91,
        "criticalDefects": 1,
        "partsEstimate": 430,
        "laborEstimate": 260,
        "safetyImpactBand": "Medium"
      },
      {
        "inspectionId": "INSP-7002",
        "vehicleLabel": "2014 Ram 1500",
        "safetyScore": 58,
        "complianceScore": 63,
        "criticalDefects": 3,
        "partsEstimate": 1200,
        "laborEstimate": 750,
        "safetyImpactBand": "High"
      }
    ]
  }
}

Download Business Data request

Prepared Criteria Mode

This complete request is the published expected-canonical artifact. Values and names remain illustrative.

{
  "resolvedDecisionType": "AUTO-INSP-001",
  "selectedProfileId": "balanced",
  "selectedScenarioId": null,
  "options": [
    {
      "name": "2019 Mazda CX-5",
      "scores": {
        "Safety Score": 82,
        "Compliance Score": 91,
        "Critical Defect Count": 1,
        "Repair Cost": 690,
        "Customer Safety Impact": 55.0
      }
    }
  ]
}

Download Prepared Criteria request

Understanding the Result

The score is a relative TOPSIS closeness coefficient within this candidate set; it is not a probability. The winner below was computed by DecisioQ.DecisionEngine.Services.TopsisEngine in-process from the published canonical request.

Winner: OPTION-1. Download verified local result

Profiles and Scenarios

Profiles: balanced, safety_quality, operations_focused

Scenarios: standard_inspection, high_safety_risk, capacity_pressure, regulatory_audit

Profiles change business priorities; scenarios represent operating context. Re-run the same candidate set and compare winner, score gap, and criterion contribution before adopting a change.

Sensitivity Analysis

Vary the highest-weight criteria in small increments and record whether the winner changes. A stable winner across reasonable weight changes is stronger evidence than a large score in one configuration.

Scenario Analysis

Use a published scenario only when it represents the intended operating context: standard_inspection, high_safety_risk, capacity_pressure, regulatory_audit. Compare the winner, ranking gap, and trade-offs with the baseline run.

Integration Examples and Next Steps

Use the API guide and client kit to transport either request mode. This example intentionally does not duplicate authentication, routing, Key Vault, usage accounting, or operational logging guidance.

Review the batch validation report, replace illustrative data with governed business data, and add domain acceptance thresholds before rollout.