User Stories — House of Legends
Status: Canonical Last Updated: 2026-05-11Doc Status: Excellent | ✓ All 6 checks passed
Overview
User stories document what each actor (Guest, Booking Guest, Checked-in Guest, Staff, Admin) can do in the system. Stories are organized by actor type with acceptance criteria defining when a story is complete.Related specs
This is a summary spec that references all other specs. See individual specs for detailed documentation:- Tech Stack — Technology background
- Data Model — Database schema
- Booking Flow — US-B01 through US-B03
- Public Pages — US-G01 through US-G04
- Admin Dashboard — US-A01 through US-A08
- Staff POS — US-S01 through US-S05
- Inquiry Forms — US-G04
- Gamification — US-CG01 through US-CG04
- Payments — Referenced by US-B01
- Notifications — Referenced by US-S05
Actors
| Actor | Description | Route Access |
|---|---|---|
| Guest (Public) | Anonymous visitor | All public pages |
| Booking Guest | User going through booking | /booking/* |
| Checked-in Guest | Verified reservation holder | /wall, /dashboard/table |
| Staff | Venue operations | /dashboard/* (limited) |
| Admin | Full system access | /dashboard/* (full) |
Guest (Public) User Stories
US-G01: Browse Upcoming Shows
As a public guest I want to see upcoming show dates So that I can plan my visit Acceptance:- Homepage shows carousel of next 5-8 events
- Each card shows show name, date/time, price, availability
- Click card → show detail page
US-G02: View Show Details
As a public guest I want to learn about a show So that I can decide to book Acceptance:- Show page has video, description, gallery
- Shows list of upcoming dates
- Each date shows availability badge
- “Book Now” button → booking flow with date locked
US-G03: Submit Inquiry Form
As a public guest I want to contact about venue rental/private event So that I can inquire about hosting Acceptance:- Form validates required fields
- Success message shown on submit
- Submission stored and admin notified
US-G04: View Photo Wall
As a public guest I want to see guest photos So that I can feel the atmosphere Acceptance:- Grid of approved photos
- Like count visible
- Winner badges shown
Booking Guest User Stories
US-B01: Book Tickets
As a booking guest I want to select tickets and pay So that I can attend a show Acceptance:- Step 1: Select ticket type and quantity
- Step 2: Add optional add-ons (skippable)
- Step 3: Fill customer info and pay
- Step 4: See confirmation with QR code
- 10-minute hold timer active
US-B02: Receive Confirmation
As a booking guest I want to get confirmation and QR code So that I can check in at the venue Acceptance:- Confirmation page shows booking details
- QR code displayed
- Add to Calendar buttons work
- Email confirmation sent
US-B03: View Booking on Mobile
As a booking guest I want to complete booking on my phone So that I can book while on the go Acceptance:- Mobile-friendly booking flow
- Sticky cart at bottom on mobile
- Touch-friendly buttons (44px min)
Checked-in Guest User Stories
US-CG01: Check In
As a checked-in guest I want to scan my QR code So that I can enter the venue Acceptance:- Staff scans QR at reception
- Guest profile created
- Welcome message displayed
US-CG02: Submit Photo
As a checked-in guest I want to submit a photo to the wall So that I can share my experience Acceptance:- Photo submission form accessible
- Can add caption
- Photo appears on wall after approval
US-CG03: React to Other Guests
As a checked-in guest I want to send reactions to other guests So that I can interact socially Acceptance:- Can see other profiles at table/event
- Can send Wave, Cheers, Heart
- Reactions accumulate on profile
US-CG04: Participate in Challenges
As a checked-in guest I want to join lucky spin or review challenge So that I can win prizes Acceptance:- Can spin wheel if enabled
- Prize applied to order if won
- Can submit Google review if enabled
Staff User Stories
US-S01: View Shift Schedule
As a staff member I want to see my tables and reservations So that I can prepare for the shift Acceptance:- List of tables with status
- Reservations for shift
- Start/end times
US-S02: Check In Guests
As a reception staff I want to scan reservation QR codes So that I can verify bookings Acceptance:- Camera scanner works
- Reservation details shown on scan
- Can mark as checked in
US-S03: Take Table Orders
As a floor staff I want to enter orders at the table So that kitchen can prepare them Acceptance:- Menu displayed
- Can add items to order
- Submit sends to kitchen
- Order appears in KDS
US-S04: Update Order Status
As a kitchen staff I want to see and update order status So that food gets served on time Acceptance:- Orders appear in real-time
- Can mark as Preparing, Ready, Served
- Status updates reflect for floor staff
US-S05: View Notifications
As a staff member I want to see alerts and notifications So that I can respond to important events Acceptance:- Notification bell shows unread count
- Can view notification list
- Can mark as read
Admin User Stories
US-A01: Manage Shows
As an admin I want to create and edit show templates So that I can manage content Acceptance:- Can create new experience
- Can edit all fields
- Can archive old shows
- Can upload photos/videos
US-A02: Schedule Events
As an admin I want to create scheduled events So that guests can book Acceptance:- Can create individual events
- Can batch generate recurring events
- Can edit event details
- Can cancel events
US-A03: Manage Reservations
As an admin I want to view and modify reservations So that I can handle customer requests Acceptance:- Can search reservations
- Can view full details
- Can cancel/refund
- Can resend confirmation
US-A04: View Analytics
As an admin I want to see business metrics So that I can make decisions Acceptance:- Dashboard shows key metrics
- Can see occupancy rates
- Can see revenue trends
US-A05: Manage Inquiries
As an admin I want to view and respond to inquiries So that I can convert leads Acceptance:- Kanban board shows all inquiries
- Can update status
- Can add follow-up notes
- Can see inquiry history
US-A06: Manage Challenges
As an admin I want to configure gamification So that I can engage guests Acceptance:- Can enable/disable Photo Wall
- Can configure Lucky Spin prizes
- Can review Google Review submissions
US-A07: Manage Tables
As an admin I want to configure venue layout So that operations run smoothly Acceptance:- Can add/edit tables
- Can set table capacity
- Can view floor plan
US-A08: Manage Menu
As an admin I want to update food and beverage menu So that guests have options Acceptance:- Can add/edit menu items
- Can set prices
- Can toggle availability
- Can set categories