> ## Documentation Index
> Fetch the complete documentation index at: https://docs.highailabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Future Feature Flows

> Projected user flows for planned features — health sync, session journal, AI media, share cards, referrals, challenges, and more from the roadmap.

## Overview

This page documents projected user flows for features on the High IQ roadmap. These flows represent design-phase thinking and will evolve as features move into development. They are organized by roadmap phase to show how the product experience will expand over time.

## Phase 1: Share Cards

```mermaid theme={null}
graph TD
    A[User Viewing Content] --> B{Shareable Content Type}

    B -->|Notebook| C[Notebook Share Card]
    B -->|Order Recap| D[Order Share Card]
    B -->|Strain Discovery| E[Strain Share Card]
    B -->|Achievement| F[Achievement Share Card]
    B -->|Monthly Stats| G[Stats Share Card]

    C --> H[Generate Branded Image]
    D --> H
    E --> H
    F --> H
    G --> H

    H --> I[iOS Share Sheet]
    I --> I1[iMessage]
    I --> I2[Instagram Stories]
    I --> I3[Twitter/X]
    I --> I4[Save to Photos]
    I --> I5[Copy Link]

    I --> J[Deep Link Embedded]
    J --> K[Recipient Taps Link]
    K --> L{Has App?}
    L -->|Yes| M[Opens to Content]
    L -->|No| N[App Store Page]
```

## Phase 2: Referral System

```mermaid theme={null}
sequenceDiagram
    participant R as Referrer
    participant App as High IQ
    participant DB as Backend
    participant N as New User

    R->>App: Open Invite Friends screen
    App->>DB: Generate unique referral code
    DB-->>App: Code + deep link

    R->>N: Share referral link
    N->>App: Click link → App Store
    N->>App: Download + open app

    App->>DB: Check referral code
    DB-->>App: Valid referral
    N->>App: Create account

    App->>DB: Credit referrer
    DB-->>R: Reward notification
    App->>DB: Credit new user
    DB-->>N: Welcome bonus

    Note over R,N: Tiered rewards based on referred users' activity
```

### Referral Reward Tiers

```mermaid theme={null}
graph TD
    A[Referral Signed Up] --> B[Base Reward]
    B --> B1[Referrer: 100 IQ Points]
    B --> B2[New User: 50 IQ Points]

    A --> C{New User Activity}
    C -->|First Order| D[Activity Bonus]
    D --> D1[Referrer: 200 IQ Points]

    C -->|Subscribe to Pro| E[Conversion Bonus]
    E --> E1[Referrer: 500 IQ Points]
    E --> E2[1 Month Free Extension]

    C -->|5 Referrals Total| F[Referrer Milestone]
    F --> F1[Community Badge: Connector]
```

## Phase 3: Session Journal

```mermaid theme={null}
graph TD
    A[User Wants to Log Session] --> B[Open Session Logger]
    B --> C[Select Strain from Stash]
    C --> D[Set Session Details]

    D --> D1[Consumption Method]
    D1 --> D1a[Smoke / Vape / Edible / Dab / Tincture]

    D --> D2[Dosage Amount]
    D --> D3[Time of Day]
    D --> D4[Setting / Context]
    D4 --> D4a[Social / Solo / Work / Exercise / Sleep]

    D --> E[Pre-Session Mood]
    E --> E1[Scale 1-10 + Tags]

    C --> F[Consume Strain]

    F --> G[Post-Session Check-In]
    G --> G1[Effects Felt]
    G1 --> G1a[Relaxed / Focused / Creative / Sleepy / Anxious...]
    G --> G2[Intensity Rating]
    G --> G3[Duration]
    G --> G4[Post-Session Mood]
    G --> G5[Notes]

    G --> H[Session Logged]
    H --> I[Stash Quantity Updated]
    H --> J[Stats Updated]
    H --> K[Pattern Data Collected]
    K --> L[AI Learns Preferences]
```

## Phase 4: Health Sync

```mermaid theme={null}
graph TD
    A[Enable Health Sync] --> B{Provider Selection}

    B -->|Apple Health| C[HealthKit Integration]
    C --> C1[Read: Sleep, HRV, Steps, Heart Rate]

    B -->|Oura Ring| D[Oura API]
    D --> D1[Read: Sleep Stages, Readiness, HRV]

    B -->|Eight Sleep| E[Eight Sleep API]
    E --> E1[Read: Sleep Quality, Bed Temperature]

    B -->|Google Fit| F[Google Fit API]
    F --> F1[Read: Activity, Sleep, Heart Rate]

    C1 --> G[Correlation Engine]
    D1 --> G
    E1 --> G
    F1 --> G

    G --> H[Cannabis × Health Insights]
    H --> H1[Indicas hurt my REM sleep]
    H --> H2[Limonene strains improve my mood]
    H --> H3[Evening use drops next-day HRV]

    H --> I[Personalized Recommendations]
    I --> I1[Avoid terpinolene after 10pm]
    I --> I2[Myrcene strains improve your sleep]
    I --> I3[Your optimal window is 6-8pm]
```

### Health Correlation Flow

```mermaid theme={null}
sequenceDiagram
    participant U as User
    participant App as High IQ
    participant Health as Health Provider
    participant AI as AI Engine

    App->>Health: Fetch last 7 days of health data
    Health-->>App: Sleep, HRV, activity data

    App->>App: Match health data with consumption logs
    App->>AI: Analyze correlations

    AI-->>App: Correlation insights

    App->>U: Display Health Insights Card
    Note over App,U: "Last Tuesday you used Blue Dream at 9pm. Your deep sleep was 22% below average that night."

    App->>U: Display Recommendations
    Note over App,U: "Try switching to a myrcene-dominant strain for evening use."
```

## Phase 5: IQ Points Economy

```mermaid theme={null}
graph TD
    A[User Actions] --> B{Point-Earning Activities}

    B -->|Upload Order| C[+50 IQ Points]
    B -->|Generate Notebook| D[+100 IQ Points]
    B -->|Complete Ranking| E[+25 IQ Points]
    B -->|Scan Label| F[+30 IQ Points]
    B -->|Refer Friend| G[+100 IQ Points]
    B -->|Share Card| H[+20 IQ Points]
    B -->|Daily Login| I[+10 IQ Points]

    C --> J[IQ Points Balance]
    D --> J
    E --> J
    F --> J
    G --> J
    H --> J
    I --> J

    J --> K[IQ Store]
    K --> K1[Custom Themes]
    K --> K2[Profile Cosmetics]
    K --> K3[Bonus AI Credits]
    K --> K4[Exclusive Card Variants]
    K --> K5[Badge Frames]

    style J fill:#fef3c7
```

## Phase 6: Cannabis Personality

```mermaid theme={null}
graph TD
    A[Month Ends] --> B[Analyze Month's Data]
    B --> C[Consumption Patterns]
    C --> C1[Strain Types Ratio]
    C --> C2[Terpene Preferences]
    C --> C3[Time-of-Day Patterns]
    C --> C4[Effect Preferences]

    C --> D[Generate Personality Type]
    D --> D1[The Explorer: Diverse strain types]
    D --> D2[The Ritualist: Consistent routines]
    D --> D3[The Healer: Wellness-focused]
    D --> D4[The Socialite: Social consumption]
    D --> D5[The Night Owl: Evening dominant]
    D --> D6[The Connoisseur: Terpene-focused]

    D --> E[Monthly Personality Card]
    E --> F[Shareable Image]
    F --> G[Share to Social]

    E --> H[Personality History]
    H --> I[Track Changes Over Time]
```

## Phase 7: AI-Generated Media

```mermaid theme={null}
graph TD
    A[Notebook Generated] --> B{Media Generation Options}

    B --> C[AI Podcast]
    C --> C1[Source-Grounded Two-Host Conversation]
    C --> C2[Two AI Hosts Discuss Your Strains]
    C --> C3[5-10 Minute Episode]

    B --> D[Video Report]
    D --> D1[AI-Generated Visuals]
    D --> D2[Voiceover Narration]
    D --> D3[60-90 Second Summary]

    B --> E[Strain Art]
    E --> E1[Custom AI Artwork Per Strain]
    E --> E2[Style Matching Strain Character]
    E --> E3[Downloadable + Shareable]

    B --> F[Session Music]
    F --> F1[AI Soundtrack Per Strain]
    F --> F2[Mood-Matched to Terpene Profile]
    F --> F3[Background Listening]

    C1 --> G[Media Library in Notebook]
    D1 --> G
    E1 --> G
    F1 --> G

    G --> H[Share Individual Media]
    H --> I[Social Sharing with Branding]
```

## Phase 8: Challenges & Leaderboards

```mermaid theme={null}
graph TD
    A[Monthly Challenge Announced] --> B{Challenge Types}

    B -->|Variety Challenge| C[Try 10 New Strains]
    B -->|Explorer Challenge| D[Visit 3 New Dispensaries]
    B -->|Streak Challenge| E[30-Day Activity Streak]
    B -->|Social Challenge| F[Refer 5 Friends]
    B -->|420 Special| G[Seasonal Event]

    C --> H[Opt-In to Challenge]
    D --> H
    E --> H
    F --> H
    G --> H

    H --> I[Track Progress]
    I --> J[Leaderboard Position]
    J --> K{Challenge Complete?}

    K -->|Yes| L[Exclusive Badge]
    L --> M[IQ Points Bonus]
    M --> N[Leaderboard Recognition]

    K -->|No| O[Continue or Give Up]
    O --> O1[No penalty for giving up]
```

## Smart Suggestions Flow (Future)

```mermaid theme={null}
graph TD
    A[AI Analyzes User Data] --> B{Context Signals}

    B -->|Time of Day| C[Morning: Energetic Strains]
    B -->|Day of Week| D[Weekend: Social Strains]
    B -->|Weather| E[Rainy Day: Relaxing Strains]
    B -->|Consumption History| F[You usually use X at this time]
    B -->|Low Stash| G[Restock with similar strain]

    C --> H[Smart Suggestion Card]
    D --> H
    E --> H
    F --> H
    G --> H

    H --> I[Dashboard Card]
    I --> J{User Action}
    J -->|Accept| K[Navigate to Strain Profile]
    J -->|Dismiss| L[Learn from Feedback]
    J -->|Save for Later| M[Add to Wishlist]
```

## Dispensary Map Flow (Future)

```mermaid theme={null}
graph TD
    A[Open Dispensary Map] --> B[Show Nearby Dispensaries]
    B --> C[Map View with Pins]
    C --> D[Tap Pin]
    D --> E[Dispensary Preview Card]
    E --> E1[Name + Distance]
    E --> E2[Rating]
    E --> E3[Open/Closed Status]

    E --> F{Actions}
    F --> F1[Get Directions]
    F --> F2[Save to My Dispensaries]
    F --> F3[Scan Menu - Shopping Agent]
    F --> F4[View Hours + Details]

    B --> G[Filter Options]
    G --> G1[Distance Radius]
    G --> G2[Rating Minimum]
    G --> G3[Currently Open]
    G --> G4[Has Online Menu]
```

## Related Flows

<CardGroup cols={2}>
  <Card title="Master Journey" icon="route" href="/help/user-flows/master-journey">
    How future features extend the journey.
  </Card>

  <Card title="Feature Adoption" icon="chart-line" href="/help/user-flows/feature-adoption">
    Projected adoption patterns for new features.
  </Card>

  <Card title="User Personas" icon="users" href="/help/user-flows/personas">
    Which personas benefit most from each feature.
  </Card>

  <Card title="Achievement System" icon="medal" href="/help/user-flows/achievements">
    New achievement tracks for new features.
  </Card>
</CardGroup>
