Skip to main content

Troubleshoot Leave Holidays and Weekly Offs

Summary​

Safe triage for missing calendar entries, failed saves, and unexpected day classification.

Audience​

Employees or administrators affected by the scenario, first-line support, QA, service owners, and architects.

Symptoms​

Holiday/weekly-off configuration fails, reload differs, or Leave days treat a date unexpectedly.

Scope​

Legacy configuration UI, compatibility calendar APIs, extracted Leave calendar, and Attendance/payroll ownership overlap.

Cause​

The cause must be confirmed from current state and source-backed evidence.

Likely causes​

  • Route/permission unavailable
  • Save/delete/toggle request failed
  • Different calendar store owns the active path
  • Policy exclusions disabled
  • Calendar data stale or divergent

Safe diagnostic steps​

  1. Reload the configuration page and note the safe date/day/type category.
  2. Determine the runtime owner and effective policy exclusion settings.
  3. Compare approved calendar reads across only the relevant owners.

Resolution​

Correct calendar data through its authorized UI/owner and change control. Do not directly update stores.

Safe resolution​

Use only the resolution above and approved operational processes. Do not modify databases, replay messages, bypass authorization, or repeat ambiguous state-changing actions.

Validation​

Reload the calendar and test an approved synthetic calculation containing the date/day.

Evidence to collect​

Collect the safe UTC window, route/operation category, response/status category, deployed version, affected scope count, and a correlation identifier. Exclude credentials, tokens, personal Leave details, employee identifiers, payloads, configuration values, and private topology.

Escalation​

Leave, Attendance, payroll calendar, gateway, and product owners as appropriate.

Source References​

  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/PayrollFeaturePages.tsx
  • microservices/src/leave-service/Domain/Leave/CalendarEntities.cs
  • microservices/src/leave-service/Domain/Leave/LeaveDayCalculator.cs

See Also​

Keywords​

  • Leave troubleshooting
  • Troubleshoot Leave Holidays and Weekly Offs
  • Safe diagnostics

Revision Information​

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