Skip to main content

The Gate Scanner Interface

The Scanner role is the most restrictive role on the platform. It exists solely to securely validate tickets at the venue entrance. Scanners cannot see financial data or edit event details.

1. Zero-Scroll Architecture

The /scan dashboard was heavily optimized for speed. When a line of 500 students is waiting to enter, every second counts. We eliminated the need to scroll. The camera feed takes up the bottom portion of the screen, and the Scan Results Panel floats directly above it. As soon as a code is scanned, the result immediately updates the top panel, allowing the scanner to process the next student instantly.

2. Manual Entry Disabled

To prevent severe human error, we completely removed the ability to type in a ticket ID manually. In older systems, if a scanner accidentally typed a 1 instead of a 7, they would accidentally invalidate an innocent student’s ticket who hadn’t even arrived yet! Only QR scanning is permitted.

3. Understanding Scan Results

When the camera detects a UniTix QR code, it verifies the cryptographic JWT signature. The scanner screen will display one of three outcomes:

Success (Green)

The ticket is perfectly valid. The student is granted entry and the database is updated. The phone will vibrate to confirm.

Warning (Yellow)

The ticket is authentic, but the student already checked in earlier. The screen will display exactly what time they entered. Do not let them pass.

Error (Red)

The ticket is completely invalid. It may be forged, from a different event entirely, or their manual payment is still pending.