pronto-helpdesk 1.0.2__py3-none-any.whl

accounts/admin.py

@@ -0,0 +1,107 @@
+from django.contrib import admin
+from django.contrib.auth.admin import UserAdmin as DjangoUserAdmin
+from django.contrib.auth.forms import AdminUserCreationForm
+from django.core.exceptions import ValidationError
+from django.forms.models import BaseInlineFormSet
+
+from pronto.enums import Role
+
+from .models import StudentProfile, User
+
+
+class UserCreationFormWithoutUsername(AdminUserCreationForm):
+    """Django's admin creation form, with email as the credential."""
+
+    class Meta(AdminUserCreationForm.Meta):
+        model = User
+        fields = (
+            "email",
+            "role",
+            "first_name",
+            "last_name",
+        )
+
+
+class StudentProfileFormSet(BaseInlineFormSet):
+    """Requires a profile for a student and refuses one to anybody else."""
+
+    def clean(self):
+        super().clean()
+        kept = [
+            form
+            for form in self.forms
+            if form.cleaned_data and not form.cleaned_data.get("DELETE")
+        ]
+        if self.instance.role == Role.STUDENT and not kept:
+            raise ValidationError("A student needs a matricola and a degree programme.")
+        if self.instance.role != Role.STUDENT and kept:
+            raise ValidationError("Only students have a student profile.")
+
+
+class StudentProfileInline(admin.StackedInline):
+    """The student data, edited on the user's page."""
+
+    model = StudentProfile
+    formset = StudentProfileFormSet
+
+    def get_extra(self, request, obj=None, **kwargs):
+        if obj is not None and obj.role != Role.STUDENT:
+            return 0
+        return 1
+
+
+@admin.register(User)
+class UserAdmin(DjangoUserAdmin):
+    """Django's UserAdmin without ``username``."""
+
+    add_form = UserCreationFormWithoutUsername
+    inlines = [StudentProfileInline]
+
+    list_display = ["email", "last_name", "first_name", "role", "is_active", "is_staff"]
+    list_filter = ["role", "is_active", "is_staff"]
+    search_fields = [
+        "email",
+        "last_name",
+        "first_name",
+        "student_profile__matricola",
+    ]
+    ordering = ["email"]
+
+    fieldsets = [
+        (None, {"fields": ("email", "password")}),
+        (
+            "Anagrafica",
+            {"fields": ("first_name", "last_name")},
+        ),
+        (
+            "Ruolo e permessi",
+            {
+                "fields": (
+                    "role",
+                    "is_active",
+                    "is_staff",
+                    "is_superuser",
+                    "groups",
+                    "user_permissions",
+                )
+            },
+        ),
+        ("Date", {"fields": ("last_login", "date_joined")}),
+    ]
+    add_fieldsets = [
+        (
+            None,
+            {
+                "classes": ("wide",),
+                "fields": (
+                    "email",
+                    "role",
+                    "first_name",
+                    "last_name",
+                    "usable_password",
+                    "password1",
+                    "password2",
+                ),
+            },
+        ),
+    ]

accounts/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class AccountsConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "accounts"

accounts/migrations/0001_initial.py

@@ -0,0 +1,113 @@
+# Generated by Django 5.2.16 on 2026-09-03 09:38
+
+import django.utils.timezone
+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="User",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("password", models.CharField(max_length=128, verbose_name="password")),
+                (
+                    "last_login",
+                    models.DateTimeField(
+                        blank=True, null=True, verbose_name="last login"
+                    ),
+                ),
+                (
+                    "is_superuser",
+                    models.BooleanField(
+                        default=False,
+                        help_text="Designates that this user has all permissions without explicitly assigning them.",
+                        verbose_name="superuser status",
+                    ),
+                ),
+                (
+                    "first_name",
+                    models.CharField(
+                        blank=True, max_length=150, verbose_name="first name"
+                    ),
+                ),
+                (
+                    "last_name",
+                    models.CharField(
+                        blank=True, max_length=150, verbose_name="last name"
+                    ),
+                ),
+                (
+                    "is_staff",
+                    models.BooleanField(
+                        default=False,
+                        help_text="Designates whether the user can log into this admin site.",
+                        verbose_name="staff status",
+                    ),
+                ),
+                (
+                    "is_active",
+                    models.BooleanField(
+                        default=True,
+                        help_text="Designates whether this user should be treated as active. Unselect this instead of deleting accounts.",
+                        verbose_name="active",
+                    ),
+                ),
+                (
+                    "date_joined",
+                    models.DateTimeField(
+                        default=django.utils.timezone.now, verbose_name="date joined"
+                    ),
+                ),
+                ("email", models.EmailField(max_length=254, unique=True)),
+                (
+                    "role",
+                    models.CharField(
+                        choices=[("STUDENT", "Student"), ("EMPLOYEE", "Employee")],
+                        max_length=8,
+                    ),
+                ),
+                (
+                    "groups",
+                    models.ManyToManyField(
+                        blank=True,
+                        help_text="The groups this user belongs to. A user will get all permissions granted to each of their groups.",
+                        related_name="user_set",
+                        related_query_name="user",
+                        to="auth.group",
+                        verbose_name="groups",
+                    ),
+                ),
+                (
+                    "user_permissions",
+                    models.ManyToManyField(
+                        blank=True,
+                        help_text="Specific permissions for this user.",
+                        related_name="user_set",
+                        related_query_name="user",
+                        to="auth.permission",
+                        verbose_name="user permissions",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "user",
+                "verbose_name_plural": "users",
+                "abstract": False,
+            },
+        ),
+    ]

accounts/migrations/0002_alter_user_options_alter_user_email_and_more.py

@@ -0,0 +1,49 @@
+# Generated by Django 5.2.16 on 2026-09-10 09:10
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("accounts", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name="user",
+            options={"verbose_name": "utente", "verbose_name_plural": "utenti"},
+        ),
+        migrations.AlterField(
+            model_name="user",
+            name="email",
+            field=models.EmailField(
+                help_text="Indirizzo istituzionale, usato anche come credenziale di accesso.",
+                max_length=254,
+                unique=True,
+                verbose_name="indirizzo email",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="user",
+            name="is_active",
+            field=models.BooleanField(
+                default=False,
+                help_text="Diventa vero quando l'utente apre il link di verifica ricevuto per email.",
+                verbose_name="attivo",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="user",
+            name="role",
+            field=models.CharField(
+                choices=[
+                    ("STUDENT", "Studente"),
+                    ("EMPLOYEE", "Dipendente"),
+                    ("ADMIN", "Amministratore"),
+                ],
+                help_text="Derivato dal dominio dell'indirizzo email in fase di registrazione.",
+                max_length=16,
+                verbose_name="ruolo",
+            ),
+        ),
+    ]

accounts/migrations/0003_user_matricola_degree_programme.py

@@ -0,0 +1,53 @@
+# Generated by Django 5.2.16 on 2026-09-28 23:06
+
+import django.core.validators
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("accounts", "0002_alter_user_options_alter_user_email_and_more"),
+        ("auth", "0012_alter_user_first_name_max_length"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="user",
+            name="degree_programme",
+            field=models.CharField(
+                blank=True,
+                default="",
+                help_text="Solo per gli studenti: il corso di laurea a cui sono iscritti.",
+                max_length=200,
+                verbose_name="corso di studi",
+            ),
+        ),
+        migrations.AddField(
+            model_name="user",
+            name="matricola",
+            field=models.CharField(
+                blank=True,
+                default="",
+                error_messages={
+                    "unique": "A student with this matricola is already registered."
+                },
+                help_text="Solo per gli studenti: il numero di matricola Unibo, da 6 a 10 cifre.",
+                max_length=10,
+                validators=[
+                    django.core.validators.RegexValidator(
+                        "^[0-9]{6,10}$", "A matricola is a number of 6 to 10 digits."
+                    )
+                ],
+                verbose_name="matricola",
+            ),
+        ),
+        migrations.AddConstraint(
+            model_name="user",
+            constraint=models.UniqueConstraint(
+                condition=models.Q(("matricola", ""), _negated=True),
+                fields=("matricola",),
+                name="unique_matricola",
+                violation_error_message="A student with this matricola is already registered.",
+            ),
+        ),
+    ]

accounts/migrations/0004_studentprofile.py

@@ -0,0 +1,71 @@
+# Generated by Django 5.2.16 on 2026-10-01 13:44
+
+import django.core.validators
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("accounts", "0003_user_matricola_degree_programme"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="StudentProfile",
+            fields=[
+                (
+                    "user",
+                    models.OneToOneField(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        primary_key=True,
+                        related_name="student_profile",
+                        serialize=False,
+                        to=settings.AUTH_USER_MODEL,
+                        verbose_name="utente",
+                    ),
+                ),
+                (
+                    "matricola",
+                    models.CharField(
+                        error_messages={
+                            "unique": "A student with this matricola is already registered."
+                        },
+                        help_text="Il numero di matricola Unibo, da 6 a 10 cifre.",
+                        max_length=10,
+                        unique=True,
+                        validators=[
+                            django.core.validators.RegexValidator(
+                                "^[0-9]{6,10}$",
+                                "A matricola is a number of 6 to 10 digits.",
+                            )
+                        ],
+                        verbose_name="matricola",
+                    ),
+                ),
+                (
+                    "degree_programme",
+                    models.CharField(
+                        help_text="Il corso di laurea a cui lo studente è iscritto.",
+                        max_length=200,
+                        verbose_name="corso di studi",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "profilo studente",
+                "verbose_name_plural": "profili studenti",
+                "constraints": [
+                    models.CheckConstraint(
+                        condition=models.Q(("matricola", ""), _negated=True),
+                        name="student_profile_matricola_not_empty",
+                    ),
+                    models.CheckConstraint(
+                        condition=models.Q(("degree_programme", ""), _negated=True),
+                        name="student_profile_degree_programme_not_empty",
+                    ),
+                ],
+            },
+        ),
+    ]

accounts/migrations/0005_copy_student_data.py

@@ -0,0 +1,54 @@
+# Moves each student's matricola and degree programme to a student profile.
+# Data a profile cannot hold stops the migration. A separate migration because
+# PostgreSQL cannot alter a table in the transaction that wrote rows to it.
+
+from django.db import migrations
+
+from pronto.enums import Role
+
+
+def copy_to_profiles(apps, schema_editor):
+    User = apps.get_model("accounts", "User")
+    StudentProfile = apps.get_model("accounts", "StudentProfile")
+    profiles = []
+    invalid = []
+    for user in User.objects.order_by("pk"):
+        given = [
+            bool(value.strip()) for value in (user.matricola, user.degree_programme)
+        ]
+        if user.role == Role.STUDENT and all(given):
+            profiles.append(
+                StudentProfile(
+                    user=user,
+                    matricola=user.matricola,
+                    degree_programme=user.degree_programme,
+                )
+            )
+        elif user.role == Role.STUDENT or any(given):
+            invalid.append(user.email)
+    if invalid:
+        raise RuntimeError(
+            "These users' matricola and degree programme do not match their "
+            f"role (both required of a student, refused from anyone else): "
+            f"{', '.join(invalid)}. Correct them, then migrate again."
+        )
+    StudentProfile.objects.bulk_create(profiles)
+
+
+def copy_to_users(apps, schema_editor):
+    User = apps.get_model("accounts", "User")
+    StudentProfile = apps.get_model("accounts", "StudentProfile")
+    for profile in StudentProfile.objects.all():
+        User.objects.filter(pk=profile.pk).update(
+            matricola=profile.matricola, degree_programme=profile.degree_programme
+        )
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("accounts", "0004_studentprofile"),
+    ]
+
+    operations = [
+        migrations.RunPython(copy_to_profiles, copy_to_users),
+    ]

accounts/migrations/0006_remove_user_matricola_degree_programme.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.2.16 on 2026-10-01 13:44
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("accounts", "0005_copy_student_data"),
+    ]
+
+    operations = [
+        migrations.RemoveConstraint(
+            model_name="user",
+            name="unique_matricola",
+        ),
+        migrations.RemoveField(
+            model_name="user",
+            name="degree_programme",
+        ),
+        migrations.RemoveField(
+            model_name="user",
+            name="matricola",
+        ),
+    ]

accounts/migrations/0007_require_user_names.py

@@ -0,0 +1,55 @@
+# Generated by Django 5.2.16 on 2026-10-01 13:51
+#
+# Every user needs a first and a last name, admins included, and the database
+# refuses an empty one. Users without them stop the migration first, with a
+# list of who they are: names cannot be made up, and the constraint's own
+# error would not say whom it is about.
+
+from django.db import migrations, models
+from django.db.models import Q
+
+
+def check_names(apps, schema_editor):
+    User = apps.get_model("accounts", "User")
+    unnamed = User.objects.filter(Q(first_name="") | Q(last_name="")).order_by("pk")
+    if unnamed.exists():
+        emails = ", ".join(unnamed.values_list("email", flat=True))
+        raise RuntimeError(
+            f"These users have no first or last name: {emails}. Give them one, "
+            "then migrate again."
+        )
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("accounts", "0006_remove_user_matricola_degree_programme"),
+        ("auth", "0012_alter_user_first_name_max_length"),
+    ]
+
+    operations = [
+        migrations.RunPython(check_names, migrations.RunPython.noop),
+        migrations.AlterField(
+            model_name="user",
+            name="first_name",
+            field=models.CharField(max_length=150, verbose_name="first name"),
+        ),
+        migrations.AlterField(
+            model_name="user",
+            name="last_name",
+            field=models.CharField(max_length=150, verbose_name="last name"),
+        ),
+        migrations.AddConstraint(
+            model_name="user",
+            constraint=models.CheckConstraint(
+                condition=models.Q(("first_name", ""), _negated=True),
+                name="user_first_name_not_empty",
+            ),
+        ),
+        migrations.AddConstraint(
+            model_name="user",
+            constraint=models.CheckConstraint(
+                condition=models.Q(("last_name", ""), _negated=True),
+                name="user_last_name_not_empty",
+            ),
+        ),
+    ]

accounts/migrations/0008_activate_accounts.py

@@ -0,0 +1,55 @@
+# Generated by Django 5.2.16 on 2026-10-06 15:55
+"""Accounts are active from registration on: e-mail verification is gone.
+
+New users get ``is_active=True`` by default. The users who registered while
+verification existed and never opened their link are still inactive, and with
+the link gone nothing would ever activate them: this migration does.
+
+Which rows: inactive users who have never logged in (``last_login IS NULL``).
+An account could only log in once verified, so an inactive one with a login
+was deactivated afterwards, by an admin, and stays inactive. The trade-off: an
+account an admin deactivated before it ever logged in looks exactly like an
+unverified one, and is activated too. So is one that only logged in before
+token logins were recorded, and was deactivated later: the login endpoint has
+set ``last_login`` since 1 October 2026, and left it NULL before. Nothing in
+the table tells these apart. When this migration was written, the inactive users on the hosted database
+were all unverified registrations; an admin who has deactivated someone since
+should check the user list in the admin after migrating.
+
+Going back changes no data. Which users this migration activated is not
+recorded, and deactivating every user who has never logged in would also lock
+out those registered, active, after it ran. Reverting the code restores
+verification for new registrations only.
+
+The schema change is the default and the help text alone: Django keeps field
+defaults in Python, so the ``AlterField`` runs no SQL.
+"""
+
+from django.db import migrations, models
+
+
+def activate_unverified(apps, schema_editor):
+    User = apps.get_model("accounts", "User")
+    User.objects.filter(is_active=False, last_login__isnull=True).update(is_active=True)
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("accounts", "0007_require_user_names"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="user",
+            name="is_active",
+            field=models.BooleanField(
+                default=True,
+                help_text=(
+                    "Toglilo per impedire all'utente di accedere, invece di "
+                    "eliminarne l'account."
+                ),
+                verbose_name="attivo",
+            ),
+        ),
+        migrations.RunPython(activate_unverified, migrations.RunPython.noop),
+    ]