Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rubyforgood/human-essentials

Human Essentials is an inventory management system for diaper, incontinence, and period-supply banks. It supports them in distributing to partners, tracking inventory, and reporting stats and analytics.
https://github.com/rubyforgood/human-essentials

hacktoberfest help-wanted non-profit open-source rails rubyforgood sdg-1 sdg-10 sdg-3

Last synced: 7 days ago
JSON representation

Host: GitHub
URL: https://github.com/rubyforgood/human-essentials
Owner: rubyforgood
License: mit
Created: 2017-04-22T01:11:13.000Z (almost 8 years ago)
Default Branch: main
Last Pushed: 2024-10-29T18:55:58.000Z (3 months ago)
Last Synced: 2024-10-29T20:38:49.709Z (3 months ago)
Topics: hacktoberfest, help-wanted, non-profit, open-source, rails, rubyforgood, sdg-1, sdg-10, sdg-3
Language: Ruby
Homepage: https://humanessentials.app
Size: 42.9 MB
Stars: 456
Watchers: 51
Forks: 487
Open Issues: 120
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: code-of-conduct.md

Awesome Lists containing this project

Open-Source-Ruby-and-Rails-Apps - human-essentials - Human Essentials is an inventory management system for essentials banks, to aid them in distributing items to their partners, tracking their inventory, and providing statistics about their inventory flows. 🔥 ✅ 🚀 (Happy Exploring 🤘)

README

        # Human Essentials



















 

 





























## Mission 💖

Human Essentials is an inventory management system built to address the needs of [Diaper Banks](https://nationaldiaperbanknetwork.org/diaper-need/) as directly and explicitly as possible and adapted to meet the needs of other Essentials Banks. Essentials Banks maintain inventory, receive donations and other human essentials supplies (e.g. diapers, period supplies), and issue distributions to community partner organizations. Like any non-profit, they also need to perform reports on this data and have day-to-day operational information they need. This application aims to serve those needs and facilitate the general operations of the Diaper Banks (e.g., using barcode readers, scale weighing, inventory audits).

## Impact 🌟

Human Essentials has over 200 registered banks across the United States at **no cost** to them. It is currently helping over **3 million** children receive diapers and over **400k** period supply recipients receive period supplies. Our team is in partnership with the [National Diaper Bank Network (NDBN)](https://nationaldiaperbanknetwork.org/) and can be found in their annual conference that brings numerous of non-profit organizations that distribute essential products to people.

We are proud of our achievements up to date but there is much more to do! This is where you come in...

## Ruby for Good

Human Essentials is one of many projects initiated and run by Ruby for Good. You can find out more about Ruby for Good at https://rubyforgood.org

## Digital Public Good 🎉

The [Digital Public Goods Alliance](https://digitalpublicgoods.net/registry/) recognizes Human Essentials as a digital public good (DPG). This project supports the following Sustainable Development Goals:

* [SDG 1](https://sdgs.un.org/goals/goal1) - End poverty in all its forms everywhere

* [SDG 3](https://sdgs.un.org/goals/goal3) - Ensure healthy lives and promote well-being for all at all ages

* [SDG 10](https://sdgs.un.org/goals/goal10) - Reduce inequality within and among countries

Use as an Organization or Contribute as an Individual/Team to this Project:

- [NGO Adoption Info](ngo.md) - information about how to use this DPG

- [Skills Based Volunteering Info](sbv.md) - information about how to volunteer

## Welcome Contributors! 👋

Thanks for checking us out! Check out our [Contributing Guidelines](https://github.com/rubyforgood/human-essentials/blob/main/CONTRIBUTING.md) on how to contribute.

## Deployment Process

The human-essentials & partner application should ideally be deployed on a weekly or bi-weekly schedule depending on the merged updates in the main branch. This is the process we take to deploy updates from our main branch to our servers.

### Requirements

- SSH access to our servers (usually granted to core maintainers)

- Login credentials to our [Mailchimp](https://mailchimp.com/) account

### Steps

#### 1. Merge main into production branch 

All deploys deploy from the production branch, which keeps track of what is currently in production.

```sh

git checkout production

git merge main

```

#### 2. Tag & Release

1. Push a tag with the appropriate date versioning. Refer to the [releases](https://github.com/rubyforgood/human-essentials/releases) for the correct versioning. For example, if you are deploying on June 23, 2024:

    ```sh

    git tag 2024.06.23

    git push origin tag 2024.06.23

    ```

2. Publish a release, associated to that tag pushed up in the previous step, [here](https://github.com/rubyforgood/human-essentials/releases/new). Include details about the release's updates (we use this to notify our stakeholders on updates via email).

### Running delayed jobs

Run delayed jobs locally with the `rake jobs:work` command. This is necessary to view any emails in your browser. Alternatively, you can run a specific delayed job by opening a Rails console and doing something like:

```ruby

Delayed::Job.last.invoke_job

```

You can replace the `last` query with any other query (e.g. `Delayed::Job.find(123)`).

# Acknowledgements

Thanks to Rachel (from PDX Diaperbank) for all of her insight, support, and assistance with this application, and Sarah ( http://www.sarahkasiske.com/ ) for her wonderful design and CSS work at Ruby For Good '17!

# License

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Frubyforgood%2Fdiaper.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Frubyforgood%2Fdiaper?ref=badge_large)

# ✨ Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    

      
_{Edwin Mak}
💻 📆 🚇 🤔 💬 🛡️

      
_{Sean Marcia}
💻 💼 💵 🔍 📋

      
_{Aaron H}
📆 💻

      
_Dmitry
💻

      
_{Adam Bachman}
💻

      
_{JC Avena}
💻

      
_mdworken
💻 📆

    

    

      
_{Marius Pop}
💻

      
_Elayne
💻

      
_{Amy Detwiler}
💻

      
_Gia
💻

      
_{Amina Adewusi}
💻

      
_albertchae
💻 🤔

      
_{Keith Walters}
💻

    

    

      
_{Chase Southard}
💻

      
_{Brock Wilcox}
💻

      
_danquill
💻

      
_{Keith Bennett}
💻

      
_{Benjamin Reynolds}
💻

      
_jtu0
💻

      
_{Juarez Lustosa}
💻

    

    

      
_{Julien A.}
💻

      
_{Emerson Manabu Araki}
💻

      
_{Ben Klang}
💻

      
_karolina
💻

      
_{Josh Cano}
💻

      
_{Julian Macmang}
💻

      
_{Philip DeFraties}
💻

    

    

      
_{GabrielRMuller}
💻

      
_{Lucas Hiago}
💻

      
_{Lanya Butler}
💻

      
_{Eduardo Moreira}
💻

      
_{Alicia Barrett}
💻

      
_{Bob Forcha}
💻

      
_{William Murphy}
💻

    

    

      
_{Kate Donaldson}
💻

      
_{Matthew Russell Dodds}
💻

      
_{Allison McMillan}
💻

      
_{Ashley Jean}
💻

      
_{Eduardo Alencar}
💻

      
_{Thomas Hart}
💻

      
_{Bart Agapinan}
💻

    

    

      
_Monique
💻

      
_{Valerie Woolard}
💻

      
_zak-kay
💻

      
_{Jason LaHatte}
💻

      
_{Dave Tapley}
💻

      
_Meghan
💻

      
_{Andy Thackray}
💻

    

    

      
_{Felipe Lovato Flores}
💻

      
_{Marcel Kooi}
💻

      
_{Lee Sharma}
💻

      
_{Scott Steele}
💻 🤔

      
_{Sam Weerasinghe}
💻

      
_{Gerald Abrencillo}
💻

      
_{Rodolfo Santos}
💻

    

    

      
_{Gabriel Baldão}
💻

      
_{Melanie White}
💻

      
_{Melissa Miller}
💻

      
_{Marc Heiligers}
💻

      
_{Joe Hunt}
💻

      
_{Meg Gutshall}
💻

      
_{Andrew H Schwartz}
💻

    

    

      
_{Joseph Glass}
💻

      
_{Reese Williams}
💻

      
_{Santiago Perez}
💻

      
_{Sirius Dely}
💻

      
_{Heather Herrington}
💻

      
_{Moacir Guedes}
💻

      
_CraigJZ
💻

    

    

      
_{Semih Arslanoğlu}
💻

      
_{Mauricio de Lima}
💻

      
_{David Curtis}
💻

      
_{Natalia Galán}
💻

      
_{Anderson Fernandes}
💻

      
_{Gabriel Belgamo}
💻

      
_{Jorge David C.T Junior}
💻

    

    

      
_{Seth Lieberman}
💻

      
_{Jorge Oliveira Santos}
💻

      
_Drinks
💻

      
_{Bruno Castro}
💻

      
_{Carlos Palhares}
💻

      
_{Clifton McIntosh}
💻

      
_{Daniel Beigelman}
💻

    

    

      
_{Meg Viar}
💻

      
_{Svetlana Vileshina}
💻

      
_{Ben Reed}
💻

      
_{Emily Giurleo}
💻

      
_{Alem Getu}
💻

      
_{Dejan Bjeloglav}
💻

      
_{Cassiano Blonski Sampaio}
💻

    

    

      
_Greg
💻

      
_finn
💻

      
_{Jayson Mandani}
💻

      
_{Stanley Liu}
💻

      
_{Curtis Bartell}
💻

      
_{Libby Rodriguez}
💻

      
_{joshuacgraves}
💬 📆

    

    

      
_Himanshu
💻

      
_{Mohamed Hegab}
💻

      
_{Alejandro AR}
💻

      
_hatsu
💻

      
_{Matt Glover}
💻

      
_js-sapphire
💻

      
_lasitha
💻

    

    

      
_{Patrick McClernan}
💻

      
_{Marc Bellingrath}
💻

      
_{Daniel Orner}
💻

      
_{Bob Mazanec}
💻

      
_{Mark Yen}
💻

      
_{Rachael Wright-Munn}
💻

      
_{Ítalo Matos}
💻

    

    

      
_{Alvaro Sanchez Diaz}
💻

      
_mbrundige
💻

      
_{Robert Greene}
💻

    

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!