Video Course - Information Architecture (VID)

Purpose

• Chuẩn hoá cấu trúc dữ liệu cho khóa video quay sẵn và lesson player, phục vụ lesson flow, báo cáo, và đồng bộ sang Learning Management.

Core Entities

• Course → metadata (title, description, program, level, estimatedDuration, prerequisiteCourseIds[]).
• Module → group lesson theo chủ đề; thuộc Course.
• Lesson → đơn vị học; thuộc Module. Attributes: lessonNumber, title, summary, estimatedTime, unlockRule.
• Activity → phần tử trong lesson (Video, InlineQuiz, Assignment, Reading, PracticeLink, AIConversation). Gồm position, type, resourceId, duration.
• LessonStage → trạng thái gating (locked, available, completed, failed), unlockCondition (ví dụ: previous_activity_completed).

Media & Interaction

• VideoResource: url, subtitles[], downloadAllowed, markers (highlight segments).
• InlineQuiz: câu hỏi, đáp án, quizStats (global aggregates).
• AssignmentReference: liên kết exercise/worksheet (kéo theo ExerciseResult khi hoàn tất).
• AITutorSession: lưu transcript summary, mode (text/voice), toggle transcript flag.
• LessonNote
  • LessonNoteFreeform: noteId, lessonId, content (rich/text/drawing), createdAt, lastEditedAt.
  • LessonNoteTimestamp: noteId, lessonId, timestampSec, content; optional attachments.

Progress & Reporting

• LessonProgress: userId, lessonId, currentActivityId, status, startedAt, completedAt, durationAccumulated, scoring (nếu có).
• ActivityProgress: userId, activityId, status, score, attempts, answers.
• LessonSummary: tổng hợp notes, quiz kết quả, AI tutor highlights, generatedReportUrl.
• ActivityEvent: log activity_entered, quiz_answered, note_created, ai_session_started, ai_mode_switched.

Data Flow Toward Learning Management

• ActivityProgress cho activities dạng luyện tập tạo ExerciseResult với source = video_course.
• LessonSummary emit event lesson_completed → LM dùng để cập nhật streak/goal.
• Mapping fields: program, skill, domain lấy từ lesson metadata để đồng bộ phân tích.

Monetization Hooks

• accessPolicy: subscription, credit, free.
• unlockCost: số credit nếu mua lẻ; đồng bộ Payment.
• accessAudit: ghi nhận lần mở khoá, nguồn (subscription/credit).

Analytics

• Event schema: lesson_started, lesson_completed, activity_skipped, inline_quiz_answered, ai_tutor_mode_selected, note_created_freeform, note_created_timestamp.
• KPI: completion rate, average quiz accuracy, AI usage rate, notes per lesson.

Technical Notes

• Content stored headless (CMS); lesson player fetch sequence + gating config.
• Notes + AI sessions cần chính sách bảo mật (GDPR-like) → mã hoá lưu trữ.
• Offline caching (future): select subset (video + notes) sync back.