QR Code
Scanning · Verification · Attendance
QR Code Scanning
The QR code scanning system provides fast, secure, and accurate attendance tracking and verification capabilities. QR code technology enables efficient check-in/check-out processes, location verification, and secure access control throughout the TALENTS System.
Fast scanning
Instant QR code recognition.
Secure verification
Tamper-proof authentication.
Mobile friendly
Works on all devices.
Key Features
Advanced scanning technology.
Quick Check-in
Fast attendance recording.
Location Verification
Confirm work site presence.
Security Features
Tamper-resistant verification.
Offline Capability
Function without internet.
Integration
Seamless system integration.
Best Practices
Effective scanning guidelines.
Clear Scanning
Ensure proper lighting and focus.
Device Maintenance
Keep devices charged and updated.
Location Awareness
Verify correct scanning locations.
Regular Updates
Keep QR codes current and valid.
QR Code Scanning Process
Step-by-step attendance recording.
How QR Code Scanning Works
QR Code Generation
User generates a QR code containing their UUID, timestamp, and scan type (checkin/checkout).
QR Code Scanning
Authorized scanner scans the QR code and selects the specific job and shift.
Validation Process
System validates user existence, job application status, shift availability, and timing constraints.
Attendance Recording
System creates or updates attendance record with appropriate status and timestamps.
Attendance Creation Conditions
Required validations and checks.
User Validation
- • User must exist in the system
- • User UUID must be valid and match
- • User account must be active
Application Status
- • Must have accepted application for the job
- • Application status must be 'accepted'
- • Job must match the specified job_id
Shift Validation
- • Shift must exist and belong to the job
- • Check-in time must be within shift period
- • Shift must be active and available
Time Constraints
- • Check-in must be within shift hours
- • Late arrival detection and tracking
- • Prevent duplicate check-ins for same shift
API Endpoints
QR code scanning API routes.
| Method | Endpoint | Description |
|---|---|---|
GET | /api/qr/generate | Generate QR code for authenticated user |
POST | /api/qr/scan | Scan QR code and record attendance |
GET | /api/qr/scanner | Display QR scanner interface |
Attendance Data Structure
Recorded attendance information.
Core Attendance Fields
| Field | Type | Description |
|---|---|---|
| user_id | Foreign ID | Reference to the user/talent |
| shift_id | Foreign ID | Reference to the shift |
| job_id | Foreign ID | Reference to the job |
| project_id | Foreign ID | Reference to the project |
| check_in_time | DateTime | When the user checked in |
| check_out_time | DateTime | When the user checked out |
| total_hours | Decimal | Total hours worked (calculated) |
| status | String | present, late, absent, etc. |
| scanner_id | Foreign ID | Who scanned the check-in |
| checkout_scanner_id | Foreign ID | Who scanned the check-out |
Attendance Table Interface
Visual representation of attendance data.
The attendance table provides a comprehensive view of all recorded attendance entries, with filtering, sorting, and export capabilities.
Advanced Filtering
Filter by date range, user, job, project, and status.
Real-time Data
Live attendance status and duration tracking.
Error Handling & Validation
Common scenarios and responses.
User Not Found
Returns 404 when the scanned UUID doesn't match any user in the system.
No Accepted Application
Returns 404 when user doesn't have an accepted application for the specified job.
Outside Shift Hours
Returns success but with warning when scanning outside shift time period.
Duplicate Check-in
Prevents duplicate check-ins for the same user and shift on the same day.
Integration with Other Systems
Connected verification workflows.
Connected Workflows
User Integration
Applications and Jobs verification