This document outlines the key user journeys through the BitcoinLatte application.

Diagram: diagrams/flow-browse-shops.puml

Key Features:

• No login required
• Full map access
• View all approved shops
• See aggregated votes/comments
• Get directions

Diagram: diagrams/flow-submit-shop.puml

Key Features:

• No account required
• Address autocomplete
• Image upload
• Crypto type selection
• Optional tracking with login

Diagram: diagrams/flow-vote-comment.puml

Key Features:

• Magic link authentication
• Multiple vote types
• Categorized comments
• Real-time updates
• One vote per type per user

Diagram: diagrams/flow-track-submissions.puml

Key Features:

• Submission tracking
• Status badges
• Admin feedback
• Resubmission option
• Activity history

Diagram: diagrams/flow-admin-review.puml

Key Features:

• Bulk review interface
• Image verification
• Location validation
• Edit before approval
• Rejection with notes
• Email notifications

Diagram: diagrams/flow-admin-manage-users.puml

Key Features:

• User search
• Admin privileges management
• Activity monitoring
• Content moderation
• Action logging

Diagram: diagrams/flow-shop-discovery.puml

Key Features:

• Location-based discovery
• Interactive map
• Real-time search
• Multiple filters
• Quick preview popups

Diagram: diagrams/flow-pwa-installation.puml

Key Features:

• Install prompt
• Home screen icon
• Offline functionality
• Full-screen mode
• Native app feel

Diagram: diagrams/flow-image-upload.puml

Key Features:

• Client-side validation
• Image preview
• Progress indicator
• Automatic resizing
• Error handling

Diagram: diagrams/flow-search-filter.puml

Key Features:

• Multiple search types
• Combined filters
• Location-based search
• Map/list toggle
• Filter persistence

• Goal: Find Bitcoin-accepting coffee shops
• Behavior: Browses map, reads reviews, visits shops
• Needs: Accurate locations, current info, directions

• Goal: Promote Bitcoin adoption
• Behavior: Submits shops, votes, comments
• Needs: Easy submission, tracking, community engagement

• Goal: Get listed on the platform
• Behavior: Submits own shop, monitors reviews
• Needs: Quick approval, accurate info, positive reviews

• Goal: Maintain quality and accuracy
• Behavior: Reviews submissions, moderates content
• Needs: Efficient tools, clear information, bulk actions

1. Visit site: 100%
2. Click submit: 15%
3. Start form: 10%
4. Complete form: 7%
5. Submit: 5%

Optimization targets:

• Simplify form
• Add progress indicator
• Reduce required fields
• Improve address autocomplete

1. Prompted to login: 100%
2. Enter email: 40%
3. Check email: 35%
4. Click magic link: 30%
5. Complete registration: 28%

Optimization targets:

• Clear value proposition
• Faster email delivery
• Better email copy
• Seamless redirect

1. Detect offline/error
2. Show user-friendly message
3. Cache user action
4. Retry when online
5. Notify success/failure

1. Detect invalid input
2. Highlight field
3. Show specific error
4. Suggest correction
5. Allow retry

1. Detect expired session
2. Save current state
3. Prompt re-authentication
4. Restore state
5. Continue action

• Lazy load map
• Defer non-critical JS
• Optimize images
• Cache static assets

• Prefetch likely routes
• Optimistic UI updates
• Background data sync
• Smooth transitions

• Debounce search
• Throttle scroll
• Batch updates
• Progressive enhancement