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!*