Skip to main content

Troubleshoot Leave Balances

Summary​

Safe triage for missing, stale, or unexpected Leave balance values.

Audience​

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

Symptoms​

No balance appears, available value is unexpected, or an approved/cancelled request is not reflected.

Scope​

Per-user/type/year balance components, current UI derivation, decision usage, and coexistence reconciliation.

Cause​

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

Likely causes​

  • No matching user/type/year record
  • Employee-to-user identity mismatch
  • Component values or year differ
  • Decision/event processing incomplete
  • Monolith and Leave Service stores diverge

Safe diagnostic steps​

  1. Compare opening, accrued, used, adjusted, carried-forward, and encashed through approved views.
  2. Recalculate available using the documented formula without publishing values.
  3. Confirm the request terminal state and relevant event/projection progress.

Resolution​

Use approved balance administration or reconciliation ownership. Never edit balance storage directly.

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​

Confirm stored components and derived available agree in the authoritative path and UI.

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 product/service and database owners; Payroll owner when its read model differs.

Source References​

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

See Also​

Keywords​

  • Leave troubleshooting
  • Troubleshoot Leave Balances
  • Safe diagnostics

Revision Information​

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