Overview
Event management tools help organizers track attendee participation throughout DeltaHacks using QR code scanning. This includes check-in, meal distribution, and event attendance.Station Configuration
Stations are configurable check-in points for different purposes. Manage stations at/admin/station-config.
Station Types
Stations are categorized byname:
Food Stations
Track meal distribution and dietary restrictions. Example options:- “Breakfast - Saturday”
- “Lunch - Saturday”
- “Dinner - Saturday”
- “Midnight Snack”
- “Breakfast - Sunday”
Event Stations
Track attendance at workshops and activities. Example options:- “Opening Ceremony”
- “Workshop - Intro to React”
- “Workshop - ML Basics”
- “Sponsor Fair”
- “Closing Ceremony”
Station Data Model
name + option combination must be unique.
Creating Stations
- Navigate to
/admin/station-config - Choose Food Options or Event Options section
- Enter the option name (e.g., “Lunch - Saturday”)
- Click Add
Editing Stations
Click the edit icon on a station to rename it. This updates all existing EventLogs to reference the new name.Deleting Stations
QR Code Scanning
Authorized users can scan attendee QR codes to log participation.Scanner Roles
These roles can scan QR codes:- ADMIN - Can scan all stations
- FOOD_MANAGER - Can scan food stations
- EVENT_MANAGER - Can scan event stations
- GENERAL_SCANNER - Can scan both food and events
Check-In Process
Initial Check-In (Status: RSVP → CHECKED_IN)
The specialcheckIn station changes user status:
- User must have
status: RSVP(confirmed attendance) - Users with REJECTED, WAITLISTED, or ACCEPTED (not RSVP’d) status will be denied
- Returns user’s t-shirt size in metadata
- User status changes to
CHECKED_IN - EventLog entry created
- User can now access food/event stations
Food Distribution
Scan QR code at a food station:- User must be
CHECKED_IN - User cannot scan same food station twice (prevents double-claims)
- User’s dietary restrictions in metadata for kitchen reference
Event Attendance
Scan QR code at an event station:- User must be
CHECKED_IN - User cannot scan same event station twice
- Track workshop attendance
- Award prizes for participation
- Measure event popularity
Event Logs
All scans create EventLog entries:[userId, stationId] prevents duplicate scans.
Viewing Event Logs
Access comprehensive logs at/admin/scanner-events.
Filters
- Station Type: Filter by “food” or “events”
- Station Option: Filter by specific meal/event
- Search: Find by user name or email
Infinite Scroll
Logs load 50 at a time with “Load More” button for performance.Event Log Statistics
The scanner events page shows:- Determine meal counts for catering
- Measure event popularity
- Track overall engagement
Special Stations
Check-In Station
- ID:
"checkIn" - Purpose: Initial event check-in
- Effect: Changes status from RSVP → CHECKED_IN
- Returns: T-shirt size
Judge Assignment Station
- ID:
"judges" - Purpose: Assign JUDGE role to external judges
- Effect: Adds JUDGE role to user
- Requires: ADMIN role to scan
The “judges” station is used to quickly onboard external judges. Scan their QR code to grant judging access.
Mobile Scanning App
For optimal scanning experience:- Use a dedicated tablet/phone for each station
- Keep device charged and connected to WiFi
- Use camera-based QR scanning (native or web)
- Have backup manual search in case QR code doesn’t scan
Search Users
If QR code fails, search by name:Meal Tracking
Users have meal-related fields:- Per-user meal limits
- Time-based meal restrictions (e.g., one meal per 4 hours)
Error Handling
Common Errors
User not found- QR code is invalid or user doesn’t exist
- User has status IN_REVIEW, REJECTED, WAITLISTED, or ACCEPTED (without RSVP)
- User already scanned the checkIn station
- User already scanned this specific food/event station
- User trying to access food/event station without checking in first
Analytics Queries
Total Check-Ins
Food Station Usage
Event Attendance
Related Pages
- User Management - Assign scanner roles
- Equipment Tracking - Similar scanning workflow
- Admin Dashboard - View overall statistics