Auto-renew subscriptions before they lapse

Answers "does a plan renew itself?": until now, no — and that was a silent revenue
leak, not merely a missing convenience. A club whose period ended with its last due
PAID owes nothing, so dues_overdue() is empty, so archive_overdue_clubs never fires.
The club kept using the platform for free and no dashboard number went red, because
nothing was ever billed. The safety net only caught clubs you remembered to invoice.

`renew_subscriptions` (cron) issues the next period 30 days before the current one
ends, so the invoice lands before the period lapses and grace only matters for
genuine non-payers. It is idempotent by construction: a just-renewed club has a
latest period a year out, past the horizon, so a second run is a no-op.

It ACTS by default and previews with --dry-run — the opposite asymmetry to
archiving, and deliberately so. Archiving switches off a customer, so not-acting is
safe there; here, not-acting is the expensive failure, because an unbilled club is
also an unchased one. An unpriced tier fails that one club loudly (non-zero exit, so
cron mails you) without stopping the rest.

Opt-out per club via Subscription.auto_renew, mirroring auto_archive: off means you
invoice that club by hand. The dashboard gains a "renewals pending" count that
should sit at ~0 — a number here means cron has died and a club is about to go free,
which no other metric would reveal.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

controlpanel/forms.py

@@ -82,7 +82,7 @@ class SubscriptionForm(forms.ModelForm):
 
     class Meta:
         model = Subscription
-        fields = ["tier", "auto_archive", "notes"]
+        fields = ["tier", "auto_renew", "auto_archive", "notes"]
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)

controlpanel/services/statistics.py

@@ -18,7 +18,7 @@ from waffle import get_waffle_flag_model
 
 from authentication.middleware import ELEVATED_ROLES
 from billing.models import Due, DuePayment, Subscription
-from billing.services.dues import dues_in_grace, dues_overdue
+from billing.services.dues import dues_in_grace, dues_overdue, subscriptions_due_for_renewal
 from club.models import Club, ClubMembership, ClubRole, Season
 from events.models import Attendance, Event
 from members.models import Member
@@ -141,7 +141,7 @@ def onboarding_funnel():
     return [
         {"label": "Clubs", "count": total, "icon": "building-2"},
         {"label": "With members", "count": sum(1 for club in clubs if club.member_count), "icon": "users"},
-        {"label": "With a team", "count": sum(1 for club in clubs if club.team_count), "icon": "shield"},
+        {"label": "With a team", "count": sum(1 for club in clubs if club.team_count), "icon": "trophy"},
         {"label": "With events", "count": sum(1 for club in clubs if club.event_count), "icon": "calendar-days"},
     ]
 
@@ -172,6 +172,10 @@ def platform_attention():
         "dues_in_grace": dues_in_grace().count(),
         "dues_overdue": dues_overdue().count(),
         "clubs_unbilled": Club.objects.active().filter(subscription__isnull=True).count(),
+        # Normally ~0: the renewal job keeps it there. A number that sits here means cron is
+        # dead, and a club is about to use the platform for free — silently, because nothing is
+        # owed, so no other number on this page would go red.
+        "renewals_pending": len(subscriptions_due_for_renewal()),
     }
 
 

controlpanel/templates/controlpanel/club_detail.html

@@ -234,6 +234,11 @@
             {% else %}
                 <p class="text-sm opacity-70">
                     On <strong>{{ subscription.tier.name }}</strong>.
+                    {% if subscription.auto_renew %}
+                        Renews automatically 30 days before the period ends.
+                    {% else %}
+                        <span class="badge badge-warning badge-sm">Auto-renew off</span> — you must open each period by hand, or this club uses the platform for free.
+                    {% endif %}
                     {% if subscription.auto_archive %}
                         Archived automatically when a period goes unpaid past its grace period.
                     {% else %}

controlpanel/views.py

@@ -414,7 +414,7 @@ class SubscribeClubView(PlatformStaffRequiredMixin, FormView):
                 subscription.save()
                 messages.success(self.request, f"{club} is now on {subscription.tier}. The current period keeps the amount it was billed at.")
             else:
-                subscribe(club, form.cleaned_data["tier"], start=form.cleaned_data.get("start"), auto_archive=form.cleaned_data["auto_archive"])
+                subscribe(club, form.cleaned_data["tier"], start=form.cleaned_data.get("start"), auto_archive=form.cleaned_data["auto_archive"], auto_renew=form.cleaned_data["auto_renew"])
                 messages.success(self.request, f"{club} is on {form.cleaned_data['tier']}. Its first period is open.")
         except BillingError as error:
             messages.error(self.request, str(error))