blackcanyontickets/reactrebuild0825/STAFF_TRAINING_MATERIALS.md

Scanner PWA Staff Training Materials

📱 Quick Setup Guide for Gate Staff

Before Your Shift - Device Setup (15 minutes)

Step 1: Install the Scanner App

For iPhone/iPad:

1. Open Safari browser (not Chrome!)
2. Go to: scanner.blackcanyontickets.com/scan
3. Tap the Share button (box with arrow up)
4. Select "Add to Home Screen"
5. Name it "Gate Scanner" → Tap Add

For Android Phone:

1. Open Chrome browser
2. Go to: scanner.blackcanyontickets.com/scan
3. Look for "Add to Home Screen" popup
4. If no popup: Tap 3 dots → "Add to Home Screen"
5. Name it "Gate Scanner" → Tap Add

Step 2: Set Up Camera Permission

1. Tap the "Gate Scanner" app on your home screen
2. When asked for camera access → Tap "Allow"
3. You should see the camera view with a scanning frame

If camera doesn't work:

• iPhone: Settings → Privacy → Camera → Gate Scanner → ON
• Android: Settings → Apps → Gate Scanner → Permissions → Camera → Allow

Step 3: Configure Your Gate

1. In the scanner app, tap the gear ⚙️ icon
2. Enter your gate name: "Main Gate", "VIP Entrance", etc.
3. Leave other settings as default → Tap Save

During Your Shift - Basic Operation

How to Scan Tickets

1. Hold your device 6-12 inches from the QR code
2. Center the code in the scanning frame
3. Hold steady - don't move until you hear a beep
4. Look at the result banner at the top

Understanding Scan Results

✅ GREEN = SUCCESS - Let them in!

• Shows: Event name, ticket type, customer email
• Action: Allow entry immediately

⚠️ YELLOW = ALREADY SCANNED - Check carefully!

• Shows: When and where it was first scanned
• Action: Ask "Have you been in and out?" If no → Call supervisor

❌ RED = INVALID - Do not allow entry

• Shows: Error reason (fake, expired, cancelled)
• Action: Direct to box office, be polite but firm

🔵 BLUE = OFFLINE ACCEPTED - Let them in

• Shows: "Will verify when connection restored"
• Action: Allow entry (normal during network issues)

🔒 RED WITH LOCK = LOCKED TICKET - Do not allow entry

• Shows: "Payment dispute" or "Refund processed"
• Action: Direct to support, provide contact info

Using the Flashlight

• Automatic: Flashlight turns on in dark conditions
• Manual: Tap the flashlight 🔦 icon to toggle on/off
• Best for: Dark venues, evening events, hard-to-read codes

Common Situations and Solutions

"The scanner isn't working!"

Problem: Black screen, no camera view Fix:

1. Close the app completely (swipe up, swipe away)
2. Reopen "Gate Scanner" app
3. If still broken → Use backup device or call for help

"It says 'scanning too fast'"

Problem: Orange/red warning about speed limit Fix:

1. Slow down! Wait for beep before next scan
2. If blocked, wait for countdown timer to finish
3. Resume at normal speed (about 1 scan every 2-3 seconds)

"Scans aren't saving/syncing"

Problem: High "pending sync" number in settings Fix:

1. Check WiFi connection - switch to cellular if needed
2. Keep scanning (they'll sync when connection returns)
3. If pending count > 50 → Alert IT support

"Customer says ticket should work"

Problem: Valid-looking ticket scanning as invalid/already used Response:

1. Don't argue - be polite and professional
2. Say: "I'm showing an issue with this ticket"
3. Direct them to: "Please visit the box office for assistance"
4. Never override the scanner result

Emergency Procedures

Complete Scanner Failure

If ALL scanners stop working:

1. Switch to paper list immediately
2. Check names against ID
3. Mark attendees manually
4. Call IT support right away

Network Outage

If internet/WiFi goes down:

1. Keep scanning - app works offline
2. Look for blue "offline accepted" results
3. Check settings → pending sync count occasionally
4. Don't panic - everything will sync later

Device Problems

If your device breaks/overheats/gets stolen:

1. Get backup device from supervisor
2. Report incident immediately
3. Continue with backup while replacement is configured

Smartphone Tips for All-Day Scanning

Battery Management

• Before shift: Charge to 100%
• During shift: Use power bank if available
• Screen settings: Set brightness to 75% (not 100%)
• Close other apps to save battery

Comfort and Safety

• Hold device properly: Support with both hands when possible
• Take breaks: Look away from screen every 20-30 minutes
• Stay hydrated: Scanning in sun/heat is exhausting
• Rotate positions: Switch scanning hand to avoid strain

Professional Appearance

• Keep device clean: Wipe screen regularly for best scanning
• Professional demeanor: Device is a work tool, not personal phone
• Focus on customers: Make eye contact, smile, be welcoming
• Efficient processing: Quick scan → friendly greeting → direct to entrance

🎯 Troubleshooting Quick Reference

Problem → Solution Flowchart

Camera not working → Close app → Reopen → Check permissions → Use backup device

Too fast warning → Slow down → Wait for countdown → Resume normal pace

Network issues → Continue offline → Monitor pending sync → Report if >50 pending

Invalid ticket → Be polite → Explain issue → Direct to box office → Never override

Already scanned → Ask if re-entry → Check time/location → Call supervisor if suspicious

Device failure → Report immediately → Get backup device → Continue operations

Contact Information (Post at Each Gate)

Technical Issues:

• IT Support: [PHONE]
• Network Problems: [EMAIL]

Operational Issues:

• Gate Supervisor: [PHONE]
• Event Manager: [PHONE]
• Security: [RADIO CHANNEL]

Emergency Contacts:

• Venue Management: [PHONE]
• Medical Emergency: 911
• Fire/Police Emergency: 911

Scanner Settings Reference

Access Settings: Tap gear icon ⚙️ in app header

Important Settings:

• Zone/Gate: Your gate name (required)
• Optimistic Accept: ON (allows offline scanning)
• Audio Feedback: ON (success beep)
• Haptic Feedback: ON (vibration)

Information Displays:

• Total Scans: Count from your device
• Pending Sync: Waiting for internet (should be low)
• Last Sync: Most recent successful sync time

📋 Pre-Shift Checklist (Print and Laminate)

Device Check ✅

• Scanner app installed and opens correctly
• Camera permission granted and working
• Flashlight toggles on/off properly
• Device charged to 80%+ battery
• Gate/zone name configured in settings

Network Check ✅

• WiFi connected and internet working
• Cellular signal available as backup
• Test scan synchronizes (pending sync = 0)

Knowledge Check ✅

• Know all scan result colors and meanings
• Understand "already scanned" policy
• Can locate backup device and contact numbers
• Practice manual entry for broken QR codes
• Rehearsed "invalid ticket" customer response

Supplies Check ✅

• Power bank/charging cable available
• Backup device identified and tested
• Emergency contact sheet posted
• Guest list printout as fallback
• Hand sanitizer (if required)

💡 Pro Tips for Efficient Scanning

Optimal Scanning Technique

1. Position: 6-12 inches from QR code
2. Angle: Device parallel to ticket (not tilted)
3. Lighting: Use flashlight in dim conditions
4. Stability: Hold steady until beep sounds
5. Speed: Average 1 scan every 2-3 seconds

Managing Peak Entry Times

• Stay calm during rush periods
• Communicate - tell people "One moment please"
• Be efficient but don't sacrifice accuracy
• Watch for rate limiting warnings
• Ask for help if line gets too long

Customer Service Excellence

• Smile and make eye contact while device processes
• Explain briefly if there's a delay: "Just verifying your ticket"
• Be patient with elderly or tech-confused customers
• Stay positive even when dealing with invalid tickets
• Thank people for their patience during busy times

Maintaining Equipment

• Keep screen clean - use microfiber cloth
• Protect from rain - use bag/cover if needed
• Avoid extreme temperatures - shade device when possible
• Handle carefully - scanning devices are expensive
• Report damage immediately - don't try to fix yourself

🚨 Staff Safety and Security

Personal Safety

• Stay alert to surroundings while scanning
• Know emergency exits and evacuation procedures
• Keep radio/communication device accessible
• Report suspicious behavior to security
• Never confront aggressive customers alone

Device Security

• Keep device secure when not scanning
• Don't leave unattended even briefly
• Report theft/loss immediately
• Don't share login credentials with other staff
• Lock screen during breaks if device supports it

Data Privacy

• Customer data stays on device only
• Don't photograph or share scan results
• Don't discuss customer information with others
• Follow venue privacy policies for all customer interactions

📞 Quick Contact Card (Wallet Size)

🔧 Technical Support IT Help: [PHONE] Platform Issues: [EMAIL]

👥 Operations Gate Supervisor: [PHONE]
Event Manager: [PHONE] Security Radio: Channel [#]

🚨 Emergencies Medical: 911 Fire/Police: 911 Venue Management: [PHONE]

📱 Scanner Issues • Camera black screen: Close/reopen app • Too fast warning: Slow down, wait • Network issues: Continue offline • Invalid ticket: Direct to box office

⚠️ Remember ✅ Green = Enter
⚠️ Yellow = Check carefully ❌ Red = No entry 🔵 Blue = Enter (offline) 🔒 Red lock = No entry (contact support)

---

Keep this card with you during your shift. When in doubt, ask your supervisor or call technical support. Your job is to keep entry moving safely and efficiently!