Release

.flake8

@@ -1,3 +1,3 @@
 [flake8]
-exclude = venv, migrations
+exclude = venv, migrations, .venv, .env
 max-line-length = 88

README.md

@@ -12,24 +12,6 @@ Students attendance report  [page](https://attendancebackend-v9zk.onrender.com/a
 
 ## Code contribution
 
-### Lint & Formatting
-We use `flake8==6.1.0` as a linter and `black==23.11.0` as a code formatter
-
-Install
-```bash
-pip install flake8==6.1.0 black==23.11.0
-```
-
-Run black
-```bash
-black .
-```
-
-Run flake8
-```bash
-flake8 .
-```
-
 ## Setup
 
 ### Using python.
@@ -49,8 +31,32 @@ python manage.py migrate
 python manage.py runserver
 ```
 
-After that you have to create superuser and create some dummy data.
-Dummy data can be created using django Fixtures if you are interested raise a PR for that.
+After that you can load dummy data. Run below command in a different shell.
+```bash
+python manage.py loaddata ./fixture.json
+```
+
+After loading fixtures you can use following credencials to loggin
+username: [email protected]
+password: password
+
+### Lint & Formatting
+We use `flake8==6.1.0` as a linter and `black==23.11.0` as a code formatter
+
+Install
+```bash
+pip install flake8==6.1.0 black==23.11.0
+```
+
+Run black
+```bash
+black .
+```
+
+Run flake8
+```bash
+flake8 .
+```
 
 ### To build an image.
 ```bash

attendance/admin.py

@@ -2,6 +2,8 @@
 from django.urls import reverse
 from attendance.models import (
     Student,
+    StudentGroup,
+    StudentGroupItem,
     Subject,
     SubjectClass,
     ClassAttendance,
@@ -11,6 +13,7 @@
     FalseAttemptGeoLocation,
     ClassAttendanceByBSM,
     ProblemSolvingPercentage,
+    SubjectClassStudentGroups,
 )
 from django.utils.html import format_html
 
@@ -158,7 +161,13 @@ def send_notification(self, obj):
     send_notification.short_description = "Send Reminder"
 
 
+class SubjectClassStudentGroupsInline(admin.TabularInline):
+    model = SubjectClassStudentGroups
+    autocomplete_fields = ["student_group"]
+
+
 class SubjectClassAdmin(admin.ModelAdmin):
+    inlines = [SubjectClassStudentGroupsInline]
     list_display = (
         "__str__",
         "subject",
@@ -262,6 +271,32 @@ def send_reminder(self, obj):
             )
 
 
+class StudentGroupItemInline(admin.TabularInline):
+    model = StudentGroupItem
+    autocomplete_fields = ["student"]
+
+
+class StudentGroupAdmin(admin.ModelAdmin):
+    inlines = [StudentGroupItemInline]
+    search_fields = ["name"]
+    readonly_fields = ("add_bulk_candidates",)
+
+    def add_bulk_candidates(self, obj):
+        from django.utils.html import format_html
+
+        if obj.pk:
+            return format_html(
+                '<a class="button" target="_blank" href="{}">Add bulk students</a>',
+                reverse("student_group", args=[obj.pk]),
+            )
+        else:
+            return format_html(
+                '<a class="button" target="_blank" disabled>Add bulk students</a>'
+            )
+
+
+# admin.site.register(SubjectClassStudentGroups)
+admin.site.register(StudentGroup, StudentGroupAdmin)
 admin.site.register(ProblemSolvingPercentage, ProblemSolvingPercentageAdmin)
 admin.site.register(ClassAttendanceByBSM, ClassAttendanceByBSMAdmin)
 admin.site.register(Student, StudentAdmin)

attendance/migrations/0057_studentgroup_studentgroupitem_studentgroup_students.py

@@ -0,0 +1,64 @@
+# Generated by Django 4.2.8 on 2024-02-25 11:30
+
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("attendance", "0056_alter_classattendance_options"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="StudentGroup",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("name", models.CharField(max_length=50)),
+            ],
+        ),
+        migrations.CreateModel(
+            name="StudentGroupItem",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("join_date", models.DateTimeField(auto_now_add=True)),
+                (
+                    "student",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="attendance.student",
+                    ),
+                ),
+                (
+                    "student_group",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="attendance.studentgroup",
+                    ),
+                ),
+            ],
+        ),
+        migrations.AddField(
+            model_name="studentgroup",
+            name="students",
+            field=models.ManyToManyField(
+                through="attendance.StudentGroupItem", to="attendance.student"
+            ),
+        ),
+    ]

attendance/migrations/0058_alter_studentgroupitem_unique_together.py

@@ -0,0 +1,16 @@
+# Generated by Django 4.2.8 on 2024-02-25 12:05
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("attendance", "0057_studentgroup_studentgroupitem_studentgroup_students"),
+    ]
+
+    operations = [
+        migrations.AlterUniqueTogether(
+            name="studentgroupitem",
+            unique_together={("student", "student_group")},
+        ),
+    ]

attendance/migrations/0059_subjectclassstudentgroups.py

@@ -0,0 +1,54 @@
+# Generated by Django 4.2.8 on 2024-02-25 12:25
+
+import attendance.models
+from django.db import migrations, models
+import django.db.models.deletion
+import enumfields.fields
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("attendance", "0058_alter_studentgroupitem_unique_together"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="SubjectClassStudentGroups",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "attendance_policy",
+                    enumfields.fields.EnumField(
+                        default=0,
+                        enum=attendance.models.AttendanceStatus,
+                        max_length=10,
+                    ),
+                ),
+                (
+                    "student_group",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="attendance.studentgroup",
+                    ),
+                ),
+                (
+                    "subject_class",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="attendance.subjectclass",
+                    ),
+                ),
+            ],
+            options={
+                "unique_together": {("subject_class", "student_group")},
+            },
+        ),
+    ]

attendance/migrations/0060_alter_subjectclassstudentgroups_attendance_policy.py

@@ -0,0 +1,23 @@
+# Generated by Django 4.2.8 on 2024-02-25 12:28
+
+import attendance.models
+from django.db import migrations
+import enumfields.fields
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("attendance", "0059_subjectclassstudentgroups"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="subjectclassstudentgroups",
+            name="attendance_policy",
+            field=enumfields.fields.EnumField(
+                default=0,
+                enum=attendance.models.SubjectClassStudentGroups.AttendancePolicy,
+                max_length=10,
+            ),
+        ),
+    ]

attendance/migrations/0061_alter_subjectclass_is_attendance_by_geo_location_enabled.py

@@ -0,0 +1,17 @@
+# Generated by Django 4.2.8 on 2024-06-16 09:53
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("attendance", "0060_alter_subjectclassstudentgroups_attendance_policy"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="subjectclass",
+            name="is_attendance_by_geo_location_enabled",
+            field=models.BooleanField(default=False),
+        ),
+    ]

attendance/migrations/0062_alter_subjectclass_is_attendance_mandatory.py

@@ -0,0 +1,17 @@
+# Generated by Django 4.2.8 on 2024-06-16 09:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("attendance", "0061_alter_subjectclass_is_attendance_by_geo_location_enabled"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="subjectclass",
+            name="is_attendance_mandatory",
+            field=models.BooleanField(default=True, help_text="dont use this field"),
+        ),
+    ]