Skip to main content

Troubleshoot Leave Tenant and Employee Context

Summary​

Safe triage for missing tenant, employee resolution, active state, and joining context.

Audience​

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

Symptoms​

A request cannot resolve the tenant or employee, reports an unavailable profile, or behaves differently for an inactive/new employee.

Scope​

Tenant context, user/employee identity bridge, local EmployeeProfile, active status, and joining date.

Cause​

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

Likely causes​

  • Tenant context missing or inconsistent
  • Employee projection missing or stale
  • Legacy/user/employee identity does not resolve
  • Employee inactive or request precedes joining date

Safe diagnostic steps​

  1. Confirm the user entered through the intended tenant route.
  2. Compare safe employee-projection freshness/status evidence with the Employee source.
  3. Check whether a recent Employee event is pending/failed without exposing event payloads.

Resolution​

Correct the approved login/context path or restore the Employee event flow through its owning service. Do not create or edit the Leave projection 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​

Perform a safe self/profile resolution and then retry only the minimum intended Leave operation.

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​

Employee integration and Leave owners; Identity/platform owner for tenant resolution.

Source References​

  • microservices/src/leave-service/Domain/Leave/EmployeeProfile.cs
  • microservices/src/leave-service/Messaging/EmployeeProfileConsumer.cs
  • microservices/src/leave-service/Application/LeaveWorkflows.cs

See Also​

Keywords​

  • Leave troubleshooting
  • Troubleshoot Leave Tenant and Employee Context
  • Safe diagnostics

Revision Information​

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