🧠 College Aptitude Test Platform

A full-stack web application designed to help college students practice and evaluate their logical and aptitude skills.
This project enables admins to create aptitude tests and students to attempt them online, view results, and track performance through a leaderboard.
Students also receive email notifications before each scheduled test to ensure active participation.

---

🚀 Features

👨‍🎓 For Students

• Sign Up & Login – Secure authentication system for student access.
• Attempt Aptitude Tests – Take part in upcoming or available tests directly from the dashboard.
• View Results – Instantly view your score and performance summary after test submission.
• Leaderboard – Check your ranking among other students based on test performance.
• Email Notifications – Get automatic reminders via email the night before a scheduled test.

🧑‍💼 For Admins

• Create & Manage Tests – Add, edit, or delete aptitude tests with questions, options, and correct answers.
• View Submissions – Track all student submissions and performance reports.
• Automated Notifications – The system automatically sends email alerts to all registered students before test day.

---

🏗️ Tech Stack

Category	Technology
Frontend	React.js, Tailwind CSS, ShadCN UI
Backend	Node.js, Express.js
Database	MongoDB
Authentication	JWT-based Auth with Refresh Tokens
Email Service	EmailJS
Deployment	Vercel (Frontend) & Render / Railway (Backend)

---

⚙️ Installation & Setup

Prerequisites

• Node.js (v18+)
• MongoDB (local or cloud)
• A .env file with environment variables

Steps

1. Clone the repository

   git clone https://github.com/your-username/college-aptitude-platform.git
   cd college-aptitude-platform
   

2. Install Dependencies

   # Install backend dependencies
   cd Server
   npm install
   
   # Install frontend dependencies
   cd ../Client
   npm install
   

3. Setup environment variables

   Create a .env file in the server directory and include:

   PORT=5000
   MONGO_URI=your_mongodb_connection_string
   JWT_SECRET=your_jwt_secret
   NODE_ENV=development
   EMAIL_USER=your_email@example.com
   EMAIL_PASS=your_email_password_or_app_password
   

4. Run the development servers

   # Run backend
   cd server
   npm run dev
   
   # Run frontend
   cd ../client
   npm run dev

   🧮 Core Functionalities

   Feature	Description
   Test Creation	Admins can add aptitude questions and assign test dates.
   Test Attempt	Students can answer MCQs and submit responses.
   Leaderboard	Shows rankings based on performance and accuracy.
   Email Reminder	Sends automated reminder emails to all students one night before the test.
   Secure Auth	JWT + Refresh Tokens for protected routes.

   🧑‍💻 Contributors

   Subhas Mondal – Project Lead & Full Stack Developer || Upcoming Intern at QuantumHash Corporation

   Sumit Prasad Gupta – Full Stack Developer

   Pritam Mohanto - Compititive Programmer || ICPC Regionalist

   📜 License

   This project is developed as part of a college project and is open for educational and non-commercial use.