docs(scanner): add comprehensive staging rollout documentation
Add three critical documents for Scanner PWA production deployment: 1. STAGING_ROLLOUT_CHECKLIST.md - Main operational checklist - Pre-event setup procedures for IT/admin team - Staff device setup with PWA installation steps - Day-of operations and gate management protocols - Post-event data sync and cleanup procedures - Emergency fallback procedures and escalation contacts 2. STAFF_TRAINING_MATERIALS.md - Gate staff training resources - Step-by-step device setup for iOS/Android - Scanner operation guide with result interpretation - Troubleshooting guide for common issues - Professional smartphone usage tips for all-day events - Quick reference cards and emergency procedures 3. SCANNER_TECHNICAL_RUNBOOK.md - IT administrator guide - Complete system architecture and API documentation - Environment setup for staging/production deployment - Monitoring, alerting, and performance baseline configuration - Network requirements and quality management - Security considerations and vulnerability management - Escalation procedures and maintenance schedules These documents provide complete operational readiness for Scanner PWA deployment, ensuring smooth gate operations with minimal day-of issues. Staff preparation procedures are designed for temporary/volunteer workers with clear, simple instructions and comprehensive emergency protocols. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
302
reactrebuild0825/STAFF_TRAINING_MATERIALS.md
Normal file
302
reactrebuild0825/STAFF_TRAINING_MATERIALS.md
Normal file
@@ -0,0 +1,302 @@
|
||||
# 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!*
|
||||
Reference in New Issue
Block a user