Overview
Dispensary management is the organizational layer that connects where you shop to what you buy. This flow documents how dispensaries are created, managed, and integrated with orders, the Shopping Agent, and analytics.Dispensary Lifecycle
Adding a Dispensary — All Paths
Dispensary Detail Screen Flow
Dispensary List Organization
Dispensary-Order Linking Flow
Shopping Agent Integration
Edge Cases
| Scenario | Behavior |
|---|---|
| Dispensary created from receipt with typo | User can edit name later |
| Delete dispensary with linked orders | Orders preserved (text reference), dispensary removed |
| Two dispensaries with similar names | Both maintained as separate entries |
| Menu URL becomes invalid | Shopping Agent error with “Update URL” prompt |
| Dispensary has 0 visits but exists | Shown in “All” section |
| Very long dispensary name | Truncated on card, full on detail |
| Same dispensary from Gmail + manual | Potential duplicates, user can merge by deleting one |
| Notes field very long | Scrollable, no limit |
| Rate a dispensary without visiting | Allowed |
| 20+ dispensaries saved | All shown, searchable |
Related Flows
Shopping Agent
Scanning menus at saved dispensaries.
Order Upload
Orders auto-creating and linking dispensaries.
Gmail Sync
Bulk importing orders with dispensary linking.
Stats & Analytics
Dispensary spending analysis.