AD-Group-Africa/elekeza

AI-powered adaptive accessible learning platform # Elekeza – AI-Powered Inclusive Learning Platform **Elekeza** *(meaning "to understand" in Swahili)* is an AI-powered, accessibility-first learning platform designed for the Kenyan CBC curriculum. Built for learners with Special Educational Needs (SNE) and mainstream education. **Status:** Pilot-ready. Institution module, CSV import, teacher dashboards, bulk assignment, parent portal, accessibility suite, and offline PWA all working. --- ## Table of Contents - Features - Tech Stack - Architecture - Quick Start (Local Dev) - Demo Accounts - Environment Variables - Deployment - API Summary - Project Structure - Roadmap - License - Team - Acknowledgments --- ## Features - **AI Content Simplification** – Upload PDF/DOCX/TXT; AI adapts for Dyslexia, ADHD, Autism, Intellectual Disability - **Accessibility-First Design** – 40+ toggles: OpenDyslexic font, TTS, line spacing, focus mode, contrast control - **Role-Based Dashboards** – Teacher (student management, bulk assignment), Student (lessons, progress), Parent (ward progress) - **Adaptive Quiz Engine** – Auto-generates questions, tracks progress per student - **Offline-First PWA** – Installable; lessons + quizzes cached; IndexedDB sync queue for offline answers - **Institution Management** – Register schools, CSV bulk import with automatic guardian linking - **Parent Engagement** – Guardian portal, progress tracking, notification hooks ready for SMS/WhatsApp - **Multi-School Ready** – Institution-scoped teacher views, class/grade grouping - **M‑Pesa Payments** – Payment integration for premium features (infrastructure ready) - **SMS Notifications** – Via Africa's Talking API (integration hooks in place) --- ## Tech Stack | Layer | Technology | |-------|------------| | **Frontend** | Next.js 16, TypeScript, Tailwind CSS, Capacitor, next-pwa | | **Backend** | Spring Boot 3.2, Kotlin, JWT auth (HTTP-only cookies) | | **AI Service** | FastAPI, Groq/OpenAI/Anthropic/Google LLMs | | **Database** | PostgreSQL 16 (pr …