Feat/155 change of folder architecture

quizzes/admin.py

@@ -107,7 +107,7 @@ def render_change_form(self, request, context, add=False, change=False, form_url
 
     list_display = [
         "title",
-        "maintainer",
+        "creator",
         "visibility",
         "is_anonymous",
         "version",
@@ -118,13 +118,13 @@ def render_change_form(self, request, context, add=False, change=False, form_url
     search_fields = [
         "title",
         "description",
-        "maintainer__first_name",
-        "maintainer__last_name",
-        "maintainer__email",
-        "maintainer__student_number",
+        "creator__first_name",
+        "creator__last_name",
+        "creator__email",
+        "creator__student_number",
     ]
     readonly_fields = ["version", "created_at", "updated_at", "view_questions_link", "view_sessions_link"]
-    autocomplete_fields = ["maintainer", "folder"]
+    autocomplete_fields = ["creator", "folder"]
     date_hierarchy = "created_at"
 
     def view_questions_link(self, obj):

quizzes/apps.py

@@ -4,3 +4,8 @@
 class QuizzesConfig(AppConfig):
     default_auto_field = "django.db.models.BigAutoField"
     name = "quizzes"
+
+    def ready(self):
+        from .signals import register_signals
+
+        register_signals()

quizzes/migrations/0004_folder_quiz_folder.py

@@ -1,31 +1,67 @@
-# Generated by Django 6.0 on 2025-12-26 14:18
-
 import uuid
 
 import django.db.models.deletion
+import django.utils.timezone
 from django.conf import settings
 from django.db import migrations, models
 
 
 class Migration(migrations.Migration):
 
     dependencies = [
-        ('quizzes', '0003_sharedquiz_allow_edit'),
+        ("quizzes", "0003_sharedquiz_allow_edit"),
         migrations.swappable_dependency(settings.AUTH_USER_MODEL),
     ]
 
     operations = [
         migrations.CreateModel(
-            name='Folder',
+            name="Folder",
             fields=[
-                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
-                ('name', models.CharField(max_length=128)),
-                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='folders', to=settings.AUTH_USER_MODEL)),
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                    ),
+                ),
+                ("name", models.CharField(max_length=128)),
+                (
+                    "created_at",
+                    models.DateTimeField(
+                        auto_now_add=True, default=django.utils.timezone.now
+                    ),
+                ),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "owner",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="folders",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+                (
+                    "parent",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="quizzes.folder",
+                    ),
+                ),
             ],
         ),
         migrations.AddField(
-            model_name='quiz',
-            name='folder',
-            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='quizzes', to='quizzes.folder'),
+            model_name="quiz",
+            name="folder",
+            field=models.ForeignKey(
+                blank=True,
+                null=True,
+                on_delete=django.db.models.deletion.SET_NULL,
+                related_name="quizzes",
+                to="quizzes.folder",
+            ),
         ),
     ]

quizzes/migrations/0005_rename_user_folder_owner_folder_created_at_and_more.py

@@ -1,7 +1,9 @@
-# Generated by Django 6.0 on 2025-12-29 20:16
+# Originally: rename user->owner, add created_at, updated_at
+# These changes were squashed into 0004_folder_quiz_folder on this branch.
+# This migration is kept as a no-op for backwards compatibility with
+# environments that already applied it.
 
-import django.utils.timezone
-from django.db import migrations, models
+from django.db import migrations
 
 
 class Migration(migrations.Migration):
@@ -10,21 +12,4 @@ class Migration(migrations.Migration):
         ('quizzes', '0004_folder_quiz_folder'),
     ]
 
-    operations = [
-        migrations.RenameField(
-            model_name='folder',
-            old_name='user',
-            new_name='owner',
-        ),
-        migrations.AddField(
-            model_name='folder',
-            name='created_at',
-            field=models.DateTimeField(auto_now_add=True, default=django.utils.timezone.now),
-            preserve_default=False,
-        ),
-        migrations.AddField(
-            model_name='folder',
-            name='updated_at',
-            field=models.DateTimeField(auto_now=True),
-        ),
-    ]
+    operations = []

quizzes/migrations/0006_folder_parent.py

@@ -1,7 +1,9 @@
-# Generated by Django 6.0 on 2025-12-31 13:00
+# Originally: add parent field to Folder
+# This change was squashed into 0004_folder_quiz_folder on this branch.
+# This migration is kept as a no-op for backwards compatibility with
+# environments that already applied it.
 
-import django.db.models.deletion
-from django.db import migrations, models
+from django.db import migrations
 
 
 class Migration(migrations.Migration):
@@ -10,10 +12,4 @@ class Migration(migrations.Migration):
         ('quizzes', '0005_rename_user_folder_owner_folder_created_at_and_more'),
     ]
 
-    operations = [
-        migrations.AddField(
-            model_name='folder',
-            name='parent',
-            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='quizzes.folder'),
-        ),
-    ]
+    operations = []

quizzes/migrations/0023_folder_architecture.py

@@ -0,0 +1,75 @@
+import uuid
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+def create_root_folders(apps, schema_editor):
+    User = apps.get_model("users", "User")
+    Folder = apps.get_model("quizzes", "Folder")
+    Quiz = apps.get_model("quizzes", "Quiz")
+
+    for user in User.objects.all().iterator():
+        if user.root_folder_id:
+            folder = Folder.objects.get(pk=user.root_folder_id)
+        else:
+            folder = Folder.objects.create(
+                id=uuid.uuid4(),
+                name="Moje quizy",
+                owner=user,
+                parent=None,
+            )
+            User.objects.filter(pk=user.pk).update(root_folder=folder)
+        Quiz.objects.filter(creator=user, folder__isnull=True).update(folder=folder)
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("quizzes", "0022_question_is_markdown_enabled"),
+        ("users", "0009_user_root_folder"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="SharedFolder",
+            fields=[
+                ("id", models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ("allow_edit", models.BooleanField(default=False)),
+                ("folder", models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name="shares", to="quizzes.folder")),
+                ("study_group", models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name="shared_folders", to="users.studygroup")),
+                ("user", models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name="shared_folders", to=settings.AUTH_USER_MODEL)),
+            ],
+        ),
+        migrations.RenameField(
+            model_name="quiz",
+            old_name="maintainer",
+            new_name="creator",
+        ),
+        migrations.AlterField(
+            model_name="quiz",
+            name="creator",
+            field=models.ForeignKey(
+                on_delete=django.db.models.deletion.CASCADE,
+                related_name="created_quizzes",
+                to=settings.AUTH_USER_MODEL,
+            ),
+        ),
+        migrations.RunPython(create_root_folders, migrations.RunPython.noop),
+        migrations.AlterField(
+            model_name="quiz",
+            name="folder",
+            field=models.ForeignKey(
+                on_delete=django.db.models.deletion.PROTECT,
+                related_name="quizzes",
+                to="quizzes.folder",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="folder",
+            name="created_at",
+            field=models.DateTimeField(auto_now_add=True),
+        ),
+    ]

quizzes/migrations/0024_sharedfolder_constraints.py

@@ -0,0 +1,28 @@
+# Generated by Django 6.0.1 on 2026-04-02 10:37
+
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('quizzes', '0023_folder_architecture'),
+        ('users', '0009_user_root_folder'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.AddConstraint(
+            model_name='sharedfolder',
+            constraint=models.CheckConstraint(condition=models.Q(models.Q(('study_group__isnull', True), ('user__isnull', False)), models.Q(('study_group__isnull', False), ('user__isnull', True)), _connector='OR'), name='sharedfolder_exactly_one_target'),
+        ),
+        migrations.AddConstraint(
+            model_name='sharedfolder',
+            constraint=models.UniqueConstraint(fields=('folder', 'user'), name='unique_sharedfolder_folder_user'),
+        ),
+        migrations.AddConstraint(
+            model_name='sharedfolder',
+            constraint=models.UniqueConstraint(fields=('folder', 'study_group'), name='unique_sharedfolder_folder_study_group'),
+        ),
+    ]