Course Delivery

1. Overview

The core LMS workflow: course authoring, content delivery, enrollment, completion tracking, and transcript posting. Masters courses, course_enrollments, learning_records. Realizes COURSE-AUTHOR and CONTENT-DELIVERY capabilities. The backbone module every LMS deployment installs first; the other LMS modules embedded_master courses to reference content.

2. Entity summary

Name	Description
Course Enrollments	Per-learner per-course state record: assigned date, due date, attempts, status (not_started, in_progress, completed, expired), score. The operational unit of learning tracking.
Courses	Atomic learning unit: e-learning module, video, live session, blended programme, external content. Carries content reference, duration, format, language, prerequisites, certification award.
Learning Records	Granular completion event for a course or activity, often xAPI / SCORM / cmi5 statement: actor, verb, object, result, timestamp. Feeds skill_profiles and certifications.
Cost Centers	Organisational unit for cost allocation: name, code, manager, hierarchy, currency. Drives variance reporting and project / departmental P&L. A near-universal foreign key in finance and payroll.
Employees	Canonical record of a person currently or formerly employed by the organization. Carries identity (legal name, contact, IDs), employment metadata (start date, end date, employment type, country), and pointers to position, job profile, org unit, manager, and life-event history. The most multi-mastered data object in the catalog: HCM masters the core HR slice, Payroll masters the comp/withholding slice, and IGA masters the identity/access slice. Onboarding, PA, and Talent Management consume or contribute.
Org Units	Node in the organizational hierarchy: division, business unit, department, team. Carries manager, cost center alignment, geographic scope, and parent/child relationships. HCM masters the operational hierarchy; EPM contributes the cost-center mapping (which would be Finance-mastered once a Finance/GL domain is loaded).
Positions	Approved slot in the org - a ‘chair’ with role definition, cost center, reporting line, location, and FTE allocation. Distinct from job_profiles (the catalog definition) and from employees (the person filling the slot). A position can be open, filled, or eliminated. SWP designs future positions via org_designs; HCM operationalizes them once approved.

flowchart TD
  classDef master fill:#d4f4dd,stroke:#27ae60,color:#0b3d20;
  classDef embedded_master fill:#fff4cc,stroke:#c79100,color:#5b4500;
  classDef platform_builtin fill:#e0e0e0,stroke:#424242,color:#1a1a1a;
  org_units["Org Units"]
  courses["Courses"]
  course_enrollments["Course Enrollments"]
  learning_records["Learning Records"]
  employees["Employees"]
  hcm_positions["Positions"]
  cost_centers["Cost Centers"]
  users["Users"]
  org_units -->|"groups"| employees
  org_units -->|"contains"| hcm_positions
  hcm_positions -->|"is_filled_by (opt)"| employees
  cost_centers -->|"funds"| org_units
  employees -->|"enrolls_in (opt)"| course_enrollments
  org_units -->|"maps_to (opt)"| cost_centers
  courses -->|"enrolled_via"| course_enrollments
  course_enrollments -->|"produces"| learning_records
  cost_centers -->|"funds (opt)"| course_enrollments
  employees -->|"reflects (opt)"| learning_records
  employees -->|"fills (opt)"| hcm_positions
  employees -->|"learns_via"| course_enrollments
  org_units -->|"rolls_up_to (opt)"| org_units
  users -->|"owns (opt)"| courses
  employees -->|"is_linked_to (opt)"| users
  users -->|"manages (opt)"| hcm_positions
  users -->|"leads (opt)"| org_units
  users -->|"owns (opt)"| cost_centers
  users -->|"authors (opt)"| courses
  users -->|"enrolls in"| course_enrollments
  users -->|"assigns (opt)"| course_enrollments
  users -->|"earns"| learning_records
  org_units -->|"has members (opt)"| users
  class org_units embedded_master;
  class courses master;
  class course_enrollments master;
  class learning_records master;
  class employees embedded_master;
  class hcm_positions embedded_master;
  class cost_centers embedded_master;
  class users platform_builtin;
  style org_units stroke-dasharray:5 5;
  style hcm_positions stroke-dasharray:5 5;
  style cost_centers stroke-dasharray:5 5;

3. Entities catalog

#	data_object	role	mastered in	necessity	pattern flags	notes
1	`course_enrollments` (Course Enrollments)	master	-	required	personal_content	-
2	`courses` (Courses)	master	-	required	-	-
3	`learning_records` (Learning Records)	master	-	required	personal_content	-
4	`cost_centers` (Cost Centers)	embedded_master	`ERP-FIN` (domain-level, not modularized)	optional	-	-
5	`employees` (Employees)	embedded_master	`hcm-core-worker`	required	personal_content	-
6	`org_units` (Org Units)	embedded_master	`hcm-org-positions`	optional	-	-
7	`hcm_positions` (Positions)	embedded_master	`hcm-org-positions`	optional	single_approver	-

4. Aliases and industry synonyms

(no industry-scoped aliases or non-synonym alias types loaded for this scope; generic synonyms are omitted as common knowledge.)

5. Relationships

5.1 Intra-scope edges

from	verb	to	cardinality	kind	necessity	owner_side	notes
`org_units`	groups	`employees`	one_to_many	reference	required	source	-
`org_units`	contains	`hcm_positions`	one_to_many	reference	required	source	-
`hcm_positions`	is_filled_by	`employees`	one_to_one	reference	optional	target	-
`cost_centers`	funds	`org_units`	one_to_many	reference	required	source	-
`employees`	enrolls_in	`course_enrollments`	one_to_many	reference	optional	source	-
`org_units`	maps_to	`cost_centers`	one_to_one	reference	optional	source	-
`courses`	enrolled_via	`course_enrollments`	one_to_many	reference	required	source	-
`course_enrollments`	produces	`learning_records`	one_to_many	composition	required	source	-
`cost_centers`	funds	`course_enrollments`	one_to_many	reference	optional	source	-
`employees`	reflects	`learning_records`	one_to_many	reference	optional	source	-
`employees`	fills	`hcm_positions`	one_to_one	reference	optional	source	-
`employees`	learns_via	`course_enrollments`	one_to_many	reference	required	source	-
`org_units`	rolls_up_to	`org_units`	one_to_many	reference	optional	source	-

5.2 Built-in edges (`users` and other platform built-ins)

from	verb	to	cardinality	necessity	owner_side	notes
`users`	owns	`courses`	one_to_many	optional	source	-
`employees`	is_linked_to	`users`	one_to_one	optional	target	-
`users`	manages	`hcm_positions`	one_to_many	optional	source	-
`users`	leads	`org_units`	one_to_many	optional	source	-
`users`	owns	`cost_centers`	one_to_many	optional	source	-
`users`	authors	`courses`	one_to_many	optional	source	-
`users`	enrolls in	`course_enrollments`	one_to_many	required	source	-
`users`	assigns	`course_enrollments`	one_to_many	optional	source	-
`users`	earns	`learning_records`	one_to_many	required	source	-
`org_units`	has members	`users`	one_to_many	optional	target	-

5.3 Cross-scope edges

from	verb	to	cardinality	necessity	notes
`employees`	triggers	`iga_provisioning_events`	one_to_many	optional	-
`employees`	finalized by	`onboarding_document_collections`	one_to_many	optional	-
`pre_employees`	promotes to	`employees`	one_to_one	required	-
`legal_holds`	identifies_custodians_from	`employees`	many_to_many	optional	-
`legal_advice_records`	references	`employees`	many_to_many	optional	-
`employees`	is host for	`host_assignments`	one_to_many	required	-
`job_profiles`	defines	`hcm_positions`	one_to_many	required	-
`employees`	signs	`employment_contracts`	one_to_many	required	-
`employees`	generates	`employment_events`	one_to_many	required	-
`employees`	triggers	`asset_lifecycle_events`	one_to_many	optional	-
`employees`	requests	`absence_requests`	one_to_many	optional	-
`employees`	holds	`skill_profiles`	one_to_one	optional	-
`org_units`	engages	`contingent_workers`	one_to_many	optional	-
`org_units`	is_scored_by	`engagement_drivers`	one_to_many	optional	-
`org_units`	is_measured_by	`people_kpis`	one_to_many	optional	-
`employees`	triggers	`service_requests`	one_to_many	optional	-
`org_units`	triggers	`iga_entitlement_definitions`	one_to_many	optional	-
`employees`	triggers	`pay_runs`	one_to_many	optional	-
`hcm_positions`	spawns	`job_requisitions`	one_to_many	optional	-
`job_profiles`	maps_to	`courses`	many_to_many	optional	-
`employees`	becomes	`career_aspirations`	one_to_one	optional	-
`employees`	becomes	`work_shifts`	one_to_many	optional	-
`employees`	becomes	`compensation_statements`	one_to_one	optional	-
`salary_bands`	anchors	`hcm_positions`	one_to_many	optional	-
`employees`	triggers	`benefit_enrollments`	one_to_many	optional	-
`employees`	triggers	`corporate_cards`	one_to_many	optional	-
`employees`	spawns	`onboarding_journeys`	one_to_one	optional	-
`employees`	spawns	`hr_cases`	one_to_many	optional	-
`employees`	feeds	`headcount_plans`	one_to_many	optional	-
`employees`	feeds	`agency_time_entries`	one_to_many	optional	-
`employees`	onboarded by	`onboarding_journeys`	one_to_many	required	-
`onboarding_tasks`	spawns	`course_enrollments`	one_to_many	optional	-
`courses`	sequenced_into	`learning_paths`	many_to_many	optional	-
`courses`	fulfills	`compliance_assignments`	one_to_many	optional	-
`courses`	grants	`learner_certifications`	one_to_many	optional	-
`skill_profiles`	updated by	`course_enrollments`	one_to_many	optional	-
`hcm_positions`	requires	`compliance_assignments`	one_to_many	optional	-
`org_units`	sponsors	`compliance_assignments`	one_to_many	optional	-
`employees`	reflected on	`compliance_assignments`	one_to_many	optional	-
`course_enrollments`	updates	`career_aspirations`	one_to_many	optional	-
`learning_records`	feeds	`people_kpis`	one_to_many	optional	-
`employees`	declares	`life_events`	one_to_many	optional	-
`org_units`	sponsors	`benefit_plans`	many_to_many	optional	-
`employees`	updated by	`life_events`	one_to_many	optional	-
`survey_campaigns`	targets	`org_units`	many_to_many	optional	-
`org_units`	owns	`action_plans`	one_to_many	optional	-
`employees`	submits	`survey_responses`	one_to_many	optional	-
`employees`	flagged on	`engagement_drivers`	one_to_many	optional	-
`employees`	reflected on	`engagement_drivers`	one_to_many	optional	-
`employees`	raises	`hr_cases`	one_to_many	required	-
`employees`	updated by	`hr_cases`	one_to_many	optional	-
`case_categories`	drives	`employees`	one_to_many	optional	-
`contingent_workers`	reviewed_against	`employees`	one_to_one	optional	-
`candidates`	becomes	`employees`	one_to_one	required	-
`employees`	enrolls_in	`benefit_enrollments`	one_to_many	required	-
`survey_campaigns`	targets	`employees`	many_to_many	optional	-
`workforce_scenarios`	drives	`hcm_positions`	one_to_many	required	-
`org_designs`	proposes	`hcm_positions`	one_to_many	required	-

6. Cross-domain context

6.1 Master consumers (other modules / domains that embed this scope’s masters)

data_object	other module / domain	role	necessity	notes
`course_enrollments`	LMS-SKILLS (Skills and Learning Paths) - LMS	embedded_master	required	-
`course_enrollments`	PA-PREDICTIVE-MODELS (Predictive Models) - PA	consumer	optional	-
`course_enrollments`	TALENT-SUCCESSION-CAREER (Succession and Career Planning) - TALENT-MGMT	consumer	optional	-
`courses`	LMS-COMPLIANCE-TRAINING (Compliance Training) - LMS	embedded_master	required	-
`learning_records`	PA-PREDICTIVE-MODELS (Predictive Models) - PA	derived	required	-

6.2 Outbound handoffs (events this scope publishes)

source module	target domain	target module	trigger_event	payload	integration	friction	description
LMS-COURSE-DELIVERY	HCM	(domain-level)	`learning_record.posted`	`learning_records`	event_stream	low	Authoritative learning transcript visible in HCM employee record.
LMS-COURSE-DELIVERY	LMS	LMS-SKILLS	`course_enrollment.completed`	`course_enrollments`	lifecycle_progression	low	-
LMS-COURSE-DELIVERY	LMS	LMS-COMPLIANCE-TRAINING	`course.published`	`courses`	lifecycle_progression	low	-
LMS-COURSE-DELIVERY	TALENT-MGMT	TALENT-SUCCESSION-CAREER	`course_enrollment.completed`	`course_enrollments`	event_stream	low	Course completion updates skill-profile; TALENT-MGMT reflects in dev-plans and succession.

6.3 Inbound handoffs (events this scope reacts to)

target module	source domain	source module	trigger_event	payload	integration	friction	description
LMS-COURSE-DELIVERY	HCM	HCM-CORE-WORKER	`employee.created`	`employees`	event_stream	low	New-hire creation provisions required-training assignments (compliance, role-based). Drives day-one and 30-day learning workflows.

6.4 Master providers (modules / domains that own masters this scope embeds)

data_object	role here	necessity	canonical owner(s)	slice notes
`cost_centers`	embedded_master	optional	ERP-FIN (Core ERP Financial Management)	-
`employees`	embedded_master	required	HCM-CORE-WORKER (HCM), PAYROLL (Payroll Management), IGA (Identity Governance and Administration), MDM (Master Data Management)	-
`hcm_positions`	embedded_master	optional	HCM-ORG-POSITIONS (HCM)	-
`org_units`	embedded_master	optional	HCM-ORG-POSITIONS (HCM)	-

7. Lifecycle states (per touched entity)

`course_enrollments` (Course Enrollment)

order	state_name	initial?	terminal?	requires_permission?	derived gate	description
1	`enrolled`	✓	-	-	-	Learner enrolled in the course but has not started.
2	`in_progress`	-	-	-	-	Learner has begun the course content or activities.
3	`completed`	-	✓	✓	`lms-course-delivery:complete`	Learner met all completion criteria with a passing score.
4	`failed`	-	✓	✓	`lms-course-delivery:fail`	Learner did not meet the passing criteria within allowed attempts.
5	`expired`	-	✓	✓	`lms-course-delivery:expire`	Enrollment closed unmet at the due date or content expiry.
6	`withdrawn`	-	✓	✓	`lms-course-delivery:withdraw`	Learner withdrew or was unenrolled before completion.

`courses` (Course)

order	state_name	initial?	terminal?	requires_permission?	derived gate	description
1	`draft`	✓	-	-	-	Course being authored by an instructional designer or SME.
2	`in_review`	-	-	-	-	Content under review by L&D or compliance reviewers.
3	`published`	-	-	✓	`lms-course-delivery:publish`	Course released to the catalog and available for enrollment.
4	`retired`	-	✓	✓	`lms-course-delivery:retire`	Course removed from the catalog and kept for historical transcripts.

`employees` (Employee)

This scope holds employees as embedded_master; the canonical state machine is owned by HCM-CORE-WORKER.

order	state_name	initial?	terminal?	requires_permission?	derived gate	description
1	`draft`	✓	-	-	-	Pre-hire stub created during requisition or onboarding handoff; not yet a worker of record.
2	`active`	-	-	✓	`hcm-core-worker:active_employee`	Worker is currently employed and appears in headcount, payroll eligibility, and directory feeds.
3	`on_leave`	-	-	✓	`hcm-core-worker:on_leave_employee`	Employee is on approved leave (parental, medical, sabbatical); active record but suppressed from some downstream feeds.
4	`suspended`	-	-	✓	`hcm-core-worker:suspended_employee`	Employment temporarily halted (investigation, disciplinary); pay and access may be paused.
5	`terminated`	-	✓	✓	`hcm-core-worker:terminated_employee`	Employment ended (voluntary or involuntary); final pay processed, access deprovisioned.

`hcm_positions` (Position)

This scope holds hcm_positions as embedded_master; the canonical state machine is owned by HCM-ORG-POSITIONS.

order	state_name	initial?	terminal?	requires_permission?	derived gate	description
1	`proposed`	✓	-	-	-	Position has been designed but not yet approved against the headcount plan.
2	`approved`	-	-	✓	`hcm-org-positions:approved_position`	Cleared by headcount/finance owner; eligible to spawn a requisition.
3	`open`	-	-	✓	`hcm-org-positions:open_position`	Approved and actively being recruited against; not yet filled.
4	`filled`	-	-	✓	`hcm-org-positions:filled_position`	An employee occupies the position.
5	`frozen`	-	-	✓	`hcm-org-positions:frozen_position`	Temporarily not fillable (hiring freeze, budget hold); retains the slot.
6	`eliminated`	-	✓	✓	`hcm-org-positions:eliminated_position`	Removed from the org structure permanently.

`learning_records` (Learning Record)

order	state_name	initial?	terminal?	requires_permission?	derived gate	description
1	`recorded`	✓	-	-	-	Statement captured from the content runtime or external source.
2	`validated`	-	✓	✓	`lms-course-delivery:validate`	Record validated against schema and posted to the learner transcript.
3	`voided`	-	✓	✓	`lms-course-delivery:void`	Record voided due to data error, duplicate, or content reset.

`org_units` (Org Unit)

This scope holds org_units as embedded_master; the canonical state machine is owned by HCM-ORG-POSITIONS.

order	state_name	initial?	terminal?	requires_permission?	derived gate	description
1	`draft`	✓	-	-	-	Org unit defined as part of a future structure; not yet operational.
2	`active`	-	-	✓	`hcm-org-positions:active_org_unit`	Operational unit; carries headcount, cost-center linkage, and reporting lines.
3	`reorganized`	-	✓	✓	`hcm-org-positions:reorganized_org_unit`	Unit folded into or replaced by a new structure; references remain for history.
4	`closed`	-	✓	✓	`hcm-org-positions:closed_org_unit`	Unit dissolved; no employees or positions reside in it.

8. Permissions and business rules (derived)

8.1 Permissions

permission	tier	description	included in `:admin`?
`lms-course-delivery:read`	baseline-read	Read access to every entity in the module	✓
`lms-course-delivery:manage`	baseline-manage	Edit operational records	✓
`lms-course-delivery:admin`	baseline-admin	Edit reference data and inherit every workflow gate below	-
`lms-course-delivery:publish`	workflow-gate (lifecycle)	Transition `courses` into state `published`	✓
`lms-course-delivery:retire`	workflow-gate (lifecycle)	Transition `courses` into state `retired`	✓
`lms-course-delivery:complete`	workflow-gate (lifecycle)	Transition `course_enrollments` into state `completed`	✓
`lms-course-delivery:fail`	workflow-gate (lifecycle)	Transition `course_enrollments` into state `failed`	✓
`lms-course-delivery:expire`	workflow-gate (lifecycle)	Transition `course_enrollments` into state `expired`	✓
`lms-course-delivery:withdraw`	workflow-gate (lifecycle)	Transition `course_enrollments` into state `withdrawn`	✓
`lms-course-delivery:validate`	workflow-gate (lifecycle)	Transition `learning_records` into state `validated`	✓
`lms-course-delivery:void`	workflow-gate (lifecycle)	Transition `learning_records` into state `voided`	✓
`lms-course-delivery:view_all_course_enrollments`	override (personal_content)	View all `course_enrollments` rows beyond row-scope	✓
`lms-course-delivery:manage_all_course_enrollments`	override (personal_content)	Manage all `course_enrollments` rows beyond row-scope	✓
`lms-course-delivery:view_all_learning_records`	override (personal_content)	View all `learning_records` rows beyond row-scope	✓
`lms-course-delivery:manage_all_learning_records`	override (personal_content)	Manage all `learning_records` rows beyond row-scope	✓

8.2 Business rules

rule_name	data_object	source flag	intent
`course_enrollment_edit_scope`	`course_enrollments`	has_personal_content	Row-scope by default; override via `lms-course-delivery:view_all_course_enrollments` / `lms-course-delivery:manage_all_course_enrollments`
`learning_record_edit_scope`	`learning_records`	has_personal_content	Row-scope by default; override via `lms-course-delivery:view_all_learning_records` / `lms-course-delivery:manage_all_learning_records`