Skip to content

README.md

Latest commit

 

History

History
72 lines (50 loc) · 2.46 KB

README.md

File metadata and controls

72 lines (50 loc) · 2.46 KB

📝 Django Enrollment System

A lightweight student enrollment management system built with Django, designed to mimic real university operations. It supports students, teachers, registrars, departments, programs, courses, sections, and enrollments with realistic relationships. The system includes role-based permissions, GPA and grade tracking, and can automatically populate the database with realistic sample data using manage.py populate.

🚀 Quick Start

Prerequisites

  • Python 3.8+
  • Git

Installation

# 1. Clone repository
git clone https://github.com/yourusername/enrollment-system.git
cd enrollment-system

# 2. Create virtual environment
python -m venv venv

# 3. Activate environment
# Linux/Mac:
source venv/bin/activate
# Windows:
.\venv\Scripts\activate

# 4. Install Faker for realistic data population
pip install Faker

# images
pip install Pillow 

# 5. Setup database
python manage.py migrate

# 6. Create admin account
python manage.py createsuperuser

# 7. (Optional) Populate database with realistic sample data
python manage.py populate

# 8. Run development server
python manage.py runserver

Visit http://localhost:8000 in your browser.

✨ Key Features

Feature Description
👨‍💼 User Roles Admin, Teacher, Registrar, and Student access levels with automatic group assignment
📚 Course Management Create and manage courses, prerequisites, programs, and curricula
🎓 Enrollment System Student registration, section management, and grade tracking
🧑‍🏫 Teacher & Advisor Roles Teachers can manage sections and advise students
📊 Admin Dashboard Centralized interface for departments, programs, and user management
🔄 Database Population manage.py populate can reset and fill the database with realistic sample data

🛠️ Technologies

  • Python & Django
  • Django ORM with relational models
  • PostgreSQL / SQLite (configurable)
  • Bootstrap / Tailwind (optional for UI)

📜 License

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