A full-stack MERN web application to manage, track, and analyze students' Codeforces performance. Designed for institutions to monitor student progress, send inactivity reminders, and view detailed analytics for contests and problem-solving history.
YouTube Demo Video: Video Link
A central dashboard listing all enrolled students, including:
- Name, Email, Phone Number, Codeforces Handle
- Current Rating and Max Rating
- Last Synced Time
- Reminders Sent Count
- Toggle for enabling/disabling email reminders
- Add, Edit, and Delete students
- Search by name
- Export the entire dataset as a CSV
- View individual student profiles
Each student profile includes two detailed sections:
- Filters: Last 30, 90, or 365 days
- Line chart showing rating changes
- Contest list showing:
- Contest Name
- Rank
- Rating Change
- Number of unsolved problems
- Filters: Last 7, 30, or 90 days
- Most difficult problem solved
- Total problems solved
- Average problem rating
- Average problems per day
- Bar chart showing problems solved per rating bucket
- Submission heatmap (activity calendar)
- Automatic data sync at 2 AM daily (customizable via cron)
- No real-time API calls during user hours
- Immediate sync on handle update
- Students with no recent accepted submissions (past 7 days) receive automatic email reminders
- Reminders are tracked per student
- Email reminders can be disabled per student
- Dark/Light Mode Toggle
- Responsive UI (mobile and tablet friendly)
- Clean and well-documented codebase
| Layer | Technologies |
|---|---|
| Frontend | React, Tailwind CSS |
| Backend | Node.js, Express.js |
| Database | MongoDB |
| Other | Axios, Chart.js, node-cron, nodemailer, json2csv |
Clone the repository
git clone https://github.com/yourusername/student-progress-system.git
cd student-progress-system
Set environment variables
Create a .env file inside the Backend directory:
PORT=5000
MONGO_URI=mongodb:
EMAIL_USER=
EMAIL_PASS=
Install dependencies and run the servers
Backend:
cd Backend
npm install
npm run dev
Frontend:
cd ../Frontend
npm install
npm run dev
Access the application Visit http://localhost:5173 in your browser
GET /api/students - Fetch all students
POST /api/students - Add a new student
PUT /api/students/:id - Edit student or toggle reminders
DELETE /api/students/:id - Delete student
GET /api/export - Download all student data as CSV
GET /api/contests/:studentId - Contest history for a student
GET /api/problems/:studentId - Problem-solving data for a student
- GET /api/cron-config - Get current cron configuration
- POST /api/cron-config - Update cron time and frequency or TimeZone
- GitHub Repository: https://github.com/Hritabhash1/CodeTrack
- YouTube Demo Video: Video Link
- Drive Video Link : Click the Link
The system avoids real-time API calls during daytime to reduce API load
Each student's Codeforces data is stored in the database to allow efficient access
Reminders are only sent to students who have email reminders enabled