Skip to main content

Weekly Off Management UI

Summary

Weekly offs are managed as day-of-week selections inside Holidays Configuration, not as a separate route.

Audience

HR administrators, payroll administrators, QA, support, and frontend developers.

Overview

  • Navigation: Weekly Offs or Holidays → /settings/holidays → Weekly Off Policy.
  • Listing/fields: seven named weekday buttons; selected days are visually active.
  • Actions: toggle a day; import/export controls are also present.
  • Save behavior: the client optimistically updates selection, sends the full selected-day collection, then applies the returned collection.
  • Failure behavior: a page error is set and the policy is reloaded to restore server state.
  • Validation: no additional client rule is present.
  • Tenant/permission: protected settings route; server enforcement remains authoritative.
  • Search/filter/delete/active state: not applicable or not separately implemented.
  • Loading/empty: no dedicated state.
  • API dependency: compatibility weekly-off operations.
  • Screenshot placeholder: sanitized selection grid and failed-update recovery state.

Calendar precedence across Leave, Attendance, and payroll requires confirmation; see Known limitations.

Screen reference

RequirementConfirmed behavior
PurposeSelect the tenant's visible weekly-off weekdays.
Navigation pathWeekly Offs or Holidays → /settings/holidays → Weekly Off Policy.
Intended usersConfirmed HR-admin-oriented menu audience.
PreconditionsAuthenticated protected settings route and loaded calendar policy.
Main componentsHolidayConfigurationPage weekday button grid and import/export toolbar.
Fields, columns, or sectionsSeven weekday buttons and selected-day count.
FiltersNone.
ActionsToggle a day; import/export. No separate edit/delete/active control.
ValidationNo additional client rule confirmed.
Loading stateNo dedicated state.
Empty stateEmpty selection is representable; no dedicated message.
Success stateReturned weekly-off collection replaces local state.
Error statePage error followed by policy reload.
Permission behaviorProtected settings route; server enforcement is authoritative.
API dependenciesCompatibility weekly-off replacement operation.
Related business rulesCalendar precedence and ownership remain Transitional.
Screenshot placeholderSanitized selected-day grid and failed-update recovery state.

Source References

  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/PayrollFeaturePages.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/utils/ProtectedRoute.tsx

See Also

Keywords

  • Leave UI
  • Weekly Off Management UI
  • Workforce management

Revision Information

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