rubyforgood / rubyforgood/human-essentials

Add "Avg. number of individuals receiving period supplies monthly" to Annual Survey

Open
#4,512 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

BLOCKED Difficulty—Advanced
Dominant language
Ruby
Stars
593
Forks
593
Avg merge
4d 22h
Merged PRs (30d)
41

Description

Summary

Add the Avg. number of individuals receiving period supplies monthly to Annual Survey

Why

NDBN asks for these values from the banks in their annual survey. Much easier if we can calculate it for them

Details

BLOCKED by #4283
Add a field for the average number of individuals receiving period supplies monthly to the Annual survey
Also add a note on the value "This estimate is based on 1 person per kit, and a default of 25 pads/tampons per person for non-kit items."

How do we know the # of individuals receiving period supplies?

  • we can assume that there is a 1-1 kit to person ratio, unless there is a value for quantity for individual on the kit item, in which case we should use that value (if it is 2, it is a 2 to 1 kit to person ratio)
  • The base items for period supplies have the category "Menstrual Supplies/Items"
  • Items have a "distribution quantity" -- which is the number we use when doing individual requests, so that is a reasonable quantity to use.
  • What do we do if there is no "distribution quantity", though? We use 25, (per a conversation between CL, Lynn (of the NDBN) and Judi M on Dec 12, 2023
  • Sum these values for the year, and then divide by 12 to get the monthly average.

Criteria for completion

[ ] Value is calculated and shown on the report, along with the note.
[] Tests to support this behaviour

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the Annual Survey report and the dependency in issue #4283. Trace how annual period-supply distribution data is represented, including kit quantities and distribution quantities, then add the monthly average and specified note to the report. Add tests covering the calculation and report output.

Written by the indexing model from the issue text.

Assessment

Tech stack
rails, ruby
Domain
analytics
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.