fawwerty/LessonGen-Ghana

The Ultimate SaaS Platform for NaCCA-Compliant Lesson Planning. LessonGen Ghana is a professional-grade SaaS tool designed to empower Ghanaian teachers. By leveraging advanced RAG and the Gemini 2.5 AI engine, it transforms raw NaCCA Standards-Based and Common Core (CCP) curriculum data into print-ready, high-pedagogy lesson notes in seconds. # 📚 LessonGen Ghana — Complete Platform > AI-powered NaCCA-aligned lesson planning for Ghanaian teachers. > **Now with Timetable-Awareness, Sequence Progression, and Teacher Controls.** > React Web App · Node.js Backend · React Native Mobile App · AI Training Pipeline --- ## Table of Contents 1. Project Structure 2. Quick Start — Backend 3. Quick Start — Frontend 4. Quick Start — Mobile 5. Environment Variables 6. Curriculum Upload Folders 7. Fine-Tuning the AI — Complete Guide 8. Payment Integration 9. Deploying to Production 10. Docker Deployment ## ✨ Phase 2: Professional SaaS Upgrades (Latest) This platform was recently upgraded with market-leading pedagogical intelligence: - **📅 Timetable Intelligence**: Upload/Capture your timetable images, and the AI automatically maps your teaching days and periods. - **⛓️ Sequence Awareness**: Lessons now build logically week-over-week. Week 2 recap automatically connects to Week 1 objectives. - **✏️ Teacher Control**: - **Inline Editor**: Change any text in the preview before exporting. - **Section Refresh**: Regenerate just the "Main Content" or "Starter" if you want different activities. - **📊 Difficulty Levels**: Choice of **Basic**, **Standard**, or **Advanced** content to match student performance. - **🎁 First-Free Hook**: Every user's first generation is completely free to showcase value. --- ## 1. Project Structure ``` lessongen-ghana/ │ ├── backend/ Node.js / Express API server │ ├── src/ │ │ ├── server.js Entry point │ │ ├── routes/ auth, lessons, exports, payments, curriculum, admin │ │ ├── models/ User.js, Lesson.js (MongoDB schemas) │ │ ├── middleware/ auth.js (JWT protection) │ │ └── services/ │ │ ├── aiService.js AI generation engine + variation system │ │ └── docxService.js DOCX export (matches Mickinet format) │ ├── package.json │ ├── .env.example Copy to .env and fill …