Pricing Management — Predictable Plan Changes & First-Class Add-Ons

Plan and add-on prices are now versioned and audited end-to-end. Subscribers see upcoming changes 30+ days in advance, customer-notification emails are automated, existing customers are grandfathered when prices go up, and sales reps can grant per-club discounts up to a configured cap. This update is designed for clubs and players who want a better the platform experience — less manual work, more control, and a smoother workflow.

What's Included

Subscription & Billing page now surfaces an upcoming-change banner whenever a price change is scheduled — typically 30+ days out

Three migration policies — grandfather (keep current rate), at-renewal (switch on next renewal), now (proration on next invoice)

Smart TV Displays moved to a $15/mo add-on on Free + Growth — every existing TV-display user grandfathered automatically (100% discount)

First-class add-on purchase flow — buy the TV display add-on (or any add-on) directly from the billing page, activates immediately, prorated on next invoice

Sales reps with a configured discount cap can apply discounts on the spot from a club's Pipeline page; over-cap requests auto-flag for platform-owner approval

Per-club exception support — discount % overlay (Stripe Coupon) or fixed-price override (dedicated Stripe Price) per club, with full audit trail

Customer notification emails are automated and white-label aware — scheduled, 7-day reminder, and applied confirmation

Public pricing page (/pricing) and the GET /api/v1/public/pricing JSON endpoint now read from the same versioned price book — never a stale hardcoded number

Append-only audit log captures every change, exception, approval, revocation, and apply — PG triggers block UPDATE/DELETE at the database level

Platform-owner dashboard adds a 'Pricing health' widget — total MRR, MRR by tier, grandfathered count, active exceptions, discount delta, pending changes, failed migrations

AI chat tool 'query_pricing' lets admins ask 'is there a price change coming?' or 'what's the white-label add-on?' and get instant answers from the price book

Why This Matters

Pricing Management — Predictable Plan Changes & First-Class Add-Ons addresses a real need for clubs and players. Plan and add-on prices are now versioned and audited end-to-end. Subscribers see upcoming changes 30+ days in advance, customer-notification emails are automated, existing customers are grandfathered when prices go up, and sales reps can grant per-club discounts up to a configured cap. By building this directly into the platform, clubs and players save time and get a more reliable experience — no workarounds, no third-party tools, no spreadsheets.