1. Terminology & Concepts
Buyer: Person who purchased or holds tickets.
Attendee: Recipient of a ticket assignment (may be same as Buyer).
Native App: iOS/Android Minnect application.
WebView: In-app browser screen.
My Tickets: Native app screen listing personal tickets.
All Tickets: WebView page listing tickets by email.
Assigned: Ticket has an email owner and is ready to scan.
Unassigned: Purchased ticket not yet allocated.
Checked-In: Ticket scanned at event entrance.
Expired: Event is over; ticket no longer valid.
2. How Users Arrive
Homepage Banner
If user holds tickets, banner shows:
“Your Vault 2026 tickets are ready – Tap to view or assign.”
Tap → My Tickets.
Bottom Nav
Tap Events → event list.
In an event, tap Tickets tile → WebView All Tickets.
Push Notification
“You’ve been assigned a ticket.”
Tap → WebView All Tickets for your email.
3. Events Discovery
Native: Events tab (bottom nav).
Web: /events URL.
Features:
Tabs: Upcoming, Live, Past.
Search bar for keywords.
Filters: Free / Paid / Attending.
Support Tip: If empty, ask user to clear filters or pull-to-refresh.
4. Tickets in the Native App
Tap Tickets tab or homepage banner.
Two tabs:
My Tickets: shows held tickets.
Available Tickets: possible to claim/buy.
Scroll up to load more; “↑ Top” appears after several pages.
5. Tickets in WebView (All Tickets)
From native My Tickets, tap All Tickets.
Three tabs: All, Assigned, Unassigned.
Infinite scroll or “Load More” at bottom.
Search by name, type, or email.
6. Claiming Tickets (Email-Only)
User receives email: “Claim your ticket.”
Tap the link → opens WebView.
If not logged in: Sign up or Log in.
After auth, tickets for that email appear in WebView All Tickets and in native My Tickets.
7. Assigning & Revoking Tickets
Assign (Buyer Only)
In All Tickets → Unassigned tab, tap Assign on a ticket card (mobile) or row (web).
Modal appears:
Fields: First Name, Last Name, Assignee Email.
Buttons: Cancel, Assign.
Assign → ticket moves to Assigned.
Bulk Revoke (Buyer Only)
In Assigned tab, check multiple tickets.
Tap Revoke Selected above list.
Confirm in popup → tickets return to Unassigned.
8. Checking In (QR Scan)
Open native My Tickets → find an Assigned ticket.
Tap the QR code to expand full-screen.
At entrance, scan with event scanner.
On success: status changes to Checked-In and moves to Past section; pop-up:
“You’re checked in!”
9. Event Detail & Sub-Sections
From Events tab, tap an event to see:
Header Banner: Logo + Title
Live Banner (if live & ticket held): “Check In” button
Tiles (tap each):
Agenda: scrollable schedule
Venue Details: map with pinch-zoom
Speakers: tap → expert profile or bio fallback
Sponsors: tap → detail + PDF brochures
Vault Circles: tap → join or waitlist
Merchandise: tap → store WebView
Tickets: tap → All Tickets WebView
Support button at bottom for FAQs/contact.
10. Merchandise & External Links
On Event Detail, tap Merchandise tile.
Analytics recorded (merch_tile_tapped_native).
Opens WebView store (no native headers).
User shops; Back returns to Event Detail.
11. Web-Redirect Ticket Manager (Desktop & Mobile)
Countdown Banner
Top of page:
“Event starts in DD : HH : MM : SS (EST)”
“My tickets” Section
Prompt:
“Don’t see all of your tickets? Try an alternate email to pull up your ticket.”
Button: Add an alternate email
Add Alternate Email Flow
Popup Step 1:
Label: “Enter the alternate email you used…”
Field + Add email / Cancel
Popup Step 2:
Green alert: “Verification code sent to [email].”
Field: “Enter verification code.”
Buttons: Resend code, Submit code, Cancel
Success: reloads page, shows tickets for that email.
Ticket Display
Grid View (mobile default): cards with logo, name, email, QR, status, Assign button.
Table View (desktop, toggle icon top right):
Columns: select, Name, Type, Email, Status, Actions.
Actions menu on Assigned: Email, Download, Copy Link, Revoke.
Tabs & Search
Tabs: All ([#]), Assigned ([#]), Unassigned ([#])
Search: “Search by name, admission type or email” filters list instantly.
12. Troubleshooting Cheat Sheet
Symptom | Fix |
No tickets in My Tickets | Verify login email; suggest Add Alternate Email. |
“No tickets found” in WebView | Email wrong or link expired; resend claim link. |
QR code won’t scan | Enable camera: Settings → Privacy → Camera → Minnect. |
Assign button disabled | Ticket must be Unassigned; switch tabs or contact buyer. |
Bulk Revoke disabled | Ensure only Assigned tickets selected. |
Live banner missing | Check device time/timezone; refresh app. |
Agenda times wrong | Confirm device timezone; pull-to-refresh. |
Map won’t load | Check network; restart app or browser. |
Speaker call buttons missing | Speaker not onboarded; inform customer. |
Vault Circles join fails | Approval pending; escalate to event support. |
Alternate email not working | Clear cache/reload; advise modern browser. |
13. Breaking Scenarios (Test Your Knowledge)
Wrong Account: Customer sees zero tickets.
Answer: In My Tickets, tap Add an alternate email, follow verification, reload.
WebView Expiry: Assign form disappears after idle.
Answer: User sees “Please log in again” → re-authenticate in WebView → re-enter info.
Bulk Revoke Error: Mixed-state selection.
Answer: Error reads
“You can only revoke tickets that are in the Assigned state. Please select Assigned tickets only.”
Then deselect invalid tickets and retry.
Expired Claim Link: Email link no longer works.
Answer: Direct user to buyer or support to resend link; claim again.
QR Scan Failure: QR won’t scan.
Answer: Verify Camera permission, clean lens, ensure lighting; fallback manual check-in in dashboard.
Offline: “Service unavailable.”
Answer: Suggest network toggle or moving to signal; record ticket ID for manual check-in later.
Timezone Mix-Up: Agenda shows wrong zone.
Answer: Guide to Settings → Date & Time → Set Automatically; refresh agenda.
Vault Circles Tap No-Op:
Answer: Check waitlist status; escalate to on-site support for approval.
14. When to Escalate
WebView loads blank for all users → Backend issue (alert Engineering).
Assign modal never opens → Failed API call (escalate with logs).
Mass claim link failures → Token service problem (high-priority bug).
Scanner integration broken → Notify Operations.