Skip to main content

Work Calendar, Weekly Offs and Holidays

Summary​

The implemented work calendar consists of tenant weekly-off weekdays plus separately managed holiday dates. It is not a per-employee roster calendar.

Audience​

Employees, managers, HR and payroll administrators, product and QA.

Reference Content​

Business purpose and process​

HR administrators select company weekly-off days in the Holidays/Weekly Off Policy page and maintain dated holidays. Attendance weekly views mark those dates read-only before applying approved leave display. Leave duration calculation can exclude holidays and weekly offs according to leave policy. Payroll includes returned weekly-off and holiday day counts in payable-day inputs.

Verified rules​

  • Weekly-off rules are tenant-scoped day-of-week values.
  • In the extracted resolver, a tenant with no weekly-off rows falls back to Sunday; a tenant with rows that are all inactive has intentionally configured no weekly offs.
  • Direct weekly-off updates upsert supplied days and leave omitted days unchanged.
  • Compatibility updates replace the complete active set and allow clearing it.
  • The compatibility UI presents all seven weekdays as a company-level selection.
  • Holidays override weekly offs in the inspected attendance display order; approved leave is checked after both.

Limitations​

There is no alternating-week rule, nth-week rule, employee-specific weekly off, shift-specific weekly off, half-day holiday, regional calendar assignment, factory/location calendar or roster publication. The platform provisioning sample contains a rotational label, but no scheduling engine consumes it; it is not implemented business behavior.

Requires confirmation​

Which service owns holidays/weekly offs in a deployed environment depends on routing. Holiday pay, substitute days, statutory calendars and conflict resolution require policy/legal confirmation.

Business Evidence Checklist​

  • Business purpose: Define recurring non-working weekdays and dated holidays.
  • Actors: HR configures; employees/managers view; Leave, Attendance and Payroll consume.
  • Business process: Maintain calendar rules, classify dates and propagate outcome categories.
  • Status transitions: Weekly-off rules can be active/inactive; holidays have CRUD rather than publication states.
  • Responsibilities: HR maintains accurate tenant calendar data.
  • Business rules: Valid unique weekdays and routing-specific update semantics apply.
  • Integrations: Attendance display, Leave duration and Payroll payable-day inputs.
  • Limitations: No alternating, employee, shift, location or regional calendar assignment.
  • Requires confirmation: Ownership and statutory calendar/pay rules require confirmation.

Source References​

  • microservices/src/attendance-service/Domain/TimeOffice/WeeklyOffRule.cs
  • microservices/src/attendance-service/Application/Services/AttendancePolicyResolver.cs
  • microservices/src/leave-service/Application/LeaveWorkflows.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/AttendanceStatus.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/PayrollFeaturePages.tsx

See Also​

Keywords​

  • Weekly off
  • Holiday calendar
  • Work calendar

Revision Information​

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