South African education management platform for teachers
# EduPlan SA
> South African Education Management Platform — Built for teachers, by teachers.
## 🎓 What is EduPlan SA?
EduPlan SA is a free, all-in-one web application designed specifically for **South African educators**. It helps teachers manage every aspect of their classroom life, from lesson planning to attendance tracking, all aligned with the **CAPS curriculum**.
---
## ✨ Features
| Feature | Description |
|---------|-------------|
| **🤖 AI Lesson Plans** | Generate complete CAPS-aligned lesson plans in seconds. Just enter grade, subject, and topic |
| **📊 Marks & Reports** | Record CASS tasks, exams, PAT projects. Calculate averages and export CSV reports |
| **📅 Attendance** | One-click daily attendance. Present, Absent, or Late. Save by class and date |
| **👨🎓 Student Management** | Full student rosters with filtering, search, and class assignment |
| **📚 Study Guides** | Generate CAPS-aligned study guides for exam prep with DBE references |
| **⭐ Student Rewards** | Give digital badges for Academic Excellence, Perfect Attendance, Leadership, etc. |
| **📋 Class Schedule** | Weekly timetable with SA subjects, grades, and time slots |
| **💬 Educator Chat** | Connect with fellow teachers by grade and subject |
| **🔐 Secure Login** | JWT-based authentication with protected routes |
---
## 🏗️ Architecture
```
edupulsa/
├── landing/ # Marketing website (this is what users see first)
│ └── index.html # Beautiful landing page with features & CTA
├── frontend/ # React SPA (the app itself)
│ ├── src/
│ │ ├── pages/ # Dashboard, Classes, Marks, etc.
│ │ ├── components/ # Sidebar, Modal, Layout
│ │ ├── hooks/ # Data fetching hooks
│ │ ├── lib/ # SA constants (subjects, grades, provinces)
│ │ └── context/ # Auth context
│ └── dist/ # Production build
├── backend/ # Express API server
│ ├── server.js # Entry point
│ ├── auth.js …