pitso4u/SmartExam-SA

SmartExam SA is an end-to-end ecosystem that helps South African teachers plan, generate, and manage assessment papers aligned with the CAPS curriculum. It consists of a production-ready Android application and a centralized Next.js Admin Portal for marketplace management. # SmartExam SA SmartExam SA is an end-to-end ecosystem that helps South African teachers plan, generate, and manage assessment papers aligned with the CAPS curriculum. It consists of a production-ready Android application and a centralized Next.js Admin Portal for marketplace management. ## 🚀 Current Status: **Production Ready - Free Mode** ✅ **Firebase Integration Complete** - Real-time sync, authentication, and comprehensive testing suite ✅ **Free Access Mode** - All features 100% free until 100+ user adoptions, then subscription model activates ✅ **Cinematic Splash Screen** - Android 12+ SplashScreen API with professional branding ✅ **Monetization Infrastructure Ready** - Paystack subscription system prepared for future activation ✅ **Offline-First Architecture** - Room database with Firestore sync bridge ✅ **CAPS-Aligned Content System** - Complete question authoring and assessment generation ## Table of Contents 1. Features 2. Architecture 3. Tech Stack 4. Project Structure 5. Local Development 6. Running the App 7. Sample Data & Sync 8. Building PDFs 9. Data Model 10. Testing 11. Contribution Guide 12. Troubleshooting 13. Roadmap Ideas 14. License ## Features - **Dashboard overview** with question, paper, and subject counts plus quick links to key flows. - **Question authoring** with support for multiple question types, difficulty levels, rich metadata (CAPS aligned), and optional image attachments. - **Paystack Subscription System** - Individual teacher subscriptions (R50/month, R500/year) with Firebase Functions integration and real-time status checks (activates after 100+ user adoptions). - **Marketplace Integration** - Browse and purchase premium question packs with Paystack checkout and automatic Firestore sync. - **Admin Management Portal** for creating, validating, and publishing curriculum-compliant content to the marketplace. - **Question bank** that filters by subject, grade, or search query to reuse questions efficiently. - **Assessment generato …