🌱 FoodBridge — Surplus Food Redistribution Platform

Built for Vashisht Hackathon 3.0 — EcoTech Innovation Track

FoodBridge connects surplus food donors with recipients in real-time, using AI-powered safety scoring, smart matching, spoilage prediction, and multi-stop volunteer route batching.

---

Tech Stack

Layer	Tech
Frontend	React 18 + Vite + Tailwind CSS + Zustand
Backend	Node.js + Express + Socket.io + Mongoose
ML Service	Python FastAPI + scikit-learn
Database	MongoDB
Real-time	Socket.io

---

Features

• 🗺️ Live map feed — listings appear in real-time via WebSockets
• 🤖 AI safety scoring — every listing auto-scored 0–100 before going live
• 🟢 Spoilage risk badge — ML classifier predicts low/medium/high spoilage risk
• 🚴 Batch route planner — volunteers plan optimised multi-stop pickup routes
• 📊 Impact dashboard — meals saved, kg rescued, CO₂ prevented
• 🔔 Push notifications — instant alerts when food appears nearby
• 👥 Role-based flows — Donor / Recipient / Volunteer

---

Quick Start (Local)

1. Environment setup

cp .env.example server/.env
# Edit server/.env with your MongoDB URI and JWT secret
# Create client/.env with the VITE_* lines from .env.example

2. ML Service

cd ml
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

3. Server

cd server
npm install
npm run dev

4. Client

cd client
npm install
npm run dev

App → http://localhost:5173

---

Docker Compose

docker-compose up --build

• Client → http://localhost:5173
• Server → http://localhost:5000
• ML → http://localhost:8000

---

Seed Demo Data

curl -X POST http://localhost:5000/api/seed-impact

---

Key API Endpoints

Method	Path	Description
POST	/api/auth/register	Register (donor/recipient/volunteer)
POST	/api/auth/login	Login
GET	/api/listings	Browse food (lat/lng/radius filter)
POST	/api/listings	Post new listing
POST	/api/listings/:id/claim	Claim a listing
POST	/api/route/batch	Plan optimised volunteer route
POST	/api/route/complete-stop	Mark stop as delivered
GET	/api/route/suggestions	Suggest nearby listings to batch
POST	/ml/spoilage-predict	Predict spoilage risk
POST	/ml/match	Smart donor-recipient matching

---

Project Structure

FoodBridge/
├── client/src/
│   ├── pages/        Home, Feed, Dashboard, Volunteer, RouteBatch ...
│   └── components/   Navbar, SpoilageRiskBadge, SafetyBadge ...
├── server/src/
│   ├── models/       FoodListing, User, Review, ImpactStats
│   ├── routes/       auth, listings, users, volunteer, routeBatching
│   └── services/     mlClient, matchingEngine, expiryWatcher ...
├── ml/
│   ├── main.py               FastAPI entrypoint
│   ├── spoilage_predictor.py RandomForest spoilage classifier
│   ├── smart_matching.py     GradientBoosting matching
│   └── nlp_safety.py         NLP safety scorer
└── docker-compose.yml