Learning Entities¶
Why This Exists¶
This document defines Learning Domain entities with identity, lifecycle, and business rules.
Owner¶
The owner is the Chief Product Officer and Enterprise Architect.
Business Value¶
Entity definitions ensure learning data remains consistent across Academy content, learner progress, certificates, recommendations, and AI tutor support.
Entity Catalogue¶
| Entity | Purpose | Key attributes | Business rules | Relationships | MVP status |
|---|---|---|---|---|---|
| Course | Defines a structured learning product. | CourseId, title, objective, level, status, version. | Must have modules before publication. | Contains modules; may be part of a path. | MVP |
| Module | Groups lessons within a course. | ModuleId, CourseId, title, order, status. | Must belong to one course. | Contains lessons. | MVP |
| Lesson | Delivers a learning concept or task. | LessonId, ModuleId, title, content type, duration, status. | Must define objective and completion rule. | May have video, quiz, or exercise. | MVP |
| Video Lesson | Provides video-based instruction. | VideoLessonId, LessonId, media reference, transcript, duration. | Must have an approved transcript or summary. | Extends lesson. | MVP |
| Interactive Lesson | Provides guided scenario-based learning. | InteractiveLessonId, LessonId, scenario, steps, scoring mode. | Must define safe feedback and completion criteria. | Extends lesson. | Later |
| Quiz | Tests learning comprehension. | QuizId, LessonId, questions, pass threshold, attempt limit. | Must have answer key and scoring rule. | Receives quiz attempts. | MVP |
| Quiz Attempt | Records a user's quiz submission. | AttemptId, QuizId, UserId, score, status, submitted at. | Must be immutable after scoring except correction metadata. | Belongs to progress. | MVP |
| Practical Exercise | Captures applied learning work. | ExerciseId, LessonId, prompt, rubric, status. | Must have review criteria. | Receives exercise submissions. | MVP |
| Exercise Submission | Records a user's submitted exercise. | SubmissionId, ExerciseId, UserId, answer, review status. | Must retain submitted version. | May be AI-assisted or human-reviewed. | Later |
| Certificate | Records verified learning completion. | CertificateId, UserId, course/path reference, issued at, status. | Requires satisfied completion criteria. | Linked to progress. | MVP |
| Learning Path | Defines an ordered journey toward a goal. | PathId, title, goal, steps, target audience, status. | Steps must reference active learning assets. | Contains courses, lessons, quizzes, exercises. | MVP |
| User Progress | Tracks individual learning state. | ProgressId, UserId, OrganizationId, content reference, status, score. | Completion must follow content rules. | Feeds certificates and recommendations. | MVP |
| Organization Learning Profile | Tracks organization-level education maturity. | ProfileId, OrganizationId, maturity level, gaps, recommendations. | Must not mutate Organization facts. | Uses assessments and progress summaries. | MVP |
| Procurement Maturity Assessment | Measures procurement education maturity. | AssessmentId, OrganizationId, rubric version, score, level. | Must use versioned scoring. | Produces knowledge gaps. | MVP |
| Knowledge Gap | Defines missing or weak competence. | KnowledgeGapId, category, severity, evidence, status. | Must have evidence or assessment basis. | Drives recommendations. | MVP |
| Learning Recommendation | Recommends a learning action. | RecommendationId, reason, priority, target, status. | Must reference valid learning asset. | Triggered by Learning or adjacent domains. | MVP |
| AI Tutor Session | Records a tutor support session. | SessionId, UserId, topic, references, confidence, status. | Must be auditable and guarded. | Uses Intelligence reasoning output. | Later |
Entity Design Notes¶
Learning entities use stable identifiers because learning records are evidence. A certificate, quiz attempt, progress record, or tutor session must be traceable even after content is revised.
Content entities and learner entities must be separated. Revising a course must not rewrite historical progress or certificates unless a formal policy says the record is invalid.