e-RegisterNow e-Ticket Scanner

The e-RegisterNow e-Ticket Scanner is an Android application for event staff, gate attendants, and venue administrators. It supports barcode scanning, online server validation, offline database fallback, automatic queuing of pending redemptions, synchronization across scanners, and attendee lookup.

Key Capabilities

• Real-time Online Redemption: Communicates directly with the e-RegisterNow server.
• Offline StandAlone Fallback: Validates tickets against the local database when internet connectivity is unavailable or StandAlone mode is enabled.
• Automatic Synchronization: Receives ticket-status changes from the server so each connected scanner can update its local records with redemptions made on other devices.
• Smart Status Tracking: Distinguishes between REDEEMED, DUPLICATE, REFUNDED, NOT PURCHASED YET, and INVALID tickets.
• Audio-Visual Feedback: Color-coded overlay flashes, centered status banners, and distinct audio tones for every scan result.

Quick Start

1. Confirm that the device meets the stated requirements and has sufficient battery power.
2. Open the app and sign in with the assigned Ignition Key and PIN.
3. Confirm the gate name, camera selection, operating mode, and connection status.
4. Scan a test ticket and verify the expected visual and audio feedback.
5. Monitor the pending counter during operation and synchronize outstanding redemptions when connectivity is available.

3.1 Login and Device Authentication

Purpose: Authenticates the operator's assigned credentials, associates the device with the event session, and opens the main scanner screen.

Key Actions:

• Enter the assigned Ignition Key and PIN.
• Confirm the device's internet connection using the antenna icon, then sign in through the live server or use offline login when online authentication is unavailable.
• View or re-check physical internet connectivity via the bottom antenna icon.
• Access key help guidance via the "Ignition Key Help?" link.

3.2 Screen Visual Layout Diagram

#	Element	Description & Function
1	Ignition Key Input	Accepts the assigned Event Ignition Key.
2	PIN Input	Accepts the operator security PIN.
3	Help	Clickable text link opening the Ignition Key Help popup dialog.
4	Sign In Button	Authenticates credentials with the server or local DB and opens the main scanner screen. Pressing keyboard Done/Checkmark executes Sign In.
5	Online Status Indicator	Interactive icon displaying online (green) or offline (grey) status. Tapping re-checks physical internet connection.

4.1 Scan / Redemption Screen

Purpose: Main ticket scanning interface for gate attendants to check in attendees.

Key Actions:

• Continuously scan barcodes using the live camera viewfinder or type them manually into the Barcode field.
• View real-time redemption feedback (REDEEMED, DUPLICATE, REFUNDED, NOT PURCHASED YET, INVALID).
• Receive instant audio tones and color-coded overlay flashes for every scan.
• Monitor the Pending Counter Badge, which displays “☁ X Pending” when redemptions are waiting to synchronize and “✓ Synced” when the queue is clear. Tap the badge to open the Sync Dialog.
• Toggle the camera on/off using the floating switch.

4.2 Screen Visual Layout Diagram

#	Element	Description & Function
1	Ticket Name Display	Stacked header text displaying ticket category (e.g., "VIP Pass").
2	Ticket Status Display	Stacked header displaying scan status ("Ready to Scan", "REDEEMED", "DUPLICATE").
3	Camera Viewfinder	Live camera viewfinder for continuous barcode scanning.
4	Barcode Input Field	Manual barcode entry box. Tapping keyboard Done/Checkmark executes redemption.
5	Redeem Button	Manual action button to redeem the typed barcode.
6	Pending Counter Badge	Floating badge in bottom-left corner ("☁ X Pending" or "✓ Synced"). Clickable: tapping launches the Sync Popup Dialog.
7	Camera Toggle Switch	Floating switch in bottom-right corner to toggle camera active/inactive.

4.3 Scan Result & Sound Matrix

5.1 Look Up Form Screen

Purpose: Search for attendees who forgot or lost their physical/digital ticket.

Key Actions:

• Enter one or more search fields: Name, Email, Credit Card, Reference Number, or Phone Number.
• Tap Look Up or press the keyboard Search key to query the event database and view matching results.

5.2 Screen Visual Layout Diagram

#	Element	Description & Function
1	Name Field	Search by attendee first/last name. Tapping keyboard Search executes lookup.
2	Email Field	Search by purchaser email address.
3	Credit Card Field	Search by credit card number.
4	Reference Number Field	Search by transaction reference number.
5	Phone Number Field	Search by purchaser phone number.
6	Look Up Button	Submits non-empty criteria and opens the Search Results screen.

6.1 Search Results Screen

Purpose: Displays matching attendee records found during a Look Up search.

Key Actions:

• View attendee details, ticket tier, barcode ID, masked credit card, reference number, and contact info.
• Check the ticket status badge (VALID, REDEEMED, REFUNDED, NOT PURCHASED YET).
• For VALID tickets, tap the Redeem Ticket button to check in the attendee directly from the search result.
• View redemption timestamps and entrance gate info for previously redeemed tickets.

6.2 Screen Visual Layout Diagram

#	Element	Description & Function
1	Attendee Name	Card header displaying attendee's full name.
2	Ticket Type	Displays ticket category name.
3	Status Badge	Displays ticket status (VALID, REDEEMED, REFUNDED, NOT PURCHASED YET).
4	Attendee Information	Displays the barcode string, reference number, email address, phone number, and masked credit card information.
5	Redemption Details	Visible if ticket is already redeemed ("Redeemed on [Date] at [Gate]").
6	Redeem Ticket Button	Visible if ticket status is VALID. Tapping redeems the ticket directly from search results.

7.1 Settings Screen

Purpose: Hardware and app operation configuration.

Key Actions:

• View phone hardware model, OS version, and app version number.
• Switch camera lens between Back and Front cameras.
• Toggle between Online Mode (live server sync) and Stand Alone Mode (offline database only).
• View or edit the current Gate Name (e.g. "Gate1", "VIP Entrance").
• Tap Logout to end the active session.

7.2 Screen Visual Layout Diagram

#	Element	Description & Function
1	Device Name Display	Displays detected phone hardware model and Android OS version.
2	Camera Lens Toggle	Toggles camera lens selection between BACK and FRONT.
3	Stand Alone Mode Toggle	Toggles operation mode between ONLINE (live server sync) and OFFLINE (StandAlone).
4	Gate Name Field	View/edit entrance gate identifier (e.g. "Gate1", "Gate North").
5	Logout Button	Clears active session and returns to Login Screen.

[ Offline Scanning ] ──► [ Save to PendingTable ] ──► [ Display "☁ X Pending" ]
                                                              │
                                                      (Reconnect Online)
                                                              │
[ Update Local DB ] ◄── [ Receive Delta Changes ] ◄── [ Post to state=pending ]

8.1 Offline StandAlone Mode

• When the device is offline or StandAlone mode is active, ticket redemptions are validated against the local database.
• Successfully validated offline scans are immediately written to Pending Table and marked Attendance = "Y" locally.
• The Scan screen displays a live pending count badge (e.g., ☁ 3 Pending).

8.2 Live Reconnection and Auto-Push

• Upon reconnecting online, the app automatically pushes the pending backlog.
• The server receives the pending redemptions, updates the master list, and responds with any missed ticket changes.
• The app updates local ticket states and clears successfully synced items from Pending Table.

8.3 Manual Sync Dialog Trigger

• Tapping the floating ☁ X Pending badge on the Scan screen checks StandAlone preferences and internet connectivity.
• When online, Sync launches, showing real-time progress while flushing pending redemptions and downloading ticket database updates.