# 🎯 Project Spec: Campus Food Rescue

## Overview
Connect cafeteria food that would be wasted to students in need. Real-time matching between cafeteria surplus and hungry students.

**Target Users**: Students in need, school cafeteria
**Impact Goal**: 100+ meals saved
**Build Time**: 4-6 weeks

---

## Impact First

### Problem
- Cafeteria throws away food daily
- Students face food insecurity
- No connection between the two

### Impact
- **Meals Saved**: 100+ meals
- **Food Waste Reduced**: Measurable
- **Community**: Real social impact

### Leadership
- Social impact through code
- Partner with school admin
- Real-world implementation

---

## Features

### MVP
1. **Cafeteria Dashboard**: Log surplus food
2. **Student App**: Request food pickup
3. **Match**: Real-time notifications
4. **Pickup**: QR code or code-based pickup
5. **Analytics**: Meals saved, waste reduced

### Version 2
1. **Scheduled Pickup**: Recurring needs
2. **Donation Integration**: Local restaurants
3. **Map**: Pickup locations

---

## Technical Stack

| Component | Technology |
|-----------|------------|
| Frontend | React + Vercel |
| Backend | Firebase |
| Database | Firestore |
| Notifications | Firebase Cloud Messaging |

---

## Implementation

### Week 1-2: Partner Setup
- [ ] Meet with cafeteria manager
- [ ] Get admin approval
- [ ] Define surplus process

### Week 3-4: App Development
- [ ] Build student app
- [ ] Build cafeteria dashboard
- [ ] Test with pilot

### Week 5-6: Launch
- [ ] Soft launch to 50 students
- [ ] Gather feedback
- [ ] Scale

---

## Metrics

| Metric | Target |
|--------|--------|
| Meals Saved | 100+ |
| Active Students | 50+ |
| Weeks Running | 12+ |

---

## Demo

### Essay Angle
- "I learned about food insecurity from a friend"
- "Instead of just feeling bad, I built something"
- "It took 3 months to get approval, 2 weeks to build"
- "Now 100+ meals don't go to waste"
- "This is why I want to study CS — to solve real problems"

---

*Spec completed: 2026-04-28*
*Generated by Hermes Babu*