IQ Points

​

Overview

​

Earning IQ Points

​

Action Rewards

​

Earning Rules

• Daily earning cap: 500 IQ Points per day from non-referral actions (prevents farming)
• Referral daily cap: 1,000 IQ Points per day from referral-related actions
• No double-dipping: An action that triggers both a badge and a direct reward gives the badge points only (the higher value)
• Streak multiplier: A 30-day login streak earns 2x points on all actions for the next 7 days
• Points are permanent: Earned IQ Points never expire. Spent points are deducted from the balance.

​

IQ Store

​

Store Items

​

Store Rules

• Cosmetics only — No subscription features are purchasable with IQ Points. Ever.
• Permanent unlocks — All items are permanent once purchased (no rentals, no expiration)
• No real money — IQ Points cannot be purchased with real money. This is non-negotiable.
• Refundable — Items can be refunded within 7 days for full IQ Points back (one refund per item)
• Limited editions — Some items are time-limited (e.g., “Founding Member” title). Once the window closes, the item is gone forever.

​

User Value

​

How It Works

​

Technical Approach

​

Data Model (Convex)

iq_points
  - userId: Id<"users">
  - balance: number
  - lifetimeEarned: number
  - lifetimeSpent: number
  - lastUpdated: number

iq_transactions
  - userId: Id<"users">
  - type: "earn" | "spend" | "refund"
  - amount: number
  - source: string (e.g., "order_upload", "label_scan", "referral_signup", "store_purchase")
  - metadata: object (e.g., { orderId, badgeId, storeItemId })
  - createdAt: number

iq_store_items
  - itemId: string (unique key)
  - category: "profile" | "content" | "status"
  - name: string
  - description: string
  - price: number
  - isLimited: boolean
  - availableUntil?: number
  - maxPurchases: number (usually 1)

iq_purchases
  - userId: Id<"users">
  - itemId: string
  - purchasedAt: number
  - refundedAt?: number

​

Key Mutations

​

Architecture Considerations

• Real-time balance — Convex’s real-time sync means the IQ Point balance updates instantly across all screens when points are earned. No polling, no refresh needed.
• Transaction log — Every point earned and spent is logged as an immutable transaction. This enables full audit trails and makes disputes resolvable.
• Cap enforcement — Daily caps are enforced at the mutation level using date-bucketed counters. Attempting to earn beyond the cap silently succeeds (the action completes) but awards zero points.
• Streak tracking — Login streaks are tracked via a last_active_date field. A gap of more than 24 hours resets the streak counter. The 30-day multiplier is applied as a 2x modifier in the earnPoints mutation.

​

Tier Impact

​

Dependencies

• Badge system with rarity levels — built and live (triggers badge-earned points)
• Order import — built and live (triggers order upload points)
• Label scanner — built and live (triggers scan points)
• Share Cards (Phase 1) — triggers share points
• Referral System (Phase 2) — triggers referral points (the largest earning action)
• Convex tables for IQ Points (iq_points, iq_transactions, iq_store_items, iq_purchases)
• IQ Point balance UI (profile badge, balance screen)
• IQ Store screen with item browser and purchase flow
• Daily cap enforcement logic
• Streak tracking and multiplier system
• Transaction history feed

​

Open Questions

1. Complexity timing — Is a full points economy too complex for early-stage growth? An alternative is to launch with badges + cosmetic rewards only (no points), and introduce IQ Points later when the user base is larger. The risk of launching too early is that the economy feels empty; the risk of launching too late is that early users miss the earning window.
2. Earning rate calibration — The proposed rates are educated guesses. What is the right “time to first meaningful purchase”? 6-8 weeks feels right, but testing may reveal that users need faster gratification.
3. Store item freshness — How often should new items be added to the IQ Store? Monthly drops? Seasonal? User-requested items?
4. Inflation control — As users accumulate more points over time, do we need to increase store prices or introduce point sinks? A “prestige reset” mechanic (trade all points for a rare title) could help.
5. Daily cap communication — Should users see “you’ve hit today’s earning cap” or should the cap be invisible? Transparency builds trust but may frustrate power users.

​

Related Features

• Referral System — The primary high-value IQ Point earning channel
• Community Badges — Badge earned events trigger IQ Point awards
• Challenges & Leaderboards — Monthly challenges award bonus IQ Points
• Cannabis Personality — Personality card generation could cost or earn IQ Points