Skip to main content

Complete Product Requirements & Guidelines Document

1. EXECUTIVE SUMMARY

What We're Building

A social commerce-integrated event management platform that connects products, experiences, and communities in a single ecosystem.

Core Differentiation

  • Social Commerce Integration: Events drive product sales, products drive event attendance
  • 48-Hour Payout: Fastest in the industry for host trust
  • Unique QR per Ticket: Zero fraud, perfect tracking
  • Co-Organizer System: Team collaboration built-in
  • Hybrid Pricing: Different prices for physical vs online attendance

Target Users

  • Primary: Content creators, small business owners, fitness instructors, workshop hosts
  • Secondary: Brands, influencers, community organizers
  • Tertiary: Attendees seeking experiences + products

2. CORE PHILOSOPHY

The 7 Unbreakable Laws

  1. One Ticket = One Unique QR Code

    • Each ticket gets its own scannable identity
    • Prevents fraud and enables perfect tracking
    • Works offline with cryptographic signing

  2. 48-Hour Payout Rule

    • Host receives money 48 hours after event ends
    • Builds trust and retention
    • Funds held in escrow until event completes

  3. Social Commerce First

    • Events appear in product feed
    • Products can be attached to events
    • Purchases unlock event access, events unlock products

  4. Co-Organizers are First-Class Citizens

    • Full permission system (view/edit/manage)
    • Revenue sharing built-in
    • Activity tracking and accountability

  5. Hybrid Events, Hybrid Pricing

    • Physical ticket: $X
    • Online ticket: $Y (usually lower)
    • Same event, different price points

  6. Zero Friction Discovery

    • Events live in main social feed
    • "Friends going" is primary filter
    • One-tap purchase with saved payment

  7. Gallery is Required

    • Minimum 3 photos (1 cover + 2 gallery)
    • Social proof through visuals
    • Events with photos get 3x more bookings

3. USER ROLES & PERMISSIONS

3.1 Role Hierarchy

PRIMARY HOST (Event Creator)

  • Full control over everything
  • Can add/remove co-organizers
  • Receives payouts (or splits revenue)
  • Can delete event
  • Can edit all event details
  • Access to all analytics

CO-ORGANIZER (Admin Level)

  • Edit event details
  • Manage attendees
  • Use scanner app
  • View analytics
  • Message attendees
  • Process refunds
  • Cannot: Delete event, change revenue split, remove primary host

CO-ORGANIZER (Scanner Only)

  • Check-in attendees only
  • View attendee list (names only)
  • Real-time attendance count
  • Cannot: Edit anything, view financial data

ATTENDEE

  • View public events
  • Purchase tickets
  • Leave reviews
  • Access attached products
  • Share event to friends

3.2 Permission Matrix

Action Primary Host Co-Organizer (Admin) Co-Organizer (Scanner) Attendee
Create event ✓ ✗ ✗ ✗
Edit event details ✓ ✓ ✗ ✗
Delete event ✓ ✗ ✗ ✗
Add co-organizers ✓ ✗ ✗ ✗
Remove co-organizers ✓ ✗ ✗ ✗
Set revenue split ✓ ✗ ✗ ✗
Check-in attendees ✓ ✓ ✓ ✗
View attendee details ✓ ✓ ✓ (limited) ✗
Export attendee data ✓ ✓ ✗ ✗
Refund tickets ✓ ✓ ✗ ✗
Message attendees ✓ ✓ ✗ ✗
View revenue analytics ✓ ✓ ✗ ✗
Receive payouts ✓ ✓ (if split) ✗ ✗
Respond to reviews ✓ ✓ ✗ ✗
Attach products ✓ ✓ ✗ ✗

4. FUNCTIONAL FEATURES

4.1 EVENT CREATION & MANAGEMENT

Event Types Supported

One-Time Event

  • Single date and time
  • Fixed capacity
  • Example: Product launch party, workshop, pop-up

Recurring Series

  • Repeats: Weekly, bi-weekly, monthly
  • Select specific days (Mon, Wed, Fri)
  • End condition: Never / After X times / End date
  • Preview next 6 occurrences
  • Example: Weekly yoga class, monthly networking

Multi-Day Event

  • Multiple consecutive dates
  • Same ticket works for all days
  • Track attendance per day
  • Example: 3-day retreat, festival, conference

Location Options

In-Person Only

  • Google Maps address required
  • Option to hide address until 24-48h before
  • Parking info (optional)
  • Venue capacity limits

Online Only

  • Platform: Zoom / Google Meet / Custom
  • Meeting link revealed after purchase
  • Unlimited or limited capacity
  • Timezone considerations

Hybrid (Physical + Online) - CRITICAL FEATURE

  • Physical ticket: Higher price (e.g., $35)
  • Online ticket: Lower price (e.g., $15)
  • Same event, different experiences
  • Separate capacity limits
  • Different benefits for each type

Hybrid Pricing Logic:

  • Physical attendees get: Full experience, networking, physical gifts, free refreshments
  • Online attendees get: Live stream, Q&A access, recording for 48 hours
  • Host sets different prices to reflect value difference
  • Attendees choose which experience they want

Core Event Fields

Required:

  • Event title (5-100 characters)
  • Cover photo (minimum 1920x1080px)
  • Category (Fitness, Fashion, Food, Art, Music, Learning, Networking, Other)
  • Date & time (with timezone auto-detect)
  • Location (physical address OR online platform)
  • Price (free or minimum $1)
  • Capacity (1-10,000)
  • Gallery (minimum 3 photos: 1 cover + 2 additional)

Optional:

  • Tagline (shown under title)
  • Description (rich text, max 5,000 characters)
  • Tags (#yoga #miami #beachfront)
  • Parking information
  • What to bring
  • Age restrictions
  • Dress code
  • Refund policy

Visibility Settings

Public Event

  • Appears in feed, search, host profile
  • Anyone can find and book
  • SEO indexed for Google search
  • Perfect for: Community events, public workshops

Unlisted Event

Invite-Only Event

  • Host manually invites attendees
  • Each invite has unique link
  • Cannot be shared publicly
  • Perfect for: VIP events, beta testing, exclusive launches
  • Events with 5+ photos get 2.5x more bookings
  • Shows venue, vibe, past events
  • Social proof through user-generated content
  • Helps attendees visualize experience
  • Minimum: 3 photos (1 cover + 2 gallery)
  • Maximum: 10 photos + 2 videos
  • Video length: Max 60 seconds
  • Supported formats: JPG, PNG, MP4
  • Auto-compress and optimize
  • Drag to reorder
  • Add captions (optional)
  • Photo 1: Venue exterior/entrance
  • Photo 2: Interior/space setup
  • Photo 3: Past event crowd (social proof)
  • Photo 4: Host/instructor/speaker
  • Video 1: 30-second event preview

4.2 CO-ORGANIZER SYSTEM

Why Co-Organizers Matter

  • Events need teams (host can't do everything)
  • Clear permission structure prevents conflicts
  • Revenue sharing incentivizes collaboration
  • Multiple scanners speed up check-in

Adding Co-Organizers

Step 1: Search & Select

  • Search by username or email
  • View profile before adding
  • See if they've organized events before

Step 2: Set Permission Level

  • Admin: Full management rights (edit, attendees, analytics)
  • Scanner Only: Check-in access only

Step 3: Configure Revenue Split (Optional)

No Split (Default)

  • Primary host receives 100% of revenue
  • Co-organizer helps for free or separate payment

Percentage Split

  • Example: 70% host / 30% co-organizer
  • Automatically calculated per ticket
  • Both receive separate payouts 48h after event

Fixed Amount per Ticket

  • Example: Co-organizer gets $10 per ticket
  • Host receives remainder after platform fee
  • Good for: Sales commissions, referral fees

Step 4: Send Invitation

  • Co-organizer receives notification
  • Must accept invitation
  • Can decline with message

Co-Organizer Dashboard

What Co-Organizers See:

  • All events they're helping with
  • Their role and permissions
  • Revenue share (if applicable)
  • Upcoming payouts
  • Attendance stats

What They Can Do (Admin Level):

  • Edit event description and details
  • Respond to attendee questions
  • Check-in attendees with scanner
  • View real-time attendance
  • Message all attendees
  • Process refunds
  • View analytics dashboard

What They Cannot Do:

  • Delete the event
  • Change revenue split
  • Remove primary host
  • Add/remove other co-organizers

Revenue Split Examples

Example 1: Fitness Instructor + Studio Owner

  • Event: Yoga workshop ($30 ticket)
  • 20 tickets sold = $600 gross
  • Platform fee (10%): -$60
  • Net revenue: $540
  • Split: 60% instructor ($324) / 40% studio ($216)
  • Both receive separate payouts 48h after class

Example 2: Content Creator + Photographer

  • Event: Photography workshop ($50 ticket)
  • 30 tickets sold = $1,500 gross
  • Platform fee (10%): -$150
  • Net revenue: $1,350
  • Split: Creator gets 100%, photographer paid separately
  • Creator receives full $1,350

Example 3: Brand + Influencer Partnership

  • Event: Product launch party ($25 ticket)
  • 100 tickets sold = $2,500 gross
  • Platform fee (10%): -$250
  • Net revenue: $2,250
  • Split: 50/50 = $1,125 each
  • Both receive equal payouts

4.3 TICKETING SYSTEM

Single vs Multiple Tickets

Single Ticket Purchase

  • Buyer info auto-filled from profile
  • Email sent immediately
  • QR code generated instantly
  • Add to Apple/Google Wallet

Multiple Ticket Purchase

  • Buyer can purchase up to 10 tickets at once
  • Collects name for each attendee
  • Email optional for each ticket
  • Buyer can choose delivery method

Multiple Ticket Purchase Flow

Step 1: Select Quantity

  • "How many tickets?" [−] 3 [+]
  • Total price updates automatically
  • Group discount applied if available

Step 2: Collect Attendee Information

For each ticket, collect:

  • First name (required)
  • Last name (required)
  • Email (optional)
  • Checkbox: "Send ticket to this email"

Ticket 1 (Buyer):

  • Auto-filled from profile
  • Email: emma@email.com (locked)
  • Always receives ticket

Ticket 2:

  • First name: Mike
  • Last name: Torres
  • Email: mike@email.com
  • ☑️ Send ticket to this email

Ticket 3:

  • First name: Sarah
  • Last name: Chen
  • Email: (left blank)
  • ☐ Send ticket to this email

Step 3: Choose Delivery Method

Option A: Email all tickets to me

  • All PDFs sent to buyer's email
  • Buyer forwards to attendees manually
  • Good for: Families, small groups

Option B: Send to each person's email

  • Each attendee receives their own ticket
  • Requires email for each ticket
  • Good for: Corporate events, organized groups

Option C: Download all PDFs now

  • Instant download of all tickets
  • Buyer distributes manually
  • Works offline

Step 4: Payment

  • One payment for all tickets
  • All tickets linked to buyer's account
  • Buyer can manage all tickets

Ticket Structure

Each Ticket Contains:

  • Unique QR code (cryptographically signed)
  • Event name and date
  • Attendee name
  • Ticket number (e.g., "Ticket 1 of 3")
  • Venue address (revealed based on settings)
  • Check-in instructions
  • Ticket type (Physical or Online for hybrid events)

For Hybrid Events:

  • Physical ticket: Shows venue address
  • Online ticket: Shows "Meeting link revealed 1 hour before"
  • Each has unique QR code
  • Different pricing clearly displayed

QR Code System

Why Unique QR per Ticket:

  • Prevents sharing/fraud
  • Tracks exactly who attended
  • Enables personalized experience
  • Works for multi-day events

How It Works:

  • Each ticket = unique cryptographic hash
  • Can be validated offline
  • Signed with secret key
  • Tamper-proof

For Multi-Day Events:

  • Same QR code for all days
  • Scanner tracks scans per day
  • Shows: "Emma - Day 2 of 3"
  • Allows re-entry each day

For Recurring Series:

  • Option 1: One QR for entire series (unlimited pass)
  • Option 2: Separate QR per class (class pack)
  • Scanner shows: "Class 5 of 10 used"

4.4 PRODUCT ATTACHMENT

Why Attach Products to Events

For Hosts:

  • Additional revenue stream
  • Cross-sell complementary products
  • Build product awareness
  • Create exclusive offers

For Attendees:

  • Discover relevant products
  • Event-exclusive discounts
  • Unlock products by attending
  • Complete the experience

Product Attachment Flow

Step 1: Browse Your Products

  • Host selects from their shop
  • Maximum 5 products per event
  • Can mix physical and digital products

Step 2: Set Product Badge

  • 🎫 Available at event: Can purchase on-site
  • ⚡ Event exclusive: Only available to attendees
  • 🎁 Free with ticket: Included in ticket price
  • 💰 Discounted for attendees: Special pricing
  • 🔓 Unlocked after event: Access granted post-event
  • ⏰ Limited time: Available during event only

Step 3: Configure Discount (if applicable)

  • Percentage off (e.g., 15% off)
  • Fixed amount off (e.g., $10 off)
  • Auto-generate discount code
  • Set expiration (e.g., 48 hours after event)

Step 4: Set Availability Timing

  • Before event: Pre-order available
  • During event: Show in event page
  • After event: Unlock for attendees only

Product Display on Event Page

Before Event:

  • Products shown with badges
  • "Available at this event"
  • Pre-order option (if enabled)
  • Shows discount for attendees

During Event:

  • "Available now"
  • Live inventory count
  • Quick purchase from event page
  • Shows who's buying (social proof)

After Event (Attendees Only):

  • Push notification: "You've unlocked 3 exclusive products!"
  • Email with product links
  • Time-limited discount code
  • "Attendee-only" badge

Product Integration Examples

Example 1: Yoga Workshop

  • Event: $35 ticket
  • Attached products:
    • Yoga mat: $65 (15% off = $55.25)
    • Block set: $28 (free with VIP ticket)
    • Water bottle: $15 (available at event)
    • Workshop recording: $10 (unlocked after event)

Example 2: Fashion Pop-Up

  • Event: Free entry
  • Attached products:
    • Limited dress: $189 (event exclusive colorway)
    • Tote bag: $89 (only 20 made, sold at event)
    • Accessories bundle: $45 (15% off for attendees)

Example 3: Food Tasting

  • Event: $20 ticket (includes 3 samples)
  • Attached products:
    • Hot sauce: $12 (free with ticket)
    • Recipe book: $25 (signed at event)
    • Cooking class: $75 (20% off for attendees)

4.5 CHECK-IN SYSTEM

Scanner App Features

Core Functionality:

  • Scan QR codes from phone or printed ticket
  • Works offline (syncs when online)
  • Unlimited simultaneous scanners
  • Real-time updates across devices
  • Manual search by name (if QR fails)

Scanner Interface:

  • Camera viewfinder (full screen)
  • Live count: "42/50 checked in"
  • Flash toggle
  • Switch camera (front/back)
  • Manual search button
  • Attendee list view

Successful Scan Shows:

  • ✓ Check-in successful
  • Attendee name
  • Ticket number
  • Ticket type (Physical/Online)
  • First-time or returning
  • Special notes (VIP, dietary restrictions, etc.)
  • Auto-advances to next scan in 2 seconds

Check-In Scenarios

Normal Check-In:

  • Attendee shows QR code
  • Scanner reads code
  • System validates
  • Shows success message
  • Marks as checked in

Duplicate Attempt:

  • ❌ "Already checked in at 9:45am"
  • Shows who scanned them
  • Option to "Allow re-entry" (if enabled)

Wrong Event:

  • ❌ "This ticket is for Beach Yoga on March 22"
  • Shows correct event details
  • Option to contact host

Refunded/Cancelled:

  • ❌ "Ticket refunded on March 10"
  • Cannot check in
  • Contact host for resolution

Multi-Day Event:

  • ✓ "Welcome back! Day 2 of 3"
  • Shows previous check-in times
  • Allows entry

Offline Mode

How It Works:

  • Scanner downloads attendee list when online
  • Can validate QR codes offline using cryptographic signature
  • Stores check-ins locally
  • Syncs when back online
  • Shows "Offline mode" indicator

Benefits:

  • Works in venues with no WiFi
  • No delays during peak check-in times
  • Zero downtime
  • Perfect for outdoor events

4.6 REVIEW & FEEDBACK SYSTEM

When Reviews Are Collected

Timing Strategy:

  • 2 hours after event ends: Quick rating request (1-5 stars only)
  • 24 hours later: Full review request (text + photos)
  • 1 week later: Final reminder (for non-responders)

Notification Messages:

  • Push notification: "How was Beach Yoga? Rate your experience ⭐"
  • Email: "Share your thoughts and earn 50 points!"
  • In-app banner: Shows after user opens app

Review Collection Form

Quick Rating (Mobile-Optimized):

  • Overall experience: Tap stars (1-5)
  • Optional quick ratings:
    • Venue quality
    • Host/instructor
    • Organization
    • Value for money

Detailed Review (Optional):

  • Text box: "What did you love?" (max 500 characters)
  • Upload photos/videos (max 5 photos or 1 video)
  • Privacy settings:
    • Public review (visible to everyone)
    • Anonymous (hide my name)
    • Private (only host sees it)

Review Incentives:

  • Leave review: 50 points (= $5 credit)
  • Add photos: Bonus 100 points
  • Featured in gallery: +50 points
  • Unlock: 10% off next event from this host

Review Display

On Event Page:

  • Star rating average (e.g., 4.8 out of 5)
  • Total review count (127 reviews)
  • Star distribution bar chart
  • Most mentioned keywords ("great vibes", "amazing instructor")
  • Filter options: Recent / Highest / Lowest / With Photos

Individual Review Card:

  • Reviewer name + photo
  • Star rating
  • Review text
  • Photos/videos attached
  • Date attended
  • "Helpful" button (with count)
  • Host response (if any)

Host Response Feature

Why It Matters:

  • Shows host cares
  • Builds community
  • Addresses concerns publicly
  • Encourages future bookings

Host Response Interface:

  • Notification when new review posted
  • "Respond" button on each review
  • Text box (max 300 characters)
  • Tone suggestions: "Thank them", "Address concern", "Invite back"
  • Shows "Host responded" badge

Response Examples:

  • Positive: "Thank you Emma! So glad you loved it 🙏 See you next Sunday?"
  • Constructive: "Thanks for the feedback! We've added more mats for next time."
  • Issue resolution: "Sorry about the parking! We're now sharing detailed directions 24h before."

4.7 DISCOVERY & FEED INTEGRATION

Event Discovery Methods

Main Feed (Social Commerce Style):

  • Events appear between product listings
  • Personalized algorithm
  • Prioritizes: Friends going, nearby, interests, past behavior

Feed Filters:

  • 🗓️ This weekend
  • 👥 Friends are going (strongest FOMO trigger)
  • 📍 Near me (location-based)
  • 🔄 Recurring classes
  • 🎨 By category (Fitness, Fashion, Food, etc.)
  • 💰 Free events only

Search:

  • Type-ahead suggestions
  • Search by: Name, location, host, category
  • Filter by: Date, price range, capacity
  • Sort by: Relevance, date, distance, popularity

Host Profile:

  • All events by this host
  • Past events (with reviews)
  • Upcoming events
  • Recurring series
  • "Follow" to get notified of new events

Social Proof Triggers

"Friends Going" (Most Powerful):

  • "12 friends are going"
  • Shows friend profile pics
  • Tap to see full list
  • "Sarah, Mike, and 10 others"

Real-Time Activity:

  • "Sarah just bought a ticket"
  • "3 tickets sold in the last hour"
  • "Only 5 spots left!"

Scarcity Indicators:

  • "80% sold out"
  • "Last 10 tickets"
  • Early bird ends in "2 hours"
  • "Selling fast 🔥"

Social Sharing:

  • "I'm going!" post to feed (auto or manual)
  • Share to Instagram Stories
  • Copy link to share anywhere
  • QR code poster (for physical sharing)

5. NON-FUNCTIONAL FEATURES

5.1 Performance Requirements

Speed Targets:

  • Event page load: Under 2 seconds
  • Search results: Under 1 second
  • Scanner response: Under 500ms (scan to confirmation)
  • Image loading: Progressive (thumbnail first, then full)
  • Payment processing: Under 3 seconds

Scalability:

  • Support 10,000 concurrent users browsing
  • Handle 1,000 ticket purchases per minute
  • Process 100,000 QR scans per day
  • Store millions of events without slowdown

Reliability:

  • 99.9% uptime (less than 9 hours downtime per year)
  • Zero data loss
  • Automatic failover for critical systems
  • Real-time backup

5.2 Security Requirements

Payment Security:

  • Never store credit card details
  • PCI DSS compliant
  • Stripe/PayPal integration only
  • 3D Secure support
  • Fraud detection algorithms

QR Code Security:

  • Cryptographically signed
  • Cannot be forged
  • Offline validation support
  • Tamper detection
  • One-time use (default)

Data Protection:

  • All data encrypted at rest
  • HTTPS/TLS for all connections
  • GDPR compliant
  • User data export on request
  • Right to deletion

Account Security:

  • Two-factor authentication (optional)
  • OAuth social login
  • Session management
  • Password strength requirements
  • Suspicious activity alerts

5.3 Usability Requirements

Mobile-First Design:

  • 95% of users on mobile
  • Touch-friendly buttons (minimum 44×44px)
  • Thumb-zone optimization
  • Responsive images
  • Fast loading on 4G

Accessibility:

  • Screen reader support
  • Keyboard navigation
  • High contrast mode
  • Text scaling support
  • Alt text for all images

Internationalization:

  • Multi-language support (Phase 2)
  • Currency conversion
  • Timezone handling (automatic)
  • Date format localization
  • Right-to-left support (Phase 2)

5.4 Reliability Requirements

Error Handling:

  • Clear error messages (no technical jargon)
  • Graceful degradation (if feature fails, others still work)
  • Automatic retry for failed operations
  • Transaction rollback on payment failure
  • Help links in error messages

Data Integrity:

  • No double-booking (atomic transactions)
  • No lost payments
  • Accurate ticket counts
  • Consistent check-in status
  • Audit trail for all money operations

Disaster Recovery:

  • Daily automated backups
  • Point-in-time recovery
  • Multi-region replication
  • Recovery time: Under 4 hours
  • Data loss tolerance: Under 15 minutes

6. COMPLETE USER FLOWS

6.1 HOST CREATES HYBRID EVENT (FULL FLOW)

Step 1: Initiate Creation

  • Click "Create Event" button in navigation
  • Lands on event creation form

Step 2: Upload Media (Required)

  • Drag & drop cover photo OR click to browse
  • System auto-crops to 16:9 ratio
  • Shows preview
  • Add gallery photos (minimum 2 more required)
  • Reorder by dragging
  • Add captions (optional)
  • Upload video (optional, max 60 seconds)

Step 3: Basic Information

  • Event title: "Beach Yoga & Sunset Meditation"
  • Tagline: "2-hour oceanfront session · Every Sunday"
  • Category: Select "Fitness & Wellness"
  • Tags: Add #yoga #miami #beachfront #meditation
  • Description: Rich text editor (add formatting, emojis, links)

Step 4: Choose Event Type

  • Radio buttons:
    • ○ One-time event
    • ● Recurring series ← SELECTED
    • ○ Multi-day event

Step 5: Configure Recurring Pattern

  • Repeats: Select "Every week"
  • Repeats on: Check "Sunday"
  • Time: 5:00 PM
  • End condition: ● No end date ← SELECTED
  • Preview shows: "Next 6 occurrences: Mar 16, Mar 23, Mar 30..."

Step 6: Choose Location Type

  • Radio buttons:
    • ○ In-person only
    • ○ Online only
    • ● Hybrid (both physical and online) ← SELECTED

Step 7: Configure Hybrid Pricing (Critical)

  • Physical Attendance Section:

    • Price: $35 per person
    • Venue: "Miami Beach - Ocean Drive"
    • Address: (Google Maps autocomplete)
    • Capacity: 30 people
    • Hide address until: 24 hours before ← Toggle ON
    • Benefits included:
      • ☑️ In-person instruction
      • ☑️ Yoga mat provided
      • ☑️ Post-session tea & snacks
      • ☑️ Networking opportunity

  • Online Attendance Section:

    • Price: $15 per person
    • Platform: Zoom ← Dropdown
    • Capacity: ● Unlimited ← Radio selected
    • Meeting link revealed: 1 hour before
    • Benefits included:
      • ☑️ Live stream access
      • ☑️ Q&A participation
      • ☑️ Recording access (48 hours)

Step 8: Visibility Settings

  • Radio buttons:
    • ● Public (anyone can find) ← SELECTED
    • ○ Unlisted (link only)
    • ○ Invite-only

Step 9: Attach Products (Optional)

  • Click "+ Add Products"
  • Select from shop:
    • ✓ Premium yoga mat ($65) - Badge: 💰 15% off for attendees
    • ✓ Meditation cushion ($45) - Badge: 🎫 Available at event
    • ✓ Class recording ($10) - Badge: 🔓 Unlocked after attending
  • Set discount codes automatically generated

Step 10: Add Co-Organizer (Optional)

  • Click "+ Add Co-Organizer"
  • Search: @johnsmith
  • Found: John Smith (yoga instructor)
  • Permission level: ● Admin ← SELECTED
  • Revenue split: 70% host / 30% John
  • Send invitation

Step 11: Review & Preview

  • System shows preview of event page
  • Check all details
  • Edit any section by clicking
  • Review pricing summary:
    • Physical: $35 × 30 capacity = $1,050 max
    • Online: $15 × unlimited
    • Platform fee: 10%

Step 12: Publish

  • Click "Publish Event"
  • Event goes live immediately
  • Confirmation message: "Event published! Share it now"
  • Options:
    • Copy link
    • Share to social media
    • Send to contacts
    • Download promotional QR code poster

6.2 ATTENDEE DISCOVERS & PURCHASES TICKETS (FULL FLOW)

Step 1: Browse Feed

  • Open app/website
  • Scroll through personalized feed
  • See event card between product listings
  • Event card shows:
    • Cover photo
    • Event title
    • Date, time, location
    • Price(s) for hybrid
    • "12 friends going" ← Social proof
    • "8/30 spots left" ← Scarcity

Step 2: Click Event Card

  • Lands on event detail page
  • Sees:
    • Large cover photo
    • Gallery carousel (swipe through)
    • Event description
    • Host profile (with follow button)
    • Date, time, location
    • Choose ticket type section

Step 3: Choose Ticket Type (Hybrid Event)

  • Two options presented:

    Option A: Physical Attendance

    • 🏖️ IN-PERSON
    • $35 per ticket
    • "8/30 spots left"
    • Benefits list shown
    • [Select Physical] button

    Option B: Online Attendance

    • 💻 VIRTUAL
    • $15 per ticket
    • "Unlimited spots"
    • Benefits list shown
    • [Select Virtual] button

  • User selects: Physical (taps button)

Step 4: Select Quantity

  • "How many tickets?"
  • Tap [+] button → Shows "2 tickets"
  • Price updates: "$70 total"
  • Shows: "You're bringing a friend! 🎉"

Step 5: Enter Attendee Information

  • Ticket 1 (You):

    • Name: Emma Wilson (auto-filled from profile)
    • Email: emma@email.com (locked)

  • Ticket 2:

    • First name: [Sarah]
    • Last name: [Chen]
    • Email: [sarah@email.com] (optional)
    • Checkbox: ☑️ Send ticket to this email

Step 6: Choose Delivery Method

  • Radio buttons:
    • ○ Email all tickets to me (I'll forward them)
    • ● Send to each person's email ← SELECTED
    • ○ Download all PDFs now

Step 7: Review Order

  • Order summary shows:
    • 2× Physical tickets = $70
    • Platform fee included
    • Total: $70
  • See attached products section:
    • "Get 15% off yoga mat (attendee exclusive)"
    • "Unlock meditation recording after event"

Step 8: Payment

  • Saved payment method shown
  • Or add new card
  • Apply promo code field (optional)
  • Checkbox: ☑️ Agree to refund policy
  • Tap [Complete Purchase - $70]

Step 9: Purchase Confirmation

  • Success screen:
    • ✓ "You're all set!"
    • Event details recap
    • "2 tickets sent to emails"
    • Countdown to event
  • Actions available:
    • [Add to Calendar] (adds to phone calendar)
    • [View Tickets] (shows QR codes)
    • [Share with Friends]
    • [View Location] (if revealed)

Step 10: Receive Tickets

  • Emma's email:

    • Subject: "Your tickets for Beach Yoga - March 16"
    • Body: Event details, both QR codes (PDF attachments)
    • Add to Apple Wallet button
    • Event reminders: 24h before, 2h before

  • Sarah's email:

    • Subject: "Emma bought you a ticket!"
    • Body: Event details, her QR code (PDF attachment)
    • "Emma is bringing you to Beach Yoga 🎉"
    • Add to Apple Wallet button

Step 11: Day Before Event

  • Push notification: "Beach Yoga tomorrow at 5pm!"
  • Venue address revealed (was hidden)
  • Shows: "Miami Beach, 1234 Ocean Drive"
  • Google Maps integration: [Get Directions]
  • Parking info shown
  • What to bring reminder

Step 12: Day of Event - Check-In

  • Arrive at venue
  • Open app → My Tickets
  • Show QR code to scanner
  • Scanner shows: ✓ "Welcome Emma! Enjoy your class"
  • Mat and welcome tea provided
  • Network with other attendees

Step 13: After Event - Review Request

  • 2 hours later: Push notification
    • "How was Beach Yoga? Rate your experience ⭐"
  • Quick rating: Tap 5 stars
  • Earn 50 points

Step 14: Next Day - Product Unlock

  • Push notification: "You've unlocked exclusive access! 🎉"
  • Email shows:
    • Meditation recording: $10 (attendee only)
    • 15% off yoga mat (code: BEACHYOGA15)
    • Valid for 48 hours
  • Tap to shop

Step 15: Join Recurring Series (Optional)

  • See banner: "Join the series - $25/week"
  • Or: "Buy 4-class pack for $90 (save $10)"
  • One-tap purchase for next class

6.3 CO-ORGANIZER HELPS WITH EVENT (FULL FLOW)

Step 1: Receive Invitation

  • Push notification: "Emma invited you to co-organize Beach Yoga"
  • Email with details:
    • Event name and date
    • Your role: Admin
    • Revenue split: 30% per ticket
    • What you can do (edit, check-in, analytics)

Step 2: Accept Invitation

  • Tap notification
  • View event details
  • Review permissions
  • Tap [Accept Invitation]
  • Success: "You're now co-organizing this event!"

Step 3: Access Co-Organizer Dashboard

  • Open app → My Events
  • See tab: Hosting (5) | Co-Organizing (2)
  • Tap Co-Organizing tab
  • See: Beach Yoga - Every Sunday
    • Role: Co-Organizer (Admin)
    • Revenue: 30% per ticket
    • Next class: Sunday 5pm

Step 4: Manage Event Details

  • Tap event
  • Can edit:
    • Description
    • Gallery photos
    • Attached products
    • Attendee messages
  • Cannot edit:
    • Pricing
    • Revenue split
    • Delete event

Step 5: Check-In Attendees (Day of Event)

  • Arrive at venue early
  • Open Scanner app
  • See: "Beach Yoga - March 16"
  • Dashboard shows:
    • 28 tickets sold (24 physical, 4 online)
    • 0 checked in so far
    • Attendee list

Step 6: Scan QR Codes

  • Attendee arrives, shows QR
  • Hold camera to code
  • Scan successful:
    • ✓ "Emma Wilson checked in"
    • "Physical attendance"
    • "First time here! 🎉"
  • Auto-advances to next scan
  • Counter updates: "1/24 checked in"

Step 7: Handle Issues

  • Attendee: "My QR code won't scan"
  • Co-organizer taps [Manual Search]
  • Types "Emma"
  • Finds: Emma Wilson
  • Taps [Check In Manually]
  • Success

Step 8: Monitor Real-Time Stats

  • Dashboard updates live:
    • "15/24 checked in"
    • "9 remaining"
    • Last check-in: 2 minutes ago
  • See list of who's checked in vs not

Step 9: Message Attendees

  • During event: Tap [Message All]
  • Type: "Don't forget to grab your tea at the snack table!"
  • Send to all physical attendees
  • Excludes online attendees

Step 10: After Event - View Analytics

  • Event completed
  • Access analytics:
    • Total attendance: 22/24 showed up (92%)
    • 4 online attendees joined
    • Revenue: $700 gross
    • Platform fee: $70
    • Net: $630
    • Your share: $189 (30%)
    • Host share: $441 (70%)

Step 11: Receive Payout

  • 48 hours after event
  • Push notification: "Your payout is ready!"
  • $189 deposited to your account
  • Can withdraw to bank
  • View transaction history

6.4 HOST RESPONDS TO REVIEWS (FULL FLOW)

Step 1: Receive Review Notification

  • Push notification: "Emma left a 5-star review!"
  • Email summary of review

Step 2: View Review

  • Open app → My Events → Beach Yoga
  • Tap "Reviews" tab
  • See new review:
    • Emma Wilson ⭐⭐⭐⭐⭐
    • "The sunrise session was magical! Perfect music, amazing energy..."
    • 📸 3 photos attached
    • Posted: 2 hours ago

Step 3: Read Full Review

  • Tap review to expand
  • Read complete text
  • View photos Emma uploaded
  • See: "12 people found this helpful"

Step 4: Write Response

  • Tap [Respond] button
  • Text box appears
  • Suggested responses shown:
    • "Thank them warmly"
    • "Invite them back"
    • "Address specific points"

Step 5: Submit Response

  • Type: "Thank you so much Emma! 🙏 Your energy was beautiful. Hope to see you next Sunday!"
  • Character count: 87/300
  • Tap [Post Response]

Step 6: Response Published

  • Appears under Emma's review:
    • ↳ SunStudio (Host) "Thank you so much Emma! 🙏 Your energy was beautiful. Hope to see you next Sunday!"
      • 2 minutes ago
  • Emma receives notification

Step 7: Track Review Impact

  • Analytics show:
    • Avg rating improved: 4.7 → 4.8
    • Conversion rate increased: +8%
    • "Reviews mentioning instructor: +15%"

6.5 ATTENDEE TRANSFERS TICKET (FULL FLOW)

Step 1: Can't Attend

  • Original attendee (Emma) realizes she can't go
  • Opens app → My Tickets
  • Finds: Beach Yoga - March 16
  • Taps ticket

Step 2: Initiate Transfer

  • Taps [Transfer Ticket]
  • Warning: "This will send your ticket to someone else"
  • Checkbox: ☑️ I understand this ticket will no longer be mine

Step 3: Enter Recipient Info

  • Enter friend's details:
    • Name: Lisa Martinez
    • Email: lisa@email.com (optional)
    • Phone: (optional)
  • Add personal message:
    • "Can't make it, hope you enjoy! 🧘‍♀️"

Step 4: Choose Transfer Method

  • Radio buttons:
    • ● Email the ticket to Lisa
    • ○ Generate transfer link (I'll send it)
    • ○ Transfer to Nexgate user @lisamartinez

Step 5: Confirm Transfer

  • Review:
    • Transferring to: Lisa Martinez
    • Event: Beach Yoga - March 16
    • Your ticket will be deactivated
  • Tap [Confirm Transfer]

Step 6: Transfer Complete

  • Success message
  • Emma's QR code deactivated
  • Lisa receives email:
    • "Emma transferred a ticket to you!"
    • Event details
    • New unique QR code (different from Emma's)
    • Add to calendar button

Step 7: System Updates

  • Host dashboard updated:
    • Attendee list shows: Lisa Martinez (transferred from Emma)
    • Scanner will recognize Lisa's QR code
    • Emma's old QR code marked invalid

Step 8: Check-In Day

  • Lisa arrives with new QR code
  • Scanner reads it
  • Shows: ✓ "Lisa Martinez - Transferred ticket"
  • Successful entry

7. BUSINESS RULES

7.1 Payment & Payout Rules

Ticket Purchase:

  • Payment charged immediately
  • Funds held in escrow
  • Cannot be released until event completes
  • Buyer receives instant confirmation

48-Hour Payout Rule:

  • Payout scheduled: Event end time + 48 hours
  • Applies to all event types (one-time, recurring, multi-day)
  • For multi-day: Payout after final day + 48 hours
  • For recurring: Payout 48h after each class
  • Weekends don't delay payout (automated)

Platform Fee:

  • 10% of ticket price
  • Deducted from gross revenue
  • Covers payment processing, hosting, support
  • Transparent in all calculations
  • No hidden fees

Revenue Split (with Co-Organizers):

  • Calculated on NET revenue (after platform fee)
  • Example: $100 ticket
    • Platform fee: $10
    • Net: $90
    • If 70/30 split: Host gets $63, Co-organizer gets $27
  • Each person receives separate payout
  • Both deposited simultaneously

Refund Policy:

  • Host sets refund deadline (e.g., "Full refund until 24h before")
  • Options:
    • Full refund anytime
    • Full refund until X days/hours before
    • Partial refund (e.g., 50% after deadline)
    • No refunds
  • Refunds processed within 5-7 business days
  • Platform fee non-refundable (host absorbs cost)

Failed Events:

  • If event cancelled by host: Full automatic refunds
  • If event cancelled by platform: Full automatic refunds
  • Refund includes platform fee (we absorb cost)
  • No payout to host for cancelled events

7.2 Capacity & Availability Rules

Hard Capacity Limits:

  • System prevents overselling
  • When capacity reached: "Sold Out" shown
  • Atomic transactions (no race conditions)
  • Waitlist option for sold-out events

Hybrid Event Capacity:

  • Physical and online tracked separately
  • Example: 30 physical, unlimited online
  • Physical sells out → Online still available
  • Clear separation in UI

Recurring Series:

  • Each occurrence has own capacity
  • Can be different per class
  • Example: Monday (30 spots), Wednesday (40 spots)
  • Overselling one class doesn't affect others

Waitlist (Phase 2):

  • Automatic when event sells out
  • Join waitlist button
  • If spot opens: Auto-notify in order
  • 24-hour claim window

7.3 Ticket Validation Rules

QR Code Scanning:

  • Each QR code is unique per ticket
  • Default: One-time scan only
  • Multi-day events: Multiple scans allowed
  • Recurring series: One scan per class
  • System tracks all scan attempts

Duplicate Scan Prevention:

  • Shows: "Already checked in at 9:45am"
  • Option to allow re-entry (host setting)
  • Tracks who scanned them
  • Logs all attempts

Offline Validation:

  • Scanner downloads attendee list when online
  • Cryptographic signature validates QR offline
  • Syncs check-ins when back online
  • Works perfectly without internet

Transferred Tickets:

  • Original QR code invalidated
  • New QR code generated for recipient
  • System tracks transfer history
  • Scanner recognizes new attendee

7.4 Privacy & Data Rules

Address Hiding:

  • Host can hide venue address
  • Options:
    • Always visible
    • Hidden until 24 hours before
    • Hidden until 48 hours before
    • Hidden until after purchase
  • Prevents venue crashes for popular events
  • Good for exclusive/private events

Attendee Data Access:

  • Host sees: Names, emails, ticket types
  • Co-organizer (Admin) sees: Same as host
  • Co-organizer (Scanner) sees: Names only
  • Attendees see: Nothing about other attendees (unless host enables)

Data Export:

  • Host can export attendee CSV
  • Includes: Name, email, ticket type, check-in status
  • GDPR compliant
  • Cannot be used for spam (terms violation)

Review Privacy:

  • Attendees choose:
    • Public (visible to all)
    • Anonymous (name hidden)
    • Private (host only)
  • Cannot change after posting
  • Host responses always public

7.5 Event Status Rules

Draft:

  • Not visible to public
  • Host can edit freely
  • No tickets sold
  • Can save and return later

Published:

  • Visible based on visibility settings
  • Tickets can be purchased
  • Host can still edit (with limitations)
  • Cannot unpublish once tickets sold

Cancelled:

  • No new tickets sold
  • Automatic refunds processed
  • Remains visible with "Cancelled" badge
  • Reviews still visible (for transparency)

Completed:

  • Event date has passed
  • No new tickets sold
  • Payout scheduled/processed
  • Reviews can be left
  • Remains visible with past event badge

8. SUCCESS METRICS

8.1 Platform-Level Metrics

Growth Metrics:

  • Total events created per month
  • Active hosts (created event in last 30 days)
  • Total tickets sold
  • Gross Merchandise Value (GMV)
  • Month-over-month growth rate

Engagement Metrics:

  • Event page views
  • Conversion rate (view → purchase)
  • Average tickets per purchase
  • Social shares per event
  • "Friends going" click-through rate

Quality Metrics:

  • Average event rating (target: 4.5+)
  • Host retention rate (host 2nd event)
  • Attendee return rate (attend another event)
  • Review completion rate (target: 40%+)

Revenue Metrics:

  • Platform fee revenue
  • Average ticket price
  • Revenue per host
  • Payment success rate (target: 98%+)

8.2 Feature-Specific Metrics

Hybrid Events:

  • % of events that are hybrid
  • Physical vs online ticket ratio
  • Online attendance rate (joined livestream)
  • Revenue difference (physical vs online)

Co-Organizer Feature:

  • % of events with co-organizers
  • Average team size
  • Co-organizer retention rate
  • Revenue split adoption rate

Product Attachment:

  • % of events with attached products
  • Product click-through rate from events
  • Conversion rate (event → product purchase)
  • Average order value (event attendees vs non-attendees)

Scanner Performance:

  • Average scan time (target: <2 seconds)
  • Offline mode usage rate
  • Check-in error rate (target: <1%)
  • Multiple scanner adoption

Review System:

  • Review submission rate (target: 40%+)
  • Average review length (words)
  • Photo/video attachment rate
  • Host response rate (target: 60%+)

8.3 User Satisfaction Metrics

Host Satisfaction:

  • Net Promoter Score (NPS)
  • Time to first event
  • Support ticket volume
  • Payout satisfaction rating
  • Feature request votes

Attendee Satisfaction:

  • Event rating distribution
  • Ticket transfer rate (lower is better)
  • Refund request rate (lower is better)
  • Repeat attendance rate
  • Social sharing rate

Co-Organizer Satisfaction:

  • Invitation acceptance rate
  • Permission clarity score
  • Payout satisfaction
  • Conflict/dispute rate (target: <0.5%)

9. INTEGRATION POINTS

9.1 Social Commerce Integration

Product → Event Connection:

  • Product page shows: "Meet the creator at Beach Yoga"
  • "Available at this event" badge
  • One-click to view event
  • Bundle: Buy product + event ticket

Event → Product Connection:

  • Event page shows attached products
  • "Shop the look" section
  • Attendee-exclusive discounts
  • Post-event product unlock

Feed Integration:

  • Events appear between products
  • Same card design language
  • Unified discovery experience
  • Cross-promotion opportunities

9.2 Calendar Integration

Add to Calendar:

  • Apple Calendar
  • Google Calendar
  • Outlook
  • Download .ics file
  • Automatic reminders set

Recurring Event Sync:

  • All occurrences added automatically
  • Updates sync if event changes
  • Cancellations propagate
  • Time zone handling

9.3 Payment Integration

Supported Methods:

  • Credit/debit cards (Stripe)
  • Apple Pay
  • Google Pay
  • PayPal (Phase 2)
  • Buy Now Pay Later (Phase 2)

Payout Methods:

  • Bank transfer (ACH)
  • Debit card instant payout (+1% fee)
  • PayPal (Phase 2)
  • International wire (Phase 2)

9.4 Communication Integration

Email:

  • Ticket delivery
  • Event reminders (24h, 2h before)
  • Review requests
  • Host notifications
  • Payout confirmations

Push Notifications:

  • Friend activity ("Sarah is going")
  • Event reminders
  • Check-in success
  • Review incentives
  • Payout ready

SMS (Optional):

  • Ticket delivery backup
  • Critical reminders
  • Address reveal
  • Last-minute changes

9.5 Social Media Integration

Sharing:

  • Share event to Instagram Stories
  • Post to Facebook
  • Tweet about event
  • Copy link
  • QR code poster generation

Social Proof:

  • Import friends from social platforms
  • Show who's attending
  • Cross-platform event discovery
  • Social login (OAuth)

10. IMPLEMENTATION PRIORITIES

Phase 1: MVP Launch (Months 1-3)

Must-Have Features:

  1. Event creation (one-time + recurring)
  2. Hybrid pricing (physical + online)
  3. Multiple ticket purchase with name collection
  4. Unique QR per ticket
  5. Gallery (minimum 3 photos required)
  6. Scanner app (offline capable)
  7. 48-hour payout system
  8. Basic review system
  9. Product attachment (up to 5)
  10. Public/unlisted visibility
  11. Feed integration
  12. Basic co-organizer (Admin level only)

Success Criteria:

  • 50 events created
  • 500 tickets sold
  • 4.0+ average event rating
  • <5% refund rate
  • 95%+ scanner success rate

Phase 2: Enhanced Features (Months 4-6)

Add:

  1. Co-organizer scanner-only role
  2. Revenue split automation
  3. Invite-only events
  4. Multi-day events
  5. Waitlist system
  6. Advanced review filters
  7. Host response to reviews
  8. Ticket transfer
  9. Event analytics dashboard
  10. Attendee messaging

Success Criteria:

  • 200 events created
  • 20% use co-organizer feature
  • 10% are hybrid events
  • 50%+ review submission rate

Phase 3: Scale & Optimize (Months 7-12)

Add:

  1. Class packs (10-class bundles)
  2. Monthly unlimited passes
  3. Advanced analytics
  4. Automated marketing tools
  5. International currency support
  6. Multiple languages
  7. Advanced permissions
  8. Custom branding (premium)
  9. White-label options (enterprise)
  10. API for third-party integrations

Success Criteria:

  • 1,000+ events per month
  • 50,000+ tickets sold
  • 4.5+ average rating
  • 70%+ host retention
  • Profitable platform economics

11. RISK MITIGATION

Technical Risks

Risk: QR Code Fraud

  • Mitigation: Cryptographic signing, one-time use, offline validation
  • Monitoring: Track duplicate scan attempts
  • Response: Automatic flagging system

Risk: Payment Processing Failures

  • Mitigation: Redundant payment processors, automatic retry
  • Monitoring: Real-time success rate dashboard
  • Response: Instant customer support notification

Risk: Scanner Offline Failures

  • Mitigation: Offline-first design, local storage, sync when online
  • Monitoring: Track offline usage patterns
  • Response: Manual check-in backup process

Business Risks

Risk: Low Host Adoption

  • Mitigation: 48-hour payout USP, low fees, easy setup
  • Monitoring: Time-to-first-event metric
  • Response: Onboarding improvements, host incentives

Risk: Fraud/Chargebacks

  • Mitigation: Escrow system, attendance verification, clear policies
  • Monitoring: Chargeback rate (<0.5%)
  • Response: Dispute resolution team

Risk: Competition

  • Mitigation: Social commerce integration (unique moat)
  • Monitoring: Feature parity analysis
  • Response: Innovate faster, deepen integrations

Legal/Compliance Risks

Risk: GDPR/Privacy Violations

  • Mitigation: Privacy-by-design, data minimization, consent flows
  • Monitoring: Regular audits
  • Response: Legal team, data protection officer

Risk: Payment Regulations

  • Mitigation: PCI DSS compliance, licensed partners
  • Monitoring: Quarterly compliance checks
  • Response: Update processes immediately

12. CONCLUSION

What Makes Nexgate Events Different

The Unique Formula:

Social Commerce + Events + Community = Network Effects

Why It Works:

  1. Events drive product discovery
  2. Products drive event attendance
  3. Community drives both
  4. Every interaction strengthens the network

The Flywheel:

Host creates event 
→ Attaches products 
→ Shares to social feed 
→ Friends see & attend 
→ Buy attached products 
→ Leave reviews 
→ More social proof 
→ More attendees 
→ Host creates more events 
→ REPEAT

Success Formula

For Hosts:

  • 48-hour payout = trust
  • Co-organizers = scale
  • Product integration = additional revenue
  • Social discovery = free marketing

For Attendees:

  • Find events through friends (not ads)
  • One QR for all tickets
  • Exclusive product access
  • Seamless experience

For Platform:

  • 10% take rate on growing GMV
  • Network effects compound
  • High retention on both sides
  • Defensible moat through integration

Next Steps

  1. Validate MVP with 10 pilot hosts
  2. Build core features (Months 1-3)
  3. Launch beta to 100 hosts
  4. Iterate based on feedback
  5. Scale to 1,000+ hosts
  6. Become the #1 social commerce event platform

END OF DOCUMENT

This is a living document. Update as features evolve and user feedback is collected.

Last updated: [Date] Version: 1.0 Owner: Product Team

Back to top