📘 TrackWise – AI-Powered Task Management & Student Progress Tracking Platform

TrackWise is a comprehensive, role-based learning management and task tracking system designed for educational institutions, bootcamps, and mentorship programs. It enables seamless collaboration between educators and students through intelligent task management, real-time progress tracking, AI-powered tutoring, and interactive communication.

Built on the modern MERN (MongoDB, Express, React, Node.js) stack with JWT authentication and role-based access control, TrackWise provides an intuitive interface for managing educational workflows at scale.

🌟 Key Features

👨‍🏫 Trainer/Educator Features

Comprehensive Dashboard – Centralized hub for managing all students, programs, and tasks
Task Creation & Assignment – Create, assign, and manage tasks with deadlines and difficulty levels
AI-Powered Task Generation – Automatically generate exercises and coding tasks using AI
Real-time Monitoring – Live tracking of student progress, submissions, and performance metrics
Student Analytics – Detailed performance reports, completion rates, and progress visualization
Communication Tools – Direct messaging with students through integrated chat system
Trainer Management – Admin panel to add and manage multiple trainers

👨‍🎓 Student Features

Personal Dashboard – View assigned tasks, deadlines, and progress overview
Task Management – Submit solutions, track task status (pending, in-progress, completed)
Progress Tracking – Visual representation of learning progress and achievements
AI Tutor – Interactive AI-powered tutoring system for concept clarification and problem-solving
Real-time Chat – Direct messaging with trainers for immediate assistance
Program Enrollment – Browse and enroll in available training programs
Performance Analytics – Personal performance metrics and improvement suggestions

🛡️ Admin Features

User Management – Create and manage admin accounts, trainers, and students
Program Management – Create, update, and delete training programs
System Overview – Monitor overall platform usage and performance
Role-Based Access Control – Manage permissions and access levels for all users
Authentication Management – Secure JWT token-based authentication and password reset

🤖 AI-Powered Features

Intelligent Task Generator – Generate contextual programming tasks and exercises
AI Tutoring System – Real-time AI assistant to help students understand concepts
Adaptive Learning – AI suggestions based on student performance and learning patterns

💬 Communication System

Real-time Chat – Instant messaging between trainers and students
Chat Rooms – Topic-based discussion channels
Message Persistence – All conversations stored for future reference
Notification System – Real-time alerts for new messages and task updates

📊 Analytics & Reporting

Progress Charts – Visual representation of student progress over time
Performance Metrics – Completion rates, time spent, and accuracy metrics
Leaderboards – Rank students based on performance and task completion
Export Reports – Generate downloadable progress reports (CSV, PDF)

🛠️ Tech Stack

Frontend

React.js 18.3 – Modern UI library with hooks and functional components
Vite 6.0 – Ultra-fast build tool and development server
Redux Toolkit & React-Redux – State management for complex application state
React Router v6 – Client-side routing and navigation
Tailwind CSS – Utility-first CSS framework for responsive design
Recharts – Data visualization and charting library
React Calendar – Calendar component for date selection
Axios – HTTP client for API communication
React Hot Toast – Toast notifications for user feedback
React Modal – Modal dialog component
Lucide React – Icon library

Backend

Node.js & Express.js – Fast, scalable server framework
MongoDB – NoSQL database for flexible data storage
Mongoose – MongoDB object modeling (ODM)
JWT (jsonwebtoken) – Secure token-based authentication
Bcrypt/Bcryptjs – Password hashing and encryption
CORS – Cross-origin resource sharing middleware
SendGrid – Email service for notifications and password resets
Node-cron – Task scheduling for automated operations
Moment.js – Date and time manipulation
Dotenv – Environment variable management

Development Tools

ESLint – Code quality and style checking
Nodemon – Auto-restart server during development
Vercel – Deployment platform for frontend

🏗️ Architecture

System Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                    Client Layer (React + Vite)              │
│  ┌──────────────────┐  ┌──────────────────┐ ┌────────────┐ │
│  │  Auth Pages      │  │  Dashboards      │ │  Components│ │
│  │  - Login/Signup  │  │  - Admin         │ │  - Chat    │ │
│  │  - Reset Password│  │  - Trainer       │ │  - Tasks   │ │
│  └──────────────────┘  │  - Student       │ │  - Programs│ │
│                         └──────────────────┘ └────────────┘ │
│                         Redux Store (State Management)       │
└──────────────────────────────────────────────────────────────┘
                              ↓↑
                    Axios HTTP Client (REST API)
                              ↓↑
┌──────────────────────────────────────────────────────────────┐
│                   Server Layer (Express.js)                  │
│  ┌──────────────────┐  ┌──────────────────┐ ┌────────────┐  │
│  │  Routes          │  │  Controllers     │ │ Middleware │  │
│  │  - Admin         │  │  - Auth Control  │ │ - JWT Verify│  │
│  │  - Trainer       │  │  - Task Control  │ │ - Role Check│  │
│  │  - Student       │  │  - AI Control    │ │            │  │
│  │  - Chat          │  │  - Chat Control  │ └────────────┘  │
│  │  - AI            │  └──────────────────┘                  │
│  └──────────────────┘                                        │
│        Services (Business Logic)                             │
│  ├─ ChatService      ├─ TaskGenerationService               │
│  ├─ TutorService     └─ LLM Client (AI Integration)         │
└──────────────────────────────────────────────────────────────┘
                              ↓↑
┌──────────────────────────────────────────────────────────────┐
│              Database Layer (MongoDB)                        │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐       │
│  │ Users    │ │ Programs │ │ Tasks    │ │ Messages │       │
│  │ Schemas  │ │ Schemas  │ │ Schemas  │ │ Schemas  │       │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘       │
└──────────────────────────────────────────────────────────────┘

Directory Structure

TrackWise/
├── client/                          # React Frontend
│   ├── src/
│   │   ├── components/             # Reusable UI components
│   │   │   ├── AdminAuthCard/
│   │   │   ├── StudentAuthCard/
│   │   │   ├── TrainerAuthCard/
│   │   │   ├── Header/
│   │   │   ├── Sidebar/
│   │   │   ├── ProgramCard/
│   │   │   ├── ManageProgramCard/
│   │   │   ├── CreateProgram/
│   │   │   ├── ProgramChat/
│   │   │   ├── StudentAITutor/
│   │   │   ├── AddTrainerPanel/
│   │   │   ├── ProfileModal/
│   │   │   ├── Calendar/
│   │   │   ├── Loader/
│   │   │   └── ResetPassword/
│   │   ├── pages/                  # Page components
│   │   │   ├── AuthPage/          # Login/Registration
│   │   │   ├── Dashboard/         # Admin Dashboard
│   │   │   ├── TrainerDashboard/
│   │   │   ├── StudentDashboard/
│   │   │   ├── Programs/
│   │   │   └── Trainers/
│   │   ├── redux/                  # State management
│   │   │   ├── store.js
│   │   │   ├── actions/           # Redux actions
│   │   │   └── reducers/          # Redux reducers
│   │   ├── services/               # API communication
│   │   │   ├── AdminOperations.js
│   │   │   ├── StudentOperations.js
│   │   │   ├── TrainerOperations.js
│   │   │   ├── ChatOperations.js
│   │   │   ├── AIOperations.js
│   │   │   └── TokenOperations.js
│   │   ├── hooks/                  # Custom React hooks
│   │   │   ├── useChatApi.js
│   │   │   └── useToast.jsx
│   │   ├── assets/                 # Static assets
│   │   │   ├── icons/
│   │   │   └── illustrations/
│   │   ├── App.jsx
│   │   ├── main.jsx
│   │   ├── App.css
│   │   └── index.css
│   ├── package.json
│   ├── vite.config.js
│   ├── eslint.config.js
│   └── index.html
│
├── server/                          # Node.js Backend
│   ├── controllers/                 # Route controllers
│   │   ├── adminController.js
│   │   ├── studentController.js
│   │   ├── trainerController.js
│   │   ├── aiController.js
│   │   ├── chatController.js
│   │   └── index.js
│   ├── routes/                      # API routes
│   │   ├── adminRoutes.js
│   │   ├── studentRoutes.js
│   │   ├── trainerRoutes.js
│   │   ├── aiRoutes.js
│   │   ├── chatRoutes.js
│   │   └── tokenRoutes.js
│   ├── models/                      # MongoDB schemas
│   │   ├── adminSchema.js
│   │   ├── studentSchema.js
│   │   ├── trainerSchema.js
│   │   ├── programSchema.js
│   │   ├── AITask.js
│   │   ├── AITutorContext.js
│   │   ├── chatMessage.js
│   │   ├── chatRoom.js
│   │   └── counterSchema.js
│   ├── services/                    # Business logic
│   │   └── chatService.js
│   ├── aiServices/                  # AI-related services
│   │   ├── llmClient.js            # LLM integration
│   │   ├── taskGenerationService.js # Task AI generation
│   │   └── tutorService.js         # Tutor AI logic
│   ├── middleware/                  # Express middleware
│   │   ├── roleMiddleware.js       # Role-based access
│   │   └── verifyTokenMiddleWare.js # JWT verification
│   ├── config/                      # Configuration
│   │   └── db.js                   # MongoDB connection
│   ├── utils/                       # Utility functions
│   │   └── jwt.js                  # JWT operations
│   ├── scripts/                     # Setup scripts
│   │   └── createDefaultAdmin.js   # Initialize admin account
│   ├── index.js                     # Server entry point
│   └── package.json
│
└── README.md                        # This file

⚙️ Installation & Setup

Prerequisites

Node.js (v16 or higher)
npm or yarn package manager
MongoDB (local or cloud instance like MongoDB Atlas)
Git for version control

Step 1: Clone the Repository

git clone https://github.com/yourusername/trackwise.git
cd trackwise

Step 2: Backend Setup

cd server

# Install dependencies
npm install

# Create .env file
echo > .env

Configure your .env file:

MONGODB_URI=mongodb://localhost:27017/trackwise
# or for MongoDB Atlas:
# MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/trackwise

JWT_SECRET=your_super_secret_jwt_key_here_make_it_strong
SENDGRID_API_KEY=your_sendgrid_api_key
SENDGRID_FROM_EMAIL=noreply@trackwise.com
NODE_ENV=development
PORT=7000

Start the backend server:

npm start
# or for development with auto-reload:
npx nodemon index.js

The server should run on http://localhost:7000

Step 3: Frontend Setup

cd ../client

# Install dependencies
npm install

# Create .env file
echo > .env.local

Configure your .env.local file:

VITE_API_BASE_URL=http://localhost:7000
VITE_APP_NAME=TrackWise

Start the development server:

npm run dev

The frontend should run on http://localhost:5173

Step 4: Initialize Admin Account

cd server
node scripts/createDefaultAdmin.js

This will create a default admin account with credentials:

Email: admin@trackwise.com
Password: (check console output)

Step 5: Verify Installation

Open http://localhost:5173 in your browser
Login with admin credentials
Navigate through different dashboards to verify setup

🔌 API Endpoints

Authentication Routes `/api/token`

POST /register – Register new user (admin/trainer/student)
POST /login – User login with email and password
POST /refresh – Refresh JWT token
POST /verify – Verify token validity
POST /reset-password – Request password reset
POST /reset-password/:token – Confirm password reset

Admin Routes `/api/admin`

GET /dashboard – Get admin dashboard data
GET /trainers – List all trainers
POST /trainers – Add new trainer
DELETE /trainers/:id – Remove trainer
GET /students – List all students
GET /programs – List all programs
POST /programs – Create new program
PUT /programs/:id – Update program
DELETE /programs/:id – Delete program

Trainer Routes `/api/trainer`

GET /dashboard – Get trainer dashboard with assigned students
GET /students – List assigned students
POST /tasks – Create task for student
PUT /tasks/:id – Update task status/details
GET /tasks – Get all created tasks
DELETE /tasks/:id – Delete task
GET /programs – List available programs
POST /programs – Create new program
GET /students/:id/progress – Get student progress analytics

Student Routes `/api/student`

GET /dashboard – Get student dashboard
GET /tasks – List assigned tasks
PUT /tasks/:id – Submit task solution
GET /programs – Browse available programs
POST /programs/:id/enroll – Enroll in program
GET /progress – Get personal progress analytics
GET /profile – Get student profile

AI Routes `/api/ai`

POST /generate-task – Generate task using AI
POST /tutor – Get AI tutoring response
POST /task-solution-feedback – Get AI feedback on solution

Chat Routes `/api/chat`

GET /conversations – Get all conversations
POST /conversations – Start new conversation
GET /conversations/:id/messages – Get conversation messages
POST /conversations/:id/messages – Send message
PUT /messages/:id – Edit message
DELETE /messages/:id – Delete message

⚙️ Configuration

Environment Variables

Backend (.env)

MONGODB_URI          # MongoDB connection string
JWT_SECRET           # Secret key for JWT signing
NODE_ENV             # development/production
PORT                 # Server port (default: 7000)
SENDGRID_API_KEY     # SendGrid email API key
SENDGRID_FROM_EMAIL  # Sender email address

Frontend (.env.local)

VITE_API_BASE_URL    # Backend API base URL
VITE_APP_NAME        # Application name

Database Configuration

MongoDB schemas are automatically created when the server starts. Initial schemas include:

User Models: Admin, Trainer, Student
Program Models: Program, AITask, AITutorContext
Communication Models: ChatRoom, ChatMessage
Utility Models: Counter (for auto-incrementing IDs)

📖 Usage Guide

For Admins

Login with admin credentials
Dashboard Overview – See system statistics and user counts
Manage Trainers – Add, edit, or remove trainers
Create Programs – Define training programs with details
Monitor Progress – Track overall system activity

For Trainers

View Dashboard – See assigned students and programs
Create Tasks – Generate or manually create assignments
Use AI Generator – Let AI create contextual tasks
Monitor Students – Track individual progress
Communicate – Chat directly with students
Generate Reports – Export student performance data

For Students

View Dashboard – See assigned tasks and programs
Complete Tasks – Submit solutions with code
Chat with Trainer – Ask questions in real-time
Use AI Tutor – Get help understanding concepts
Track Progress – Monitor your achievements and improvements
Enroll Programs – Join new training programs

🌐 Use Cases

🏫 Educational Institutions

Monitor student coding and practical work progress
Assign homework and projects efficiently
Track attendance and engagement metrics
Generate performance reports for parents/stakeholders

🧑‍🏫 Mentorship & Coaching Programs

Assign weekly learning tasks to mentees
Visualize learning patterns and growth
Provide personalized feedback and guidance
One-on-one communication with mentees

💼 Bootcamps & Online Courses

Manage cohorts of students
Track course completion rates
Generate certificates and completion reports
Provide AI-powered tutoring support

👥 Coding Clubs & Hackathon Teams

Transparent task assignment and tracking
Leaderboard-based performance gamification
Real-time collaboration and communication
Project milestone tracking

🤖 Skill Development Programs

Adaptive learning paths with AI suggestions
Automated task generation based on difficulty levels
Performance-based progress tracking
Personalized learning recommendations

🚀 Deployment

Frontend Deployment (Vercel)

cd client
npm run build
vercel

Backend Deployment (Heroku/Railway/Render)

cd server
# Push to your hosting provider
git push heroku main

MongoDB Setup (MongoDB Atlas)

Create account at mongodb.com/cloud/atlas
Create cluster and database
Get connection string
Update MONGODB_URI in .env

🧪 Testing & Quality

# Frontend linting
cd client
npm run lint

# Backend testing (setup required)
cd server
npm test

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit changes (git commit -m 'Add AmazingFeature')
Push to branch (git push origin feature/AmazingFeature)
Open a Pull Request

Code Standards

Use meaningful variable and function names
Follow consistent indentation (2 spaces)
Add comments for complex logic
Keep commits focused and descriptive

📄 License

This project is licensed under the ISC License - see the LICENSE file for details.

🆘 Support & Documentation

Issues: Report bugs on GitHub Issues
Discussions: Use GitHub Discussions for questions
Documentation: See /docs directory for detailed guides
Email: support@trackwise.com

🎯 Roadmap

Mobile app (React Native)
Video integration for recorded lessons
Advanced analytics dashboard
Integration with GitHub for code submission
Automated code review with AI
Peer-to-peer learning features
Gamification (badges, points, achievements)
Multi-language support

👥 Team & Credits

Developed with ❤️ for educators and learners worldwide

Special thanks to:

OpenAI for AI integration capabilities
MongoDB Atlas for database hosting
The React and Node.js communities

Last Updated: February 2026

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
TrackWise-main		TrackWise-main
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation