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 β¦