✖️ Multiplier Node

The Multiplier Node is a `calculation` node that multiplies a previously calculated compensation value based on attainment tiers.

It supports:

Attainment via:
Target (single or period-based)
Metric
Tier configuration using:
A value (which can be dynamic via getCompensationValue)
Or a fixed multiplier value

The multiplier is applied to:

A single compensation_value, or
An array of compensationValues per profile

📦 JSON Representation

{
  "type": "calculation",
  "data": {
    "id": "multiplier",
    "formData": {
      "reference_type": "target" | "metric",
      "target": { "id": "target_id" },
      "metric": { "id": "nps_score" },
      "tiers": [
        { "attainment": 80, "multiplier": 1 },
        { "attainment": 100, "multiplier": 1.25 }
      ]
    },
    "type": "calculation"
  }
}

🧾 Form Data Fields

Field	Required	Description
`reference_type`	✅	How to compute attainment: `target` or `metric`.
`target.id`	✅ if `reference_type = target`	The ID of the target to check attainment for.
`metric.id`	✅ if `reference_type = metric`	The ID of the metric used for attainment.
`tiers`	✅	Array of `[ attainment, multiplier
`tiers[].attainment`	✅	Minimum required attainment for the tier to apply.
`tiers[].multiplier`	✅ if `value` not set	Value to multiply compensation by.
`tiers[].value`	✅ if `multiplier` not set	Supports `getCompensationValue()` logic to compute the multiplier dynamically.

⚙️ Execution Logic

Attainment Calculation

If reference_type = target:
Use either:
The record’s processing date (if no outcome period), or
Period-based attainment (if outcome_period is defined).
If reference_type = metric:
Fetch metric value for the current compensation period.

Tier Matching

Attainment is scaled (e.g. ×100 if target-based).
Sorted tiers are evaluated from highest to lowest.
First matching tier is selected.

Apply Multiplier

If multiplier is defined in the tier → use it directly.
If value is defined → compute via getCompensationValue(value, attainment).
Final compensation = original × multiplier

📤 Output Variables

Variable	Description
`tier_index`	Index of matched tier.
`attainment`	Computed attainment from target or metric.
`multiplier`	Multiplier applied.
`compensation_value`	Result after applying the multiplier (single).
`compensation_values`	Array of results for multiple profiles.

🧪 Example

Multiply commission by 1.25 if attainment ≥ 100:

"tiers": [
  { "attainment": 80, "multiplier": 1 },
  { "attainment": 100, "multiplier": 1.25 }
]

If attainment = 95 → multiplier = 1
If attainment = 102 → multiplier = 1.25