Skip to main content

LMS Enrollment Troubleshooting

Symptoms​

Assignment fails, an enrollment cannot start or complete, or employee learning rows appear over-broad.

Scope​

Enrollment creation, lifecycle, persistence uniqueness, admin UI, and Gateway ESS read boundary.

Cause​

Likely causes​

Course not Published; duplicate tenant/employee/course record; missing enrollment; invalid current state; missing tenant context; or absent employee ownership filtering.

Safe diagnostic steps​

  1. Record current lifecycle category and requested action.\n2. Confirm the course status category.\n3. Distinguish persistence uniqueness from an endpoint pre-check.\n4. For ESS, compare Gateway forwarding with Training data-scope evidence.

Resolution​

Safe resolution​

Use only the next supported lifecycle action and approved tenant/client context. Do not bypass uniqueness or terminal-state guards.

Validation​

Reload the enrollment and confirm expected state, audit/timeline category, and outbox staging category for event-producing actions.

Evidence to collect​

Collect only environment category, time window, capability/route, status or error category, sanitized correlation reference, lifecycle state category, and recent approved change context.

Escalation​

Lifecycle/persistence issues go to Training; employee ownership ambiguity jointly to Gateway, Training, Identity, and security.

Source References​

  • microservices/src/training-service/Api/TrainingEndpoints.cs
  • microservices/src/training-service/Domain/TrainingEntities.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/TalentAdminPages.tsx
  • microservices/src/training-service/Infrastructure/TrainingDbContext.cs

Summary​

This Draft page provides non-destructive, source-backed diagnosis and stops where recovery authority is not confirmed.

Audience​

LMS users, support, operations, engineering, QA, architecture, security, and implementation teams.

Overview​

Use supported reads and sanitized evidence. Never expose personal learning data, credentials, configuration values, infrastructure details, or operational commands.

See Also​

Keywords​

  • LMS troubleshooting
  • Safe diagnostics

Revision Information​

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