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.
41 lines
1.5 KiB
Python
41 lines
1.5 KiB
Python
"""Invoice PDFs.
|
|
|
|
The PDF is rendered on demand from the Due's frozen snapshot (plan, amount, dates), so it
|
|
carries no state of its own beyond the number. Only the number is stored — an accountant
|
|
reconciles against it, so it is allocated once, never recomputed.
|
|
"""
|
|
|
|
from django.template.loader import render_to_string
|
|
|
|
from billing.models import Due, Invoice
|
|
from billing.services import BillingError
|
|
|
|
|
|
def issue_invoice(due: Due) -> Invoice:
|
|
"""One invoice per due, allocated once. Re-issuing returns the existing one rather than
|
|
burning a number — a gap in an invoice series is a question you do not want to answer."""
|
|
invoice, _created = Invoice.objects.get_or_create(due=due)
|
|
|
|
return invoice
|
|
|
|
|
|
def render_pdf(html: str) -> bytes:
|
|
"""HTML to PDF.
|
|
|
|
WeasyPrint is imported here, not at module scope: it binds to native pango/cairo
|
|
libraries, and a machine without them must still be able to run the app, the tests and
|
|
every other page — it should only fail when someone actually asks for a PDF, and say why.
|
|
"""
|
|
try:
|
|
from weasyprint import HTML
|
|
except (ImportError, OSError) as error:
|
|
raise BillingError("PDF rendering needs the native pango/cairo libraries (on macOS: brew install pango).") from error
|
|
|
|
return HTML(string=html).write_pdf()
|
|
|
|
|
|
def invoice_pdf(invoice: Invoice, base_url: str | None = None) -> bytes:
|
|
html = render_to_string("billing/invoice.html", {"invoice": invoice, "due": invoice.due, "club": invoice.due.club, "payments": invoice.due.payments.all()})
|
|
|
|
return render_pdf(html)
|