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
| Requirement | Confirmed behavior |
|---|---|
| Purpose | Select the tenant's visible weekly-off weekdays. |
| Navigation path | Weekly Offs or Holidays → /settings/holidays → Weekly Off Policy. |
| Intended users | Confirmed HR-admin-oriented menu audience. |
| Preconditions | Authenticated protected settings route and loaded calendar policy. |
| Main components | HolidayConfigurationPage weekday button grid and import/export toolbar. |
| Fields, columns, or sections | Seven weekday buttons and selected-day count. |
| Filters | None. |
| Actions | Toggle a day; import/export. No separate edit/delete/active control. |
| Validation | No additional client rule confirmed. |
| Loading state | No dedicated state. |
| Empty state | Empty selection is representable; no dedicated message. |
| Success state | Returned weekly-off collection replaces local state. |
| Error state | Page error followed by policy reload. |
| Permission behavior | Protected settings route; server enforcement is authoritative. |
| API dependencies | Compatibility weekly-off replacement operation. |
| Related business rules | Calendar precedence and ownership remain Transitional. |
| Screenshot placeholder | Sanitized selected-day grid and failed-update recovery state. |
Source References
UI/salary-ui/apps/client-hrms-portal/src/pages/hr/PayrollFeaturePages.tsxUI/salary-ui/apps/client-hrms-portal/src/utils/ProtectedRoute.tsx
Related Articles
See Also
Keywords
- Leave UI
- Weekly Off Management UI
- Workforce management
Revision Information
- Status: Draft
- Last reviewed: 2026-07-15
- Review cycle: Quarterly