Quản lý khóa học - Room & Schedule (Learning Management)

Purpose

• View lịch học/room để học viên thấy nhanh buổi sắp tới, tham gia đúng giờ, và quản lý xung đột.

Shell Fit

• Đây là local schedule view bên trong destination Khóa học.
• Card lịch hoặc shortcut từ Program Workspace root / Hôm nay hoặc aggregate schedule view chỉ nên đưa user vào đúng view này của Khóa học, không tạo thêm schedule lane song song ở shell level.

Elements / Scope

• Nguồn dữ liệu: Activity type Class session (tham chiếu ./CM_Course_Activity_Model.md).
• Chế độ xem: 7-day mini calendar + agenda/list; filter theo khóa/hình thức (Online/Offline/Hybrid).
• Thông tin: ngày giờ, lớp, hình thức, link/phòng, giáo viên (nếu có), trạng thái tham gia/điểm danh.
• CTA: Join (Zoom/online), View info, Add to calendar, Report issue (đổi lịch/địa điểm).
• Nhắc nhở: buổi sắp diễn ra, join window, quiet hours.

Logic / Rules

• Chỉ hiển thị phiên tương lai; quá khứ chuyển vào Recap/History.
• Sắp xếp mặc định theo thời gian gần nhất; pin “Buổi sắp diễn ra” lên đầu.
• Join window: cho phép vào sớm X phút (config); hiển thị timer “Bắt đầu trong …”.
• Hình thức:
  • Online: link join, fallback “copy link”.
  • Offline: địa chỉ/map; CTA “Xem đường đi”.
  • Hybrid: hiển thị cả hai, ưu tiên chế độ user chọn khi đăng ký.
• Cảnh báo xung đột: nếu 2 buổi trùng giờ, hiển thị warning và gợi ý liên hệ support.
• Quiet hours: nhắc nhở tuân thủ cấu hình (không push ngoài giờ yên tĩnh trừ urgent).
• Deeplink từ Home/Calendar mini: mở đúng ngày + highlight session.
• Attendance operations contract (course mode):
  • mỗi lần absence tạo trigger CS follow-up.
  • nếu late_count_14d >= 3 tạo thêm trigger CS follow-up.
  • SLA liên hệ đầu tiên của CS: trong vòng 48h từ lúc trigger.
  • trigger hợp lệ phải có option xếp lịch học bù.
• Learner-facing behavior:
  • với case đã có trigger CS, learner vẫn xem lịch bình thường.
  • UI hiển thị trạng thái hỗ trợ đang được liên hệ/hỗ trợ học bù dưới dạng non-blocking.

UI / Behavior

• Layout: 7-day mini calendar + agenda list; chọn ngày → filter list; có drawer chi tiết buổi.
• Card buổi học: tên lớp, thời gian, hình thức, CTA join/view, trạng thái (sắp diễn ra/đã điểm danh/đã hủy).
• “Buổi sắp diễn ra”: block nổi, CTA join, badge đếm ngược.
• Filter chips: All / Online / Offline / Hybrid / theo khóa.
• Empty state: “Không có lịch trong 7 ngày tới” + CTA mở Courses/Practice.
• Access: link “Add to calendar” (ICS/Google); offline thì hiển thị map link.
• Edge: hủy/đổi lịch → badge “Đã đổi lịch” + lý do; lỗi link Zoom → nút copy link/backup room.
• Khi phát sinh absence/late-trigger:
  • hiển thị notice nhẹ về hỗ trợ CS,
  • cung cấp CTA Xem lịch học bù khi đã có đề xuất.

Change log

• 2026-03-26: Thêm Shell Fit để giữ rõ Room & Schedule là local schedule view của Khóa học.
• 2026-02-18: Bổ sung contract vận hành điểm danh cho Course mode: CS trigger theo vắng học và trễ 3 lần/14 ngày, SLA liên hệ 48h, và hỗ trợ học bù.
• 2026-01-20: Bổ sung join window, filter hình thức, cảnh báo xung đột, quiet hours, agenda + mini calendar.
• 2026-01-18: Khởi tạo logic trang Room & Schedule.