Bernard Siebens
fc6488ce55
Implements BILLING.md. The architecture was sound -- snapshot-on-Due, dated prices, asymmetric dry-run commands are all kept -- so this fixes the three hardcoded assumptions rather than rewriting. The real defect: grace ran from period_END, so an annual club used the whole unpaid year plus 45 days (~410 days) before anything switched it off. Grace now runs from the period START, and every clock is per-plan. - Tier -> Plan (+ TierPrice -> PlanPrice, and every FK). Migration 0004 is hand-written: run non-interactively, makemigrations emits DeleteModel+CreateModel and drops every price, subscription and due. Its two RemoveConstraints must come first, or SQLite's table-rebuild tries to render a constraint over a just-renamed column. Verified by round-tripping real rows through it. - Plan gains duration_months / renewal_lead_days / grace_days / is_trial, with CheckConstraints and a matching clean() so the form reports an impossible plan instead of 500ing on IntegrityError. - Existing dues keep their stored grace_until. Re-deriving it would put the date in the past for every open annual period and archive the entire paying customer base on the next --commit run. - Trials take their length from the trial plan's own duration_months; start_trial() loses its trial_months argument. - New BillingNotice service drives a club-facing warning: every level on the dashboard, and on every management page once urgent. - send_billing_reminders emails club admins, once per escalation level so a daily cron is not a daily email. SMTP settings are env-driven and provider-agnostic; the backend defaults to console. - Paying does not auto-restore an archived club -- the control panel surfaces a Reactivate prompt instead, since a club can also be archived by hand.
78 lines
2.6 KiB
Python
78 lines
2.6 KiB
Python
"""What a club's own admins are told about money they owe the platform.
|
|
|
|
Separate from dues.py because the audience is different: everything in dues.py is read by
|
|
platform staff in the control panel, and this is the one piece of billing a *club* sees. It
|
|
returns data, never rendered text — the wording lives in the template so it can be translated,
|
|
and the same notice feeds both the on-screen banner and the reminder email.
|
|
"""
|
|
|
|
from dataclasses import dataclass
|
|
from datetime import date
|
|
from decimal import Decimal
|
|
|
|
from django.utils import timezone
|
|
|
|
from billing.models import Due
|
|
|
|
#: Inside this many days of being archived, the notice stops being a warning and becomes a
|
|
#: final one — which is also the point at which it follows the admin onto every page.
|
|
URGENT_DAYS = 7
|
|
|
|
INFO = "info"
|
|
WARNING = "warning"
|
|
ERROR = "error"
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class BillingNotice:
|
|
"""The single most pressing thing a club owes, and how alarmed to be about it."""
|
|
|
|
level: str
|
|
due: Due
|
|
amount_outstanding: Decimal
|
|
period_start: date
|
|
grace_until: date
|
|
days_until_archive: int
|
|
#: False when the subscription has auto_archive off. Money is still owed and still worth
|
|
#: saying so, but the countdown must not claim an archiving that will never happen.
|
|
will_archive: bool
|
|
|
|
@property
|
|
def is_urgent(self) -> bool:
|
|
return self.level == ERROR
|
|
|
|
|
|
def club_billing_notice(club, today: date | None = None) -> BillingNotice | None:
|
|
"""The notice for ``club``, or None when it owes nothing.
|
|
|
|
Picks the due with the earliest ``grace_until`` when several are owing: that is the one
|
|
that will archive the club first, so it is the one worth shouting about.
|
|
"""
|
|
today = today or timezone.localdate()
|
|
|
|
due = club.dues.filter(status__in=Due.OWING).select_related("plan").order_by("grace_until").first()
|
|
if due is None:
|
|
return None
|
|
|
|
subscription = getattr(club, "subscription", None)
|
|
will_archive = subscription.auto_archive if subscription is not None else False
|
|
days_left = due.days_until_archive(today)
|
|
|
|
if due.is_overdue(today):
|
|
level = ERROR
|
|
elif due.is_in_grace(today):
|
|
level = ERROR if days_left <= URGENT_DAYS else WARNING
|
|
else:
|
|
# Issued during the plan's renewal lead window: billed, but nothing is late yet.
|
|
level = INFO
|
|
|
|
return BillingNotice(
|
|
level=level,
|
|
due=due,
|
|
amount_outstanding=due.balance,
|
|
period_start=due.period_start,
|
|
grace_until=due.grace_until,
|
|
days_until_archive=days_left,
|
|
will_archive=will_archive,
|
|
)
|