Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mansi1309/zero-hunger

Zero Hunger is a food donation platform that combats hunger by enabling instant donations. It features secure JWT authentication with multi-role dashboards for Admins, Donors, and Agents. Donors request and track donations, Admins manage requests and assign agents, and Agents handle collections with real-time updates.
https://github.com/mansi1309/zero-hunger

bootstrap5 ejs expressjs mongodb nodejs

Last synced: 25 days ago
JSON representation

Zero Hunger is a food donation platform that combats hunger by enabling instant donations. It features secure JWT authentication with multi-role dashboards for Admins, Donors, and Agents. Donors request and track donations, Admins manage requests and assign agents, and Agents handle collections with real-time updates.

Awesome Lists containing this project

README

        

# Food Donation Management System

![image](https://github.com/user-attachments/assets/e50dece6-6011-4522-9d77-d19ed595f183)

## Features

- The system consists of three types of users: admins, donors and agents.
- Admins: They control all the activities and accept/reject donations and select agents.
- Donors: They are the driving users of the application who donate food.
- Agents: They are responsible for collecting food from homes of food donors.
- Each user should have an account.
- Every user also have a dashboard where they can view several things in short summary.
- The application provides signup, login and logout functionalities.

### Donor Features

- Donors make the donation request for food with basic details.
- Donors' donation requests can be accepted or rejected and the status can be easily tracked by them.
- Donors can view their current incomplete donations (if any).
- Donors can also view all their past donations.
- Donors can update their profile.

![image](https://github.com/user-attachments/assets/955b5cbe-8db2-4933-b29d-00386abf9669)

![image](https://github.com/user-attachments/assets/a14800af-7bfa-4bbd-ae1a-c5b7e8ada66d)

![image](https://github.com/user-attachments/assets/8eef492b-79da-4865-82e9-d7b321b85b35)

### Admin Features

- Admins receive all the requests made by donors.
- Admins can accept or reject the donation requests depending upon the details provided by a donor.
- If accepted, admins can assign an agent to a donation for collecting donation from the donor's home.
- Admins can view all the pending donations along with status.
- Admins can view all the donations that they have received.
- Admins can also view all the agents in the application.
- Admins can update their profile.

![image](https://github.com/user-attachments/assets/83b8007f-352c-498e-9f2b-84a8026a083f)

![image](https://github.com/user-attachments/assets/e4164e30-a1ae-4750-ba5e-979f1c513ba1)

### Agent Features

- Agents will receive notifications from admins to collect food from donor's homes.
- Agents can mark their collection upon collection of food from donor's home.
- Agents can also view all those food donations which have been collected by them previously.
- Agents can update their profile.
![image](https://github.com/user-attachments/assets/a351cec6-6add-4285-9440-7a4b912ee556)
![image](https://github.com/user-attachments/assets/4c0bfc26-1f8d-4c7e-a4ee-42e72c497373)

### Store data in Mongodb
![image](https://github.com/user-attachments/assets/9bc487e8-f6bf-40f0-a1a2-d53a05e51807)

![image](https://github.com/user-attachments/assets/41ad0067-6299-46d1-9d95-46bd22792f4d)

## Technologies used

- HTML
- CSS
- Bootstrap
- Javascript
- Node.js
- Express.js
- Mongodb
- ejs

## npm packages used

- express
- ejs
- express-ejs-layouts
- mongoose
- express-session
- bcryptjs
- passport
- passport-local
- connect-flash
- method-override
- dotenv