Compliance Warnings
Understanding roster compliance warnings — working time limits, rest periods, TES rule violations, and availability conflicts.
Warning Types
| Type | Severity | Trigger |
|---|---|---|
| Long shift | Warning | Shift exceeds 12 hours net |
| Insufficient rest | Warning/Error | Less than 11h (warning) or 8h (error) rest between shifts |
| Consecutive workdays | Warning | More than 7 consecutive workdays |
| Insufficient free weekends | Warning | No free weekend in a 5-week rolling window |
| Missing weekly rest day | Warning | No rest day in a 7-day window |
| Period hours exceeded | Warning/Error | Approaching (warning) or exceeding (error) overtime threshold |
| Insufficient break | Warning | Shift over 6h with less than 30min break |
| Availability conflict | Warning | Shift assigned to an employee who is marked as unavailable |
| Shift overlap | Error | Assignment would overlap one of the employee's other (non-cancelled) shifts |
Shift Overlap is a Hard Stop
Most warnings are advisory — they surface in the manager UI so the supervisor can override and assign anyway. Shift overlap is the exception. The database itself enforces the rule via an exclusion constraint: one employee, one slot, no overlap. Period.
The compliance check produces a shift_overlap warning before any UPDATE runs, so the user sees a clean 422 with a helpful message ("Conflicts with existing shift on 2026-05-01 08:00–16:00") instead of a generic 500. The check fires on every reassignment path: shift swap accept (fast-fail, no manager escalation), supervisor approve, and offer claim.
If you legitimately need to assign a conflicting shift, the right move is to first reschedule or cancel the conflicting shift, then create or accept the new one. There's no override for this rule, by design.
Availability Conflict Warnings
When you assign a shift to an employee who has marked themselves as unavailable (via one-off entry, recurring entry, or their default availability setting), the system shows an availability conflict warning.
These warnings are informational only — they don't prevent the assignment. This allows managers to override availability in emergencies while still being aware of the conflict.
The warning includes the employee's notes if they provided a reason (e.g., "Team practice").
See Employee Availability for details on how availability is managed.