🎓 Student Management System

A complete, production-ready Student Management System built with Django and MongoDB

✨ Features

🎯 Core Features

✅ Complete CRUD Operations - Create, Read, Update, Delete students
✅ User Authentication - Register, Login, Logout with secure passwords
✅ Role-Based Access Control - Admin, Teacher, Student roles
✅ Assignment Management - Create, submit, and grade assignments
✅ Search Functionality - Search students by name, email, or course

🆕 Advanced Features (NEW!)

✅ 📊 Statistics Dashboard - Real-time charts with Chart.js
✅ 🔍 Advanced Filtering - Filter by course, grade, and sort options
✅ 📸 Profile Pictures - Upload and display student photos
✅ 📅 Attendance Tracking - Complete attendance management system
✅ 📥 Export to Excel/PDF - Professional reports for presentations

🚀 Quick Start

Prerequisites

Python 3.13
MongoDB Community Server
pip (Python package manager)

Installation

Clone or navigate to the project:

cd C:\Users\DELL\MyNewProject

Install dependencies:

py -3.13 -m pip install -r requirements.txt

Start MongoDB:

net start MongoDB

Run the server:

py -3.13 manage.py runserver

Access the application:

http://localhost:8000/

📊 Dashboard Preview

The dashboard includes:

📈 4 Summary Cards - Students, Assignments, Submissions, Attendance
🎨 4 Interactive Charts - Course distribution, Grade distribution, Submissions, Attendance
📋 Quick Statistics Table - Real-time metrics

🎯 Key Features Breakdown

1. Statistics Dashboard

Real-time data visualization
Interactive Chart.js charts
Summary cards with icons
Professional color scheme

2. Advanced Filtering & Sorting

Search by name, email, course
Filter by course and grade
Sort by multiple fields
A-Z / Z-A toggle

3. Profile Pictures

Upload student photos
Circular profile display
Fallback to initials
Automatic file management

4. Attendance Tracking

Mark attendance (Present/Absent/Late/Excused)
View attendance history
Calculate statistics
Export attendance reports

5. Export Functionality

Export students to Excel
Export students to PDF
Export attendance to Excel
Professional formatting

👥 User Roles

🔴 Administrator

Full system access
Manage students (add, edit, delete)
Manage assignments
Mark attendance
Export data

🟢 Teacher

Add and edit students
Create and manage assignments
Mark attendance
Grade submissions
Export data

🔵 Student

View students and assignments
Submit assignments
View own attendance
View own grades

🛠️ Technology Stack

Backend

Django 4.2.7 - Web framework
Python 3.13 - Programming language
PyMongo 4.6.0 - MongoDB driver

Database

MongoDB - NoSQL database for flexible data storage

Frontend

Bootstrap 5.3.0 - Responsive UI framework
Chart.js 4.4.0 - Interactive charts
Bootstrap Icons - Icon library

Libraries

Pillow - Image processing
openpyxl - Excel generation
reportlab - PDF generation

📂 Project Structure

MyNewProject/
├── student_management/          # Main project directory
│   ├── settings.py             # Project settings
│   ├── urls.py                 # Main URL configuration
│   └── wsgi.py                 # WSGI configuration
│
├── students/                    # Main app directory
│   ├── templates/              # HTML templates
│   │   └── students/
│   │       ├── base.html       # Base template
│   │       ├── home.html       # Student list
│   │       ├── dashboard.html  # Statistics dashboard
│   │       ├── attendance_list.html
│   │       └── ...
│   ├── views.py                # View functions
│   ├── urls.py                 # App URL patterns
│   ├── forms.py                # Django forms
│   ├── models.py               # Data models
│   ├── mongodb.py              # MongoDB operations
│   ├── export_utils.py         # Export functions
│   ├── decorators.py           # Permission decorators
│   └── context_processors.py  # Template context
│
├── media/                       # User uploaded files
│   └── profile_pictures/       # Student photos
│
├── manage.py                    # Django management script
├── requirements.txt             # Python dependencies
│
└── Documentation/
    ├── FEATURES_GUIDE.md       # Complete feature guide
    ├── QUICK_START.md          # Quick start guide
    ├── ROLE_PERMISSIONS_GUIDE.md
    └── NEW_FEATURES_SUMMARY.txt

📖 Documentation

FEATURES_GUIDE.md - Complete documentation of all features
QUICK_START.md - Quick start and testing guide
ROLE_PERMISSIONS_GUIDE.md - Role-based permissions
NEW_FEATURES_SUMMARY.txt - Summary of new features

🎨 Screenshots

Dashboard

Real-time statistics with 4 interactive charts
Summary cards showing key metrics
Professional color-coded design

Student List with Filters

Advanced filtering panel
Profile pictures display
Export buttons (Excel, PDF)
Quick action buttons

Attendance Management

Date-wise attendance tracking
Color-coded status badges
Attendance history per student
Statistics and percentages

🔐 Security Features

Password Hashing - Secure password storage with Django's built-in hashing
CSRF Protection - All forms protected against CSRF attacks
Role-Based Access - Different permissions for each user role
Session Management - Secure session handling
URL Protection - Decorator-based view protection

📊 Database Collections

students

Student information
Profile pictures
Enrollment dates

assignments

Assignment details
Due dates and marks
Course information

submissions

Student submissions
Grades and feedback
Submission status

attendance

Attendance records
Date and status
Remarks

user_profiles

User roles
Authentication data
Profile information

🚀 Deployment

Development

py -3.13 manage.py runserver

Production Considerations

Set DEBUG = False in settings.py
Configure ALLOWED_HOSTS
Use production-grade web server (Gunicorn, uWSGI)
Set up MongoDB with authentication
Configure static files serving
Set up SSL/TLS certificates

🧪 Testing

Manual Testing

Register users with different roles
Test all CRUD operations
Mark attendance for multiple students
Export data to Excel and PDF
Test filtering and sorting
Upload profile pictures

Test Data

Use the provided sample data in QUICK_START.md to populate the system.

🐛 Troubleshooting

Server won't start

# Check MongoDB
mongosh

# Restart MongoDB
net start MongoDB

Dependencies issues

# Reinstall dependencies
py -3.13 -m pip install -r requirements.txt --force-reinstall

Profile pictures not showing

# Create media directory
mkdir media\profile_pictures

📝 API Endpoints

Authentication

/register/ - User registration
/login/ - User login
/logout/ - User logout

Students

/ - Student list (with filters)
/add/ - Add student
/edit/<id>/ - Edit student
/delete/<id>/ - Delete student
/detail/<id>/ - Student details

Dashboard & Analytics

/dashboard/ - Statistics dashboard
/student/<id>/performance/ - Student performance

Attendance

/attendance/ - Attendance list
/attendance/mark/<id>/ - Mark attendance
/attendance/student/<id>/ - Student attendance history

Assignments

/assignments/ - Assignment list
/assignments/add/ - Create assignment
/assignments/<id>/ - Assignment details
/assignments/<id>/submit/ - Submit assignment

Export

/export/students/excel/ - Export students to Excel
/export/students/pdf/ - Export students to PDF
/export/attendance/excel/ - Export attendance to Excel

🤝 Contributing

This is a college project, but suggestions and improvements are welcome!

📄 License

This project is created for educational purposes.

👨‍💻 Author

College Project

Built with Django and MongoDB
Completed in one day as requested
Production-ready features

🎓 For College Presentation

Key Highlights:

Full-stack application with Django and MongoDB
20+ features including CRUD, authentication, and advanced features
Role-based security with 3 user types
Modern UI with Bootstrap 5 and Chart.js
Production-ready with proper error handling and validation
Well-documented with multiple guide files
Scalable architecture using MongoDB

Demo Flow (5 minutes):

Show Dashboard with charts (1 min)
Demonstrate filtering and sorting (1 min)
Add student with profile picture (1 min)
Mark attendance and show statistics (1 min)
Export to Excel and PDF (1 min)

📞 Quick Commands

# Start server
py -3.13 manage.py runserver

# Create superuser
py -3.13 manage.py createsuperuser

# Access MongoDB shell
mongosh
use student_management_db
db.students.find()

# Install dependencies
py -3.13 -m pip install -r requirements.txt

⭐ Features at a Glance

Feature	Status	Description
CRUD Operations	✅	Complete Create, Read, Update, Delete
Authentication	✅	Register, Login, Logout
Authorization	✅	Role-based access control
Dashboard	✅	Interactive charts and statistics
Filtering	✅	Advanced search and filter
Profile Pictures	✅	Image upload and display
Attendance	✅	Complete tracking system
Export	✅	Excel and PDF generation
Assignments	✅	Create, submit, grade
Responsive UI	✅	Mobile-friendly design

🎉 Conclusion

This Student Management System is a complete, production-ready application with all modern features expected in a real-world system. It demonstrates proficiency in:

Full-stack web development
Database design and operations
User authentication and authorization
Data visualization
File handling and exports
Modern UI/UX design
Security best practices

Perfect for your college project! 🎓✨

Made with ❤️ using Django and MongoDB

Name		Name	Last commit message	Last commit date
student_management		student_management
students		students
.gitignore		.gitignore
ASSIGNMENT_FEATURE_GUIDE.md		ASSIGNMENT_FEATURE_GUIDE.md
AUTHENTICATION_GUIDE.md		AUTHENTICATION_GUIDE.md
COMPLETION_REPORT.md		COMPLETION_REPORT.md
DIRECTORY_TREE.txt		DIRECTORY_TREE.txt
DOCUMENTATION_COMPLETE.txt		DOCUMENTATION_COMPLETE.txt
FAQ.md		FAQ.md
FEATURES_GUIDE.md		FEATURES_GUIDE.md
NEW_FEATURES_SUMMARY.txt		NEW_FEATURES_SUMMARY.txt
New folder.code-workspace		New folder.code-workspace
PRESENTATION_SLIDES.md		PRESENTATION_SLIDES.md
PROJECT_AT_A_GLANCE.txt		PROJECT_AT_A_GLANCE.txt
PROJECT_DOCUMENTATION.md		PROJECT_DOCUMENTATION.md
PROJECT_DOCUMENTATION_PART2.md		PROJECT_DOCUMENTATION_PART2.md
PROJECT_DOCUMENTATION_PART3.md		PROJECT_DOCUMENTATION_PART3.md
PROJECT_PRESENTATION.md		PROJECT_PRESENTATION.md
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
QUICKSTART.md		QUICKSTART.md
QUICK_START.md		QUICK_START.md
README.md		README.md
ROLE_PERMISSIONS_GUIDE.md		ROLE_PERMISSIONS_GUIDE.md
START_HERE.txt		START_HERE.txt
check_setup.py		check_setup.py
install_dependencies.bat		install_dependencies.bat
manage.py		manage.py
requirements.txt		requirements.txt
run_server.bat		run_server.bat
setup_guide.txt		setup_guide.txt

Latest commit

History

Folders and files

Repository files navigation