Skip to main content

Shift and Overtime Integration

Summary​

The extracted shift model supplies an overtime-after-hours threshold to attendance calculation. Payroll combines attendance overtime with separately maintained manual overtime hours and applies the employee overtime rate.

Audience​

Employees, managers, HR/payroll administrators, product and QA.

Reference Content​

Business process​

Worked hours are compared with the effective overtime threshold. Punch-derived and approval recalculations set overtime to the positive excess, while manual attendance normalization preserves the greater of supplied and derived amounts in applicable modes. Payroll adds manual overtime records and multiplies total overtime by the employee’s configured hourly overtime rate.

Verified rules​

  • Shift overtime threshold cannot be negative or exceed a day in the extracted domain.
  • Overtime hours cannot be negative after calculation normalization.
  • Payroll overtime amount is total overtime hours multiplied by a nonnegative employee rate.
  • Compatibility shift UI stores a text overtime rule; extracted compatibility parsing converts supported hour expressions and otherwise preserves/falls back to existing thresholds.

Responsibilities​

HR defines shift/policy thresholds, managers or attendance administrators approve attendance, and Payroll owns rates and final calculation review. Source does not implement an overtime approval workflow tied to shift scheduling.

Limitations​

No daily/weekly statutory overtime cap, tiered rate, holiday/rest-day multiplier, preapproval, comp-time, shift differential or jurisdiction engine is verified. Manual overtime can coexist with attendance overtime, so governance is required to avoid unsupported double counting.

Requires confirmation​

Legal eligibility, rounding, rate precedence, approvals and production configuration require confirmation.

Business Evidence Checklist​

  • Business purpose: Derive and value hours beyond an effective threshold.
  • Actors: Employees, managers, HR/attendance and payroll administrators.
  • Business process: Resolve threshold, calculate/approve hours and value them in Payroll.
  • Status transitions: No overtime scheduling/approval state is implemented here.
  • Responsibilities: HR configures, attendance approves and Payroll validates rates/results.
  • Business rules: Nonnegative bounded thresholds/hours and nonnegative rates apply.
  • Integrations: Shift, Attendance, manual overtime and Payroll.
  • Limitations: No statutory tiers, multipliers, comp-time or preapproval engine.
  • Requires confirmation: Legal and tenant overtime policy requires confirmation.

Source References​

  • microservices/src/attendance-service/Domain/TimeOffice/Shift.cs
  • microservices/src/attendance-service/Domain/Attendance/AttendanceCalculator.cs
  • microservices/src/payroll-service/Application/PayrollCalculationService.cs
  • Services/OvertimeService.cs

See Also​

Keywords​

  • Overtime threshold
  • Overtime hours
  • Payroll rate

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-20
  • Review cycle: Quarterly