Name	Name	Last commit message	Last commit date
Latest commit History 124 Commits
.github	.github
app	app
static	static
student_management_system	student_management_system
templates	templates
.env.example	.env.example
.gitignore	.gitignore
.pre-commit-config.yaml	.pre-commit-config.yaml
LICENSE	LICENSE
README.md	README.md
firebase-key.json.example	firebase-key.json.example
manage.py	manage.py
pyproject.toml	pyproject.toml
requirements.txt	requirements.txt
todo.md	todo.md
uv.lock	uv.lock

Student Management System

A comprehensive Django-based Student Management System with modern features and robust architecture.

Features

User Authentication and Authorization
Student Information Management
Course Management
Attendance Tracking
Grade Management
Parent Portal
Admin Dashboard
Firebase Integration
SMS Notifications
Email Notifications
Caching System
Security Features
Responsive UI with Jazzmin Admin Theme

Prerequisites

Python 3.8 or higher
Redis Server
PostgreSQL (recommended) or SQLite
Firebase Account (for Firebase features)
SMS Gateway Account (for SMS features)

Firebase Setup

Create a Firebase Project:
- Go to Firebase Console
- Click "Add project" and follow the setup wizard
- Give your project a name and enable Google Analytics (optional)
Get Firebase Configuration:
- In Firebase Console, click on the gear icon () next to "Project Overview"
- Select "Project settings"
- Scroll down to "Your apps" section
- Click the web icon ()
- Register your app with a nickname
- Copy the configuration object that looks like this:
const firebaseConfig = { apiKey: "xxx", authDomain: "xxx", projectId: "xxx", storageBucket: "xxx", messagingSenderId: "xxx", appId: "xxx", measurementId: "xxx" };
Set up Firebase configuration files:

# Copy and rename the example files cp static/firebase-messaging-sw.example.js static/firebase-messaging-sw.js cp static/js/firebase-config.example.js static/js/firebase-config.js # Update the configuration in both files with your Firebase credentials # - In firebase-messaging-sw.js: Update the firebaseConfig object # - In firebase-config.js: Update both firebaseConfig and vapidKey
Get Service Account Key:
- In Project Settings, go to "Service accounts" tab
- Click "Generate new private key"
- Save the downloaded JSON file as firebase-key.json in your project root
- Add this file to .gitignore to keep it secure
Update Environment Variables:
- Copy the values from your Firebase configuration to your .env file:
FIREBASE_API_KEY=your-api-key FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com FIREBASE_PROJECT_ID=your-project-id FIREBASE_STORAGE_BUCKET=your-project.appspot.com FIREBASE_MESSAGING_SENDER_ID=your-sender-id FIREBASE_APP_ID=your-app-id FIREBASE_MEASUREMENT_ID=your-measurement-id

Installation

Clone the repository:

git clone https://github.com/S4NKALP/Student-Management-System-In-Django.git cd Student-Management-System-In-Django
Choose your installation method:

Using UV (Recommended, faster):

# Install UV if not already installed curl -LsSf https://astral.sh/uv/install.sh | sh # UV will automatically: # - Create and manage virtual environment # - Install all dependencies # - Handle package versions # - Optimize installation process

Using pip (Traditional method):

# Create and activate virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt
Set up environment variables: Create a .env file in the project root with the following variables:

DEBUG=True SECRET_KEY=your-secret-key ALLOWED_HOSTS=localhost,127.0.0.1 DATABASE_URL=your-database-url # Email Configuration EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend DEFAULT_FROM_EMAIL=your-email@example.com EMAIL_HOST=smtp.gmail.com EMAIL_PORT=587 EMAIL_HOST_USER=your-email@gmail.com EMAIL_HOST_PASSWORD=your-app-password EMAIL_USE_TLS=True # Firebase Configuration FIREBASE_API_KEY=your-api-key FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com FIREBASE_PROJECT_ID=your-project-id FIREBASE_STORAGE_BUCKET=your-project.appspot.com FIREBASE_MESSAGING_SENDER_ID=your-sender-id FIREBASE_APP_ID=your-app-id FIREBASE_MEASUREMENT_ID=your-measurement-id # SMS Configuration SMS_API_KEY=your-sms-api-key SMS_SENDER_ID=your-sender-id
Run migrations:

# Create database migrations python manage.py makemigrations # Apply migrations python manage.py migrate
Create a superuser:

python manage.py createsuperuser
Collect static files:

python manage.py collectstatic

Running the Development Server

python manage.py runserver

Visit http://localhost:8000 to access the application.

Production Deployment

For production deployment, it's recommended to:

Set DEBUG=False in your environment variables
Use a production-grade database (PostgreSQL recommended)
Set up proper SSL/TLS certificates
Configure a production-grade web server (Nginx/Apache)
Use Gunicorn as the WSGI server:
gunicorn student_management_system.wsgi:application

Project Structure

student_management_system/ +-- app/ # Main application directory +-- static/ # Static files (CSS, JS, images) +-- templates/ # HTML templates +-- student_management_system/ # Project settings +-- manage.py # Django management script +-- requirements.txt # Project dependencies +-- README.md # This file

Security Features

CSRF Protection
XSS Protection
SQL Injection Protection
Secure Password Hashing
Session Security
HTTPS Enforcement
Security Headers
Rate Limiting

API Endpoints

The system provides various AJAX endpoints for data exchange between the frontend and backend:

Authentication Endpoints

POST /login/ - User login
POST /logout/ - User logout
POST /password-reset/ - Password reset options
POST /password-reset/phone/ - Phone-based password reset
POST /password-reset/email/ - Email-based password reset
POST /password-reset/set/ - Set new password

Dashboard Endpoints

GET /app/dashboard/ - Main dashboard
GET /app/student-dashboard/ - Student dashboard
GET /app/teacher-dashboard/ - Teacher dashboard
GET /app/parent-dashboard/ - Parent dashboard
GET /app/admission-officer-dashboard/ - Admission officer dashboard
GET /app/hodDashboard/ - HOD dashboard