Skip to main content

Troubleshoot Leave Attendance Conflicts

Summary​

Safe triage when Attendance conflicts block Leave creation or approval.

Audience​

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

Symptoms​

The UI or API reports existing Attendance or cannot complete a conflict check.

Scope​

Synchronous Attendance conflict dependency during confirmed Leave creation/approval paths.

Cause​

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

Likely causes​

  • Attendance exists in the selected range
  • Attendance service unavailable or request context rejected
  • Different employee/date/tenant context across services

Safe diagnostic steps​

  1. Confirm the sanitized date range and employee context category.
  2. Use safe correlation traces to determine conflict versus dependency failure.
  3. Ask Attendance owner to verify the relevant classification through approved access.

Resolution​

Resolve the underlying business record through its normal Attendance governance process, or restore the dependency. Do not bypass the check or edit data 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​

Repeat the approved conflict check and then the intended Leave action only after the source condition is resolved.

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​

Attendance owner and Leave owner; Identity/gateway owners for context/routing failures.

Source References​

  • microservices/src/leave-service/Infrastructure/AttendanceServiceConflictClient.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 Attendance Conflicts
  • Safe diagnostics

Revision Information​

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