# Overtime Jurisdiction Preset Library (US + Canada)

This document and the accompanying data file provide the initial overtime preset library for BuyerKiosk native timesheets.

- Data file: `docs/specs/013-employee-scheduling/overtime-presets.json`
- Status values:
  - `verified`: derived from an official government source and reviewed at the time of authoring
  - `partially_verified`: derived from an official source but missing some details / needs confirmation
  - `unverified`: plausible baseline included for design completeness, but requires sourcing and review
  - `needs_research`: placeholder rule not yet defined

## Scope (What This Library Covers)

- Weekly overtime threshold (hours/week) and overtime multiplier
- Optional daily overtime thresholds (hours/day) and double-time multipliers where explicitly supported

## Out of Scope (Must Be Handled via Custom Rules)

The following are commonly jurisdiction-specific and frequently include exemptions or special handling:

- Averaging agreements / work cycle agreements
- Overtime banking / time off in lieu rules
- Industry/occupation exemptions and special rules
- Public holiday interactions that change weekly thresholds
- Collective bargaining agreements

## Maintenance Notes

- Treat this library as **product data**: changes require a changelog entry and test coverage in the eventual rule engine.
- Rules change over time. Each store’s applied rule should be snapshotted by effective date (per `scheduleOvertimeRules.effectiveStartDate` in `docs/specs/013-employee-scheduling/solution-design.md`).

## Research TODOs

No outstanding placeholder jurisdictions in `docs/specs/013-employee-scheduling/overtime-presets.json`.

Some sources may be stored as versioned screenshots under `docs/specs/013-employee-scheduling/source_material/` when official sites are access-restricted.