RescueBite connects food donors with volunteers to distribute surplus food to high-hunger areas based on an AI priority engine.

• Node.js (for frontend)
• Python 3.8+ (for backend)

1. Open terminal and navigate to the backend folder:

   cd backend

2. Create and activate a virtual environment:

   python -m venv venv
   # Windows:
   .\venv\Scripts\activate
   # Mac/Linux:
   source venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Run the FastAPI server:

   uvicorn main:app --reload

   The backend runs on http://localhost:8000. You can view the API docs at http://localhost:8000/docs.

1. Open a new terminal and navigate to the frontend folder:

   cd frontend

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

   The frontend usually runs on http://localhost:5173. Open this URL in your browser.

• Donor Module (React): Form to submit food type, quantity, and expiry.
• AI Priority Engine (Python): Ranks donations based on expiry time and local hunger levels. Priority score logic in ai_engine.py.
• Volunteer Dashboard (React + Leaflet): Displays AI-prioritized tasks on an interactive map. Allows volunteers to accept tasks.
• Live Heatmap (React + Leaflet + AI Data): Shows Red (High), Yellow (Medium), and Green (Low) hunger zones using dummy data populated on backend startup.

Uses SQLite (rescuebite.db) with SQLAlchemy. Auto-creates tables (Donations, Volunteers, HeatmapZones) when the FastAPI app starts.

• POST /donations Submit new food
• GET /donations Get all donations
• GET /donations/nearby Get AI-prioritized pending tasks
• POST /accept-task Accept a donation task
• GET /heatmap-data Get heatmap zones