initial commit

main/admin.py

@@ -0,0 +1,78 @@
+from django.contrib import admin
+from main.models import (
+    Teacher,
+    Student,
+    Staff,
+    Course,
+    AcademicYear,
+    Subject,
+    NewsEvent,
+)
+
+# Register your models here.
+
+
+class TeacherAdmin(admin.ModelAdmin):
+    list_display = ("first_name", "last_name", "email", "phone", "active_status")
+    search_fields = ("first_name", "last_name", "email")
+    list_filter = ("gender", "active_status")
+
+
+class StudentAdmin(admin.ModelAdmin):
+    list_display = (
+        "first_name",
+        "last_name",
+        "email",
+        "phone",
+        "course",
+        "academic_year",
+        "active_status",
+    )
+    search_fields = ("first_name", "last_name", "email", "phone")
+    list_filter = ("gender", "course", "academic_year", "active_status")
+
+
+class StaffAdmin(admin.ModelAdmin):
+    list_display = (
+        "first_name",
+        "last_name",
+        "email",
+        "phone",
+        "position",
+        "active_status",
+    )
+    search_fields = ("first_name", "last_name", "email", "phone")
+    list_filter = ("position", "active_status")
+
+
+class CourseAdmin(admin.ModelAdmin):
+    list_display = ("name", "course_type", "duration", "academic_year")
+    search_fields = ("name",)
+    list_filter = ("course_type", "academic_year")
+
+
+class AcademicYearAdmin(admin.ModelAdmin):
+    list_display = ("batch",)
+    search_fields = ("batch",)
+
+
+class SubjectAdmin(admin.ModelAdmin):
+    list_display = ("name", "course", "semester_or_year_number")
+    search_fields = ("name", "course__name")
+    list_filter = ("course", "semester_or_year_number")
+
+
+class NewsEventAdmin(admin.ModelAdmin):
+    list_display = ("title", "type", "created_at")
+    search_fields = ("title", "summary")
+    list_filter = ("type", "created_at")
+
+
+# Register models with custom admin configurations
+admin.site.register(Teacher, TeacherAdmin)
+admin.site.register(Student, StudentAdmin)
+admin.site.register(Staff, StaffAdmin)
+admin.site.register(Course, CourseAdmin)
+admin.site.register(AcademicYear, AcademicYearAdmin)
+admin.site.register(Subject, SubjectAdmin)
+admin.site.register(NewsEvent, NewsEventAdmin)

main/apps.py

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

main/migrations/0001_initial.py

@@ -0,0 +1,100 @@
+# Generated by Django 5.1.4 on 2025-01-06 13:02
+
+import django.core.validators
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('auth', '0012_alter_user_first_name_max_length'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='AcademicYear',
+            fields=[
+                ('id', models.AutoField(primary_key=True, serialize=False)),
+                ('batch', models.CharField(max_length=255, unique=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='NewsEvent',
+            fields=[
+                ('id', models.BigAutoField(primary_key=True, serialize=False)),
+                ('title', models.CharField(max_length=255)),
+                ('summary', models.TextField()),
+                ('type', models.CharField(choices=[('news', 'News'), ('event', 'Event')], max_length=5)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Staff',
+            fields=[
+                ('id', models.AutoField(primary_key=True, serialize=False)),
+                ('first_name', models.CharField(max_length=255)),
+                ('last_name', models.CharField(max_length=255)),
+                ('position', models.CharField(choices=[('clerk', 'Clerk'), ('assistant', 'Assistant'), ('guard', 'Guard')], max_length=255)),
+                ('address', models.CharField(max_length=255)),
+                ('email', models.EmailField(max_length=255, unique=True)),
+                ('phone', models.CharField(max_length=15, validators=[django.core.validators.RegexValidator('^\\+?1?\\d{9,15}$', 'Enter a valid phone number.')])),
+                ('active_status', models.BooleanField(default=True)),
+                ('username', models.CharField(blank=True, max_length=255, null=True, unique=True)),
+                ('password', models.CharField(max_length=255)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Course',
+            fields=[
+                ('id', models.BigAutoField(primary_key=True, serialize=False)),
+                ('name', models.CharField(max_length=100)),
+                ('course_type', models.CharField(choices=[('semester', 'Semester-based'), ('yearly', 'Yearly-based')], max_length=10)),
+                ('duration', models.PositiveIntegerField(help_text='Number of semesters or years')),
+                ('academic_year', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='main.academicyear')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Student',
+            fields=[
+                ('id', models.AutoField(primary_key=True, serialize=False)),
+                ('active_status', models.BooleanField(default=True)),
+                ('first_name', models.CharField(max_length=255)),
+                ('last_name', models.CharField(max_length=255)),
+                ('gender', models.CharField(choices=[('M', 'Male'), ('F', 'Female')], max_length=1)),
+                ('phone', models.CharField(max_length=10, unique=True, validators=[django.core.validators.RegexValidator('^\\d{10}$', 'Enter a valid 10-digit phone number.')])),
+                ('email', models.EmailField(max_length=255, unique=True)),
+                ('username', models.CharField(blank=True, max_length=255, null=True, unique=True)),
+                ('password', models.CharField(max_length=255)),
+                ('academic_year', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='main.academicyear')),
+                ('course', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='main.course')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Subject',
+            fields=[
+                ('id', models.BigAutoField(primary_key=True, serialize=False)),
+                ('name', models.CharField(max_length=255)),
+                ('semester_or_year_number', models.PositiveIntegerField()),
+                ('course', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='subjects', to='main.course')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Teacher',
+            fields=[
+                ('id', models.AutoField(primary_key=True, serialize=False)),
+                ('first_name', models.CharField(max_length=255)),
+                ('last_name', models.CharField(max_length=255)),
+                ('address', models.CharField(max_length=255)),
+                ('gender', models.CharField(choices=[('M', 'Male'), ('F', 'Female')], max_length=1)),
+                ('email', models.EmailField(max_length=255, unique=True)),
+                ('phone', models.CharField(max_length=15, validators=[django.core.validators.RegexValidator('^\\+?1?\\d{9,15}$', 'Enter a valid phone number.')])),
+                ('active_status', models.BooleanField(default=True)),
+                ('username', models.CharField(blank=True, max_length=255, null=True, unique=True)),
+                ('password', models.CharField(max_length=255)),
+                ('group', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='auth.group')),
+            ],
+        ),
+    ]

main/models.py

@@ -0,0 +1,145 @@
+from django.db import models
+import random
+from django.core.validators import RegexValidator
+from django.contrib.auth.models import Group
+# Create your models here.
+
+
+class Teacher(models.Model):
+    id = models.AutoField(primary_key=True)
+    first_name = models.CharField(max_length=255)
+    last_name = models.CharField(max_length=255)
+    address = models.CharField(max_length=255)
+    gender = models.CharField(max_length=1, choices=[("M", "Male"), ("F", "Female")])
+    email = models.EmailField(max_length=255, unique=True)
+    phone = models.CharField(
+        max_length=15,
+        validators=[RegexValidator(r"^\+?1?\d{9,15}$", "Enter a valid phone number.")],
+    )
+    group = models.ForeignKey(Group, on_delete=models.SET_NULL, null=True, blank=True)
+    active_status = models.BooleanField(default=True)
+    username = models.CharField(max_length=255, unique=True, blank=True, null=True)
+    password = models.CharField(max_length=255)
+
+    def save(self, *args, **kwargs):
+        if not self.username:
+            random_number = random.randint(1000, 9999)
+            self.username = f"{self.first_name.lower()}_{random_number}"
+        super().save(*args, **kwargs)
+
+    def __str__(self):
+        return f"{self.first_name} {self.last_name}"
+
+
+class Student(models.Model):
+    id = models.AutoField(primary_key=True)
+    active_status = models.BooleanField(default=True)
+    first_name = models.CharField(max_length=255)
+    last_name = models.CharField(max_length=255)
+    gender = models.CharField(max_length=1, choices=[("M", "Male"), ("F", "Female")])
+    phone = models.CharField(
+        max_length=10,
+        unique=True,
+        validators=[
+            RegexValidator(r"^\d{10}$", "Enter a valid 10-digit phone number.")
+        ],
+    )
+    email = models.EmailField(max_length=255, unique=True)
+    course = models.ForeignKey("Course", on_delete=models.CASCADE)
+    academic_year = models.ForeignKey("AcademicYear", on_delete=models.CASCADE)
+    username = models.CharField(max_length=255, unique=True, blank=True, null=True)
+    password = models.CharField(max_length=255)
+
+    def save(self, *args, **kwargs):
+        if not self.username:
+            random_number = random.randint(1000, 9999)
+            self.username = f"{self.first_name.lower()}_{random_number}"
+        super().save(*args, **kwargs)
+
+    def __str__(self):
+        return f"{self.first_name} {self.last_name}"
+
+
+class Staff(models.Model):
+    id = models.AutoField(primary_key=True)
+    first_name = models.CharField(max_length=255)
+    last_name = models.CharField(max_length=255)
+    position = models.CharField(
+        max_length=255,
+        choices=[("clerk", "Clerk"), ("assistant", "Assistant"), ("guard", "Guard")],
+    )
+    address = models.CharField(max_length=255)
+    email = models.EmailField(max_length=255, unique=True)
+    phone = models.CharField(
+        max_length=15,
+        validators=[RegexValidator(r"^\+?1?\d{9,15}$", "Enter a valid phone number.")],
+    )
+    active_status = models.BooleanField(default=True)
+    username = models.CharField(max_length=255, unique=True, blank=True, null=True)
+    password = models.CharField(max_length=255)
+
+    def save(self, *args, **kwargs):
+        if not self.username:
+            random_number = random.randint(1000, 9999)
+            self.username = f"{self.first_name.lower()}_{random_number}"
+        super().save(*args, **kwargs)
+
+    def __str__(self):
+        return f"{self.first_name} {self.last_name}"
+
+
+class Course(models.Model):
+    id = models.BigAutoField(primary_key=True)
+    COURSE_TYPE_CHOICES = [
+        ("semester", "Semester-based"),
+        ("yearly", "Yearly-based"),
+    ]
+    name = models.CharField(max_length=100)
+    academic_year = models.ForeignKey("AcademicYear", on_delete=models.CASCADE)
+    course_type = models.CharField(max_length=10, choices=COURSE_TYPE_CHOICES)
+    duration = models.PositiveIntegerField(help_text="Number of semesters or years")
+
+    def __str__(self):
+        return self.name
+
+
+class AcademicYear(models.Model):
+    id = models.AutoField(primary_key=True)
+    batch = models.CharField(max_length=255, unique=True)
+
+    def __str__(self):
+        return f"Batch {self.batch}"
+
+
+class Subject(models.Model):
+    id = models.BigAutoField(primary_key=True)
+    name = models.CharField(max_length=255)
+    course = models.ForeignKey(
+        "Course", on_delete=models.CASCADE, related_name="subjects"
+    )
+    semester_or_year_number = models.PositiveIntegerField()
+
+    def __str__(self):
+        return f"{self.name} (Sem/Year {self.semester_or_year_number})"
+
+
+class NewsEvent(models.Model):
+    TYPE_CHOICES = [
+        ("news", "News"),
+        ("event", "Event"),
+    ]
+    id = models.BigAutoField(primary_key=True)
+    title = models.CharField(max_length=255)
+    summary = models.TextField()
+    type = models.CharField(max_length=5, choices=TYPE_CHOICES)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    def __str__(self):
+        return f"{self.title} ({self.get_type_display()})"
+
+
+USER_CHOICES = [
+    ("staff", "Staff"),
+    ("teacher", "Teacher"),
+    ("student", "Student"),
+]

main/tests.py

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

main/views.py

@@ -0,0 +1,3 @@
+from django.shortcuts import render
+
+# Create your views here.