Feat/email log model

backend/make/apps/owasp.mk

@@ -27,6 +27,12 @@ owasp-create-project-metadata-file:
 	@echo "Generating metadata"
 	@CMD="python manage.py owasp_create_project_metadata_file $(entity_key)" $(MAKE) backend-exec-command
 
+SNAPSHOT_FREQUENCY ?= weekly
+
+owasp-create-snapshot:
+	@echo "Creating OWASP community snapshot"
+	@CMD="python manage.py owasp_create_snapshot --frequency $(SNAPSHOT_FREQUENCY)" $(MAKE) exec-backend-command
+
 owasp-enrich-chapters:
 	@echo "Enriching OWASP chapters"
 	@CMD="python manage.py owasp_enrich_chapters" $(MAKE) backend-exec-command
@@ -58,12 +64,6 @@ owasp-generate-community-snapshot-video:
 		nest-snapshot-video \
 		python manage.py owasp_generate_community_snapshot_video $(snapshot_key) /home/owasp/generated_videos
 
-SNAPSHOT_FREQUENCY ?= weekly
-
-owasp-create-snapshot:
-	@echo "Creating OWASP community snapshot"
-	@CMD="python manage.py owasp_create_snapshot --frequency $(SNAPSHOT_FREQUENCY)" $(MAKE) exec-backend-command
-
 owasp-process-snapshots:
 	@echo "Processing OWASP snapshots"
 	@CMD="python manage.py owasp_process_snapshots" $(MAKE) backend-exec-command

backend/src/apps/owasp/admin/__init__.py

@@ -7,6 +7,7 @@
 from .board_of_directors import BoardOfDirectorsAdmin
 from .chapter import ChapterAdmin
 from .committee import CommitteeAdmin
+from .email_log import EmailLogAdmin
 from .entity_channel import EntityChannelAdmin
 from .entity_member import EntityMemberAdmin
 from .event import EventAdmin

backend/src/apps/owasp/admin/email_log.py

@@ -0,0 +1,32 @@
+"""Admin registration for EmailLog model."""
+
+from django.contrib import admin
+
+from apps.owasp.models.email_log import EmailLog
+
+
+class EmailLogAdmin(admin.ModelAdmin):
+    """Admin for EmailLog model."""
+
+    list_display = ("get_user", "snapshot", "status", "created_at")
+    list_filter = ("status", "created_at")
+    search_fields = ("snapshot_subscription__user__email",)
+    readonly_fields = (
+        "snapshot_subscription",
+        "snapshot",
+        "status",
+        "error_message",
+        "created_at",
+    )
+
+    def has_add_permission(self, request):
+        """Prevent manual creation of email logs."""
+        return False
+
+    @admin.display(description="User")
+    def get_user(self, obj):
+        """Return the user from the subscription."""
+        return obj.snapshot_subscription.user if obj.snapshot_subscription else "—"
+
+
+admin.site.register(EmailLog, EmailLogAdmin)

backend/src/apps/owasp/admin/snapshot_subscription.py

@@ -1,24 +1,109 @@
 """Admin registration for SnapshotSubscription model."""
 
+from django import forms
 from django.contrib import admin
+from django.core.exceptions import ValidationError
 
 from apps.owasp.models.snapshot_subscription import SnapshotSubscription
 
 
+class SnapshotSubscriptionAdminForm(forms.ModelForm):
+    """Custom form for SnapshotSubscription admin to validate duplicates with M2M."""
+
+    class Meta:
+        """Meta options."""
+
+        model = SnapshotSubscription
+        fields = (
+            "user",
+            "name",
+            "frequency",
+            "is_active",
+            "include_chapters",
+            "include_events",
+            "include_issues",
+            "include_posts",
+            "include_projects",
+            "include_pull_requests",
+            "include_releases",
+            "include_users",
+            "subscribed_projects",
+            "subscribed_chapters",
+            "subscribed_committees",
+        )
+
+    def clean(self):
+        """Validate form data, including M2M fields, to check for duplicates."""
+        if self.instance:
+            self.instance._is_admin_form = True  # noqa: SLF001
+        cleaned_data = super().clean()
+
+        user = cleaned_data.get("user")
+        if not user:
+            return cleaned_data
+
+        duplicate_found = SnapshotSubscription.check_duplicate_setup(
+            user=user,
+            frequency=cleaned_data.get("frequency"),
+            include_chapters=cleaned_data.get("include_chapters"),
+            include_events=cleaned_data.get("include_events"),
+            include_issues=cleaned_data.get("include_issues"),
+            include_posts=cleaned_data.get("include_posts"),
+            include_projects=cleaned_data.get("include_projects"),
+            include_pull_requests=cleaned_data.get("include_pull_requests"),
+            include_releases=cleaned_data.get("include_releases"),
+            include_users=cleaned_data.get("include_users"),
+            entity_ids={
+                "projects": [p.pk for p in (cleaned_data.get("subscribed_projects") or [])],
+                "chapters": [c.pk for c in (cleaned_data.get("subscribed_chapters") or [])],
+                "committees": [c.pk for c in (cleaned_data.get("subscribed_committees") or [])],
+            },
+            exclude_pk=self.instance.pk if self.instance else None,
+        )
+
+        toggles = [
+            cleaned_data.get("include_chapters"),
+            cleaned_data.get("include_events"),
+            cleaned_data.get("include_issues"),
+            cleaned_data.get("include_posts"),
+            cleaned_data.get("include_projects"),
+            cleaned_data.get("include_pull_requests"),
+            cleaned_data.get("include_releases"),
+            cleaned_data.get("include_users"),
+        ]
+        has_entities = bool(
+            cleaned_data.get("subscribed_projects")
+            or cleaned_data.get("subscribed_chapters")
+            or cleaned_data.get("subscribed_committees")
+        )
+
+        if not any(toggles) and not has_entities:
+            msg = "Your subscription cannot be empty. Please choose something to follow."
+            raise ValidationError(msg)
+
+        if duplicate_found:
+            msg = "A subscription with the same configuration already exists."
+            raise ValidationError(msg)
+
+        return cleaned_data
+
+
 class SnapshotSubscriptionAdmin(admin.ModelAdmin):
     """Admin for SnapshotSubscription model."""
 
-    list_display = ("user", "frequency", "is_active", "created_at", "updated_at")
+    form = SnapshotSubscriptionAdminForm
+
+    list_display = ("user", "name", "frequency", "is_active", "created_at", "updated_at")
     list_filter = ("frequency", "is_active", "created_at")
-    search_fields = ("user__email", "user__username")
+    search_fields = ("user__email", "user__username", "name")
     raw_id_fields = ("user",)
     readonly_fields = ("unsubscribe_token", "created_at", "updated_at")
-    autocomplete_fields = ("subscribed_projects", "subscribed_chapters")
+    autocomplete_fields = ("subscribed_projects", "subscribed_chapters", "subscribed_committees")
 
     fieldsets = (
-        (None, {"fields": ("user", "frequency", "is_active")}),
+        (None, {"fields": ("user", "name", "frequency", "is_active")}),
         (
-            "Content Preferences",
+            "Content Toggles",
             {
                 "fields": (
                     "include_chapters",
@@ -33,9 +118,13 @@ class SnapshotSubscriptionAdmin(admin.ModelAdmin):
             },
         ),
         (
-            "Subscription Filters",
+            "Subscribed Entities",
             {
-                "fields": ("subscribed_projects", "subscribed_chapters"),
+                "fields": (
+                    "subscribed_projects",
+                    "subscribed_chapters",
+                    "subscribed_committees",
+                ),
             },
         ),
         (

backend/src/apps/owasp/api/internal/mutations/__init__.py

@@ -0,0 +1,10 @@
+"""OWASP app mutations."""
+
+import strawberry
+
+from .snapshot_subscription import SnapshotSubscriptionMutations
+
+
+@strawberry.type
+class OwaspMutations(SnapshotSubscriptionMutations):
+    """OWASP mutations."""