Merge pull request #390 from ibrahim-kiri/project

Added a student management system

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/asgi.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/settings.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/urls.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/wsgi.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/manage.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/requirements.txt

@@ -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/students/admin.py

@@ -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/apps.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/forms.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/migrations/0001_initial.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/models.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}'