Back to Playbook
Act 2: Setting Up the Kingdom

10. Time Tracking Setup (Shifts, Attendance, Biometrics)

Story

With employees now active in the system, Sarah begins configuring shifts, attendance policies, grace periods, and biometric tracking rules so working hours can be monitored accurately every day.

She carefully sets up attendance structures because even small configuration mistakes could affect check-ins, overtime, payroll calculations, approvals, reporting accuracy, and compliance workflows across the organization.

Happy Path

Shift schedules, attendance rules, and biometric integrations are configured successfully so employees can start tracking time without operational confusion.

Marking someone late is where attendance stops and payroll starts. A late arrival costs nothing on its own — what it costs is decided by the deduction rules on the payroll policy, covered in Chapter 11. Grace lives in one place — the shift. It decides whether an arrival counts as late at all, and that is the whole of its job: it does not also make a late day look less late. The deduction bands are counted from the shift's start time, so a band set at 2 hr charges an 11:00 arrival on a 9:00 shift no matter how generous the grace is. The payroll policy used to carry a second grace of its own; it did not replace the shift's, it stacked on top of it, so that field has been retired.

  • Create shift templates with start time, end time, break time, grace periods, and overnight settings
  • Assign primary and secondary shifts with effective date ranges
  • Configure attendance policies including IP restrictions and auto-approval behavior
  • Register biometric attendance devices for employee check-ins
  • Apply company attendance rules for weekends, late marks, and overtime handling
  • Automatically connect attendance records to payroll and reporting workflows

Failure Modes

FailureWhat the user seesWhat happens next
Invalid shift time range configuredValidation rejects shift timingCorrect start and end time values
Break duration exceeds total shift durationValidation rejection shownReduce break duration within shift limits
Delete shift with active employee assignmentsDeletion blocked or reassignment requiredReassign employees before deletion
Overlapping effective shift dates for the same employeeConflict validation shownAdjust assignment date ranges
Employee has no assigned shiftCompany default shift applied automaticallyAssign a dedicated shift if needed
Invalid IP whitelist range configuredValidation rejects IP configurationEnter a valid IP or CIDR range
Biometric device goes offlineAttendance sync interruptedFallback to manual attendance until device reconnects
Duplicate biometric punch events receivedDuplicate attendance entries detectedSystem automatically deduplicates punches

Edge Cases

ScenarioBehaviorWhy
Overnight shift crosses midnightAttendance is recorded against the original shift start dateMaintains accurate attendance and overtime tracking
Late mark should trigger only after grace periodLate status activates after configured grace durationSupports flexible attendance policies
Employee is marked late but loses no payThe payroll policy has no late deduction rule in effect, the lateness sits below every configured band, or the band covering it charges 0Attendance records the fact; the payroll policy decides the price
A day is late on the attendance screen but the payslip charges no latenessOnly a day whose recorded status is Late is charged as late. A weekend or holiday punch, a status set by hand, a flexible-duration day and a late arrival that ended as a half day all keep the minutes without being late daysAttendance measures the minutes from the punches whatever the day turns out to be; a day that ended short is charged once, under Days missed
Shift contains multiple break periodsBreak sessions are tracked separately within attendance logsImproves detailed work-hour tracking
Employee uses secondary shift on selected daysPrimary shift remains default while secondary shift overrides specific schedulesSupports flexible workforce scheduling
Strict IP enforcement enabledCheck-in attempts outside whitelisted IP ranges are blockedStrengthens attendance security controls
Soft IP enforcement enabledCheck-in is allowed but flagged with a warningBalances security with operational flexibility
Biometric device clock drifts from server timeTolerance window adjusts punch acceptance automaticallyPrevents false late or absent records