Skip to content

UC-STU-002: Video-Based Learning

1. Metadata

Property Value
ID UC-STU-002
Actor Student
Trigger Assignment of new learning module by Admin
Pre-conditions Student is authenticated; Network connection available (for streaming) or Offline cache validated
Post-conditions Module marked 'Completed'; Quiz results stored; Certificate/Badge awarded
Side Effects Trigger 'Module Completion' notification to Teacher; Unlock subsequent module

2. Description

The primary educational interface where students consume nutritional content via rich video media and validate their understanding through embedded assessments.

3. Success Scenario

  1. Module Selection: Student selects the "Assigned Module" card from their personalized learning path.
  2. Player Initialization:
    • System checks the local cache for the video file.
    • System initializes the secure player (HLS/DASH) if streaming.
  3. Consumption:
    • Student watches the video.
    • Control Rule: Seek-bar is disabled for first-time viewing to ensure full content exposure.
  4. Engagement Check: System prompts a "Tap to Continue" interaction at the mid-point to verify active participation.
  5. Assessment:
    • Upon video completion, a 3-5 question quiz is automatically launched.
    • System records the selection and time-to-answer for each question.
  6. Grading:
    • System calculates the score instantly.
    • If Score >= 66%: Module is marked as "Gold Verified."
    • If Score < 66%: Student is prompted to "Review and Retake."
  7. Sync & Reward:
    • Results are synced to the backend.
    • A digital "Nutrition Hero" badge is added to the student's profile.

4. Acceptance Criteria

  • [ ] Video Integrity: Player must support adaptive bitrate streaming to prevent buffering on 2G/3G networks.
  • [ ] Accurate Tracking: Module completion must only be recorded if >95% of the video duration was played.
  • [ ] Session Persistence: If the app crashes, the student must be able to resume within 10 seconds of the previous timestamp.
  • [ ] Clear Feedback: Quiz results must highlight the correct answers for any missed questions to support learning.
  • [ ] Data Efficiency: Video player must prioritize low-resolution (360p) by default to save student data.

5. Engagement Logic (Segment Tracking)

sequenceDiagram participant P as Media Player participant S as Tracking Service participant B as Batch Processor P->>S: Heartbeat (Timestamp: 25%) S-->>S: Log Milestone: Q1_WATCHED P->>S: Heartbeat (Timestamp: 50%) S-->>S: Log Milestone: MID_WATCHED P->>S: Heartbeat (Timestamp: 95%) S->>B: Trigger Completion Logic B-->>B: Award 'Module Complete' Badge