Frazer99/smartclass-zambia

# SmartClass Zambia -- v0.2 (this build) Your AI Teacher, Anytime, Anywhere. Built by ZedCode Technologies. This build implements the platform requested on top of the SRS: an AI teacher (Lesson section) and an interactive Past Paper section, content driven entirely by admin-uploaded syllabus/materials/past papers, Form 2-6 subject coverage, a 10-minute free trial per subject, and K50/subject/month subscriptions via MTN Money, Airtel Money and Visa. ## What's implemented - **Auth**: register/login (JWT), student + admin roles, Form 2-6 selection. - **Admin content pipeline**: upload a syllabus document (.pdf/.docx/.txt) -> the system parses it and auto-creates the topic list for that subject/Form; upload approved textbooks/pamphlets/notes, which feed the AI teacher's retrieval-augmented answers; create past papers with a question-by-question breakdown (text, marks, marking scheme). - **Subjects by Form**: Form 2-3 = Mathematics + Science; Form 4-6 = Mathematics + Physics + Chemistry (configurable in the DB, not hardcoded). - **Lesson section**: pick a topic, the SmartTeach(TM) engine greets the learner, explains step by step (grounded in uploaded material via TF-IDF retrieval), asks a comprehension check, waits for the answer, detects hesitation/wrong answers and re-explains from another angle (up to 3 attempts), then assigns practice and summarizes. Every teacher turn also produces smart-whiteboard content. - **Past Paper section**: pick a past paper (whole paper or specific question(s)), the AI teacher walks through each selected question step by step (grounded in the marking scheme/answer guide when provided), answers learner follow-up "why" questions, and moves to the next question on request. - **Free trial + subscriptions**: every interactive AI-teacher turn reports elapsed time; the first 10 minutes per subject are free, then the API returns 402 Payment Required and the frontend shows a paywall modal. Subscribing (K50/subject/month) via MTN Mobile Money, A …