Support scanning Illinois App QR codes for ticketing check in

[devksingh4]

Summary by CodeRabbit

• New Features

  • Added iCard QR code scanning capability to look up ticket purchases
  • Introduced UIN-based ticket lookup functionality
  • Added multi-ticket selection when multiple claimable tickets are found

• Improvements

  • Enhanced user guidance with instructional text for different QR code scan types
  • Improved error handling and validation in scan workflows
  • Optimized modal displays for ticket claim results and status updates

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

Added UIN-based purchase lookup workflow to the ScanTickets component. Extended QR code processing to distinguish between iCard codes (16 digits plus equals sign) and existing JSON-based codes, routing each through separate handling paths. Refactored scan flow state management and error handling. Enhanced UI with instructional text and updated modal flows for multi-select and result display.

Changes

Cohort / File(s)

Summary

UIN-based workflow and QR code processing src/ui/pages/tickets/ScanTickets.page.tsx

Added handleUinLookup(uin) function to perform purchases lookup by UIN, including validation, loading state management, and branch logic for single ticket auto-claim versus multi-select modal. Extended QR processing to detect and handle iCard codes (16 digits followed by =) as a distinct path. Refactored handleSuccessfulScan to accept QRData or string and route accordingly. Updated modal flows to display detailed results and error states. Enhanced UI with instructional text for scanning pickup and iCard QR codes. Adjusted keyboard navigation and focus behaviors for accessibility.

Sequence Diagram

sequenceDiagram
    actor User
    participant Scanner as QR Scanner
    participant ScanTickets as ScanTickets Component
    participant LookupService as Lookup Service
    participant Modal as Selection Modal

    User->>Scanner: Scan QR Code
    Scanner->>ScanTickets: Frame captured
    
    alt iCard Code (16 digits + "=")
        ScanTickets->>LookupService: handleUinLookup(uin)
        LookupService-->>ScanTickets: Purchases lookup result
        
        alt Single ticket found
            ScanTickets->>User: Auto-claim ticket
        else Multiple claimable tickets
            ScanTickets->>Modal: Show multi-select modal
            User->>Modal: Select tickets
            Modal->>ScanTickets: Proceed with selection
            ScanTickets->>User: Claim selected tickets
        else Error or no tickets
            ScanTickets->>User: Display error state
        end
    else JSON Code (existing pickup flow)
        ScanTickets->>User: Process pickup (existing logic)
    end

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

• Areas requiring extra attention:
  • handleUinLookup(uin) function logic, including validation, error handling, and branching for single vs. multiple ticket scenarios
  • QR code pattern detection logic (iCard detection using regex/pattern matching for "16 digits + =")
  • Refactored handleSuccessfulScan routing logic and parameter type changes
  • Modal flow state management and cleanup on close operations
  • Integration between UIN lookup and existing pickup/claim workflows to ensure no regressions
  • Edge cases in video device initialization and frame processing with the new dual-path logic

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch dsingh14/support-icard-qrcode

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Cache: Disabled due to data retention organization setting

Knowledge base: Disabled due to data retention organization setting

📥 Commits

Reviewing files that changed from the base of the PR and between 3fe0874 and 9935399.

📒 Files selected for processing (1)

• src/ui/pages/tickets/ScanTickets.page.tsx (18 hunks)

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

💰 Infracost report

Monthly estimate generated

_{This comment will be updated when code changes.}