# 🎯 Project Spec: CodeTeacheR — Peer Tutoring Platform

## Overview
An Airbnb-style matching platform connecting high school students who need help with AP Computer Science to peer tutors who aced it. Tutors earn community service hours; students get help from peers who "get it."

**Target Users**: High school students taking AP CS, IB CS, or intro coding
**Impact Goal**: 100+ tutoring sessions in first semester
**Time to Build**: 2-3 weeks MVP

---

## Impact First — Why This Matters

### The Problem
- School tutors are overwhelmed and can't help everyone
- Professional tutoring is expensive ($50+/hour)
- Students feel embarrassed asking "dumb questions" to teachers
- Peers who aced CS WANT to help but no platform exists

### The Impact
- **Tutoring Sessions**: 100+ sessions in first semester
- **Community Service**: Tutors earn hours for service
- **Grades**: Measure improvement in tutee grades
- **Network**: Students connect with CS peers

### Leadership Angle
- This is PURE LEADERSHIP — organizing a community
- You're not just coding, you're managing a network
- Requires vetting, quality control, conflict resolution

---

## Technical Stack

### MVP (Weeks 1-2)
| Component | Technology | Cost |
|-----------|------------|------|
| Frontend | Google Sites or simple React | $0 |
| Backend | Google Sheets (MVP) | $0 |
| Matching | Simple form + email | $0 |
| Storage | Google Drive | $0 |

### Full Version (Weeks 3-4)
| Component | Technology | Cost |
|-----------|------------|------|
| Frontend | React + Firebase | $0 |
| Auth | Firebase Auth | $0 |
| Database | Firestore | $0 |
| Scheduling | Google Calendar API | $0 |

---

## Core Features (MVP)

### Must Have
1. **Tutor Signup**: Form with name, subjects, availability, grade
2. **Student Request**: Form with subject, topic, preferred time
3. **Matching**: Manual or semi-automated matching
4. **Session Tracking**: Log sessions with topics covered
5. **Reviews**: Tutee feedback on tutors
6. **Hours Logging**: For community service verification

### Nice to Have
1. **Video Integration**: Zoom/Google Meet links
2. **Automated Matching**: Algorithm based on topic + availability
3. **Progress Tracking**: Before/after grades
4. **Leaderboard**: Top tutors

---

## User Flow

```
STUDENT:
1. Visit site, fill request form (subject, topic, availability)
2. Receive email with tutor match + contact
3. Schedule session
4. Complete session
5. Leave review

TUTOR:
1. Sign up with subjects + availability
2. Receive request email
3. Accept/decline
4. Complete session
5. Log hours + receive review
```

---

## Matching Logic (MVP)

### Manual Process (Week 1)
1. Student submits request → stored in Google Sheet
2. Admin (you) reviews daily
3. Manual email to matched tutor
4. Tutor accepts → email to student

### Semi-Auto (Week 2+)
- Algorithm matches: Subject → Tutor Subject AND Availability overlaps
- Email both parties
- Either can decline

---

## Implementation Plan

### Week 1: Basic Setup
- [ ] Create Google Form for tutor signup
- [ ] Create Google Form for student requests
- [ ] Set up Google Sheet for matching
- [ ] Create simple landing page (Google Sites)
- [ ] Test with 5 tutors, 5 students

### Week 2: Matching & Tracking
- [ ] Daily matching process
- [ ] Session logging system
- [ ] Review collection
- [ ] Community service hour tracking

### Week 3: Expansion
- [ ] Automate matching emails
- [ ] Grow tutor network (10→20)
- [ ] Get school counselor approval

### Week 4: Metrics
- [ ] Track session count
- [ ] Collect testimonials
- [ ] Document impact

---

## Metrics to Track

| Metric | Target | How |
|--------|--------|-----|
| Tutoring Sessions | 100+ | Session log |
| Active Tutors | 20+ | Signup sheet |
| Student Satisfaction | 4.5/5 | Reviews |
| Tutor Hours Logged | 500+ | Hours tracker |

---

## How to Demo

### Video (2-3 min)
1. Show the problem (students struggling, no peer help)
2. Show the solution (matching platform)
3. Show the network (20 tutors, 100 sessions)
4. Show testimonials
5. Show metrics

### Essay Angle
- "I saw my classmates struggling and wanted to help"
- "Instead of tutoring myself, I built a platform to scale help"
- "Now 50 students help each other, not just me"
- "Leadership isn't always being the leader — it's enabling leaders"

---

## Extension Ideas

1. **School Network**: Expand to district-wide
2. **Subject Expansion**: Add math, physics, chemistry
3. **Virtual Sessions**: Video integration
4. **AI Assistant**: Draft responses, not replace humans

---

*Spec completed: 2026-04-28*

*Generated by Hermes Babu*