🎓 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