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.
191 lines
7.7 KiB
Python
191 lines
7.7 KiB
Python
"""Whether the signed-in user is a club ADMIN, for the management nav to hide
|
|
admin-only sections (seasons, positions, roles, shop, forms) from plain staff.
|
|
|
|
The underlying views are gated regardless (``ClubAdminRequiredMixin``) -- this is
|
|
purely so the nav doesn't show a link a coach or manager can't actually follow.
|
|
Same reasoning for ``news_permissions`` below, gating just the "New news item"
|
|
action rather than the whole section (``NewsAuthorRequiredMixin``/``can_add_news``).
|
|
"""
|
|
|
|
from waffle import flag_is_active
|
|
|
|
from billing.services.notices import club_billing_notice
|
|
from club.services.access import can_add_news, has_management_access, is_club_admin, is_coach_manager
|
|
|
|
#: Every management URL name, mapped to the nav item it should light up --
|
|
#: management/templates/management/_nav_items.html compares against this.
|
|
#: One dict here beats threading `nav=` through every view in views.py, and
|
|
#: unlike that, a new page can't silently be forgotten (it just renders with
|
|
#: no active item until added below, rather than needing every view touched).
|
|
_NAV_SECTIONS = {
|
|
"home": "home",
|
|
"member_list": "member_list",
|
|
"member_create": "member_list",
|
|
"member_import_template": "member_list",
|
|
"member_import": "member_list",
|
|
"member_import_confirm": "member_list",
|
|
"member_detail": "member_list",
|
|
"member_update": "member_list",
|
|
"member_delete": "member_list",
|
|
"member_attach_family": "member_list",
|
|
"member_grant_login": "member_list",
|
|
"member_detach_family": "member_list",
|
|
"family_create": "member_list",
|
|
"family_detail": "member_list",
|
|
"family_add_child": "member_list",
|
|
"family_add_parent": "member_list",
|
|
"family_membership_role_update": "member_list",
|
|
"membership_list": "membership_list",
|
|
"membership_mark_paid": "membership_list",
|
|
"membership_export_pdf": "membership_list",
|
|
"membership_mark_fully_paid": "membership_list",
|
|
"membership_record_payment": "membership_list",
|
|
"position_list": "position_list",
|
|
"position_create": "position_list",
|
|
"position_update": "position_list",
|
|
"role_list": "role_list",
|
|
"role_create": "role_list",
|
|
"role_revoke": "role_list",
|
|
"team_list": "team_list",
|
|
"team_create": "team_list",
|
|
"team_update": "team_list",
|
|
"team_delete": "team_list",
|
|
"team_detail": "team_list",
|
|
"team_roster_add": "team_list",
|
|
"team_roster_update": "team_list",
|
|
"team_roster_remove": "team_list",
|
|
"team_staff_add": "team_list",
|
|
"team_staff_update": "team_list",
|
|
"team_staff_remove": "team_list",
|
|
"team_photo_set": "team_list",
|
|
"team_photo_delete": "team_list",
|
|
"news_list": "news_list",
|
|
"news_create": "news_list",
|
|
"news_detail": "news_list",
|
|
"news_update": "news_list",
|
|
"news_delete": "news_list",
|
|
"news_publish": "news_list",
|
|
"news_unpublish": "news_list",
|
|
"news_photo_upload": "news_list",
|
|
"news_photo_set_main": "news_list",
|
|
"news_photo_delete": "news_list",
|
|
"event_list": "event_list",
|
|
"event_create": "event_list",
|
|
"event_detail": "event_list",
|
|
"event_update": "event_list",
|
|
"event_delete": "event_list",
|
|
"event_detach": "event_list",
|
|
"event_fetch_game_info": "event_list",
|
|
"rbihf_import": "event_list",
|
|
"rbihf_import_confirm": "event_list",
|
|
"event_series_create": "event_list",
|
|
"event_series_detail": "event_list",
|
|
"event_series_update": "event_list",
|
|
"event_series_delete": "event_list",
|
|
"event_series_stop": "event_list",
|
|
"event_series_generate": "event_list",
|
|
"location_list": "location_list",
|
|
"location_create": "location_list",
|
|
"location_update": "location_list",
|
|
"location_delete": "location_list",
|
|
"opponent_list": "opponent_list",
|
|
"opponent_create": "opponent_list",
|
|
"opponent_update": "opponent_list",
|
|
"opponent_delete": "opponent_list",
|
|
"sponsor_list": "sponsor_list",
|
|
"sponsor_create": "sponsor_list",
|
|
"sponsor_update": "sponsor_list",
|
|
"sponsor_delete": "sponsor_list",
|
|
"product_list": "product_list",
|
|
"order_list": "order_list",
|
|
"discount_list": "discount_list",
|
|
"invoice_list": "invoice_list",
|
|
"form_list": "form_list",
|
|
"submission_list": "form_list",
|
|
}
|
|
|
|
|
|
def active_nav_section(request):
|
|
"""Which management nav item is currently active, derived from the resolved
|
|
URL name. Guarded on the "management" namespace so a same-named url_name in
|
|
some other app can never leak into this."""
|
|
match = request.resolver_match
|
|
if match is None or match.namespace != "management":
|
|
return {"nav": None}
|
|
|
|
return {"nav": _NAV_SECTIONS.get(match.url_name)}
|
|
|
|
|
|
def is_admin(request):
|
|
club = getattr(request, "club", None)
|
|
if club is None or not request.user.is_authenticated:
|
|
return {"is_club_admin": False}
|
|
|
|
return {"is_club_admin": is_club_admin(request.user, club)}
|
|
|
|
|
|
def billing_notice(request):
|
|
"""What this club owes the platform, for the club's own admins.
|
|
|
|
A context processor rather than view context because the notice has to be able to follow
|
|
an admin onto every management page once it turns urgent -- billing/base.html renders it
|
|
at error level only, and the home page renders it at every level.
|
|
|
|
Admins only: platform billing is none of an ordinary member's business, and the query is
|
|
skipped entirely for everyone else rather than fetched and hidden in the template.
|
|
"""
|
|
club = getattr(request, "club", None)
|
|
if club is None or not request.user.is_authenticated or not is_club_admin(request.user, club):
|
|
return {"billing_notice": None}
|
|
|
|
return {"billing_notice": club_billing_notice(club)}
|
|
|
|
|
|
def management_position(request):
|
|
"""Whether the signed-in user holds a management position (or is ADMIN) --
|
|
gates the nav's Locations/Opponents links, which ``ManagementPositionRequiredMixin``
|
|
restricts to exactly this group (unlike most staff-visible sections)."""
|
|
club = getattr(request, "club", None)
|
|
if club is None or not request.user.is_authenticated:
|
|
return {"has_management_position": False}
|
|
|
|
return {"has_management_position": is_club_admin(request.user, club) or is_coach_manager(request.user, club)}
|
|
|
|
|
|
def management_link(request):
|
|
"""Whether to show a "Management" link in the global navbar (templates/_base.html),
|
|
next to the Django admin one -- only on a club subdomain, and only for someone with
|
|
real authority there (see has_management_access)."""
|
|
club = getattr(request, "club", None)
|
|
if club is None or not request.user.is_authenticated:
|
|
return {"has_management_access": False}
|
|
|
|
return {"has_management_access": has_management_access(request.user, club)}
|
|
|
|
|
|
def feature_sections(request):
|
|
"""Whether the nav's Shop/Forms sections -- and the Events page's "Import
|
|
from RBIHF" button -- should show at all. Each is gated behind its own
|
|
waffle Flag (see club.mixins.FeatureRequiredMixin, which gates the
|
|
underlying views regardless), on top of the existing is_club_admin check
|
|
those all already require."""
|
|
club = getattr(request, "club", None)
|
|
if club is None or not request.user.is_authenticated:
|
|
return {"shop_enabled": False, "forms_enabled": False, "rbihf_enabled": False}
|
|
|
|
return {
|
|
"shop_enabled": flag_is_active(request, "shop"),
|
|
"forms_enabled": flag_is_active(request, "formbuilder"),
|
|
"rbihf_enabled": flag_is_active(request, "RBIHF"),
|
|
}
|
|
|
|
|
|
def news_permissions(request):
|
|
"""Whether the "New news item" action should show -- viewing the News
|
|
section itself is open to any staff, same as Roster/Staff."""
|
|
club = getattr(request, "club", None)
|
|
if club is None or not request.user.is_authenticated:
|
|
return {"can_add_news": False}
|
|
|
|
return {"can_add_news": can_add_news(request.user, club)}
|