Skip to main content

Dynamic QR Attendance

This module enables dynamic QR attendance for employees with enhanced security through time-limited rotating QR codes. Dedicated QR devices display codes that change at configurable intervals, preventing QR code sharing and screenshot-based fraud.

Features​

  • QR Device Management - Register and manage devices that display dynamic QR codes
  • Configurable Rotation Interval - Set how frequently QR codes change per device
  • Device Registration API - Devices self-register using a unique ID and PIN
  • Code Verification API - Mobile app verifies scanned dynamic QR codes against the server

Requirements​

  • Open Core Business Suite (Base System)
  • Site Attendance module (dependency)
  • Display devices (tablets, monitors) for showing dynamic QR codes
  • Mobile devices with camera for QR scanning

Installation​

Enable via Admin Panel​

  1. Log in as administrator
  2. Navigate to Settings > Addons
  3. Find Dynamic QR Attendance and click Enable
  4. Run migrations if prompted

Enable via Command Line​

php artisan module:enable DynamicQrAttendance
php artisan migrate
note

The Site Attendance module must be installed and enabled before enabling this module.

Usage​

Registering QR Devices​

  1. Navigate to QR Devices (top-level menu item)
  2. Click to add a new device
  3. Enter device details:
    • Device name
    • Unique ID (up to 8 characters)
    • PIN (6 digits)
    • QR update interval (how often the code rotates)
    • Device type (Android, iOS, Windows, Mac, Linux, Web, or Other)
  4. Save the device

Device Self-Registration​

Devices can also register themselves via the API:

  1. The device checks if it is already registered using its unique ID
  2. If not, it registers with the server providing its unique ID and PIN
  3. Once registered, the device can request new QR codes at the configured interval

Managing Devices​

  • View - See all registered QR devices with their status and type
  • Edit - Modify device name, PIN, update interval, and type
  • Delete - Remove devices no longer in use

Employee Check-in Process​

  1. The QR device displays a rotating QR code that changes at the configured interval
  2. Employee opens the mobile app
  3. Scans the currently displayed dynamic QR code
  4. The app sends the code to the server for verification
  5. If valid, attendance is recorded; expired or invalid codes are rejected

Device Statuses​

StatusDescription
NewDevice has been created but not yet activated
ActiveDevice is registered and operational
InactiveDevice has been deactivated

Changelog: View version history

Last updated on