Overview
Notebooks are High IQ’s flagship AI feature — transforming raw purchase data into multi-layered analysis with streaming generation, visual stories, and daily recaps. This page documents every flow from generation trigger through consumption.Notebook Generation Flow
Notebook Type Selection
Generation Progress States
Progress bar stages:| Stage | Progress | Duration | What Happens |
|---|---|---|---|
| Queued | 0% | ~1s | Request sent to API |
| Analyzing | 5-15% | ~3s | Gathering stash data, strain profiles, terpene info |
| Generating | 15-25% | ~5s | AI model warming up, context prepared |
| Streaming | 25-90% | 20-90s | Sections generated one by one with visible text |
| Finalizing | 90-95% | ~3s | Computing insights, saving to database |
| Completed | 100% | Instant | Auto-navigate to detail view |
Notebook Detail View — 5-Tab Navigation
Stories Viewer Flow
Story interaction:| Gesture | Action |
|---|---|
| Swipe left | Next act |
| Swipe right | Previous act |
| Tap left edge | Previous act |
| Tap right edge | Next act |
| Long press | Pause story |
| Swipe down | Close story |
Daily Stories Flow
Free vs. Premium Notebook Access
Edge Cases
| Scenario | Behavior |
|---|---|
| Only 1 strain selected | Notebook generated but less comparative insight |
| Stream disconnects mid-generation | Partial notebook saved, retry option for remaining sections |
| Generation takes > 2 minutes | Extended progress message shown |
| AI returns empty section | Section skipped with “Not enough data” message |
| User closes app during generation | Generation continues server-side, notebook appears on return |
| Network offline | Error message, retry when online |
| Duplicate notebook for same strains | Allowed — different AI analysis each time |
| Daily Story for day with single event | Minimal story, still counts for streak |
| Notebook for archived/empty stash items | Works — uses historical data |
| Error during finalization | Error preserved with stage info for debugging |
Notebook Media Attachments (Future)
Related Flows
Order Upload
How orders create data for notebooks.
Stash Management
Selecting stash items for analysis.
Stats & Analytics
How notebook data feeds into analytics.
Achievement System
Notebook Mastery and Daily Stories tracks.