{
  "updated": "2026-10-27",
  "kind": "authored synthetic worked example",
  "native_runtime_verified": false,
  "proof_scope": "Defined arithmetic expectations only; runtime and own-data checks are separate receipts.",
  "sample": "/examples/kpi-dashboard/sample.csv",
  "title": "KPI dashboard example: actual versus target",
  "row_grain": "category-month",
  "fields": [
    [
      "Period",
      "Reporting month in YYYY-MM format; actual and target cover the same month. Your own CSV may use numeric periods, YYYY-MM or YYYY-MM-DD; Q1/Q2 labels are not supported."
    ],
    [
      "Team",
      "Team responsible for this monthly revenue slice; North and South are synthetic labels."
    ],
    [
      "Actual",
      "Actual revenue in illustrative currency units for this team-month; sum across non-overlapping rows."
    ],
    [
      "Target",
      "Revenue target in the same units and team-month grain; sum across the same rows."
    ]
  ],
  "metrics": [
    {
      "name": "Actual revenue",
      "formula": "SUM(Actual)",
      "value": "270,000",
      "definition": "Sum all six actual-revenue rows."
    },
    {
      "name": "Revenue target",
      "formula": "SUM(Target)",
      "value": "300,000",
      "definition": "Sum the six matching team-month targets."
    },
    {
      "name": "Target attainment",
      "formula": "100 × SUM(Actual) / SUM(Target)",
      "value": "90%",
      "definition": "270,000 / 300,000 × 100; a zero target leaves this ratio undefined."
    },
    {
      "name": "Gap to target",
      "formula": "SUM(Actual) − SUM(Target)",
      "value": "−30,000",
      "definition": "270,000 − 300,000; a negative gap is below this revenue target."
    }
  ],
  "worked": "January contributes 80,000, February 90,000 and March 100,000. North contributes 155,000 and South 115,000. Adding team or month totals gives the same 270,000 actual-revenue total; do not add both sets of totals together.",
  "rows": [
    {
      "Period": "2026-01",
      "Team": "North",
      "Actual": "45000",
      "Target": "50000"
    },
    {
      "Period": "2026-01",
      "Team": "South",
      "Actual": "35000",
      "Target": "50000"
    },
    {
      "Period": "2026-02",
      "Team": "North",
      "Actual": "50000",
      "Target": "50000"
    },
    {
      "Period": "2026-02",
      "Team": "South",
      "Actual": "40000",
      "Target": "50000"
    },
    {
      "Period": "2026-03",
      "Team": "North",
      "Actual": "60000",
      "Target": "50000"
    },
    {
      "Period": "2026-03",
      "Team": "South",
      "Actual": "40000",
      "Target": "50000"
    }
  ]
}