Added a student management system

Author: ibrahim-kiri

SYSTEM MANAGEMENT APPS/Student_management_system/README.md

@@ -0,0 +1,103 @@
+# Student Management System
+
+## Overview
+
+The Student Management System is a simple web application designed to manage students' information using CRUD (Create, Read, Update, Delete) functionalities. It allows users to add, view, update, and delete student records. This project is built using Python and Django framework.
+
+## Features
+
+- Add new student records
+- View all student records
+- Update existing student records
+- Delete student records
+
+## Technologies Used
+
+- Python
+- Django
+- SQLite (default database for Django)
+- HTML/CSS and Bootstrap for frontend
+
+## Installation
+
+### Prerequisites
+
+- Python 3.x installed
+- Django installed (`pip install django`)
+
+### Steps
+
+1. **Clone the repository:**
+
+    ```sh
+    git clone https://github.com/yourusername/Student_management_system.git
+    cd Student_management_system
+    ```
+
+2. **Create a virtual environment and activate it:**
+
+    ```sh
+    python -m venv venv
+    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
+    ```
+
+3. **Install dependencies:**
+
+    ```sh
+    pip install -r requirements.txt
+    ```
+
+4. **Run migrations:**
+
+    ```sh
+    python manage.py migrate
+    ```
+
+5. **Run the development server:**
+
+    ```sh
+    python manage.py runserver
+    ```
+
+6. **Access the application:**
+
+    Open your web browser and go to `http://127.0.0.1:8000`
+
+## Usage
+
+### Add a New Student
+
+1. Click on the "Add Student" link in the navigation tab.
+2. Fill out the form with the student's information.
+3. Click "Submit" to save the new student record.
+
+### View Students
+
+1. Click on the "View" button link in the students row.
+2. A students info will be displayed.
+
+### Update a Student
+
+1. Click on the "Edit" button link in the students row you want to update.
+2. Update the student's information in the form.
+3. Click "Submit" to save the changes.
+
+### Delete a Student
+
+1. Click on the "Delete" button link in the student row you want to delete.
+2. Confirm the deletion when prompted.
+
+## Contributing
+1. Fork the repository
+2. Create a new branch (git checkout -b feature-branch)
+3. Commit your changes (git commit -am 'Add new feature')
+4. Push to the branch (git push origin feature-branch)
+5. Create a new Pull Request
+
+## Contact
+If you have any questions or suggestions, feel free to open an issue or contact the project maintainers.
+
+
+This `README.md` file provides a clear overview of the project, how to install and run it, and how to use its features. Adjust the repository link and other details as needed for your specific project.
+
+

SYSTEM MANAGEMENT APPS/Student_management_system/django_project/__init__.py

@@ -0,0 +1,16 @@
+"""
+ASGI config for django_project project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.0/howto/deployment/asgi/
+"""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django_project.settings')
+
+application = get_asgi_application()

SYSTEM MANAGEMENT APPS/Student_management_system/django_project/asgi.py

@@ -0,0 +1,124 @@
+"""
+Django settings for django_project project.
+
+Generated by 'django-admin startproject' using Django 5.0.4.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.0/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/5.0/ref/settings/
+"""
+
+from pathlib import Path
+
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/5.0/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = 'django-insecure-weeft8nl5p-wz+)(k2ye)uo2xiepnd18w6nstud@bjt*bp+a7^'
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = True
+
+ALLOWED_HOSTS = []
+
+
+# Application definition
+
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'students',
+]
+
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = 'django_project.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [],
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.debug',
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = 'django_project.wsgi.application'
+
+
+# Database
+# https://docs.djangoproject.com/en/5.0/ref/settings/#databases
+
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': BASE_DIR / 'db.sqlite3',
+    }
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/5.0/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
+    },
+]
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/5.0/topics/i18n/
+
+LANGUAGE_CODE = 'en-us'
+
+TIME_ZONE = 'UTC'
+
+USE_I18N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/5.0/howto/static-files/
+
+STATIC_URL = 'static/'
+
+# Default primary key field type
+# https://docs.djangoproject.com/en/5.0/ref/settings/#default-auto-field
+
+DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

SYSTEM MANAGEMENT APPS/Student_management_system/django_project/settings.py

@@ -0,0 +1,23 @@
+"""
+URL configuration for django_project project.
+
+The `urlpatterns` list routes URLs to views. For more information please see:
+    https://docs.djangoproject.com/en/5.0/topics/http/urls/
+Examples:
+Function views
+    1. Add an import:  from my_app import views
+    2. Add a URL to urlpatterns:  path('', views.home, name='home')
+Class-based views
+    1. Add an import:  from other_app.views import Home
+    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
+Including another URLconf
+    1. Import the include() function: from django.urls import include, path
+    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
+"""
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', include('students.urls')),
+]

SYSTEM MANAGEMENT APPS/Student_management_system/django_project/urls.py

@@ -0,0 +1,16 @@
+"""
+WSGI config for django_project project.
+
+It exposes the WSGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.0/howto/deployment/wsgi/
+"""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django_project.settings')
+
+application = get_wsgi_application()

SYSTEM MANAGEMENT APPS/Student_management_system/django_project/wsgi.py

@@ -0,0 +1,22 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django_project.settings')
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == '__main__':
+    main()

SYSTEM MANAGEMENT APPS/Student_management_system/manage.py

@@ -0,0 +1,4 @@
+asgiref==3.8.1
+Django==5.0.4
+sqlparse==0.5.0
+typing_extensions==4.11.0

SYSTEM MANAGEMENT APPS/Student_management_system/requirements.txt

@@ -0,0 +1,5 @@
+from django.contrib import admin
+from .models import Student
+
+# Register your models here.
+admin.site.register(Student)

SYSTEM MANAGEMENT APPS/Student_management_system/students/__init__.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class StudentsConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'students'

SYSTEM MANAGEMENT APPS/Student_management_system/students/admin.py

@@ -0,0 +1,23 @@
+from django import forms
+from .models import Student
+
+class StudentForm(forms.ModelForm):
+    class Meta:
+        model = Student
+        fields = ['student_number', 'first_name', 'last_name', 'email', 'field_of_study', 'gpa']
+        labels = {
+            'student_number': 'Student Number',
+            'first_name': 'First Name',
+            'last_name': 'Last Name',
+            'email': 'Email',
+            'field_of_study': 'Field of Study',
+            'gpa': 'GPA'
+        }
+        widgets = {
+            'student_number': forms.NumberInput(attrs={'class': 'form-control'}),
+            'first_name': forms.TextInput(attrs={'class': 'form-control'}),
+            'last_name': forms.TextInput(attrs={'class': 'form-control'}),
+            'email': forms.EmailInput(attrs={'class': 'form-control'}),
+            'field_of_study': forms.TextInput(attrs={'class': 'form-control'}),
+            'gpa': forms.NumberInput(attrs={'class': 'form-control'}),
+        }

SYSTEM MANAGEMENT APPS/Student_management_system/students/apps.py

@@ -0,0 +1,26 @@
+# Generated by Django 5.0.4 on 2024-04-15 15:16
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Student',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('student_number', models.PositiveIntegerField()),
+                ('first_name', models.CharField(max_length=50)),
+                ('last_name', models.CharField(max_length=50)),
+                ('email', models.EmailField(max_length=100)),
+                ('field_of_study', models.CharField(max_length=50)),
+                ('gpa', models.FloatField()),
+            ],
+        ),
+    ]

SYSTEM MANAGEMENT APPS/Student_management_system/students/forms.py

@@ -0,0 +1,13 @@
+from django.db import models
+
+# Create your models here.
+class Student(models.Model):
+    student_number = models.PositiveIntegerField()
+    first_name = models.CharField(max_length=50)
+    last_name = models.CharField(max_length=50)
+    email = models.EmailField(max_length=100)
+    field_of_study = models.CharField(max_length=50)
+    gpa = models.FloatField()
+
+    def __str__(self):
+        return f'Student: {self.first_name} {self.last_name}'

SYSTEM MANAGEMENT APPS/Student_management_system/students/migrations/0001_initial.py

@@ -0,0 +1,29 @@
+{% extends "students/base.html" %}
+
+{% block body %}
+    <h3 class="text-center m-4">Add Student</h3>
+    {% if success %}
+        <div class="alert alert-success" role="alert">
+            The new student added successfully.
+            <a href="{% url 'index' %}" class="alert-link">Go to Home Page.</a>
+        </div>
+    {% else %}
+        <div class="row justify-content-center">
+            <div class="col-6">
+                <div class="card bg-light mb-3">
+                    <div class="card-header">
+                        <i class="fa-solid fa-address-card fa-lg"></i> Student Registration
+                    </div>
+                    <div class="card-body">
+                        <form action="{% url 'add' %}" method="POST">
+                            {% csrf_token %}
+                            {{ form.as_p }}
+                            <button type="submit" class="btn btn-primary">Add</button>
+                            <a href="{% url 'index' %}" class="btn btn-secondary">Cancel</a>
+                        </form>
+                    </div>
+                  </div>
+            </div>
+        </div>
+    {% endif %}
+{% endblock %}

SYSTEM MANAGEMENT APPS/Student_management_system/students/migrations/__init__.py

@@ -0,0 +1,65 @@
+{% load static %}
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Student Management System</title>
+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.2/css/all.min.css"
+    />
+    <link href="{% static 'css/bootstrap.min.css' %}" rel="stylesheet" />
+  </head>
+  <body class="d-flex flex-column min-vh-100">
+    <nav class="navbar navbar-expand-lg bg-primary" data-bs-theme="dark">
+      <div class="container-fluid">
+        <a class="navbar-brand" href="{% url 'index' %}">
+          <i class="fa-solid fa-graduation-cap fa-lg"></i> Student Management
+          System
+        </a>
+        <button
+          class="navbar-toggler"
+          type="button"
+          data-bs-toggle="collapse"
+          data-bs-target="#navbarColor01"
+          aria-controls="navbarColor01"
+          aria-expanded="false"
+          aria-label="Toggle navigation"
+        >
+          <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarColor01">
+          <ul class="navbar-nav me-auto">
+            <li class="nav-item">
+              <a class="nav-link" href="{% url 'index' %}">
+                <i class="fa-solid fa-list fa-lg"></i> All Students
+              </a>
+            </li>
+            <li class="nav-item">
+              <a class="nav-link" href="{% url 'add' %}">
+                <i class="fa-solid fa-plus fa-lg"></i> Add Student
+              </a>
+            </li>
+          </ul>
+        </div>
+      </div>
+    </nav>
+    <div class="container-fluid">
+      {% block body %}
+      {% endblock %}
+    </div>
+    <footer class="mt-auto mb-4">
+      <div class="text-center">
+        <span>
+          Copyright &copy;
+          <script>
+            document.write(new Date().getFullYear());
+          </script>
+          Kiringabakwe Ibrahim.
+        </span>
+      </div>
+    </footer>
+    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.min.js"></script>
+  </body>
+</html>

SYSTEM MANAGEMENT APPS/Student_management_system/students/models.py

@@ -0,0 +1,29 @@
+{% extends "students/base.html" %}
+
+{% block body %}
+    <h3 class="text-center m-4">Update Student</h3>
+    {% if success %}
+        <div class="alert alert-success" role="alert">
+            The student updated successfully.
+            <a href="{% url 'index' %}" class="alert-link">Go to Home Page.</a>
+        </div>
+    {% else %}
+        <div class="row justify-content-center">
+            <div class="col-6">
+                <div class="card bg-light mb-3">
+                    <div class="card-header">
+                        <i class="fa-solid fa-pen-to-square fa-lg"></i> Update Student Records
+                    </div>
+                    <div class="card-body">
+                        <form action="#" method="POST">
+                            {% csrf_token %}
+                            {{ form.as_p }}
+                            <button type="submit" class="btn btn-primary">Update</button>
+                            <a href="{% url 'index' %}" class="btn btn-secondary">Cancel</a>
+                        </form>
+                    </div>
+                  </div>
+            </div>
+        </div>
+    {% endif %}
+{% endblock %}

SYSTEM MANAGEMENT APPS/Student_management_system/students/static/css/bootstrap.min.css

@@ -0,0 +1,117 @@
+{% extends "students/base.html" %}
+
+{% block body %}
+<h3 class="m-4">All Students</h3>
+<div class="row">
+  <div class="col-12">
+    {% if students %}
+      <div class="card bg-light ms-4 me-4 mb-4">
+        <div class="card-header">
+          <i class="fa-solid fa-list fa-lg"></i> Student Records
+        </div>
+        <div class="card-body">
+          <p class="card-text">
+            <div class="table-responsive">
+              <table class="table table-hover">
+                <thead>
+                  <tr>
+                    <th scope="col">Student Number</th>
+                    <th scope="col">First Name</th>
+                    <th scope="col">Last Name</th>
+                    <th scope="col">Email</th>
+                    <th scope="col">Field of Study</th>
+                    <th scope="col">GPA</th>
+                    <th scope="col">Actions</th>
+                  </tr>
+                </thead>
+                <tbody>
+                  {% for student in students %}
+                    <tr>
+                      <td>{{ student.student_number }}</td>
+                      <td>{{ student.first_name }}</td>
+                      <td>{{ student.last_name }}</td>
+                      <td>{{ student.email }}</td>
+                      <td>{{ student.field_of_study }}</td>
+                      <td>{{ student.gpa }}</td>
+                      <td>
+                        <button type="button" class="btn btn-success me-1" href="{% url 'view_student' student.id %}" data-bs-toggle="modal" data-bs-target="#myModal{{student.id}}">
+                          <i class="fa-solid fa-circle-info fa-lg"></i>
+                        </button>
+
+                        <!-- Modal view Student -->
+                        <div class="modal" id="myModal{{student.id}}" tabindex="-1" aria-labelledby="myModalLabel1" aria-hidden="true">
+                          <div class="modal-dialog" role="document">
+                            <div class="modal-content">
+                              <div class="modal-header">
+                                <h5 class="modal-title">
+                                  Student: {{ student.first_name }} {{ student.last_name }}
+                                </h5>
+                                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close">
+                                  <span aria-hidden="true"></span>
+                                </button>
+                              </div>
+                              <div class="modal-body">
+                                <ul class="list-unstyled">
+                                  <li>Student Number: <strong>{{ student.student_number }}</strong></li>
+                                  <li>First Name: <strong>{{ student.first_name }}</strong></li>
+                                  <li>Last Name: <strong>{{ student.last_name }}</strong></li>
+                                  <li>Email: <strong>{{ student.email }}</strong></li>
+                                  <li>Field of Study: <strong>{{ student.field_of_study }}</strong></li>
+                                  <li>GPA: <strong>{{ student.gpa }}</strong></li>
+                                </ul>
+                              </div>
+                              <div class="modal-footer">
+                                <button type="button" class="btn btn-primary" data-bs-dismiss="modal">Close</button>
+                              </div>
+                            </div>
+                          </div>
+                        </div>
+
+                        <a class="btn btn-warning me-1" href="{% url 'edit' student.id %}">
+                          <i class="fa-solid fa-pen-to-square fa-lg"></i>
+                        </a>
+
+                        <button type="button" class="btn btn-danger" data-bs-toggle="modal" data-bs-target="#delete{{student.id}}">
+                          <i class="fa-solid fa-trash-can fa-lg"></i>
+                        </button>
+
+                        <!-- Modal delete Student -->
+                        <div class="modal" id="delete{{student.id}}" tabindex="-1" aria-labelledby="myModalLabel2" aria-hidden="true">
+                          <div class="modal-dialog" role="document">
+                            <div class="modal-content">
+                              <div class="modal-header">
+                                <h5 class="modal-title">
+                                  Student: {{ student.first_name }} {{ student.last_name }}
+                                </h5>
+                                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close">
+                                  <span aria-hidden="true"></span>
+                                </button>
+                              </div>
+                              <div class="modal-body">
+                                <p>Are you sure you want to delete this student?</p>
+                              </div>
+                              <div class="modal-footer">
+                                <form action="{% url 'delete' student.id %}" method="POST">
+                                  {% csrf_token %}
+                                  <input type="submit" class="btn btn-primary" value="Delete">
+                                </form>
+                                <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Cancel</button>
+                              </div>
+                            </div>
+                          </div>
+                        </div>
+                      </td>
+                    </tr>
+                  {% endfor %}               
+                </tbody>
+              </table>
+            </div>
+          </p>
+        </div>
+      </div>
+    {% else %}
+      <h5 class="alert alert-primary ms-4 me-4">No Student Records</h5>
+    {% endif %}
+  </div>
+</div>
+{% endblock %}

SYSTEM MANAGEMENT APPS/Student_management_system/students/templates/students/add.html

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

SYSTEM MANAGEMENT APPS/Student_management_system/students/templates/students/base.html

@@ -0,0 +1,10 @@
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.index, name='index'),
+    path('<int:id>', views.view_student, name='view_student'),
+    path('add/', views.add, name='add'),
+    path('edit/<int:id>/', views.edit, name='edit'),
+    path('delete/<int:id>/', views.delete, name='delete'),
+]

SYSTEM MANAGEMENT APPS/Student_management_system/students/templates/students/edit.html

@@ -0,0 +1,69 @@
+from django.http import HttpResponseRedirect
+from django.shortcuts import render
+from django.urls import reverse
+
+from .models import Student
+from .forms import StudentForm
+
+# Create your views here.
+def index(request):
+    return render(request, 'students/index.html', {
+        'students': Student.objects.all()
+    })
+
+def view_student(request, id):
+    student = Student.objects.get(pk=id)
+    return HttpResponseRedirect(reverse('index'))
+
+def add(request):
+    if request.method == 'POST':
+        form = StudentForm(request.POST)
+        if form.is_valid():
+            new_student_number = form.cleaned_data['student_number']
+            new_first_name = form.cleaned_data['first_name']
+            new_last_name = form.cleaned_data['last_name']
+            new_email = form.cleaned_data['email']
+            new_field_of_study = form.cleaned_data['field_of_study']
+            new_gpa = form.cleaned_data['gpa']
+
+            new_student = Student(
+                student_number = new_student_number,
+                first_name = new_first_name,
+                last_name = new_last_name,
+                email = new_email,
+                field_of_study = new_field_of_study,
+                gpa = new_gpa
+            )
+            new_student.save()
+            return render(request, 'students/add.html', {
+                'form': StudentForm(),
+                'success': True
+            })
+    else:
+        form = StudentForm()
+    return render(request, 'students/add.html', {
+        'form': StudentForm()
+    })
+
+def edit(request, id):
+    if request.method == 'POST':
+        student = Student.objects.get(pk=id)
+        form = StudentForm(request.POST, instance=student)
+        if form.is_valid():
+            form.save()
+            return render(request, 'students/edit.html', {
+                'form': form,
+                'success': True
+            })
+    else:
+        student = Student.objects.get(pk=id)
+        form = StudentForm(instance=student)
+    return render(request, 'students/edit.html', {
+        'form': form
+    })
+
+def delete(request, id):
+    if request.method == 'POST':
+        student = Student.objects.get(pk=id)
+        student.delete()
+    return HttpResponseRedirect(reverse('index'))