System Architecture — How It Works
Gift Page (VIP's audience lands here) revenueratchet.com/vip-gift?am_id=AFFILIATE_ID ↗
Backend Worker (reads/writes partner data) partner-dashboard-worker.carl-958.workers.dev
QR Code API api.qrserver.com — auto-generated from affiliate link
Affiliate tracking engine GHL Affiliate Program — affiliate_id = GHL affiliate slug
Partner data persistence Cloudflare Worker GET/POST by affiliate_id — 13 custom fields
Stats Dashboard 🚧 Under construction — gift claim tracking not yet wired
Onboarding a New VIP Partner — Step by Step (~5 min)
  1. Create the affiliate in GHL
    GHL → Affiliate Manager → Add Affiliate → enter partner name + email. GHL generates a unique affiliate_id slug (e.g. toddwilliams335). Copy it — you'll need it for the next steps.
  2. Send the partner their two URLs
    Mission Control (their dashboard): revenueratchet.com/pe-dashboard-htm-020526?affiliate_id=THEIR_ID
    Gift Page (what their audience sees): revenueratchet.com/vip-gift?am_id=THEIR_ID
    Use the 3 Ready-To-Send Email Templates from the partner kit for the welcome email.
  3. Partner completes Mission Control setup
    They log into their dashboard and fill in all 3 sections: Identity (name, title, company, headshot URL), Voice (headline, subheadline, personal message, bio, footer line), and Offer (offer headline, body, CTA button text + link). Each section saves independently.
  4. Partner previews and activates their gift page
    In Mission Control, they click "PREVIEW MY LIVE GIFT PAGE" — opens vip-gift?am_id=THEIR_ID in a new tab. If it looks good, they copy their gift link or QR code and start sharing.
  5. Send the partner kit resources
    All 7 PDFs are already linked inside Mission Control. Confirm the partner has watched the Welcome & Orientation video in the dashboard header. That video walks them through the entire system.
The 13 Partner Customization Fields — Complete Reference
Field IDLabelWhat It DoesNotes
partner_full_nameNamePartner's display name on the gift pageFirst name or full name — their choice
partner_titleTitleProfessional title shown under their namee.g. "CFO Advisor" or "Business Coach"
partner_companyCompany or FirmCompany name shown on gift pageOptional — leave blank to hide
partner_headshot_urlHeadshot URLImage URL for their photo on the gift pageMust be a public URL (Google Drive, Dropbox, website). See Headshot Guidelines PDF.
Field IDLabelWhat It DoesNotes
hero_headlineHero HeadlineThe main headline gift recipients see at the topMost important field. See Messaging Examples PDF.
hero_subheadlineHero SubheadlineSupporting text explaining the gift2–3 sentences. Textarea field.
partner_personal_messagePersonal MessageA personal note in the partner's voiceShould feel human, not corporate. Textarea.
partner_bio_shortYour Bio2–3 sentence bio shown in the "About The Partner" sectionIf left blank, the entire ABOUT THE PARTNER section is hidden.
hub_sponsor_lineFooter Partner LineOptional attribution line at top of footere.g. "This gift made possible by Acme Advisors." Leave blank to hide.
Field IDLabelWhat It DoesNotes
partner_offer_headingOffer HeadlineHeadline for the partner's custom offer sectionWhat are they offering their audience?
partner_offer_bodyOffer Body TextFull description of the offerTextarea. See Offer Examples by Partner Type PDF.
partner_cta_textCTA Button TextThe text on the call-to-action buttone.g. "Schedule a Call" or "Get Your Free Assessment"
partner_cta_linkCTA Button LinkURL the CTA button points toPartner's calendar, landing page, etc. Must include https://
Partner Kit Resources — All 7 Assets
AssetWhere It Lives
3 Ready-To-Send Email TemplatesMission Control → Configure card + Direct PDF ↗
Book One-PagerMission Control → Configure card + Direct PDF ↗
Headshot GuidelinesMission Control → Identity section + Direct PDF ↗
Professional Bio TemplateMission Control → Identity section + Direct PDF ↗
Messaging Examples by IndustryMission Control → Voice section + Direct PDF ↗
Voice & Tone GuidelinesMission Control → Voice section + Direct PDF ↗
Offer Examples by Partner TypeMission Control → Offer section + Direct PDF ↗
CTA Best Practices GuideMission Control → Offer section + Direct PDF ↗
Troubleshooting Common Issues
  1. "Missing affiliate_id parameter" error
    The partner opened Mission Control without their ?affiliate_id= in the URL. Resend them their exact dashboard link — the URL must include the parameter.
  2. Headshot not showing on gift page
    The headshot URL must be publicly accessible — Google Drive share links don't work directly. Partner needs to use a direct image URL. Refer them to the Headshot Guidelines PDF.
  3. Changes not saving
    Each section saves independently — they must click "Save & Return to Dashboard" within that section. Clicking another section's save button does NOT save the current one.
  4. About The Partner section not showing
    By design — the section hides if partner_bio_short is empty. Partner needs to fill in their bio in the Voice & Messaging section.
  5. Stats show 🚧 Under Construction
    Expected — gift claim tracking dashboard is not yet built. This is a known backlog item. Tell partners stats are coming.
Open Backlog
ItemStatusNotes
Stats Dashboard — gift claim trackingBacklog"View My Stats" link currently shows 🚧 modal. Needs Worker endpoint + GHL data feed.
First VIP partner outreachProntoSystem is live and ready. Use 3 Email Templates to initiate first wave of VIP invitations.
Partner roster trackingBacklogNo central list of active partners yet. Add to this page as partners are onboarded.
Active Partner Roster
Partner NameAffiliate IDGift PageDashboardStatus
Todd Williams (test) toddwilliams335 Gift Page ↗ Dashboard ↗ Test
Add new partners here as they are onboarded