Methodology
What the dashboard is designed to answer
This is an independent public beta for country-level DRR exploration. It consolidates open public datasets into one starting point for risk, hazard, readiness, loss, finance, donor, and project-signal analysis.
- What is the current composite disaster and humanitarian crisis risk profile?
- Which hazards are flagged as high or medium?
- What loss, displacement, readiness, and climate-vulnerability indicators are available?
- How much international DRR-related ODA is reported for the country?
- Which donors and public project-finance signals are visible?
It is not a replacement for official databases, national budget systems, licensed disaster-loss datasets, or full project appraisal.
Finance evidence tiers
| Tier | Included | Interpretation |
|---|---|---|
| Reported international DRR-related ODA | OECD CRS purpose codes 74010, 41050, and 41010 | High-confidence international public finance, not total national DRR spending. |
| Project finance signals | World Bank Projects and Operations, Green Climate Fund project records | Useful project discovery signal, not exact DRR component value. |
| Humanitarian response context | OCHA FTS country funding | Response pressure context, not prevention or preparedness spending. |
| Domestic, private, and mainstreamed DRR | Premium evidence backlog | Requires country-by-country evidence review and confidence labels. |
Build documentation
How this dashboard was built
The dashboard is a static GitHub Pages application designed for public research use. It combines a repeatable Node.js data pipeline with a lightweight D3 front end, so the public site can load quickly without a live database server.
Architecture
- Front end: `index.html`, `styles.css`, and `app.js` render the dashboard, charts, filters, country profiles, exports, premium waitlist messaging, and dataset Q&A.
- Data pipeline: `scripts/download-data.mjs` downloads, normalizes, and joins public DRR datasets by ISO3 country code.
- Processed outputs: `data/processed/dashboard-data.json` powers the dashboard, while `data/processed/country_metrics.csv` supports public CSV export.
- Validation: `scripts/validate-data.mjs` checks source counts, country coverage, schema expectations, missing values, and warning conditions before refreshed data can be committed.
- Automation: `.github/workflows/refresh-data.yml` runs the public data refresh weekly and blocks publication when strict validation warnings are present.
- Hosting: GitHub Pages serves the static dashboard from the public repository.
Design and interaction
The visual system uses an Economist-inspired editorial style: strong typography, restrained panels, black rules, a focused color palette, direct data labels, explanatory notes, and source-linked metric cards. The experience is organized around five research actions: scan global risk, ask a dataset question, inspect one country, compare two countries, and review finance signals.
Accessibility and mobile hardening
The dashboard includes skip links, semantic landmarks, visible labels, chart summaries, accessible data tables behind visual charts, focus-visible states, reduced-motion CSS, keyboard-reachable documentation tables, color contrast checks, and mobile overflow checks. The latest local and live axe-core runs returned zero automated violations across the tested dashboard and documentation views.
Source caveats
What is downloadable, and what remains constrained
The public dashboard uses sources that can be downloaded or queried programmatically without private credentials. Important sources such as official EM-DAT exports, DesInventar country databases, DELTA Resilience, NatCatSERVICE, IATI, domestic budgets, and private finance evidence require registration, licensing, country-by-country extraction, or manual interpretation.
| Source group | Dashboard use | Main caveat |
|---|---|---|
| INFORM, WorldRiskIndex, ThinkHazard | Risk, exposure, vulnerability, and hazard screening | Mixed model assumptions and source years. |
| OECD CRS | Reported DRR-related ODA by donor, recipient, sector, and flow | International support only. It is not total country DRR spending. |
| World Bank and GCF | Public project finance signals and examples | Full project amounts should not be read as exact DRR components. |
| OCHA FTS | Humanitarian response funding context | Response funding is not counted as prevention or preparedness spending. |
Premium records must be served from an authenticated API after billing and entitlement checks. They should not be committed as public static JSON, CSV, or hidden JavaScript.
Data dictionary
Core public fields
| Field | Meaning | Source |
|---|---|---|
| risk, hazardExposure, vulnerability, lackCopingCapacity | Current INFORM country risk and core risk dimensions. | INFORM Risk Index |
| drrOdaDisbursementUsd, drrOdaCommitmentUsd, drrOdaTopDonors | Latest reported DRR-related international ODA values and donor breakdown. | OECD CRS |
| lossUsdValue, lossGdpValue, nationalStrategyValue, localStrategyValue | Sendai/SDG-aligned loss and DRR strategy indicators where available. | UNDRR via Our World in Data |
| worldBankDrmProjectCount, gcfDrrProjectCount | Public project-signal counts and examples linked to each country. | World Bank, GCF |
| waterStressScore, riverFloodRiskScore, droughtRiskScore | Water stress, flood, and drought risk screening values. | WRI Aqueduct |
Roadmap
What is still pending
The current public dashboard is suitable for exploration and briefing support. The items below are the main remaining steps before presenting it as an institutional-grade product.
| Area | Pending work | Why it matters |
|---|---|---|
| Premium access | Deploy the premium API, connect Stripe, add user authentication, verify entitlements, and keep restricted data outside GitHub Pages. | Paid users should receive real protected data, not static files that can be bypassed. |
| Domestic and private finance | Add country-by-country evidence extraction for national budgets, disaster funds, climate budget tagging, IATI records, private finance, and co-finance signals. | Public ODA is useful but incomplete; total DRR finance requires a broader evidence model. |
| Data reliability | Expand validation to include per-source freshness thresholds, failed-source warnings in the UI, anomaly detection, and versioned data releases. | Organizations need to know when values changed, which sources failed, and whether outputs are comparable over time. |
| User workflows | Add saved country briefs, PDF exports, donor drilldowns, project lists, organization accounts, API keys, and repeatable export audit trails. | Institutional users need reusable outputs for screening, reporting, and internal dashboards. |
| Accessibility assurance | Complete a manual keyboard-only pass and screen-reader smoke test with NVDA, VoiceOver, or JAWS before making formal WCAG claims. | Automated checks are strong but do not replace assistive-technology testing with real workflows. |
| Governance | Add a named support process, correction workflow, source licensing notes, data retention policy for future accounts, and institutional terms. | Organizations need clear accountability before relying on the tool in decision processes. |
Recommended next sequence
- Finish manual accessibility and mobile QA.
- Deploy the premium API with authentication and Stripe in test mode.
- Add a first premium country evidence pack for a small pilot group.
- Introduce versioned data releases and visible failed-source notices.
- Move to the preferred production subpage when the `bisolutions.group` deployment path is ready.
Accessibility
Public beta accessibility status
Implemented features include a skip link, semantic landmarks, visible labels, chart summaries, accessible chart data tables, keyboard-reachable table scroll regions, focus-visible styles, reduced-motion CSS, axe-core checks, and mobile overflow checks.
Before institutional procurement or formal WCAG claims, run a manual keyboard-only pass and a screen-reader smoke test with target users.
Terms and privacy
Public beta terms
The public dashboard is provided for exploration, research, and briefing support. It does not provide legal, financial, procurement, or official statistical advice.
The static public site does not require an account and does not collect payment. Premium features require a separate authenticated backend before any restricted data or billing can be activated.
For corrections, source suggestions, institutional pilots, or country evidence requests, contact contact@bisolutions.group.