Skip to main content

Face Attendance Device

This module enables management of face attendance devices (tablets/kiosks) that use facial recognition for automated employee attendance tracking. Devices authenticate with the server, receive employee face data, and submit attendance records.

Features​

  • Device Management - Register, edit, and manage face attendance devices
  • Token-based Device Authentication - Devices authenticate using generated tokens with session management
  • User Assignment - Assign specific employees to specific devices
  • Session Monitoring - View active device sessions and their status
  • Attendance Logs - Review face recognition logs with confidence scores
  • Token Regeneration - Generate new authentication tokens for devices

Requirements​

  • Open Core Business Suite (Base System)
  • Face Attendance module (dependency)
  • Dedicated tablet/kiosk hardware with camera
  • Network connectivity for devices

Installation​

Enable via Admin Panel​

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

Enable via Command Line​

php artisan module:enable FaceAttendanceDevice
php artisan migrate
note

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

Usage​

Adding a Device​

  1. Navigate to Attendance Management > Face Attendance Devices
  2. Click Create to add a new device
  3. Enter device details:
    • Device name
    • Code
    • PIN (6 characters, required for device security)
    • Device type
    • Status
  4. Save the device (a unique ID and authentication token are generated automatically)

Assigning Users to a Device​

  1. Navigate to Attendance Management > Face Attendance Devices
  2. Click on a device and go to Assign Users
  3. Search for and select employees to assign
  4. Save the assignments

Assigned users can be viewed in a data table showing their name, department, and assignment date. Users can be unassigned individually.

Viewing Device Details​

The device detail page shows:

  • Device information (name, code, type, unique ID, status)
  • Last ping timestamp
  • Assigned users count
  • Sessions tab - Active and expired device sessions with token info and activity timestamps
  • Logs tab - Face recognition logs with user, result, confidence score, and attendance record links

Managing Devices​

  • View - See device details, sessions, and logs
  • Edit - Modify device name, code, type, and status
  • Regenerate Token - Generate a new authentication token (invalidates the old one)
  • Assign/Unassign Users - Control which employees can use the device
  • Delete - Remove devices no longer in use

Device Statuses​

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

Device Authentication Flow​

  1. Device authenticates with the server using its token
  2. Server creates a session and returns a session token
  3. Device uses the session token for subsequent requests
  4. Device retrieves face data for assigned employees
  5. Device submits attendance records when faces are recognized

Changelog: View version history

Last updated on