Skip to content

Showcase Script — the North Star

Three demo moments, written as step-by-step scripts. This is the artifact every phase must visibly advance (per plan.md → Development-Phase Goals): a step either works today (live) or names the phase that delivers it (target: P11, …). When a phase closes, walk the affected moment(s) and flip the markers — the walk, not the issue count, is the progress measure.

The machine-checkable twin of this script is scripts/smoke_e2e.py (Phase 10, #890); this file is the human walk on top of it.

Personas here are showcase lenses, not validated markets — the same logged-in platform demonstrates all three.

Moment 1 — Citizen: "How risky is my home?"

Surface: /lookup (RiskLookupPage). Known-good river-flood pin: 40.60, 22.80.

  1. Open /lookup, search an address (or drop a pin on the map). live
  2. See the multi-hazard score card: plain-language RAG bands, documented misses, screening-grade badge, provenance drawer with citation. live
  3. See the hazard raster rendered behind the pin — the map shows why the band is what it is. target: P11 (COG tile overlay exists on the Dashboard; wiring only)
  4. Toggle scenario and time horizon — "what about 2050 under SSP5-8.5?" — and watch the card update. target: P11 (API already accepts both)
  5. See a risk-over-time mini-chart across horizons. target: P11
  6. Copy a shareable permalink of this exact pin + settings and open it on a phone (responsive layout). target: P11

Moment 2 — Insurer: "What's my book's risk?"

Surface: /portfolios, /portfolios/:id.

  1. Create a portfolio; bulk-upload an asset CSV. live
  2. See the portfolio's assets on a map. target: P11 (exposure layers exist on the Dashboard; wiring only)
  3. Read the book rollup: headline band, per-hazard chips, value-weighted average, worst-N concentration table. live
  4. Toggle scenario/horizon on the rollup. target: P11 (API accepts both)
  5. Run a monetary loss computation on the portfolio — portfolio EAD/AAI and a frequency curve, not just score bands. target: P11 (compute-on-portfolio — the one new backbone compute feature)
  6. See real metrics on the portfolio list (exposure count, total EAD) instead of placeholders. target: P11
  7. Download a portfolio report. target: P11

Moment 3 — Scientist: "How do scenarios and engines compare?"

Surfaces: /matrix, /agreement, /scenarios → /compare.

  1. Run one hazard × impact-function × exposure across scenarios × horizons as a tracked batch; watch per-cell progress. live
  2. Read the result as a scenario × horizon heatmap grid and drill into any cell's full result view. target: P11 (today: flat table)
  3. Save the batch and recall it later. target: P11
  4. Download the composed report (PDF). live · Per-result CSV/PDF export on any result surface. target: P11 (wiring only)
  5. Compare two saved scenarios side by side — synchronized maps, delta stats. live, but reachable only via /scenarios selection — nav entry target: P11
  6. Run the same input across two live engines on /agreement and see real divergence badges. target: P12 (CLIMADA sidecar deploy, gated on engine#33 divergence check; today the roster has one engine)

Out of showcase scope (deliberate)

  • Cross-hazard matrix runs (one batch spanning hazards) — parked, revisit after P12
  • Report export packs (TCFD/CSRD), onboarding tour, multi-tenant admin flows
  • Pan-EU data coverage (#447)