Source Needs Assessment Data

[jtfairbank]

We need to source data from the needs assessment at build time in order to display it on the region pages. See this issue which documents the Needs Assessment Storage API for retrieving anonymized survey data. Shoutout to @coderbyheart for the implementation! 🥳

We'll be following this documentation to guide the implementation: https://www.gatsbyjs.com/docs/conceptual/data-fetching/#fetching-data-at-build-time

Goals

• Filter needs assessment data by region & quarter.
• Auto-sum needs assessment data across regions or quarters?
• Expose needs assessment data nicely via Gatsby's GraphQL API.
• Control when new needs assessment data is ingested (so we don't use the next round of needs assessment data too early).
  • Note: this is a reach goal and will likely be moved to another issue as it may involve using the CMS (Forestry) to whitelist quarters.

Checklist

• Source the data using gatsby's sourceNodes hook.
• Use gatsby's createNode function to create NeedsAssessmentSummary nodes.
• Use gatsby's createResolvers hook to link NeedsAssessmentSummary nodes to their corresponding region. Should be resolvable via DANeed.place.region and DANeed.place.subregion. Every place has a region, most places have subregions but on occasion subregion might be set to null if the data applies to an entire region ("Lebanon") or the "Other" region was selected.
• Write end-to-end tests to ensure that data is being ingested & exposed through Gatsby's graphql endpoint.

Next Up

• Create issues for Needs Assessment visualizations. #649
  • Needs Assessment: Clothing Data Visualization #625
  • Needs Assessment: Baby Clothing Data Visualization #626
  • Needs Assessment: Diapers Data Visualization #627
  • Needs Assessment: Hygiene Data Visualization #628
  • Needs Assessment: Food Data Visualization #629
  • Needs Assessment: Shelter and Storage Data Visualization #630
  • Needs Assessment: Needs Met Data Visualization #631
  • Needs Assessment: Number of Beneficiaries Data Visualization #632
  • Needs Assessment: Warehouse Space Data Visualization #638
  • Needs Assessment: Beneficiary Population Time-Series Data Visualization #648
• Show Needs Assessment visualizations on region pages.
• Create issues for a Needs Assessment page to show interactive visualizations.

[jtfairbank]

Made a request to get broken down data for all reqions / quarters: distributeaid/needs-assessment-storage#90