{
  "schema": "causal-showcase-manifest/1",
  "slug": "humanitarian-logistics",
  "version": "1.0",
  "title": "Humanitarian Disaster Response and Last-Mile Allocation",
  "question": "How should food, water, medical supplies and transport capacity be allocated across affected communities when information is incomplete?",
  "lastValidated": "2026-11-18",
  "evidence": "Reviewed",
  "scenario": {
    "params": [
      {
        "key": "detour",
        "label": "Trucks on the detour route",
        "min": 0,
        "max": 60,
        "step": 10,
        "default": 10,
        "unit": "%"
      },
      {
        "key": "points",
        "label": "New distribution points",
        "min": 0,
        "max": 4,
        "step": 1,
        "default": 0,
        "unit": "sites"
      },
      {
        "key": "equity",
        "label": "Equity weight",
        "min": 0,
        "max": 1,
        "step": 0.1,
        "default": 0,
        "unit": ""
      }
    ],
    "alternatives": [
      {
        "name": "Baseline damage",
        "description": "Current dispatch with the bridge closed.",
        "params": {
          "detour": 10,
          "points": 0,
          "equity": 0
        }
      },
      {
        "name": "Efficiency first",
        "description": "Three new points near the warehouse, no detour.",
        "params": {
          "detour": 0,
          "points": 3,
          "equity": 0
        }
      },
      {
        "name": "Detour priority",
        "description": "Half of trucks on the detour.",
        "params": {
          "detour": 50,
          "points": 0,
          "equity": 0
        }
      },
      {
        "name": "Added distribution points",
        "description": "Two new points with current dispatch.",
        "params": {
          "detour": 10,
          "points": 2,
          "equity": 0
        }
      },
      {
        "name": "Priority groups",
        "description": "Full equity weighting with current dispatch.",
        "params": {
          "detour": 10,
          "points": 0,
          "equity": 1
        }
      },
      {
        "name": "Optimized response",
        "description": "Recommended: detour share, two new points and a strong equity weight.",
        "params": {
          "detour": 40,
          "points": 2,
          "equity": 0.6
        }
      }
    ],
    "metrics": [
      {
        "key": "unmet",
        "label": "Total unmet need",
        "unit": "k person-days",
        "base": 240,
        "sd": 18,
        "higherIsBetter": false,
        "sensitivity": {
          "detour": 0.4,
          "points": -22,
          "equity": 15
        },
        "curvature": {
          "detour": 0.03
        }
      },
      {
        "key": "worst",
        "label": "Worst-served community unmet need",
        "unit": "%",
        "base": 64,
        "sd": 6,
        "higherIsBetter": false,
        "sensitivity": {
          "detour": -0.75,
          "points": -6,
          "equity": -18
        },
        "constraint": {
          "max": 35,
          "label": "Limit 35%"
        }
      },
      {
        "key": "time",
        "label": "Median delivery time",
        "unit": "h",
        "base": 30,
        "sd": 2.5,
        "higherIsBetter": false,
        "sensitivity": {
          "detour": 0.15,
          "points": -3.5,
          "equity": 2
        }
      },
      {
        "key": "spoilage",
        "label": "Spoilage",
        "unit": "%",
        "base": 6,
        "sd": 0.8,
        "higherIsBetter": false,
        "sensitivity": {
          "detour": 0.04,
          "points": 0.4,
          "equity": 0.5
        }
      }
    ],
    "objective": "Minimize total unmet need while keeping unmet need in the worst-served community at or below 35%.",
    "runs": 2000
  },
  "technical": {
    "dag": [
      [
        "Damage",
        "Population need"
      ],
      [
        "Displacement",
        "Population need"
      ],
      [
        "Bridge closure",
        "Travel time"
      ],
      [
        "Detour share",
        "Deliveries to cut-off"
      ],
      [
        "Distribution points",
        "Last-mile time"
      ],
      [
        "Travel time",
        "Deliveries"
      ],
      [
        "Deliveries",
        "Unmet need"
      ],
      [
        "Population need",
        "Unmet need"
      ],
      [
        "Field reports",
        "Need estimate"
      ]
    ],
    "estimand": "Not a causal estimand: needs are estimated states; policy comparisons are counterfactual simulations under the same sampled damage",
    "assumptions": [
      "Synthetic crisis",
      "Needs model is transparent and documented",
      "Community interactions limited to the represented displacement",
      "Field reports update uncertainty rather than overwrite history"
    ],
    "equations": [
      "Need_c(t+1) = Need_c(t) + Demand_c(t) − Delivered_c(t)",
      "Travel time_e = base_e × damage factor_e",
      "min Σ_c Unmet_c  s.t.  max_c Unmet_c / Need_c ≤ 0.35"
    ],
    "engines": {
      "Digital twins": "twin-runtime 2.8.0",
      "DES": "des-kernel 5.1.2",
      "Network": "graph-prop 1.7.2",
      "System dynamics": "stockflow 3.0.4",
      "Monte Carlo": "mc-sampler 4.0.0",
      "Optimization": "policy-opt 2.2.5"
    },
    "seed": 20261118,
    "validation": [
      {
        "name": "Convoy travel-time error",
        "value": "10.8%"
      },
      {
        "name": "Worst-community stability",
        "value": "±1 pt"
      },
      {
        "name": "Needs model coverage",
        "value": "90% band holds in 88% of back-tests"
      }
    ]
  },
  "provenance": {
    "authors": [
      "Platform Education Team"
    ],
    "reviewers": [
      "Humanitarian Operations Review",
      "Do-No-Harm Panel"
    ],
    "rights": "CC BY 4.0. Synthetic data generated by the platform.",
    "sourceData": "Synthetic communities, population needs, warehouses, inventory, route graph, damage states, vehicles, delivery events and field reports (seed 20261118). No data on real individuals.",
    "changelog": [
      {
        "version": "1.0",
        "date": "2026-11-18",
        "note": "Initial publication from the extended catalog specification (packages 8 to 20)."
      }
    ]
  },
  "exportedAt": "2026-11-18T23:20:19.058Z"
}