================================================================================
  meBUY PROMOTER TUTORIAL — Live Sessions, Referrals & Commissions
================================================================================

  URL:       http://localhost/mebuy/public/promoter/dashboard
  Login:     Promoter account credentials (email + password)
  Role:      promoter

================================================================================
  1. GETTING STARTED
================================================================================

  1.1 Becoming a Promoter
  ─────────────────────────
    • Register as a customer first
    • Contact admin to upgrade your account to promoter role
    • Once approved, you can access the promoter panel

  1.2 Promoter Dashboard
  ─────────────────────────
  URL: /promoter/dashboard

    • Active Sessions — Currently running live sessions
    • Total Sessions — All sessions you've created
    • Chats — Customer conversations
    • Total Viewers — Cumulative session viewers
    • Commissions — Total earnings from referrals
    • Referral Code — Your unique referral code (PROM-XXXXX)
    • Referral Link — Shareable link to refer customers
    • Charts — 30-day session and viewer trends
    • Top Products — Most promoted products by views

================================================================================
  2. LIVE SESSIONS
================================================================================

  Navigate to: Live Sessions (sidebar)

  2.1 What Are Live Sessions?
  ────────────────────────────
    • Live streaming sessions where you promote products
    • Customers watch, ask questions, and purchase during the session
    • Each session is tied to specific products

  2.2 Creating a Session
  ────────────────────────
    • Click "Create Session"
    • Fill in:
      - Title — Name of your live session
      - Description — What the session covers
      - Products — Select products to promote
      - Scheduled Date/Time — When the session starts
      - Cover Image — Thumbnail for the session
    • Click "Save"

  2.3 Managing Sessions
  ────────────────────────
    • View all your sessions (past, current, and scheduled)
    • Start Session — Begin a scheduled session
    • End Session — Stop a running session
    • Edit — Modify session details
    • Delete — Remove a session

  2.4 Session Statuses
  ─────────────────────
    • scheduled — Upcoming session
    • live — Currently streaming
    • ended — Session completed
    • cancelled — Session cancelled

================================================================================
  3. CHAT SYSTEM
================================================================================

  Navigate to: Chats (sidebar)

    • Message customers interested in your promotions
    • Answer questions about products
    • View conversation history
    • Start new conversations with customers
    • Clear chat history when needed

================================================================================
  4. REFERRALS & COMMISSIONS
================================================================================

  4.1 Your Referral Code
  ────────────────────────
    • Every promoter gets a unique referral code (e.g., PROM-XXXXX)
    • Your referral link: /?ref=PROM-XXXXX
    • Share this link on social media, WhatsApp, etc.
    • When a customer clicks and makes a purchase, you earn commission

  4.2 How Referrals Work
  ────────────────────────
    • A customer clicks your referral link
    • The referral is tracked via a cookie
    • When the customer completes a purchase, a commission is recorded
    • Commission percentage is configured by admin
    • Referral commissions appear in your dashboard

  4.3 Viewing Commissions
  ─────────────────────────
    • Dashboard shows total commissions earned
    • Referral commissions list with customer details
    • Commission amounts and status

================================================================================
  5. WALLET
================================================================================

  Navigate to: Wallet (sidebar)

    • Balance — Current available funds
    • Deposit — Add funds to your wallet
    • Withdraw — Withdraw funds from your wallet
    • Send — Transfer funds to another user
    • Account Details — Manage bank/mobile money details
    • Search User — Find other users to send funds

================================================================================
  6. PAYOUTS
================================================================================

  Navigate to: Payouts (sidebar)

  6.1 Payout Dashboard
  ──────────────────────
    • Current wallet balance
    • Total earned
    • Total withdrawn
    • Pending withdrawals

  6.2 Withdrawing Earnings
  ─────────────────────────
    • Click "Withdraw Funds"
    • Enter the amount
    • Select withdrawal method:
      - Bank Transfer
      - Mobile Money
      - Wallet Transfer
    • Submit withdrawal request

  6.3 Withdraw to Wallet
  ────────────────────────
    • Instantly transfer your promoter earnings to your platform wallet
    • Funds become available immediately for use

  6.4 Withdrawal History
  ────────────────────────
    • View all past withdrawal requests
    • Track status: pending → approved/rejected

================================================================================
  7. ANALYTICS
================================================================================

  Navigate to: Analytics (sidebar)

    • Session Performance — Views, engagement, duration
    • Commission Reports — Earnings broken down by period
    • Referral Statistics — How many customers you've referred
    • Product Insights — Which products get the most views

================================================================================
  8. NOTIFICATIONS
================================================================================

    • Bell icon in the header shows unread notifications
    • Get notified of new messages and updates
    • Click to mark as read
    • Polls regularly for new notifications

================================================================================
  9. TIPS FOR SUCCESS
================================================================================

  • Share your referral link everywhere — social media, WhatsApp, email
  • Create engaging live sessions to attract viewers
  • Promote high-demand products for better commissions
  • Respond to customer chats promptly
  • Check analytics to see what's working
  • Run regular live sessions to build an audience