sponsor notification history

Author: JacobCoffee

apps/sponsors/manage/urls.py

@@ -101,8 +101,9 @@
     ),
     # Composer wizard
     path("composer/", views.ComposerView.as_view(), name="manage_composer"),
-    # Notification template CRUD
+    # Notification template CRUD + history
     path("notifications/", views.NotificationTemplateListView.as_view(), name="manage_notification_templates"),
+    path("notifications/history/", views.NotificationHistoryView.as_view(), name="manage_notification_history"),
     path(
         "notifications/new/",
         views.NotificationTemplateCreateView.as_view(),

apps/sponsors/manage/views.py

@@ -52,6 +52,7 @@
     Sponsorship,
     SponsorshipBenefit,
     SponsorshipCurrentYear,
+    SponsorshipNotificationLog,
     SponsorshipPackage,
     SponsorshipProgram,
 )
@@ -534,6 +535,8 @@ def get_context_data(self, **kwargs):
         # Benefit add form (only when editable)
         if sp.open_for_editing:
             context["add_benefit_form"] = AddBenefitToSponsorshipForm(sponsorship=sp)
+        # Communication history
+        context["notification_logs"] = sp.notification_logs.select_related("sent_by").all()[:20]
         return context
 
 
@@ -1215,6 +1218,33 @@ def get_success_url(self):
         return reverse("manage_notification_templates")
 
 
+class NotificationHistoryView(SponsorshipAdminRequiredMixin, ListView):
+    """Show history of all sent notifications across all sponsorships."""
+
+    model = SponsorshipNotificationLog
+    template_name = "sponsors/manage/notification_history.html"
+    context_object_name = "logs"
+    paginate_by = 50
+
+    def get_queryset(self):
+        """Return logs ordered by most recent, with related data."""
+        qs = SponsorshipNotificationLog.objects.select_related("sponsorship__sponsor", "sent_by").order_by("-sent_at")
+        search = self.request.GET.get("search", "").strip()
+        if search:
+            qs = qs.filter(
+                Q(subject__icontains=search)
+                | Q(recipients__icontains=search)
+                | Q(sponsorship__sponsor__name__icontains=search)
+            )
+        return qs
+
+    def get_context_data(self, **kwargs):
+        """Add search term to context."""
+        context = super().get_context_data(**kwargs)
+        context["filter_search"] = self.request.GET.get("search", "")
+        return context
+
+
 # ── Sponsor contact management ───────────────────────────────────────
 
 

apps/sponsors/management/commands/seed_sponsor_manage_data.py

@@ -1,6 +1,6 @@
 """Create realistic test data for the sponsor management UI."""
 
-from datetime import timedelta
+from datetime import datetime, timedelta
 
 from django.conf import settings
 from django.contrib.auth import get_user_model
@@ -16,6 +16,7 @@
     Sponsorship,
     SponsorshipBenefit,
     SponsorshipCurrentYear,
+    SponsorshipNotificationLog,
     SponsorshipPackage,
     SponsorshipProgram,
 )
@@ -101,9 +102,13 @@ def handle(self, *args, **options):
         sponsors = self._create_sponsors()
         created_count = self._create_sponsorships(sponsors, user, current_year, today)
         self._create_notification_templates()
+        notif_count = self._create_notification_logs(user, today)
 
         self.stdout.write(
-            self.style.SUCCESS(f"Created {created_count} sponsorships across {len(sponsors)} sponsors, years {years}.")
+            self.style.SUCCESS(
+                f"Created {created_count} sponsorships across {len(sponsors)} sponsors, years {years}. "
+                f"{notif_count} notification logs."
+            )
         )
         self.stdout.write("View at: http://localhost:8000/sponsors/manage/sponsorships/")
 
@@ -291,8 +296,117 @@ def _create_notification_templates(self):
         if created:
             self.stdout.write(f"  Created {created} notification templates.")
 
+    def _create_notification_logs(self, user, today):
+        """Create realistic notification log entries for existing sponsorships."""
+        # Skip if logs already exist for seeded sponsors
+        names = [s["name"] for s in SPONSORS]
+        if SponsorshipNotificationLog.objects.filter(sponsorship__sponsor__name__in=names).exists():
+            return 0
+
+        messages = [
+            {
+                "subject": "Welcome to the PSF Sponsorship Program, {name}!",
+                "content": (
+                    "Dear {name},\n\n"
+                    "Thank you for your {level} sponsorship! "
+                    "Your sponsorship period runs from {start} to {end}.\n\n"
+                    "We will be in touch shortly with next steps regarding your benefits.\n\n"
+                    "Best regards,\nPSF Sponsorship Team"
+                ),
+                "contact_types": "primary, administrative",
+                "days_after_applied": 1,
+                "statuses": ("approved", "finalized"),
+            },
+            {
+                "subject": "Action Required: Sponsorship assets needed for {name}",
+                "content": (
+                    "Dear {name},\n\n"
+                    "This is a reminder that we still need your sponsorship assets "
+                    "(logos, descriptions, etc.) for your {level} sponsorship.\n\n"
+                    "Please submit them at your earliest convenience.\n\n"
+                    "Best regards,\nPSF Sponsorship Team"
+                ),
+                "contact_types": "primary",
+                "days_after_applied": 15,
+                "statuses": ("finalized",),
+            },
+            {
+                "subject": "Contract Sent: {name} {level} Sponsorship",
+                "content": (
+                    "Dear {name},\n\n"
+                    "Please find attached the sponsorship contract for your "
+                    "{level} sponsorship.\n\n"
+                    "Please review and sign at your earliest convenience.\n\n"
+                    "Best regards,\nPSF Sponsorship Team"
+                ),
+                "contact_types": "primary, administrative, accounting",
+                "days_after_applied": 7,
+                "statuses": ("approved", "finalized"),
+            },
+            {
+                "subject": "Sponsorship Finalized: Welcome aboard, {name}!",
+                "content": (
+                    "Dear {name},\n\n"
+                    "Great news! Your {level} sponsorship has been finalized. "
+                    "Your benefits are now active.\n\n"
+                    "If you have any questions, don't hesitate to reach out.\n\n"
+                    "Best regards,\nPSF Sponsorship Team"
+                ),
+                "contact_types": "primary, manager",
+                "days_after_applied": 20,
+                "statuses": ("finalized",),
+            },
+        ]
+
+        created = 0
+        sponsorships = Sponsorship.objects.filter(
+            sponsor__name__in=names,
+            status__in=[Sponsorship.APPROVED, Sponsorship.FINALIZED],
+        ).select_related("sponsor", "package")
+
+        for sp in sponsorships:
+            primary_email = f"contact@{sp.sponsor.name.lower().replace(' ', '')}.com"
+            billing_email = f"billing@{sp.sponsor.name.lower().replace(' ', '')}.com"
+
+            for msg in messages:
+                if sp.status not in msg["statuses"]:
+                    continue
+
+                recipients = primary_email
+                if "accounting" in msg["contact_types"] or "administrative" in msg["contact_types"]:
+                    recipients = f"{primary_email}, {billing_email}"
+
+                base_date = sp.applied_on or today
+                sent_at = timezone.make_aware(
+                    datetime.combine(base_date + timedelta(days=msg["days_after_applied"]), datetime.min.time())
+                )
+
+                SponsorshipNotificationLog.objects.create(
+                    sponsorship=sp,
+                    subject=msg["subject"].format(
+                        name=sp.sponsor.name,
+                        level=sp.level_name,
+                    ),
+                    content=msg["content"].format(
+                        name=sp.sponsor.name,
+                        level=sp.level_name,
+                        start=sp.start_date or "TBD",
+                        end=sp.end_date or "TBD",
+                    ),
+                    recipients=recipients,
+                    contact_types=msg["contact_types"],
+                    sent_by=user,
+                    sent_at=sent_at,
+                )
+                created += 1
+
+        if created:
+            self.stdout.write(f"  Created {created} notification log entries.")
+        return created
+
     def _clean(self):
         names = [s["name"] for s in SPONSORS]
+        SponsorshipNotificationLog.objects.filter(sponsorship__sponsor__name__in=names).delete()
         Contract.objects.filter(sponsorship__sponsor__name__in=names).delete()
         Sponsorship.objects.filter(sponsor__name__in=names).delete()
         Sponsor.objects.filter(name__in=names).delete()

apps/sponsors/migrations/0104_add_notification_log.py

@@ -0,0 +1,46 @@
+# Generated by Django 5.2.11 on 2026-03-22 20:15
+
+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 = [
+        ("sponsors", "0103_alter_benefitfeature_polymorphic_ctype_and_more"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="SponsorshipNotificationLog",
+            fields=[
+                ("id", models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name="ID")),
+                ("subject", models.CharField(max_length=500)),
+                ("content", models.TextField(blank=True)),
+                ("recipients", models.TextField(help_text="Comma-separated email addresses")),
+                ("contact_types", models.CharField(blank=True, max_length=200)),
+                ("sent_at", models.DateTimeField(default=django.utils.timezone.now)),
+                (
+                    "sent_by",
+                    models.ForeignKey(
+                        blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to=settings.AUTH_USER_MODEL
+                    ),
+                ),
+                (
+                    "sponsorship",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="notification_logs",
+                        to="sponsors.sponsorship",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Notification Log",
+                "verbose_name_plural": "Notification Logs",
+                "ordering": ["-sent_at"],
+            },
+        ),
+    ]

apps/sponsors/models/__init__.py

@@ -29,7 +29,11 @@
     TieredBenefitConfiguration,
 )
 from apps.sponsors.models.contract import Contract, LegalClause, signed_contract_random_path
-from apps.sponsors.models.notifications import SPONSOR_TEMPLATE_HELP_TEXT, SponsorEmailNotificationTemplate
+from apps.sponsors.models.notifications import (
+    SPONSOR_TEMPLATE_HELP_TEXT,
+    SponsorEmailNotificationTemplate,
+    SponsorshipNotificationLog,
+)
 from apps.sponsors.models.sponsors import Sponsor, SponsorBenefit, SponsorContact
 from apps.sponsors.models.sponsorship import (
     Sponsorship,
@@ -40,19 +44,15 @@
 )
 
 __all__ = [
-    # notifications
     "SPONSOR_TEMPLATE_HELP_TEXT",
-    # benefits
     "BaseEmailTargetable",
     "BaseLogoPlacement",
     "BaseTieredBenefit",
     "BenefitFeature",
     "BenefitFeatureConfiguration",
-    # contract
     "Contract",
     "EmailTargetable",
     "EmailTargetableConfiguration",
-    # assets
     "FileAsset",
     "GenericAsset",
     "ImgAsset",
@@ -70,15 +70,14 @@
     "RequiredTextAsset",
     "RequiredTextAssetConfiguration",
     "ResponseAsset",
-    # sponsors
     "Sponsor",
     "SponsorBenefit",
     "SponsorContact",
     "SponsorEmailNotificationTemplate",
-    # sponsorship
     "Sponsorship",
     "SponsorshipBenefit",
     "SponsorshipCurrentYear",
+    "SponsorshipNotificationLog",
     "SponsorshipPackage",
     "SponsorshipProgram",
     "TextAsset",

apps/sponsors/models/notifications.py

@@ -1,6 +1,8 @@
 """Email notification template models for sponsor communications."""
 
 from django.conf import settings
+from django.db import models
+from django.utils import timezone
 
 from apps.mailing.models import BaseEmailTemplate
 
@@ -57,3 +59,45 @@ def get_email_message(self, sponsorship, **kwargs):
             to=recipients,
             context={"sponsorship": sponsorship},
         )
+
+
+class SponsorshipNotificationLog(models.Model):
+    """Persisted record of every notification sent to a sponsorship."""
+
+    sponsorship = models.ForeignKey(
+        "sponsors.Sponsorship",
+        on_delete=models.CASCADE,
+        related_name="notification_logs",
+    )
+    subject = models.CharField(max_length=500)
+    content = models.TextField(blank=True)
+    recipients = models.TextField(help_text="Comma-separated email addresses")
+    contact_types = models.CharField(max_length=200, blank=True)
+    sent_by = models.ForeignKey(
+        settings.AUTH_USER_MODEL,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+    )
+    sent_at = models.DateTimeField(default=timezone.now)
+
+    class Meta:
+        """Meta configuration for SponsorshipNotificationLog."""
+
+        ordering = ["-sent_at"]
+        verbose_name = "Notification Log"
+        verbose_name_plural = "Notification Logs"
+
+    def __str__(self):
+        """Return a human-readable representation of the log entry."""
+        return f"{self.subject} → {self.sponsorship} ({self.sent_at:%Y-%m-%d %H:%M})"
+
+    @property
+    def recipient_list(self):
+        """Return recipients as a list of email addresses."""
+        return [r.strip() for r in self.recipients.split(",") if r.strip()]
+
+    @property
+    def contact_type_list(self):
+        """Return contact types as a list of strings."""
+        return [t.strip() for t in self.contact_types.split(",") if t.strip()]