add supplier tiers, directory redesign, CTA cleanup, and ROI fix

Phase 0 features: ungate planner, lead qualifier with heat scoring,
quote form (migrations 0002-0003), supplier directory with FTS5 search
(migration 0004), landing page redesign with ROI calculator and FAQ.

Phase 1 improvements: supplier tier system with Growth/Pro paid plans
(migration 0005), HTMX live directory search, three-tier card design,
Zillow-style sticky nav, "Get Matched" → "Get Quotes" CTA rename,
remove "Free" messaging site-wide, realistic ROI calculator defaults
(~3.9yr payback / ~26% ROI), mandatory form validation with 422 errors,
supplier pricing page with boost add-ons.

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

CHANGELOG.md

@@ -6,6 +6,121 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+### Added
+- **Supplier tier system** — Migration 0005 adds `tier` (free/growth/pro),
+  `logo_url`, `is_verified`, `highlight`, `sticky_until`, `sticky_country`
+  columns to suppliers table for paid listing support
+- **HTMX live search** — directory search input and filters update results
+  via `hx-get` with 300ms debounce; new `/directory/results` endpoint returns
+  swappable partial
+- **Directory card tiers** — three-tier card design: Pro (green border, logo,
+  verified badge, website), Growth (description, blue badge), Free (muted,
+  unverified, "Is this your company?" CTA); sticky/featured suppliers pinned
+  to top with blue border
+- **Supplier pricing page** — `/suppliers/` now shows Growth (€149/mo) and
+  Pro (€399/mo) plan cards with feature lists, boost add-ons grid (Logo,
+  Highlight, Verified Badge, Sticky Top, Newsletter Feature), updated FAQ
+- **Mandatory form fields** — country, timeline, and stakeholder_type now
+  required on quote request form with server-side 422 validation
+- **Validation test** — `test_quote_validation_rejects_missing_fields` verifies
+  server returns 422 JSON errors for missing mandatory fields
+
+### Changed
+- **Nav redesign** — Zillow-style sticky nav with backdrop-blur: demand-side
+  links (Planner, Directory) left, supply-side (For Suppliers, Help) after
+  separator, Sign In right; removed "Get Started Free" button
+- **CTA text sweep** — "Get Matched" → "Get Quotes" across planner, landing,
+  and lead forms; removed all "Free" qualifiers from CTAs and badges
+- **ROI calculator fix** — realistic cost model: €35K/court (was €25K),
+  staff costs, €8/sqm rent (was €4); payback and ROI now based on total
+  investment (was equity only); defaults: €40/hr rate, 35% utilization;
+  shows ~3.9yr payback, ~26% ROI (was 0.1yr/1255%)
+- **Directory route refactor** — shared `_build_directory_query()` helper
+  with tier-based SQL ordering (sticky → pro → growth → free → alphabetical)
+
+### Added
+- **Supplier directory** — public searchable directory at `/directory/` with 279
+  padel court suppliers across 31 countries; FTS5 full-text search, country and
+  category filters, pagination, category-colored badges, unclaimed listing model
+- **Supplier landing page** — `/suppliers/` marketing page for suppliers: hero,
+  how-it-works steps, example lead preview, FAQ, "Claim Your Listing" CTAs
+- **Migration 0004** — creates `suppliers` table with FTS5 virtual table,
+  content-sync triggers, and seeds 279 suppliers from PadelDirectory.md
+- **Quick ROI calculator** — landing page now features an interactive 3-slider
+  calculator (courts, rate, utilization) showing investment, monthly cash flow,
+  payback period, and annual ROI in real time
+- **Supplier matching section** — landing page "Find the Right Suppliers" section
+  with 3-step flow and link to directory
+- **FAQ accordion** — landing page FAQ covering planner features, signup
+  requirements, supplier matching, directory pricing, and projection accuracy
+
+### Changed
+- **Visual refresh** — adopted React prototype color palette and aesthetic
+  site-wide: royal blue primary (#1D4ED8), green (#16A34A), gold (#D97706);
+  elevated cards with soft shadows, rounder corners (rounded-2xl cards,
+  rounded-xl buttons/inputs), frosted-glass planner nav, highlighted CTA
+  regions with blue-tinted backgrounds, pill-shaped toggle/filter controls,
+  polished buttons with colored shadows, stronger hover lift on directory cards
+- **Landing hero redesigned** — two-column layout with headline + CTAs on left
+  and interactive Quick ROI calculator on right (matching React prototype);
+  green badge pill, feature check bullets, "Open Full Planner" CTA inside
+  calculator card; responsive single-column on mobile
+- **Landing page redesigned** — replaced screenshot card with Quick ROI
+  calculator; added supplier matching section, FAQ, and live supplier stats;
+  CTAs renamed "Open the Planner — Free"; Build journey card updated with
+  live supplier/country counts
+- **Navbar** — Planner and Directory links now visible for all users (not just
+  logged-in); footer updated with Directory and For Suppliers links
+- **Planner CTAs** — removed sticky "Get Builder Quotes" footer bar; CAPEX and
+  Returns tab CTAs now navigate to wizard step 5 (integrated lead qualifier)
+  instead of redirecting to standalone `/leads/quote` form
+- **Sitemap** — added `/planner/`, `/directory/`, and `/suppliers/` URLs
+
+### Changed
+- **Planner wizard** — Assumptions tab reorganized into 5 guided steps
+  (Your Venue → Pricing → Costs → Finance → Get Matched) with live preview
+  bar and step navigation; reduces cognitive load from 60 sliders to ~6-15
+  per step
+- **Integrated lead qualifier** — Step 5 "Get Matched" embeds the supplier
+  quote form directly in the planner; auto-fills venue, courts, glass,
+  lighting, country, budget from planner state; submits inline via fetch
+- **JSON quote endpoint** — `POST /leads/quote` now accepts `application/json`
+  and returns `{"ok": true, "heat": "..."}` for inline planner submissions;
+  standalone HTML form unchanged
+
+### Added — Phase 0 Round 2: Polish & Country-Specific Calculator
+- **Country-specific calculator** — `country` selector (DE/ES/IT/FR/NL/SE/UK/Other) and `permitsCompliance` CAPEX item for Indoor Rent and Outdoor scenarios; country presets auto-adjust permit costs
+- **Permits & Compliance** — new CAPEX line item for building permits, noise studies, and regulatory compliance (default €12K for Germany); excluded from Indoor Buy where Planning + Permits already covers this
+- **Quote form redesign** — elevated white card on gradient background, green gradient CTA buttons, progress labels (Project/Details/Contact), privacy info box, mandatory consent checkbox
+- **Project phase** (replaces location_status options) — 7-stage progression: still searching → location found → converting existing → lease signed → permit not filed → permit pending → permit granted; updated heat scoring
+- **Stakeholder type** field — "You are..." selector (Entrepreneur, Tennis Club, Municipality, Developer, Operator, Architect) with `stakeholder_type` DB column (migration 0003)
+- **Build context** — added "Need Help Finding a Venue / Land" (`venue_search`) option
+- **Quote submitted page redesign** — "You're matched!" flow with next-steps timeline, email confirmation box, and signup CTA for guests
+- **Migration 0003** — adds `stakeholder_type TEXT` column to `lead_requests`
+
+### Changed
+- **Landing page** — replaced teaser calculator with planner screenshot in browser-frame card + "Start Planning — Free" CTA; all CTAs now point to `/planner/` (no signup gate)
+- **Heat score** — updated `calculate_heat_score()` for new project phase values (`permit_granted` +4, `lease_signed`/`permit_pending` +3, `converting_existing`/`permit_not_filed` +2, `location_found` +1)
+- **Quote URL** — planner now passes `country` parameter to quote form prefill
+- **Admin email** — includes stakeholder type and updated field labels
+
+### Added — Phase 0: Ungate & Validate
+- **Guest mode planner** — removed auth gate from `/planner/` and `/planner/calculate`; scenarios still require login
+- **New calculator variables** — `budgetTarget` (budget vs CAPEX comparison), `glassType` (standard/panoramic, 1.4x multiplier), `lightingType` (LED standard/competition/natural, 1.5x/0x multipliers)
+- **Pill select UI component** — reusable `pillSelect()` helper in planner.js with matching `.pill-btn` CSS for multi-option inputs
+- **Budget indicator card** — shows over/under budget with variance amount and percentage on the Investment tab
+- **3-step "Get Builder Quotes" flow** — `/leads/quote` with project specs, details, and contact steps; no login required
+- **Lead heat scoring** — `calculate_heat_score()` rates leads as hot/warm/cool based on timeline, financing, location readiness, and budget signals
+- **PDF export CTA** — "Export Business Plan (PDF) — €99" wired to Paddle checkout (`business_plan` price in PADDLE_PRICES)
+- **SEO meta tags** — `<meta>` description, og:title, og:description, og:image on planner page
+- **Migration 0002** — expands `lead_requests` with 17 new columns for quote qualification flow; makes `user_id` nullable for guest leads
+- **Phase 0 test suite** (`tests/test_phase0.py`) — 47 tests covering guest mode, glass/lighting/budget variables, heat scoring, quote submission, schema validation
+- Updated Hypothesis strategy in `test_calculator.py` with `budgetTarget`, `glassType`, `lightingType`
+
+### Changed
+- Planner CTA links now point to `/leads/quote` with pre-filled calculator state params (venue, courts, glass, lighting, budget)
+- Sticky footer bar updated: "Get Builder Quotes" + "Export Business Plan (PDF)" replace old supplier/financing links
+
 ### Changed
 - Landing page journey section: renamed "From Idea to Operating Hall" → "Your Journey", expanded from 4 cards to 5 (Explore → Plan → Finance → Build → Grow) with "Coming Soon" badges on unreleased stages
 - Added `.grid-5` CSS helper for 5-column grid layout