PRD: Learner Journey & Mission Model

This document specifies the product requirements and technical design of the Learner Journey Model in the Octo101 AI-First Adaptive Learning Platform.

---

1. Vision & Core Philosophy

In legacy LMS systems, a Course is a static sequence of lessons:

Course ──> Lesson 1 ──> Lesson 2 ──> Lesson 3 (Linear & Fixed)

In Octo101, a Journey is a dynamic, personalized learning map directed toward a target competency milestone:

Goal ──> Journey ──> Stages ──> Missions ──> Learning Activities ──> Evidence (Dynamic Graph)

Each learner has a unique Journey Instance compiled dynamically by the Learning Planner Engine based on their Learner Model and goals. For example, if Learner B already demonstrates mastery of variables, the planner automatically skips the first mission, starting B directly on loops.

---

2. Decoupled Architecture Flow

The execution cycle of the Journey model is driven by three distinct engines:

Learner Goal + Learner Model + Knowledge Graph + Knowledge Packages
                           │
                           ▼
                  [Planner Engine]
                           │ (Generates & Re-routes)
                           ▼
                        Journey
                           │
                           ▼
                        Missions
                           │
                           ▼
                 [Experience Engine]
                           │ (Recommends & Selects)
                           ▼
                  Learning Activities
                           │
                           ▼
                       Evidence
                           │
                           ▼
                   [Learner Engine]
                           │ (Updates Model)
                           ▼
                  Updated Learner Model

---

3. Structural Specification

A. Journey

A Journey represents the macro-level path directed toward a competency goal.

• Journey Goal: Specifies target skills, competencies, and target proficiency levels.
• Completion Contract: Specifies the conditions required to finalize a journey.
• Trạng thái (Status):
  • Draft: Newly compiled, not yet active.
  • Recommended: Recommended to the learner.
  • Active: The active learning path.
  • Paused: Temporarily halted.
  • At Risk: Delayed, high error patterns, or low engagement.
  • Completed: All contract thresholds met.
  • Reopened: Re-opened due to memory decay or new gaps.

B. Stage

Stages partition long journeys into digestible phases for user experience (e.g. Stage 1: Programming Basics, Stage 2: Control Flow).

C. Mission

Missions are the objective milestones within a Stage.

• Trạng thái (Status):
  • Locked: Prerequisite missions not yet completed.
  • Available: Eligible to start.
  • Recommended: Suggested as the next step.
  • Active: Currently in progress.
  • Completed: Objective evidence thresholds met.
  • Skipped: Automatically bypassed by the planner.
  • Needs Remediation: Prerequisite gap detected, remedial help inserted.
  • Blocked: Blocked due to severe knowledge gaps.
• Types:
  • Mandatory: Required to complete the Journey.
  • Optional: Extension or enrichment.
  • Adaptive: Dynamically inserted at runtime by the planner to address gaps.

D. Completion Contract Schema

Each journey maps a strict contract specifying graduation requirements:

{
  "mastery_threshold": 0.8,
  "confidence_threshold": 0.75,
  "coverage_threshold": 0.85,
  "required_missions_completed": true,
  "blocking_gaps_allowed": 0
}

---

4. Journey Instance Representation (JSON Schema)

{
  "journey_id": "journey_python_foundations_001",
  "template_id": "template_python_foundations",
  "learner_id": "learner_001",
  "title": "Python Foundations",
  "description": "Xây dựng năng lực lập trình Python nền tảng.",
  "goal": {
    "goal_id": "goal_python_foundations",
    "target_competencies": ["computational_thinking", "basic_programming"],
    "target_skills": ["variables", "conditions", "loops", "functions"],
    "target_level": "beginner"
  },
  "status": "active",
  "current_stage_id": "stage_control_flow",
  "current_mission_id": "mission_master_loop",
  "stages": [
    {
      "stage_id": "stage_programming_basics",
      "title": "Programming Basics",
      "order": 1,
      "status": "completed",
      "mission_ids": ["mission_variables", "mission_expressions"]
    },
    {
      "stage_id": "stage_control_flow",
      "title": "Control Flow",
      "order": 2,
      "status": "active",
      "mission_ids": ["mission_conditions", "mission_master_loop"]
    }
  ],
  "completion_contract": {
    "mastery_threshold": 0.8,
    "confidence_threshold": 0.75,
    "coverage_threshold": 0.85,
    "required_missions_completed": true,
    "blocking_gaps_allowed": 0
  },
  "progress": {
    "mission_completion": 0.5,
    "mastery_progress": 0.61,
    "evidence_confidence": 0.68,
    "knowledge_coverage": 0.59,
    "overall_readiness": 0.6
  }
}