Skip to main content

Face Attendance Device

This module enables integration with face attendance hardware devices for automated employee attendance tracking. Connect dedicated face recognition hardware to the system for seamless attendance management.

Features

  • Hardware Device Integration - Connect face attendance terminals to the system
  • Device Management - Configure and monitor connected devices
  • Automated Attendance Sync - Automatically sync attendance data from devices

Requirements

  • Open Core Business Suite (Base System)
  • Face Attendance module (dependency)
  • Compatible face attendance hardware devices
  • Network connectivity for devices

Installation

  1. Ensure the Face Attendance module is installed and enabled
  2. Purchase and download the Face Attendance Device module
  3. Extract the module to Modules/FaceAttendanceDevice
  4. Run the installation command:
php artisan module:enable FaceAttendanceDevice
php artisan migrate
  1. Configure the module in Settings > Modules > Face Attendance Device

Usage

Adding a Device

  1. Navigate to Attendance > Devices
  2. Click Add Device
  3. Enter device details:
    • Device name/identifier
    • IP address or connection string
    • Device type/model
    • Location assignment
  4. Test connection
  5. Save device configuration

Device Configuration

  1. Go to Attendance > Devices > [Device Name]
  2. Configure device settings:
    • Sync interval
    • Recognition threshold
    • Operating hours
    • Offline behavior
  3. Save settings

Syncing Attendance Data

Automatic Sync:

  • Devices automatically push attendance data at configured intervals
  • Real-time sync available for supported devices

Manual Sync:

  1. Go to Attendance > Devices
  2. Select device(s) to sync
  3. Click Sync Now
  4. Review sync results

Employee Enrollment on Devices

  1. Navigate to Employees > Device Enrollment
  2. Select employee and target device
  3. Initiate enrollment:
    • Push existing face data to device
    • Or enroll directly on device
  4. Verify enrollment status

Monitoring Devices

  • Dashboard - View all devices and their status
  • Health Checks - Monitor device connectivity
  • Alerts - Receive notifications for device issues
  • Logs - Review device activity and sync history

Configuration Options

SettingDescriptionDefault
Sync IntervalHow often to sync with devices5 minutes
Retry AttemptsConnection retry attempts3
TimeoutDevice connection timeout30 seconds
Offline BufferDays of offline data storage7 days

Supported Devices

The module supports integration with various face attendance hardware:

  • Standard API devices (REST/SOAP)
  • ZKTeco face terminals
  • Hikvision face access devices
  • Custom device integrations available

Troubleshooting

Device Not Connecting:

  • Verify network connectivity
  • Check IP address configuration
  • Ensure firewall allows communication
  • Verify device credentials

Sync Failures:

  • Check device online status
  • Review error logs
  • Verify API credentials
  • Test network stability

Employee Not Recognized:

  • Re-enroll employee on device
  • Check face data quality
  • Verify enrollment sync completed