Holiday Management UI
Summary
Holidays Configuration supports listing, create, edit, delete confirmation, and import/export controls on a protected route.
Audience
HR administrators, payroll administrators, QA, support, and frontend developers.
Overview
- Navigation: Holidays →
/settings/holidays. - Preconditions: authenticated tenant user with the time-office module and matching settings capability.
- Fields: holiday name, date, and type; confirmed options are Paid, Optional, and Unpaid.
- Listing: holiday calendar plus configured-count summary.
- Actions: create, edit, delete with confirmation, import/export toolbar.
- Validation: save returns early when name or date is empty; no inline required-field message is rendered.
- Tenant scope: request context comes from the shared client; server enforcement is authoritative.
- Loading/empty: no dedicated loading skeleton or explicit empty message was found.
- Success/error: success reloads data; load/save/delete failures set a page error.
- Search/filter/active state: not present.
- API dependency: compatibility holiday operations, not a dedicated direct-service UI client.
- Screenshot placeholder: sanitized calendar, edit form, and error state.
Ownership between payroll-oriented legacy configuration and extracted Leave calendar remains Transitional.
Screen reference
| Requirement | Confirmed behavior |
|---|---|
| Purpose | Maintain the visible tenant holiday calendar. |
| Navigation path | Holidays → /settings/holidays. |
| Intended users | Confirmed HR-admin-oriented menu audience. |
| Preconditions | Authenticated tenant user with time-office and matching settings access. |
| Main components | HolidayConfigurationPage, metrics, form, calendar listing, import/export toolbar. |
| Fields, columns, or sections | Name, date, type; configured-count and holiday calendar. |
| Filters | No search/filter. |
| Actions | Create, edit, delete with confirmation, import/export. No active/inactive control. |
| Validation | Name and date required by an early return; no inline required message. |
| Loading state | No dedicated skeleton. |
| Empty state | No explicit empty message confirmed. |
| Success state | Form reset and calendar reload. |
| Error state | Page-level load/save/delete error. |
| Permission behavior | Protected settings route; server enforcement is authoritative. |
| API dependencies | Compatibility holiday operations. |
| Related business rules | Tenant calendar classification and transitional calendar ownership. |
| Screenshot placeholder | Sanitized calendar, edit form, delete confirmation, and error state. |
Source References
UI/salary-ui/apps/client-hrms-portal/src/App.tsxUI/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
- Holiday Management UI
- Workforce management
Revision Information
- Status: Draft
- Last reviewed: 2026-07-15
- Review cycle: Quarterly