Skip to content

LMS lifecycle

Audience: all
Status: specced
Owns: product + backend
Depends on: Personas, Policies, API overview

flowchart LR
OL[OL register / login] --> Prov[lms_users]
Prov --> OB[Learner onboarding]
OB --> Cat[Catalogue browse]
Cat --> Enr[Enrollment pending or active]
Cat --> Lvl[Level offering enroll]
Enr -->|priced| Pay[LMS checkout → OL pay]
Lvl -->|priced| Pay
Enr -->|organization_seat| Act
Lvl -->|organization_seat| Act
Pay --> Act[Entitlement active]
Enr -->|grant / zero-price| Act
Lvl -->|zero remaining| Act
Act --> Learn[Player + assessments]
Learn --> Comp[Completion policy]
Comp --> Cert[LMS certificate]
Comp --> Evt[lms.course.completed]
Stage Gate
Account Orchestrator JWT; user.created with lms intent (or lazy provision)
Onboarding Learner draft → submit
Catalogue Public published courses and level offerings; optional auth for outline progress / alreadyOwned
Access Active entitlement (not merely an enrollment row)
Learn Sequencing locks (lms.sequencing.locked); progress %
Complete Completion policy (required items + min % + passed assessments)
Certificate LMS-owned; lms.certificate.issued
  1. Platform invite → email (notification.requested).
  2. OL login / register.
  3. Persona onboarding.
  4. Author (draft) → publish (owner/staff) → learners appear on assigned courses.
Status Meaning
pending Created; waiting for payment or grant
active Entitlement active; player unlocked
completed Completion policy satisfied
expired Entitlement validity ended
withdrawn Ended; org-sponsored rows are withdrawn only via org release, not learner unenroll
withdrawn Cancelled
Source How it activates
self_pay POST /enrollments/{id}/checkout → payment.completed (zero-price skips OL). Amount is snapshotted on the entitlement; later list-price edits do not change it.
admin_grant Staff POST /admin/entitlements
sponsor Staff grant — “someone paid”; optional sponsorUserId / note
cap_recommendation Staff/system grant tied to capApplicationId (CAP gRPC recs + this source)
level_offering Fan-out from POST /level-offerings/{id}/enrollments. Parent LevelEnrollment holds the payment (lms_level_enrollment); children stay per-course.
organization_seat Staff-sponsored enroll or seat allocation. OL owns Organization; LMS stores organizationId / seatAllocationId.

Learner suspend is LMS-local (LearnerMembership.status). Suspended learners cannot play, self-enroll, or checkout.

LMS does not close CAP applications. It emits lms.course.completed (learnerUserId, courseId, optional capApplicationId, linkage ids). CAP decides whether GAP_TRAINING can clear.