Overview
The Shopping Agent bridges the gap between a user’s cannabis preferences and what is available at their local dispensary right now. This flow documents the complete journey from selecting a dispensary to receiving personalized product recommendations.End-to-End Flow
Pre-Scan Requirements
Scan Progress Flow
Progress stages with percentages:| Stage | Progress | Time | What Happens |
|---|---|---|---|
| Cache Check | 5% | <1s | Check Supabase for recent scan |
| Scraping | 10-40% | 5-60s | Multi-tool extraction with cascading fallback: Extract (multi-page wildcard) → Scrape+JSON → Scrape+AI (Claude fallback) → Sitemap Discovery |
| Matching | 40-60% | 2-5s | Products matched to 16,000+ strain DB |
| Personalizing | 60-85% | 3-8s | Claude generates personalized rankings |
| Saving | 85-95% | 1s | Cache results for 4 hours |
| Complete | 100% | Instant | Results displayed |
Results Screen Navigation
Personalization Tag Logic
New Strain Discovery Flow
Edge Cases
| Scenario | Behavior |
|---|---|
| Dispensary has no online menu | Error: “No menu URL found” with setup instructions |
| Menu behind login wall | Error: “Unable to access menu” with explanation |
| Menu has 200+ products | All extracted, categorized, may take 60-90s |
| Zero products matched | All appear in New Discoveries tab |
| User has no data (new user) | Tags limited to price-based, no personalization |
| Menu URL changed | Old cache invalidated, fresh scan triggered |
| Extraction fails | Cascading fallback: multi-page Extract → Scrape+JSON → Scrape+AI (Claude) → Sitemap Discovery. Error shown only if all stages fail. |
| Same product listed multiple times | Deduplicated by name |
| Strain name with special characters | Normalized for matching |
| User closes app during scan | Scan continues, results on return |
| Cache expired mid-browsing | Results still visible, refresh available |
| Dispensary menu empty (holiday/closed) | “No products found” with retry option |
Related Flows
Dispensary Management
Setting up dispensaries with menu URLs.
Strain Discovery
Exploring matched strains further.
Stash Management
Adding purchased strains to stash.
Collection & Rankings
Wishlisted strains flagged in results.