Clock Events

Overview

Clock events are the raw records of employee time — clock-in, clock-out, break start, and break end. They form the basis for worklogs and timesheet calculations.

Event Types

Event Type	Description
IN	Employee starts work
OUT	Employee ends work
BREAK_START	Employee begins a break
BREAK_END	Employee resumes work

How Events Are Created

Clock events can be created in several ways:

• Kiosk terminal — employees enter their PIN and clock in or out at a shared device.
• Schedule page — employees use the clock in/out buttons on today's shift from their own schedule view.
• Offline sync — events recorded on a device without internet are batch-synced when connectivity returns.

Worklogs

Each clock-in creates a worklog record. The worklog tracks the following information:

Field	Description
Actual start	The recorded clock-in time
Actual end	The recorded clock-out time
Rounded minutes	Total worked minutes rounded to 15-min increments
Linked shift	The planned shift this worklog is matched to
Status	Current workflow status of the worklog

Worklog statuses progress through the following stages:

Draft → Approved → Locked → Exported

Offline Synchronization

Each event has a unique device-generated ID (UUID). If a device goes offline, events are stored locally and synced when connectivity returns. The server rejects duplicate event IDs, making sync idempotent and safe to retry. No data is lost during connectivity gaps.

Manual Corrections

Supervisors can adjust worklog times via the timesheet view:

1. Open the worklog that needs correction.
2. Modify the start or end time as needed.
3. Save the adjustment.
4. The change is logged in the audit trail with the original and corrected values.
5. Adjusted worklogs return to Draft status and can be re-approved.

GPS Tracking

Clock events can optionally include GPS coordinates. If enabled for a location:

• A geofence radius is configured for the work location.
• The system records the employee's coordinates at clock-in and clock-out.
• Events outside the expected area are flagged for supervisor review.

Exceptions

The system automatically detects anomalies in clock events. These appear as exceptions on the timesheet for supervisor review.

Exception	Description
Long shift	Shift exceeds 12 hours
Insufficient rest	Less than 11 hours between consecutive shifts
Missing clock-out	Employee clocked in but did not clock out
Unscheduled work	Worklog exists without a linked planned shift