musaamano/Ethio_Mathric-

This the ethiopian entrance practice website # Ethio Matric Academy > **Master the Matric Exam, Shape Your Future.** Ethiopia's #1 preparation platform for Grade 12 National Matric Examination students. --- ## Tech Stack | Layer | Technology | |------------|-------------------------------------------------| | Frontend | React 18, Vite, Tailwind CSS, Chart.js | | Backend | Node.js, Express.js | | Database | MySQL 8 | | Auth | JWT + Refresh Tokens + bcrypt | | Storage | Local filesystem (Cloudinary-ready) | | Payment | Chapa / Telebirr / SantimPay | --- ## Features - ✅ **10,000+ Practice Questions** — All Grade 12 subjects, both streams - ✅ **Detailed Explanations** — Why correct, why wrong, memory tricks, common mistakes - ✅ **Real Mock Exams** — Countdown timer, auto-submit, instant results - ✅ **Daily Quiz** — 10 questions every day to build consistency - ✅ **Progress Analytics** — Charts, subject breakdown, weekly/monthly trends - ✅ **Leaderboard** — Daily, weekly, monthly, all-time national rankings - ✅ **Study Notes** — Chapter notes, formulas, key points, definitions - ✅ **Bookmarks** — Save difficult questions for later - ✅ **Secure Auth** — JWT, one session per account, device tracking - ✅ **Admin Panel** — Full CMS for content, users, payments, reports --- ## Quick Start ```bash # 1. Setup database mysql -u root -p < database/schema.sql # 2. Backend cd backend && cp .env.example .env # Edit .env with your DB credentials and JWT secrets npm install && npm run dev # 3. Frontend (new terminal) cd frontend && cp .env.example .env npm install && npm run dev ``` See INSTALLATION.md for full setup guide. --- ## Project Structure ``` ethio-matric-academy/ ├── backend/ │ ├── src/ │ │ ├── config/ # DB connection, JWT config │ │ ├── controllers/ # Request handlers │ │ ├── middleware/ …