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
- Ensure the Face Attendance module is installed and enabled
- Purchase and download the Face Attendance Device module
- Extract the module to
Modules/FaceAttendanceDevice - Run the installation command:
php artisan module:enable FaceAttendanceDevice
php artisan migrate
- Configure the module in Settings > Modules > Face Attendance Device
Usage
Adding a Device
- Navigate to Attendance > Devices
- Click Add Device
- Enter device details:
- Device name/identifier
- IP address or connection string
- Device type/model
- Location assignment
- Test connection
- Save device configuration
Device Configuration
- Go to Attendance > Devices > [Device Name]
- Configure device settings:
- Sync interval
- Recognition threshold
- Operating hours
- Offline behavior
- Save settings
Syncing Attendance Data
Automatic Sync:
- Devices automatically push attendance data at configured intervals
- Real-time sync available for supported devices
Manual Sync:
- Go to Attendance > Devices
- Select device(s) to sync
- Click Sync Now
- Review sync results
Employee Enrollment on Devices
- Navigate to Employees > Device Enrollment
- Select employee and target device
- Initiate enrollment:
- Push existing face data to device
- Or enroll directly on device
- 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
| Setting | Description | Default |
|---|---|---|
| Sync Interval | How often to sync with devices | 5 minutes |
| Retry Attempts | Connection retry attempts | 3 |
| Timeout | Device connection timeout | 30 seconds |
| Offline Buffer | Days of offline data storage | 7 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
Related Modules
- Face Attendance - Required for face recognition functionality
- Site Attendance - Site-based device assignments