Shopping Agent Flow

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

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

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.

Getting Started

Plans

Features

Social Content

Troubleshooting

Account & Privacy

User Flows

FAQ

Overview

End-to-End Flow

Pre-Scan Requirements

Scan Progress Flow

Results Screen Navigation

Personalization Tag Logic

New Strain Discovery Flow

Edge Cases

Dispensary Management

Strain Discovery

Stash Management

Collection & Rankings

​Overview

​End-to-End Flow

​Pre-Scan Requirements

​Scan Progress Flow

​Results Screen Navigation

​Personalization Tag Logic

​New Strain Discovery Flow

​Edge Cases

​Related Flows

Dispensary Management

Strain Discovery

Stash Management

Collection & Rankings

Overview

End-to-End Flow

Pre-Scan Requirements

Scan Progress Flow

Results Screen Navigation

Personalization Tag Logic

New Strain Discovery Flow

Edge Cases

Related Flows