POS Challenges
Doc Status: Excellent | ✓ Clear summary | ✓ Easy to read | ✓ Matches code | ✓ Good structure | ✓ Professional look | ✓ Visual components
Why This Matters
The POS Challenges page is where admins manage guest engagement activities that drive reviews and repeat visits. Staff can approve Google Review submissions (earning guests a free dessert), configure which challenges are active, and manage Lucky Spin prizes. These gamification elements help build your online reputation and create memorable experiences.How It Works
Approving Google Reviews
Guests who submit a Google review show up in the Submissions tab. Each entry tells you which table they were seated at, displays the screenshot they uploaded, and shows when they submitted it. When you spot a legitimate review, select a reward dessert from the dropdown — something like Chocolate Fondant — and click Approve. The guest gets their free treat, and you’ve turned a happy guest into an online advocate. If something looks off — it’s blank, clearly fake, or just doesn’t make sense — you can reject it with an optional note explaining why.Running the Gamification Program
The Configuration tab is where you control what engagement activities are live. Toggle Photo Wall, Lucky Spin, and Google Review challenges on or off depending on tonight’s setup. For Google Reviews, set a maximum reward value so costs stay predictable — something like 200,000 VND per dessert.Managing Lucky Spin Prizes
The Lucky Spin tab keeps your wheel fresh. You might run a month with “Free Cocktail” as a prize, then swap it out for “15% Off Next Visit” the following month. To add a prize, give it a label, pick whether it’s a free menu item or a discount percentage, and set its weight. Higher weight means guests are more likely to land on it. You can also toggle individual prizes on or off without deleting them — handy for when a prize is temporarily unavailable.Checking Tonight’s Numbers
The Stats tab gives you a real-time pulse on participation. You’ll see total guests in attendance, how many Google reviews came in (and your approval rate), how many spins happened, and how many photos guests submitted. These numbers help you understand what’s working and where to focus during future services.Key Concepts
- Google Review Challenge: Guests submit a screenshot of their Google review as proof, earning a free dessert reward
- Lucky Spin: Spin-the-wheel game at tables for guest engagement
- Photo Wall: Feature allowing guests to submit photos
- Prize Weight: Higher weight means higher probability of winning (relative to other prizes)
- Comp Item: A complimentary item (free of charge) given as a reward
Technical Details
Components
Components
| Component | File | Purpose |
|---|---|---|
| Inline components | page.tsx | Challenge review, configuration, prize management |
Convex API
Convex API
| Query/Mutation | Purpose |
|---|---|
minigames.getPendingReviews | Fetch pending Google review submissions |
minigames.approveGoogleReview | Approve a review and create comp reward |
minigames.rejectGoogleReview | Reject a submission |
minigames.getConfig | Fetch challenge configuration |
minigames.updateConfig | Update challenge settings |
minigames.getSpinPrizes | Fetch Lucky Spin prizes |
minigames.upsertSpinPrize | Create/update a prize |
minigames.listAvailable | Fetch available menu items for rewards |
minigames.getChallengeStats | Fetch participation statistics |
See Also
Admin Dashboard
Dashboard overview and navigation
Lucky Spin
Guest-facing spin wheel game
Photo Wall
Guest photo submission feature
Review Challenge
Guest review submission flow
Table Experience
Guest table PWA with gamification
Add-Ons
Booking extras management