feat: add new cancelled status for sponsors

 adds cancellation notifications, admin form buttons and page, state transitions, migration

Author: JacobCoffee

sponsors/admin.py

@@ -588,6 +588,11 @@ def get_urls(self):
                 self.admin_site.admin_view(self.approve_sponsorship_view),
                 name=f"{base_name}_approve",
             ),
+            path(
+                "<int:pk>/cancel",
+                self.admin_site.admin_view(self.cancel_sponsorship_view),
+                name=f"{base_name}_cancel",
+            ),
             path(
                 "<int:pk>/enable-edit",
                 self.admin_site.admin_view(self.rollback_to_editing_view),
@@ -745,6 +750,9 @@ def reject_sponsorship_view(self, request, pk):
     def approve_sponsorship_view(self, request, pk):
         return views_admin.approve_sponsorship_view(self, request, pk)
 
+    def cancel_sponsorship_view(self, request, pk):
+        return views_admin.cancel_sponsorship_view(self, request, pk)
+
     def approve_signed_sponsorship_view(self, request, pk):
         return views_admin.approve_signed_sponsorship_view(self, request, pk)
 

sponsors/migrations/0104_sponsorship_cancelled_on_sponsorship_withdrawn_on_and_more.py

@@ -0,0 +1,23 @@
+# Generated by Django 4.2.22 on 2025-06-26 16:06
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('sponsors', '0103_alter_benefitfeature_polymorphic_ctype_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='sponsorship',
+            name='cancelled_on',
+            field=models.DateField(blank=True, null=True),
+        ),
+        migrations.AlterField(
+            model_name='sponsorship',
+            name='status',
+            field=models.CharField(choices=[('applied', 'Applied'), ('rejected', 'Rejected'), ('approved', 'Approved'), ('finalized', 'Finalized'), ('cancelled', 'Cancelled')], db_index=True, default='applied', max_length=20),
+        ),
+    ]

sponsors/models/managers.py

@@ -17,7 +17,7 @@ def approved(self):
 
     def visible_to(self, user):
         contacts = user.sponsorcontact_set.values_list('sponsor_id', flat=True)
-        status = [self.model.APPLIED, self.model.APPROVED, self.model.FINALIZED]
+        status = [self.model.APPLIED, self.model.APPROVED, self.model.FINALIZED, self.model.CANCELLED]
         return self.filter(
             Q(submited_by=user) | Q(sponsor_id__in=Subquery(contacts)),
             status__in=status,

sponsors/models/sponsorship.py

@@ -156,12 +156,14 @@ class Sponsorship(models.Model):
     REJECTED = "rejected"
     APPROVED = "approved"
     FINALIZED = "finalized"
+    CANCELLED = "cancelled"
 
     STATUS_CHOICES = [
         (APPLIED, "Applied"),
         (REJECTED, "Rejected"),
         (APPROVED, "Approved"),
         (FINALIZED, "Finalized"),
+        (CANCELLED, "Cancelled"),
     ]
 
     objects = SponsorshipQuerySet.as_manager()
@@ -180,6 +182,7 @@ class Sponsorship(models.Model):
     applied_on = models.DateField(auto_now_add=True)
     approved_on = models.DateField(null=True, blank=True)
     rejected_on = models.DateField(null=True, blank=True)
+    cancelled_on = models.DateField(null=True, blank=True)
     finalized_on = models.DateField(null=True, blank=True)
     year = models.PositiveIntegerField(null=True, validators=YEAR_VALIDATORS, db_index=True)
 
@@ -218,7 +221,14 @@ def level_name(self, value):
     @cached_property
     def user_customizations(self):
         benefits = [b.sponsorship_benefit for b in self.benefits.select_related("sponsorship_benefit")]
-        return self.package.get_user_customization(benefits)
+        if self.package:
+            return self.package.get_user_customization(benefits)
+        else:
+            # Return default customization structure for sponsorships without packages
+            return {
+                "added_by_user": [],
+                "removed_by_user": []
+            }
 
     def __str__(self):
         repr = f"{self.level_name} - {self.year} - ({self.get_status_display()}) for sponsor {self.sponsor.name}"
@@ -327,8 +337,17 @@ def approve(self, start_date, end_date):
         self.end_date = end_date
         self.approved_on = timezone.now().date()
 
+
+    def cancel(self):
+        if self.CANCELLED not in self.next_status:
+            msg = f"Can't cancel a {self.get_status_display()} sponsorship."
+            raise InvalidStatusException(msg)
+        self.status = self.CANCELLED
+        self.locked = True
+        self.cancelled_on = timezone.now().date()
+
     def rollback_to_editing(self):
-        accepts_rollback = [self.APPLIED, self.APPROVED, self.REJECTED]
+        accepts_rollback = [self.APPLIED, self.APPROVED, self.REJECTED, self.CANCELLED]
         if self.status not in accepts_rollback:
             msg = f"Can't rollback to edit a {self.get_status_display()} sponsorship."
             raise InvalidStatusException(msg)
@@ -345,6 +364,7 @@ def rollback_to_editing(self):
         self.status = self.APPLIED
         self.approved_on = None
         self.rejected_on = None
+        self.cancelled_on = None
 
     @property
     def unlocked(self):
@@ -388,10 +408,11 @@ def open_for_editing(self):
     @property
     def next_status(self):
         states_map = {
-            self.APPLIED: [self.APPROVED, self.REJECTED],
-            self.APPROVED: [self.FINALIZED],
+            self.APPLIED: [self.APPROVED, self.REJECTED, self.CANCELLED],
+            self.APPROVED: [self.FINALIZED, self.CANCELLED],
             self.REJECTED: [],
             self.FINALIZED: [],
+            self.CANCELLED: [],
         }
         return states_map[self.status]
 

sponsors/notifications.py

@@ -86,6 +86,21 @@ class RejectedSponsorshipNotificationToSponsors(BaseEmailSponsorshipNotification
     def get_recipient_list(self, context):
         return context["sponsorship"].verified_emails
 
+class CancelledSponsorshipNotificationToPSF:
+    subject_template = "sponsors/email/psf_cancelled_sponsorship_subject.txt"
+    message_template = "sponsors/email/psf_cancelled_sponsorship.txt"
+    email_context_keys = ["sponsorship"]
+
+    def get_recipient_list(self, context):
+        return [settings.SPONSORSHIP_NOTIFICATION_TO_EMAIL]
+
+class CancelledSponsorshipNotificationToSponsors(BaseEmailSponsorshipNotification):
+    subject_template = "sponsors/email/sponsor_cancelled_sponsorship_subject.txt"
+    message_template = "sponsors/email/sponsor_cancelled_sponsorship.txt"
+    email_context_keys = ["sponsorship"]
+
+    def get_recipient_list(self, context):
+        return context["sponsorship"].verified_emails
 
 class ContractNotificationToPSF(BaseEmailSponsorshipNotification):
     subject_template = "sponsors/email/psf_contract_subject.txt"

sponsors/tests/test_admin.py

@@ -31,6 +31,7 @@ def test_lookups(self):
             ("rejected", "Rejected"),
             ("approved", "Approved"),
             ("finalized", "Finalized"),
+            ("cancelled", "Cancelled"),
         ]
         self.assertEqual(expected, self.filter.lookups(self.request, self.model_admin))
 

sponsors/tests/test_models.py

@@ -101,10 +101,11 @@ def setUp(self):
 
     def test_control_sponsorship_next_status(self):
         states_map = {
-            Sponsorship.APPLIED: [Sponsorship.APPROVED, Sponsorship.REJECTED],
-            Sponsorship.APPROVED: [Sponsorship.FINALIZED],
+            Sponsorship.APPLIED: [Sponsorship.APPROVED, Sponsorship.REJECTED, Sponsorship.CANCELLED],
+            Sponsorship.APPROVED: [Sponsorship.FINALIZED, Sponsorship.CANCELLED],
             Sponsorship.REJECTED: [],
             Sponsorship.FINALIZED: [],
+            Sponsorship.CANCELLED: [],
         }
         for status, exepcted in states_map.items():
             sponsorship = baker.prepare(Sponsorship, status=status)

sponsors/use_cases.py

@@ -46,6 +46,19 @@ def execute(self, sponsorship, request=None):
         return sponsorship
 
 
+class CancelSponsorshipApplicationUseCase(BaseUseCaseWithNotifications):
+    notifications = [
+        notifications.CancelledSponsorshipNotificationToPSF(),
+        notifications.CancelledSponsorshipNotificationToSponsors(),
+    ]
+
+    def execute(self, sponsorship, request=None):
+        sponsorship.cancel()
+        sponsorship.save()
+        self.notify(request=request, sponsorship=sponsorship)
+        return sponsorship
+
+
 class ApproveSponsorshipApplicationUseCase(BaseUseCaseWithNotifications):
     notifications = [
         notifications.SponsorshipApprovalLogger(),

sponsors/views_admin.py

@@ -52,6 +52,30 @@ def reject_sponsorship_view(ModelAdmin, request, pk):
     return render(request, "sponsors/admin/reject_application.html", context=context)
 
 
+
+
+def cancel_sponsorship_view(ModelAdmin, request, pk):
+    sponsorship = get_object_or_404(ModelAdmin.get_queryset(request), pk=pk)
+
+    if request.method.upper() == "POST" and request.POST.get("confirm") == "yes":
+        try:
+            use_case = use_cases.CancelSponsorshipApplicationUseCase.build()
+            use_case.execute(sponsorship)
+            ModelAdmin.message_user(
+                request, "Sponsorship was cancelled!", messages.SUCCESS
+            )
+        except InvalidStatusException as e:
+            ModelAdmin.message_user(request, str(e), messages.ERROR)
+
+        redirect_url = reverse(
+            "admin:sponsors_sponsorship_change", args=[sponsorship.pk]
+        )
+        return redirect(redirect_url)
+
+    context = {"sponsorship": sponsorship}
+    return render(request, "sponsors/admin/cancel_application.html", context=context)
+
+
 def approve_sponsorship_view(ModelAdmin, request, pk):
     """
     Approves a sponsorship and create an empty contract

templates/sponsors/admin/cancel_application.html

@@ -0,0 +1,34 @@
+{% extends 'admin/base_site.html' %}
+{% load i18n static sponsors %}
+
+{% block extrastyle %}{{ block.super }}<link rel="stylesheet" type="text/css" href="{% static "admin/css/forms.css" %}">{% endblock %}
+
+{% block title %}Cancel {{ sponsorship }} | python.org{% endblock %}
+
+{% block breadcrumbs %}
+<div class="breadcrumbs">
+  <a href="{% url 'admin:index' %}">{% trans 'Home' %}</a> &gt
+  <a href="{% url 'admin:app_list' app_label='sponsors' %}">{% trans 'Sponsors' %}</a> &gt
+  <a href="{% url 'admin:sponsors_sponsorship_changelist' %}">{% trans 'Sponsorship' %}</a> &gt
+  <a href="{% url 'admin:sponsors_sponsorship_change' sponsorship.pk %}">{{ sponsorship }}</a> &gt
+  {% trans 'Cancel' %}
+</div>
+{% endblock %}
+
+{% block content %}
+<h1>Cancel Sponsorship</h1>
+<p>Please review the sponsorship application and click the Cancel button to mark it as cancelled by administration.</p>
+<div id="content-main">
+<form action="" method="post" id="cancel_sponsorship_form">
+{% csrf_token %}
+
+<pre>{% full_sponsorship sponsorship display_fee=True %}</pre>
+
+<input name="confirm" value="yes" style="display:none">
+
+<div class="submit-row">
+    <input type="submit" value="Cancel" class="default">
+</div>
+
+</form>
+</div>{% endblock %}