Zoom Course - Information Architecture (ZOOM)

Purpose

• Chuẩn hoá dữ liệu cho khóa live/Zoom/offline hybrid, phục vụ scheduling, teaching tools, social engagement và báo cáo buổi học.

Core Entities

• LiveCourse: metadata (title, program, level, modality, totalSessions, description).
• Cohort: nhóm học viên, startDate, endDate, capacity, teacherIds[], assistantIds[].
• Session: buổi học cụ thể (sessionNumber, dateTime, duration, location (Zoom link/offline room), status).
• AttendanceRecord: userId, sessionId, status (present, late, absent, makeup), checkInAt, checkOutAt.
• SessionAgenda: danh sách AgendaItem (type: video, quiz, breakout, discussion, AI activity) với thời lượng dự kiến.

Teaching Tools & Activities

• TeachingActivity: gắn với AgendaItem; launch tool (Video replay, Practice set, AI conversation, Worksheet, Poll).
• InClassInteraction:
  • LiveQuiz (poll, MCQ), store per-session aggregates.
  • AIClassCoach sessions (AI hỗ trợ giáo viên/học viên).
  • BreakoutGroup assignment (groupId, members, activityLink).
• TeacherNote: giáo viên ghi chú trong buổi (timestamp, text, attachments) - chia sẻ cho học viên sau buổi.

Homework & Follow-up

• HomeworkAssignment: sessionId, title, description, dueDate, resourceLink, autoCreateExerciseResult flag.
• HomeworkSubmission: userId, assignmentId, status, submittedAt, score, feedback.
• SessionSummary: tổng hợp tham gia, kết quả homework liên quan, note giáo viên, recordingLink, followUpActions.

Social & Gamification

• AvatarProfile: userId, avatarId, customization.
• EngagementPoint: userId, sessionId, points, reason (participation, quiz high score, homework on-time).
• ClassStory: postId, cohortId, authorId, content (text/media), postedAt (dòng sự kiện lớp).
• ClassChatMessage: threadId, sessionId/cohortId, authorId, message, attachments, postedAt.

Integration with Learning Management

• Homework submissions tạo ExerciseResult (source = zoom_course) để cập nhật dashboard luyện tập.
• SessionSummary emit event session_completed → LM ghi nhận active day & streak.
• Attendance + points → optional feed cho LM streak social (nếu cần).

Monetization & Access

• AccessPolicy: subscription tier, credit deduction, free trial.
• PaymentLog: record enrollment, refund, add-on sessions.
• MakeupRequest: học viên xin học bù (sessionId, targetSessionId, status).

Analytics

• Event schema: session_started, session_ended, attendance_marked, live_quiz_answered, breakout_joined, homework_submitted, points_awarded.
• KPI: attendance rate, participation rate, homework completion, points distribution, AI usage in class.

Offline / Hybrid Considerations

• RoomResource: offline location, seating, equipment.
• MaterialPacket: tài liệu giấy phát trên lớp, mapping to digital resources.
• AnswerSheetCapture: upload/scan, OCR metadata (future).

Technical Notes

• Scheduling hệ thống đồng bộ với calendar (ICS).
• Teaching tool integration qua launch token/URL (practice, AI tutor).
• Chat/story có thể tích hợp bên thứ ba → lưu metadata + link.