🍱 Food Waste Management System

A modern full-stack web platform designed to reduce food wastage by connecting Donors, NGOs, Volunteers, and Admins through a centralized food distribution ecosystem.

---

🚀 Project Overview

The Food Waste Management System enables efficient management of:

• 🍲 Food Donations
• 📦 NGO Food Requests
• 🚚 Volunteer Distribution Tracking
• 👥 Role-Based User Management
• ⭐ Feedback & Ratings
• 📊 Dashboard Analytics

The platform helps reduce food wastage while improving food accessibility for communities in need.

---

🛠️ Tech Stack

Frontend

• React.js
• Tailwind CSS
• React Router DOM
• Axios
• Lucide React Icons

Backend

• Spring Boot
• Spring Security
• JWT Authentication
• Spring Data JPA
• REST APIs
• Hibernate
• Maven

Database

• PostgreSQL

API Testing

• Postman
• Swagger UI

---

✨ Core Features

🔐 Authentication & Authorization

• User Registration & Login
• JWT-Based Authentication
• Secure Password Encryption
• Role-Based Access Control

Roles

• 👨‍💼 Admin
• 🍱 Donor
• 🚚 Volunteer
• 🏢 NGO

---

🍲 Food Donation Module

• Add Food Donations
• Update Donation Details
• Track Donation Status
• Donation History
• Expiry Tracking

---

📦 Food Request Module

• NGOs can create food requests
• Request urgency levels
• Request tracking
• Admin monitoring

---

🚚 Distribution Management

• Assign volunteers to deliveries
• Track delivery progress
• Update delivery status
• Distribution history

---

⭐ Feedback System

• Submit feedback & ratings
• User reviews
• Admin feedback monitoring

---

📊 Dashboard Analytics

Each role has a dedicated dashboard with live statistics:

Admin Dashboard

• Total Users
• Total Donations
• Total Requests
• Total Distributions
• Total Feedback

Donor Dashboard

• Active Donations
• Meals Saved
• Donation History

NGO Dashboard

• Nearby Donations
• Request Tracking
• Approved Requests

Volunteer Dashboard

• Assigned Deliveries
• Completed Deliveries
• Delivery Updates

---

🧱 System Architecture

React Frontend
       ↓
Axios API Calls
       ↓
Spring Boot REST API
       ↓
Service Layer
       ↓
Repository Layer
       ↓
PostgreSQL Database

---

🔗 REST API Modules

Authentication

POST /api/auth/register
POST /api/auth/login

Donations

GET    /api/donations
POST   /api/donations
PUT    /api/donations/{id}
DELETE /api/donations/{id}

Requests

GET    /api/requests
POST   /api/requests
PUT    /api/requests/{id}
DELETE /api/requests/{id}

Distributions

GET    /api/distributions
POST   /api/distributions
PUT    /api/distributions/{id}
DELETE /api/distributions/{id}

Feedback

GET    /api/feedbacks
POST   /api/feedbacks
DELETE /api/feedbacks/{id}

---

🧪 API Testing

APIs tested using:

• Postman
• Swagger UI

Swagger URL

http://localhost:8080/swagger-ui/index.html

---

⚙️ Installation Guide

1️⃣ Clone Repository

git clone https://github.com/Abhi-T-A/Food-Waste-Management-System.git

---

2️⃣ Frontend Setup

cd frontend
npm install
npm run dev

Frontend runs on:

http://localhost:5173

---

3️⃣ Backend Setup

cd backend
mvn spring-boot:run

Backend runs on:

http://localhost:8080

---

🗄️ Database Configuration

Configure PostgreSQL in:

backend/src/main/resources/application.properties

Example:

spring.datasource.url=jdbc:postgresql://localhost:5432/foodwaste
spring.datasource.username=postgres
spring.datasource.password=yourpassword

---

📸 Application Screens

• Login & Signup
• Admin Dashboard
• Donor Dashboard
• NGO Dashboard
• Volunteer Dashboard
• Food Donations
• Food Requests
• Distribution Tracking
• Feedback System

---

📚 Concepts Used

• REST APIs
• CRUD Operations
• React Components
• Context API
• Protected Routes
• JWT Authentication
• Spring Security
• JPA/Hibernate
• PostgreSQL Relationships
• Dashboard Analytics

---

🔮 Future Enhancements

• 📱 Mobile Application
• ☁️ Cloud Deployment
• 📧 Email Notifications
• 📍 Real-Time Tracking
• 🤖 AI-Based Analytics
• 📊 Advanced Reports
• 🔔 Push Notifications

---

👨‍💻 Developed By

Abhi T A

Full Stack Developer Project

---

⭐ Support

If you like this project, consider giving it a ⭐ on GitHub.